_TEST_SAVE_BIT - test whether a SEGID is savable.
(GCOS8 only)
Usage:
C:
#include <climb.h>
status = _test_save_bit(ptr);
PL6:
DCL X_TEST_SAVE_BIT ENTRY(1) ALTRET;
X_TEST_SAVE_BIT(ptr);
Where:
- const void *ptr;
- points anywhere into the segment whose SEGID you want to test.
"_test_save_bit" extracts the SEGID from the pointer value.
- int status;
- is 1 if the SEGID is flagged as savable and 0 otherwise.
Description:
"_test_save_bit" determines if a SEGID in the Argument
Stack will be saved in a call to "_save_arg_stack".
Unsavable SEGIDs include those allocated with "_gtlseg",
ones with the save permission bit turned off, and
ones that were allocated directly by the program without
going through "_gtseg".
See Also:
- expl nsc lib _gtseg
- general SEGID allocation routine.
- expl nsc lib _gtlseg
- for allocating a SEGID that will only be used during
the current invocation of the program (one that disappears
over an OCLIMB).
- expl nsc lib _gtsseg
- for marking a Linkage Segment SEGID as busy.
- expl nsc lib _save_arg_stack
- for saving the Argument Stack before an OCLIMB.
- expl nsc lib _restore_arg_stack
- for restoring the Argument Stack after an OCLIMB.
Copyright © 2000, Thinkage Ltd.