vmFree(2K)

NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES

NAME

vmFree- free memory

SYNOPSIS

#include <mem/chMem.h>

int vmFree(KnCap *actorcap, VmAddr address, VmSize size);

FEATURES

MEM_VIRTUAL

DESCRIPTION

The vmFree function frees memory in an actor address space from address to address + size -1. The actor is specified by its capability actorcap. On--demand physical memory corresponding to the specified address space range is deallocated without region destruction. The address and size fields must be page-aligned.

RETURN VALUE

If successful, K_OK is returned, otherwise a negative error code is returned.

ERRORS

[K_EFAULT]

Some of the arguments provided are outside the caller's address space.

[K_EINVAL]

An inconsistent actor capability was provided.

[K_EUNKNOWN]

actorcap does not specify a reachable actor.

[K_EADDR]

Some or all the addresses from the target address range are invalid .

[K_EROUND]

address isn't page aligned.

[K_EROUND]

size isn't page-aligned.

[K_EBUSY]

Tried to free no--demand (mapped to a region with the K_NODEMAND attribute) physical memory.

RESTRICTIONS

The target actor and the current actor must be located on the same site.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

ChorusOS 4.0  Last Revised December 1999

NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES