Guardian Programming Reference Summary for C

Functions Summary (R-Z)
Guardian Programming Reference Summary for C—522630-001
8-13
alloc-options
SEGMENT_ALLOCATE_CHKPT_
Is called by a primary process to allocate an extended data segment for use by its backup
process.
This passive backup procedure is not supported in C programs. For a comparison of
active backup and passive backup, refer to the Guardian Programmer’s Guide.
SEGMENT_DEALLOCATE_
Deallocates an extended data segment.
return value:
Bits 0-13 Reserved (specify 0)
Bit 14 = 0 Allocate a selectable segment.
= 1 Allocate a flat segment. If not running on a system that supports flat
segments allocate a selectable segment.
Bit 15 = 0 Return the base-address in the base address parameter.
= 1 Allocate a flat segment starting at the address specified in the
base-address parameter. Bit <14> must also be set to 1. If not
running on a system that supports flat segments allocate a selectable
segment starting at the base address %000000D (%H00080000).
#include <cextdecs(SEGMENT_DEALLOCATE_)>
short SEGMENT_DEALLOCATE_ ( short segment-id /* i */
,[ short flags ] /* i */
,[ short *error-detail ] ); /* o */
0 = Segment successfully deallocated.
1 = Segment deallocated, but an I/O error occurred when writing to the segment's
permanent swap file; 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.
4 = Segment not deallocated; error-detail contains the reason for failure.