Guardian Programming Reference Summary for C

Functions Summary (R-Z)
Guardian Programming Reference Summary for C—522630-001
8-12
SEGMENT_ALLOCATE_
Allocates an extended data segment for use by the calling process.
return value:
#include <cextdecs(SEGMENT_ALLOCATE_)>
short SEGMENT_ALLOCATE_ ( short segment-id /* i */
,[ long segment-size ] /* i */
,[ char *filename ] /* i */
,[ short length ] /* i */
,[ short *error-detail ] /* o */
,[ short pin ] /* i */
,[ short segment-type ] /* i */
,[ long *base-address ] /* o */
,[ long max-size ] /* i */
,[ short alloc-options ] );/* i */
0=No error.
1 = File-system error related to the creation or open of 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 = Invalid segment-id.
5 = Invalid segment-size.
6 = Unable to allocate segment space.
7 = Unable to allocate segment page table space.
8 = Security violation when attempting to share segment.
9=The pin parameter does not exist.
10 = The pin parameter does not have the segment allocated.
11 = Caller is trying to share segment with self.
12 = Requested shared segment is incompatible.
13 = The segment-id parameter is already allocated by this process.
14 = Unable to allocate process segment table (PST); error-detail contains the
file-system error number.
15 = Part or all of the requested address range has already been allocated.