Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)

Guardian Procedure Calls Reference Manual—522629-013

14-18

SEGMENT_ALLOCATE_CHKPT_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Considerations

Summary

The SEGMENT_ALLOCATE_CHKPT_ procedure is called by a primary process to

allocate an extended data segment for use by its backup process.

Syntax for C Programmers

This passive backup procedure is not supported in C programs. For a comparison of

active backup and passive backup, see the

Guardian Programmer’s Guide.

Syntax for TAL Programmers

Parameters

error returned value

INT

indicates the outcome of the backup process’s call to SEGMENT_ALLOCATE_.

Any error returned to the backup by SEGMENT_ALLOCATE_ is returned here.

See the definition of

error under SEGMENT_ALLOCATE_ for a list of possible

values.

segment-id input

INT:value

is the number by which the process chooses to refer to the segment. Segment IDs

are in the range of 0 to 1023 for user processes; other values are reserved for

processes supplied by HP. A nonprivileged process cannot supply a segment ID

greater than 2047.

error:= SEGMENT_ALLOCATE_CHKPT_ ( segment-id ! i

,[ filename:length ] !

i:i

,[ error-detail ] ! o

,[ pin ] ); ! i