Guardian Procedure Calls Reference Manual

SEGMENT_GET_PREF_ALIGN_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Summary
The SEGMENT_GET_PREF_ALIGN_ procedure computes the preferred alignment for a segment of
a given size. That alignment is implementation-dependent. The operating system is able to create
more efficient mappings if preferred alignment is observed when assigning the base-address
of a segment.
NOTE: The SEGMENT_GET_PREF_ALIGN_ procedure is supported on systems running H06.20
and later H-series RVUs and J06.09 and later J-series RVUs, but some reported values changed at
the H06.24 and J06.13 RVUs.
Syntax for C Programmers
#include <kmem.h>
int SEGMENT_GET_PREF_ALIGN_ ( uint64 size );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.KMEM
result := SEGMENT_GET_PREF_ALIGN_ ( size ); ! i
Parameter
size
input
INT(64):value
is the size of the segment.
Returned Value
INT
The log (base 2) of the preferred alignment for a segment of the given size.
1284 Guardian Procedure Calls (S)