rgnDup(2K)

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO

NAME

rgnDup- duplicate an actor address space

SYNOPSIS

#include <mem/chMem.h>

int rgnDup(KnCap *tgtactorcap, KnCap *srcactorcap, VmFlags flags);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

FEATURES

MEM_VIRTUAL

DESCRIPTION

The rgnDup() function duplicates regions from the address space specified by srcactorcap into the actor address space specified by tgtactorcap. If srcactorcap or tgtactorcap is K_MYACTOR, the address space of the current actor is used as the source or the destination, respectively.

For each region from the source actor rgnDup() duplicates the region in the target actor address space with the same address, size and attributes (options).

The duplicate region can either share the data with the source region (map to the same segment of volatile memory as the source), or take a private volatile copy. The data is shared if the flags argument is K_INHERITSHARE or if flags is zero and the source region has the K_INHERITSHARE attribute. The data is copied if the flags argument is K_INHERITCOPY or if flags is zero and the source region has the K_INHERITCOPY attribute.

The region is not duplicated if the flag argument is zero and the region has neither the K_INHERITSHARE nor the K_INHERITCOPY attribute.

Before the operation, the target actor address space must be empty.

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

tgtactorcap or srcactorcap does not specify a reachable actor.

K_ENOEMPTY

The target actor address space is not empty.

K_ENOMEM

The system is out of resources.

K_EMAPPER

The segment mapper does not respect the microkernel/mapper protocol.

RESTRICTIONS

The target actor, the source 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

SEE ALSO

rgnAllocate(2K), rgnSetInherit(2K), rgnSetProtect(2K), rgnStat(2K)

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO