Guardian Procedure Calls Reference Manual

of alloc_option terms available to ordinary users. For historical continuity, it also shows
the TAL bit numbers. The bits are defined as follows:
DefinitionTAL BitNameValue
is significant only If
SEGMENT_OPTION_USEBASE is specified, the
<9>SEGMENT_OPTION_SHARED_ANYADDR64
segment is being shared, and the range of the
requested segment is partially or completely
overlapped in the current process. In that situation,
it instructs SEGMENT_ALLOCATE[64]_ to allocate
the segment at any address within the selected
(32- or 64-bit) flat segment space.
causes allocation of a selectable segment. This
option is mutually exclusive with
<11>SEGMENT_OPTION_UNALIASED_SEL16
SEGMENT_OPTION_NO_OVERLAY. This option
is unnecessary in SEGMENT_ALLOCATE_,
because selectable is the default. The option is
necessary to allocate a selectable segment using
SEGMENT_ALLOCATE64_.
precludes the use of Kernel Managed Swap
Facility (KMSF). If filename is not specified, this
<13>SEGMENT_OPTION_NOKMSF4
option causes creation of a temporary swap file
when allocating a segment. If filename is
specified, this option is irrelevant.
causes allocation of a flat segment in 32-bit
address space. This option is mutually exclusive
<14>SEGMENT_OPTION_FLAT32 or
SEGMENT_OPTION_NO_OVERLAY
2
with SEGMENT_OPTION_UNALIASED_SEL. If this
option is not specified: SEGMENT_ALLOCATE_
allocates a selectable segment;
SEGMENT_ALLOCATE64_ allocates a flat segment
in 64-bit address space.
causes the base-address parameter to be
required and treated as input/output. By default,
<15>SEGMENT_OPTION_USE_BASE1
base-address is treated as an optional output
parameter. See base-address.
If alloc-options is omitted, the default value
is 0, so none of these options is specified.
Therefore, SEGMENT_ALLOCATE_ allocates a
selectable segment, while
SEGMENT_ALLOCATE64_ allocates a flat 64-bit
segment.
Returned Value
INT
Outcome of the operation:
SEGMENT_OK0
No error.
SEGMENT_FILE_ERROR1
File-system error related to the creation or open of filename; error-detail contains the file-system error
number.
SEGMENT_PARAMETER2
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.
SEGMENT_BOUNDS3
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.
SEGMENT_ALLOCATE[64]_ Procedures 1267