Guardian Procedure Calls Reference Manual

SEGMENT_GETINFO[64]_ Procedures (Superseded by
SEGMENT_GETINFOSTRUCT_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The SEGMENT_GETINFO[64]_ procedures retrieve information about currently allocated data
segments.
The SEGMENT_GETINFO64_ procedure is a 64-bit version of the SEGMENT_GETINFO_ procedure.
These procedures are superseded by SEGMENT_GETINFOSTRUCT_.
NOTE: The SEGMENT_GETINFO64_ 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 <cextdecs(SEGMENT_GETINFO_)>
short SEGMENT_GETINFO_ ( short segment-id
,[ __int32_t *segment-size ]
,[ char *filename ]
,[ short maxlen ]
,[ short *filename-len ]
,[ short *error-detail ]
,[ __int32_t *base-address ]
,[ short *usage-flags ] );
#include <kmem.h>
int16 SEGMENT_GETINFO64_ ( int16 segment-id,
,[ uint64 _ptr64 *segment-size ]
,[ char _ptr64 *filename ]
,[ int16 maxlen ]
,[ int16 _ptr64 *filename-len ]
,[ int16 _ptr64 *error-detail ]
,[ uint64 _ptr64 *base-address ]
,[ int16 _ptr64 *usage-flags ] );
• The parameter maxlen specifies the maximum length in bytes of the character string pointed
to by filename, the actual length of which is returned by filename-len. All three of these
parameters must either be supplied or be absent.
SEGMENT_GETINFO[64]_ Procedures (Superseded by SEGMENT_GETINFOSTRUCT_ Procedure) 1287