NAME | SYNOPSIS | FEATURES | DESCRIPTION | RESTRICTIONS | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO
#include <mem/chMem.h>void PxmOpen(KnPxmOpenArgs * openArg, void * cookie);
PXM_EXT
This system call is strictly reserved for internal use only. It MUST NOT be used by any application.
The PxmOpen/PxmClose routines are provided by the Proxy-Mapper and are invoked as up-calls by the CHORUS VM. They are invoked as laps ; their second argument is the lap cookie as defined at svLapCreate time. The PxmOpen/PxmClose up-calls are invoked by the VM in order to inform the Proxy-Mapper that the data segment object is currently being used by the VM. The Proxy-Mapper must not destroy an open data segment.
The KnPxmOpenArgs data structure has the following members:
KnDtPxMapper* pxm ; KnSgId sgId ; int write ; |
The KnPxmCloseArgs data structure has exactly the same members. The pxm field is a pointer to the KnExtPxMapper structure previously defined by a call to dcPxmDeclare . It is also associated with the data segment defined by the sgId member of the structure at dcAlloc time. If the write field is set to 0, the data cache will not be modified.If the value is not 0, it may be modified. This allows the Proxy-Mapper to optimize sync or flush operations.
The PxmOpen up-call is invoked by the VM in the following cases:
When rgnMapFromDtCache or rgnInitFromDtCache are invoked
When rgnMapFromActor or rgnInitFromActor or rgnDup are invoked, and the source region was created through a call to rgnMapFromDtCache
When a physical page attached to the data cache will be destroyed by the swapper.
The PxmClose up-call is invoked by the VM in the following cases:
When a region mapping the data segment identified by the sgId field of the KnPxmCloseArgs data structure is destroyed
When a physical page attached to the corresponding data cache has been destroyed
The current implementation is only applicable to trusted supervisor actors.
No error messages are returned.
none
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | FEATURES | DESCRIPTION | RESTRICTIONS | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO