Guardian Procedure Calls Reference Manual

SEGMENT_GETINFOSTRUCT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Structure Definitions for info
Considerations
Summary
The SEGMENT_GETINFOSTRUCT_ procedure retrieves information about a currently allocated
data segment.
SEGMENT_GETINFOSTRUCT_ supersedes the SEGMENT_GETINFO[64]_ procedures.
NOTE: The SEGMENT_GETINFOSTRUCT_ procedure is supported on systems running H06.20
and later H-series RVUs and J06.09 and later J-series RVUs.
Syntax for C Programmers
#include <kmem.h>
int16 SEGMENT_GETINFOSTRUCT_ ( segmentInfoVersion version
,NSK_pin pin
,segID_t segID
,uint16 options
,segmentInfo_PTR info );
Syntax for TAL Programmers
error := SEGMENT_GETINFOSTRUCT_ ( version ! i
,pin ! i
,segID ! i
,options ! i
,info ); ! i, o
Parameters
version
input
INT
identifies the version of the procedure and data structure expected by the caller.
segmentInfoV1 is a literal value defined in kmem.h for C and KMEM for TAL to identify the
initial version. Various versions of header files kmem.h and KMEM define multiple values for
segmentInfoV1. The earliest value is forward-compatible (is accepted by the same versions
of the NonStop kernel that accept a later value). A later value is not backward compatible with
the initial version; using a later value with the original implementation of
SEGMENT_GETINFOSTRUCT_ results in error SEGMENT_VERSION (-1).
SEGMENT_GETINFOSTRUCT_ Procedure 1291