pSOSystem System Calls - Read

Conventions Using This Manual
Description
Provides a description of the call.
Arguments
Provides descriptions of all arguments used in the call.
Target
Where applicable, provides processor-specific information about the call. The
information appears next to an icon representing the processor in question, as
below:
68K
If the information is also specific to a set of host tools, a host tool icon appears next
to the processor icon, as below:
68K pRISM
Return Value
Lists the possible return values of the call. For example, pSOS+ system calls always
return a 0 to indicate a successful call, and pREPC+ calls can return either a nonzero
value if the test result is true, or 0 if it is false. The Error Codes section lists
possible errors returned by each call.
Error Codes
On 68K processors, a signal is passed to the ASR in the D0.L register.
For 68K processors with pRISM host tools, the formula is the following:
SIZE = 32 + (4 * VSIZE) + (16 * NFD) + (42 * MAXDEPTH)
Provides a list of the error codes that the call can generate. For pSOS+ and pHILE+
system calls, an error code returns as a system call return value. For other components,
such as the pREPC+ component/library and the pNA+ network manager, error
codes are loaded into an internal variable that can be read through the macro
errno. Appendix B contains a complete list of error codes for each software component.
x pSOSystem System Calls