Guardian Procedure Calls Reference Manual

pin
input
INT
specifies the PIN of the process in which to query the segment. NSK_DEFAULT_PIN (-2)
indicates self.
segment-id
input
INT
refers to the segment ID of the target segment or, if -1, indicates to iterate over all segments.
options
INT
specifies one of the following options defined in kmem.h for C and KMEM for TAL::
segmentInfoDefault0
The default value causes all information to be returned except the filename.
segmentInfoGetFileName1
This value causes the filename to be returned in addition to the default information.
info
input, output
INT .EXT64
is a pointer to a segmentInfo structure used for input and output.
Returned Value
INT
Outcome of the operation. One of these values defined in kmem.h for C and KMEM for TAL:
SEGMENT_VERSION-1
Incompatible version.
SEGMENT_OK0
No error (info->errorDetail is set to zero).
SEGMENT_FILE_ERROR1
Error when attempting to get filename of swap file (info->errorDetail is set to the file-system error; other
info members are reported normally).
SEGMENT_PARAMETER2
Unrecognized option bit.
SEGMENT_BOUNDS3
This process is not privileged, and info is out of bounds.
SEGMENT_ILLEGALID4
This process is not privileged, and segID specifies a reserved segment ID value.
SEGMENT_NOTFOUND5
No such segment id registered to target process.
SEGMENT_BADPIN6
pin parameter specifies an invalid process.
SEGMENT_NOTOWNED10
1292 Guardian Procedure Calls (S)