ChorusOS man pages section 2K: Kernel System Calls

intro(2K)

NAME

Intro- introduction to ChorusOS error codes and system calls

DESCRIPTION

This manual describes the principal ChorusOS APIs. All system calls and other interfaces provided for use by applications are documented here. In this context ``applications'' covers a wide range of functions including device drivers, OS personality emulation servers, real time control programs, and so forth.

FEATURES

Each API function is associated with one or more system features. A given interface is available if, and only if, one of its associated features was configured on the target system when that system was built.

Each manual page has a FEATURES section, where the list of features offering this interface is provided.

The features available in ChorusOS are introduced here. For each feature, there is a man page in the 5FEA section which gives an description of the feature and a list of all interfaces associated with the feature.

DATE

time of day service

EVENT

event flag sets

HOT_RESTART

management of restartable actors and persistent memory

IPC

provide OSI stack entry points

IPC_REMOTE

inter-process communication

IPC_REMOTE_COMM

IPC remote communication

LAPBIND

built-in nameserver for local access points

LAPSAFE

safe mode for LAP invocations

LOG

system logging

VIRTUAL_ADDRESS_SPACE

memory management features

ON_DEMAND_PAGING

memory management features

MIPC

message queues

MON

system monitoring

PERF

performance support

RTC

realtime clock

RTMUTEX

real-time mutexes

ROUND_ROBIN

scheduler features

TIMER

system time

SEM

semaphores

USER_MODE

support for user actors

VTIMER

thread execution timing

POSIX-compliant API features

The following features provide POSIX-compatible functions (1003.1, 1003.1b, 1003.1c).

POSIX-THREADS: POSIX 1003.1c pthread functions.
POSIX-TIMERS: POSIX 1003.1b real-time clock and timer functions.
POSIX_MQ: POSIX 1003.1b real-time message queues.
POSIX_SHM: POSIX 1003.1b real-time shared memory objects.
POSIX_SOCKETS: POSIX 1003.1j (standard BSD compatible) socket functions.

Note -

The POSIX 1003.1c pthread functions and 1003.1b real-time clock and timer functions are delivered into the standard libcx.a library.

ERRORS

Warning: For reasons of compatibility with existing standards, different system calls use distinct error return conventions. Always refer to individual man pages when interpreting error codes.

Most ChorusOS system calls are of the integer type and return a direct value which is zero or positive when the call is successful, and negative to indicate an error. The possible error return values are listed below.

The PRIVATE-DATA calls follow a similar convention (error code returned directly by the function) but the error codes are positive, not negative. PRIVATE-DATA error values are indicated below.

The POSIX-THREADS functions whose names begin with pthread_ follow a similar convention, but with POSIX error return values.

All other POSIX features (POSIX-TIMERS, POSIX_MQ, POSIX_SHM, POSIX_SOCKETS, remaining POSIX-THREADS calls) and in addition the ChorusOS ACTOR_EXTENDED_MNGT, return -1 in case of error and set the errno variable. Note that errno is not cleared on successive calls, so it should be tested only after an error has been indicated via a function return code. In multi-threaded actors, errno is implemented not as a global variable but as a macro which refers to a per-thread errno value. A complete list of the POSIX error codes (possible errno values) can be found in the file <errno.h>.

Standard ChorusOS error codes

The list of error codes is given below, with general meanings. However, this general definition may be overwritten by certain system calls. The meaning should be interpreted according to the type and the circumstances of the call.

When a thread that executes in supervisor address space performs a system call, the arguments of the call are not fully checked by the system. This applies to threads executing in supervisor actors and to threads executing in user actors when the VIRTUAL_ADDRESS_SPACE feature is disabled. In general, when such a thread invokes a system call with wrong arguments the result may be unpredictable.

The implication is that when a man page states that a system call will return a given error code in a given error situation, this will be fully enforced by the system only for threads executing in user address space. For threads executing in supervisor address space, the error situations may not be detected by the system. In particular this is the case for the K_EFAULT error situations.

0 K_OK No error: The call returned successfully.
-1 K_EINVAL Invalid argument: An invalid argument has been provided.
-2 K_ENOMEM Out of resources: The kernel has been unable to perform the call due to a lack of resources.
-3 K_ETOOMUCH Message too big: Attempted to send a message body longer than K_CMSGSIZEMAX bytes.
-4 K_ENOPORT Port invalid: The port local identifier is invalid (the port was never created, or was deleted, or has migrated before or during the call).
-5 K_EFAULT Bad address: The kernel encountered a hardware access fault in attempting to access one of the arguments of the call.
-6 K_ENOTIMP Not implemented: The call, or one of its options, is not implemented in the current version.
-7 K_EUNKNOWN Unreachable destination: Attempt to send an RPC request to an unreachable port.
-8 K_ETIMEOUT Time-out occurred: A system call failed because the time-out occurred.
-9 K_EFAIL Transaction failed: A system call failed because the actor which received the request failed.
-10 K_EABORT Aborted wait: Abortable calls (for example. ipcReceive, ipcCall, threadSuspend) have been interrupted because the waiting thread has been aborted.
-11 K_EFULL System queues saturated: An ipcSend, ipcReply or ipcCall failed because the local destination port queue is full, or the local communication system is saturated.
-12 K_EROUND Alignment error: Attempted to allocate a memory region whose starting address is not aligned to a page boundary.
-13 K_EADDR The address of an argument is invalid: Attempted to allocate a memory region overlapping another.
-14 K_EPRIV Privilege violation: Attempted to perform a forbidden operation.
-15 K_EBADMODE Invalid addressing mode: Attempted to send a message with an invalid addressing mode.
-16 K_ESIZE Size error: The size given in the parameter is incompatible with other parameters.
-17 K_EBUSY Memory locking conflict: Attempted to flush a part of a local cache locked in memory.
-18 K_EABORTRPC Aborted RPC: Aborted a remote IPC notification.
-19 K_EMAPPER Mapper access error: Unable to access a mapper.
-20 K_ENOEMPTY Non empty address space: Attempted to duplicate regions within a non-empty address space.
-21 K_EOFFSET Bad segment offset: Attempted to map an impossible part of a segment.
-22 K_EOVERLAP Region overlapping: Attempted to allocate a memory region that would overlap with another one.
-23 K_EPROT Region access rights violation: Attempted to write in a read-only region.
-24 K_ESPACE Address space violation: Attempted to allocate a region outside the valid range of virtual addresses for the address space.
-25 K_EUNDEF Undefined default mapper: The system default mapper is not defined.
-26 K_EARGS Arguments inconsistent: The combination of a number of the call arguments is inconsistent.
-28 K_EBUSYPORT Port in use: Attempted to migrate a port to which a message handler is attached.
-29 K_ELINKFAILURE Link failure: A remote communication protocol failure has been detected during remote IPC.
-30 K_EBADMSG Invalid message identifier: The message identifier parameter is not a valid message address, or the corresponding message has already been consumed.
-31 K_ENOTAVAILABLE System call not available: Attempted to invoke a system call that is not available within this configuration.

PRIVATE-DATA error codes

0 K_OK No error: The call returned successfully.
1 PD_ENOKEY No more keys available: The key table is full, no more keys can be created.
2 PD_ENOMEM Out of resources: The kernel has been unable to perform the call because of a lack of resources.
3 PD_EINVAL Invalid argument: An invalid argument has been given.
4 PD_ESERVER Cannot connect to server: The Private Data Manager is not accessible.
5 PD_EUSER Called from user mode

DEFINITIONS AND ARGUMENT TYPES

All system call arguments are integer or pointer sized. In other words, if an argument is described as "a structure ...", it is actually "a pointer to a structure ...". The following argument types may occur in system calls exported by the Core Executive or by any other module, with the semantics indicated and constant option values.

KnCap* actorcap

Usually, actorcap is a pointer to a user memory location which either contains an actor capability (input parameter) or will hold an actor capability (output parameter). As an input parameter, actorcap may contain one of the following special values instead:

K_MYACTOR: Designates the home actor of the calling thread.
K_SVACTOR: Designates the supervisor address space.

KnThreadLid threadli

Usually, threadli is a thread local identifier. Instead, threadli may contain the special value K_MYSELF, which designates the calling thread.

KnTimeVal* waitLimit

This argument is used in system calls that make the calling thread block until an explicit event or action occurs. It allows the caller to control the maximum waiting time and abortability of the wait. Usually, waitLimit is a pointer to a user memory location containing a timeout interval (expressed as a (second,nanosecond) pair, see sysTime(2K)). In this case, if the call blocks, it is ABORTABLE. Instead, waitLimit may contain one of the following special values:

K_NOBLOCK: Specifies a polling call. If the relevant condition is not satisfied immediately, the call returns with an error code and does not wait. The call is NONABORTABLE in the sense that it neither consumes the abort state (if the current thread was previously aborted) nor returns K_EABORT. For compatibility with previous versions of the system K_NOBLOCK has the value 0.
K_NOTIMEOUT: Specifies an unlimited wait. The call is ABORTABLE. For compatibility with previous versions of the system K_NOTIMEOUT has the value -1.
K_NOTIMEOUT_NOABORT: Also specifies an unlimited wait. The call is NONABORTABLE.

Site number

The Chorus kernel has the concept of "Site Number" which has the following properties

There is a unique Site Number per site.
The site number is a 32 bit unsigned integer
The site Number is embedded into all structures of the type "KnUniqueId" which are associated to the following kernel entities:
- IPC ports
- IPC Group Capabilities (KnCap)
- Actor Capabilities (KnCap)

The site number of the target is provided to the kernel when you boot the system and can be provided in two different ways:

By the boot program within the "siteNumber" field of the "bootConf" structure; in this case, it is the responsability of the boot program to determine the site number of the target. The way the site number is found by the boot is fully "boot dependent", and may be specific to the target board. For instance, it may be stored in the "NVRAM" memory, or computed more dynamically from some (unique) board identifier. When the target is booted with the standard ChorusOS network boot monitor, it is the whole IP address used by the boot monitor which is provided as the site number of the target.
Within the boot image through the "chorusSiteId" kernel tunable; in this case, the site number is statically fixed within the boot image. This approach is less flexible that the case above, as the same boot image cannot be booted on multiple similar target boards. For this reason, it should only be used when there is no way for the site number of the target board to be determined when you boot the system.

Note -

the value fixed through the tunable takes precedence over the value provided by the boot program.
by default, the site number is set to zero. If the REMOTE IPC feature of the kernel has been configured, a WARNING message is displayed on the console and the REMOTE IPC feature is not activated. In other words, only local ICP communications are enabled when the site number has not been set.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

Name: Description
_exit(2K): terminate a c_actor
acap(2K): get a c_actor capability
aconf(2K): get configurable system variables
acreate(2K): creates a c_actor
acred(2K): get/set c_actor credentials
actorCreate(2K): create an actor
actorDelete(2K): delete an actor
actorName(2K): get and/or set the symbolic name of an actor
actorPi(2K): get and/or set the protection identifier of an actor
actorPrivilege(2K): get and/or set the privilege of an actor
actorSelf(2K): get the current actor capability
actorStart(2K): See actorStop(2K)
actorStat(2K): get the status of all actors on a site
actorStop(2K): Stop an actor; Start an actor
afexec(2K): create a new c_actor
afexecl(2K): See afexec(2K)
afexecle(2K): See afexec(2K)
afexeclp(2K): See afexec(2K)
afexecv(2K): See afexec(2K)
afexecve(2K): See afexec(2K)
afexecvp(2K): See afexec(2K)
agetId(2K): get c_actor's ID
agetalparam(2K): See aload(2K)
akill(2K): kill or restart an actor
alParamBuild(2K): See aload(2K)
alParamUnpack(2K): See aload(2K)
aload(2K): Manage the loading of an actor
astart(2K): activates a c_actor
astat(2K): list all active c_actors
atrace(2K): c_actor trace
await(2K): wait for c_actor to terminate or stop
awaits(2K): See await(2K)
dladdr(2K): translate address to symbolic information
dlclose(2K): close a dynamic object
dlerror(2K): get diagnostic information
dlopen(2K): gain access to a dynamic object file
dlsym(2K): get the address of a symbol in a dynamic object
ethIpcStackAttach(2K): attach an
ethOsiStackAttach(2K): attach an
eventClear(2K): See eventInit(2K)
eventInit(2K): initialize an event flag set; Clear events in an event flag set; Post events in an event flag set; Wait for events in an event flag set
eventPost(2K): See eventInit(2K)
eventWait(2K): See eventInit(2K)
grpAllocate(2K): allocate a port group capability
grpPortInsert(2K): insert a port into a port group; remove a port from a port group
grpPortRemove(2K): See grpPortInsert(2K)
ipcCall(2K): send an RPC request and wait for the reply
ipcGetData(2K): get the current message body
ipcReceive(2K): receive a message
ipcReply(2K): reply to the current message
ipcRestore(2K): See ipcSave(2K)
ipcSave(2K): Save the current message; Restore a saved message as the current message
ipcSend(2K): send a message
ipcSysInfo(2K): get system information about the current message
ipcTarget(2K): build a message target
lapDescDup(2K): See svLapCreate(2K)
lapDescIsZero(2K): See svLapCreate(2K)
lapDescZero(2K): See svLapCreate(2K)
lapInvoke(2K): invoke a lap handler
lapResolve(2K): See svLapBind(2K)
msgAllocate(2K): allocates a message from a message space
msgFree(2K): free a message of a message space
msgGet(2K): retrieves the first message of a message queue
msgPut(2K): post a message to a message queue
msgRemove(2K): remove a message from a message queue
msgSpaceCreate(2K): create a message space
msgSpaceOpen(2K): open a message space
mutexGet(2K): See mutexInit(2K)
mutexInit(2K): initialize a mutex; acquire a mutex; release a mutex; try to acquire a mutex
mutexRel(2K): See mutexInit(2K)
mutexTry(2K): See mutexInit(2K)
padGet(2K): return actor-specific values associated with keys
padKeyCreate(2K): create a private key for an actor
padKeyDelete(2K): delete an actor private key
padSet(2K): set the actor's key to a specific value
portCreate(2K): create a port; declare a port
portDeclare(2K): See portCreate(2K)
portDelete(2K): delete a port
portEnable(2K): Enable a port portDisable; Disable a port
portGetSeqNum(2K): See portMigrate(2K)
portLi(2K): See portUi(2K)
portMigrate(2K): Migrate a port; Get a port sequence number
portPi(2K): get and/or set the protection identifier of a port
portUi(2K): Get the unique identifier of a port, given its local identifier; Get the local identifier of a port, given its unique identifier
ptdErrnoAddr(2K): return a thread-specific errno address
ptdGet(2K): return thread-specific value associated with key
ptdKeyCreate(2K): create a thread-specific data key
ptdKeyDelete(2K): delete a thread-specific data key
ptdRemoteGet(2K): return a thread-specific data value for another thread
ptdRemoteSet(2K): set a thread-specific data value for another thread
ptdSet(2K): set a thread-specific value
ptdThreadDelete(2K): delete all thread-specific values and call destructors
ptdThreadId(2K): return the thread ID
rgnAllocate(2K): allocate a region in an actor address space
rgnDup(2K): duplicate an actor address space
rgnFree(2K): deallocate regions of an actor address space
rgnInitFromActor(2K): allocate a region in an actor address space and initialise it from another region
rgnMapFromActor(2K): create a region in an actor address space and map another region to it
rgnPhysMap(2K): create a region in an actor address space and map (on demand) to it physical memory specified by the caller
rgnSetInherit(2K): Change inheritance options associated with a region; Change paging options associated with a region; Change inheritance options associated with a region; Change opaque values associated with a region
rgnSetOpaque(2K): See rgnSetInherit(2K)
rgnSetPaging(2K): See rgnSetInherit(2K)
rgnSetProtect(2K): change protection options associated with a region
rgnStat(2K): get the statistics of a region of an actor address space
rtMutexGet(2K): See rtMutexInit(2K)
rtMutexInit(2K): Initialize a realtime mutex; Acquire a realtime mutex; Release a realtime mutex; Try to acquire a realtime mutex
rtMutexRel(2K): See rtMutexInit(2K)
rtMutexTry(2K): See rtMutexInit(2K)
schedAdmin(2K): scheduling classes administration
semInit(2K): initialize a semaphore; wait on a semaphore; signal a semaphore
semP(2K): See semInit(2K)
semV(2K): See semInit(2K)
svAbortHandler(2K): See svExcHandler(2K)
svActorAbortHandler(2K): Connect an actor abort handler; Disconnect an actor abort handler; Get an actor abort handler
svActorAbortHandlerConnect(2K): See svActorAbortHandler(2K)
svActorAbortHandlerDisconnect(2K): See svActorAbortHandler(2K)
svActorAbortHandlerGetConnected(2K): See svActorAbortHandler(2K)
svActorExcHandler(2K): Connect an actor exception handler; Disconnect an actor exception handler; Get an actor exception handler
svActorExcHandlerConnect(2K): See svActorExcHandler(2K)
svActorExcHandlerDisconnect(2K): See svActorExcHandler(2K)
svActorExcHandlerGetConnected(2K): See svActorExcHandler(2K)
svActorStopHandler(2K): Actor stop handler management: Connect an actor stop handler; Disconnect an actor stop handler; Get an actor stop handler
svActorStopHandlerConnect(2K): See svActorStopHandler(2K)
svActorStopHandlerDisconnect(2K): See svActorStopHandler(2K)
svActorStopHandlerGetConnected(2K): See svActorStopHandler(2K)
svActorVirtualTimeout(2K): Set an actor's virtual timeout; Cancel an actor's virtual timeout
svActorVirtualTimeoutCancel(2K): See svActorVirtualTimeout(2K)
svActorVirtualTimeoutSet(2K): See svActorVirtualTimeout(2K)
svCopyIn(2K): Copy from trap caller space; Copy string from trap caller space; Copy to trap caller space
svCopyInString(2K): See svCopyIn(2K)
svCopyOut(2K): See svCopyIn(2K)
svExcHandler(2K): Define an exception handler; Define an abort handler
svGetInvoker(2K): get handler invoker
svLapBind(2K): bind a symbolic name to a lap descriptor; unbind the symbolic name bound to a lap descriptor; get a lap descriptor from a lap symbolic name
svLapCreate(2K): create a lap; reset a lap descriptor; test if a lap descriptor has been initialized; duplicate a lap descriptor
svLapDelete(2K): delete a lap
svLapUnbind(2K): See svLapBind(2K)
svMaskAll(2K): Disable interrupt processing; Enable interrupt processing; Reenable interrupt processing
svMaskedLockGet(2K): See svMaskedLockInit(2K)
svMaskedLockInit(2K): Initialize a spin lock; Disable interrupts and acquire a spin lock; Try to disable interrupts and acquire a spin lock; Release a spin lock and enable interrupts; Initialize a spin lock; Acquire a spin lock; Try to acquire a spin lock; Release a spin lock
svMaskedLockRel(2K): See svMaskedLockInit(2K)
svMaskedLockTry(2K): See svMaskedLockInit(2K)
svMemRead(2K): Copy from supervisor caller space; Copy to supervisor caller space
svMemWrite(2K): See svMemRead(2K)
svMsgHandler(2K): Connect/disconnect a message handler; Prepare a reply to a handled message
svMsgHdlReply(2K): See svMsgHandler(2K)
svPagesAllocate(2K): supervisor address space memory allocator
svPagesFree(2K): See svPagesAllocate(2K)
svSpinLockGet(2K): See svMaskedLockInit(2K)
svSpinLockInit(2K): See svMaskedLockInit(2K)
svSpinLockRel(2K): See svMaskedLockInit(2K)
svSpinLockTry(2K): See svMaskedLockInit(2K)
svSysCtx(2K): get system context table address
svSysPanic(2K): trigger the invocation of the panic handler
svSysTimeout(2K): Request a timeout; Cancel a timeout; Get timeout resolution
svSysTimeoutCancel(2K): See svSysTimeout(2K)
svSysTimeoutSet(2K): See svSysTimeout(2K)
svSysTrapHandler(2K): Connect a trap handler; Disconnect a trap handler; Get a trap handler
svSysTrapHandlerConnect(2K): See svSysTrapHandler(2K)
svSysTrapHandlerDisconnect(2K): See svSysTrapHandler(2K)
svSysTrapHandlerGetConnected(2K): See svSysTrapHandler(2K)
svThreadVirtualTimeout(2K): Set a thread's virtual timeout; Cancel a thread's virtual timeout
svThreadVirtualTimeoutCancel(2K): See svThreadVirtualTimeout(2K)
svThreadVirtualTimeoutSet(2K): See svThreadVirtualTimeout(2K)
svTimeoutGetRes(2K): See svSysTimeout(2K)
svTrapConnect(2K): Connect a trap handler; Disconnect a trap handler
svTrapDisConnect(2K): See svTrapConnect(2K)
svUnmask(2K): See svMaskAll(2K)
svUnmaskAll(2K): See svMaskAll(2K)
svVirtualTimeoutCancel(2K): See svVirtualTimeoutSet(2K)
svVirtualTimeoutSet(2K): Set a virtual timeout; Cancel a virtual timeout
sysBench(2K): kernel benchmark utility
sysGetConf(2K): Get Chorus module configuration value
sysGetEnv(2K): Get a value from the Chorus configuration environment
sysLog(2K): log a message in the kernel's cyclical buffer
sysPoll(2K): See sysRead(2K)
sysRead(2K): Read characters from the system console; Write characters to the system console; Poll characters from the system console
sysReboot(2K): request a reboot of the local site
sysSetEnv(2K): Set a value in the ChorusOS configuration environment
sysShutdown(2K): shut down or restart the system
sysTime(2K): get system time; get system time resolution
sysTimeGetRes(2K): See sysTime(2K)
sysTimer(2K): system timer management
sysTimerGetCounterFrequency(2K): See sysTimer(2K)
sysTimerGetCounterPeriod(2K): See sysTimer(2K)
sysTimerReadCounter(2K): See sysTimer(2K)
sysTimerStartFreerun(2K): See sysTimer(2K)
sysTimerStartPeriodic(2K): See sysTimer(2K)
sysTimerStop(2K): See sysTimer(2K)
sysUnsetEnv(2K): delete a value from the ChorusOS configuration environment
sysWrite(2K): See sysRead(2K)
threadAbort(2K): Abort a thread; Check whether the current thread has been aborted
threadAborted(2K): See threadAbort(2K)
threadActivate(2K): make a thread active
threadBind(2K): bind a thread to a processor
threadContext(2K): get and/or set the context of a thread
threadCreate(2K): create a thread
threadDelay(2K): delay the current thread
threadDelete(2K): delete a thread
threadLoadR(2K): Get the current thread's valid soft register value; Reset the current thread's valid soft register value
threadName(2K): get and/or set the symbolic name of a thread
threadResume(2K): See threadSuspend(2K)
threadScheduler(2K): get and/or set thread scheduling parameters
threadSelf(2K): get the current thread local identifier
threadSemInit(2K): Initialize a thread semaphore; Signal a thread semaphore; Wait on a thread semaphore
threadSemPost(2K): See threadSemInit(2K)
threadSemWait(2K): See threadSemInit(2K)
threadStart(2K): Stop a thread; Start a thread
threadStat(2K): obtain the descriptions of the threads running in an actor
threadStop(2K): See threadStart(2K)
threadStoreR(2K): See threadLoadR(2K)
threadSuspend(2K): Suspend a thread; Resume a thread
threadTimes(2K): get thread execution time
timerCreate(2K): create a timer
timerDelete(2K): delete a timer
timerGetRes(2K): get the timer resolution
timerSet(2K): start, cancel or query a timer
timerThreadPoolInit(2K): initialize a timer thread pool
timerThreadPoolWait(2K): wait for a timer expiration event
uiBuild(2K): Build a user-defined unique identifier; Clear a unique identifer; Compare two unique identifers; Extract the site number from a unique identifier; Check a unique identifier's locality; Get a pre-defined site unique identifier; Check whether an unique identifier has been cleared
uiClear(2K): See uiBuild(2K)
uiEqual(2K): See uiBuild(2K)
uiGetSite(2K): See uiBuild(2K)
uiIsLocal(2K): See uiBuild(2K)
uiLocalSite(2K): get the local site number
uiSite(2K): See uiBuild(2K)
uiValid(2K): See uiBuild(2K)
univTime(2K): Get time-of-day; Set time-of-day; Adjust time-of-day univTimeGetRes; Get time-of-day resolution
univTimeAdjust(2K): See univTime(2K)
univTimeSet(2K): See univTime(2K)
virtualTimeGetRes(2K): get virtual time resolution
vmCopy(2K): copy data between actor address spaces
vmFree(2K): free memory
vmLock(2K): Fix data in memory; Data in memory
vmPageSize(2K): get the minimum allocatable memory block size
vmPhysAddr(2K): get the physical address corresponding to a virtual address
vmSetPar(2K): set the memory management parameters
vmStat(2K): get memory management statistics
vmUnLock(2K): See vmLock(2K)

ChorusOS 4.0 Last Revised December 1999