Guardian Programming Reference Summary for C

Functions Summary (R-Z)
Guardian Programming Reference Summary for C—522630-001
8-15
SEGMENT_GETINFO_
Retrieves information about a currently allocated extended segment.
return value:
usage-flags
The bits, when set to 1, indicate the following:
#include <cextdecs(SEGMENT_GETINFO_)>
short SEGMENT_GETINFO_ ( short segment-id /* i */
,[ long *segment-size ] /* o */
,[ char *filename ] /* o */
,[ short maxlen ] /* i */
,[ short *filename-len ] /* o */
,[ short *error-detail ] /* o */
,[ long *base-address ] /* o */
,[ short *usage-flags ] );/* o */
0=No error.
1 = Error occurred when attempting to obtain filename; error-detail
contains the file-system error number.
2 = Parameter error; error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
3 = Bounds error; error-detail contains the number of the first parameter found
to be in error, where 1 designates the first parameter on the left.
4 = The value of segment-id is out of range.
5 = The value of segment-id is in range but not allocated by caller.
Bits 0-8 (Bits are reserved; 0 is returned)
Bit 9 Segment is a flat segment.
Bit 10 Segment is a resident cache segment.
Bit 11 Segment is a shared segment.
Bit 12 Segment is the currently in-use segment for the process.
Bit 13 Segment is writeback-inhibit. Changes made to the segment are not written to
the swap files.
Bit 14 Segment is extensible.
Bit 15 Segment is resident.