pSOSystem System Calls - Read

Using This Manual Conventions
Usage
Provides detailed usage information for certain system calls. For instance, the
verify_vol() call of the pHILE+ component performs multiple actions that require
detailed explanations.
Notes
Provides supplemental information, warnings, and side effects of a call. For pSOS+
system calls, a subsection called “Multiprocessor Considerations” describes the behavior
of the call in a multiprocessing environment if it differs from that in a singleprocessor
environment. Also, the subsection “Callable From” lists classes of program
elements that the system call can be called from. The system will deadlock if
the call is made from a program element not listed in the “Callable From” subsection.
There are four possible program elements:
Task — The smallest unit of execution that can compete on its own for system resources.
ISR — Interrupt Service Routine. A function that takes control of the system when
the CPU has been triggered with an exception from an external source. An ISR
is part of a device driver.
KI — Kernel Interface. The kernel interface is used by pSOS+m to communicate with
other pSOS+m kernels on other processors.
Callout — A function that a device driver uses to notify a pSOSystem component of an
interrupt event. A callout is called from an ISR.
See Also
Lists related service calls or the location of other relevant information.
Note, Caution, and Warning Conventions
Within the text of this manual, you may find notes, cautions, and warnings. These
statements are used for the purposes described below.
NOTE: Notes provide special considerations or details which are important to the
procedures or explanations presented.
CAUTION: Cautions indicate actions that may result in possible loss of work
performed and associated data. An example might be a system
crash that results in the loss of data for that given session.
pSOSystem System Calls xi