Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-116
SETSTOP Procedure
•
A process whose process access ID = this process’s creator access ID
(CAID) or the CAID group manager
•
A process whose process access ID = this process’s process access ID
(PAID) or the PAID group manager (this includes the caller to STEPMOM)
2 unstoppable by any other process. This mode is available only when the caller
of SETSTOP is privileged.
See the description of the PROCESS_GETINFO_ procedure for information on the
two access IDs, as well as to the
Guardian User’s Guide for additional information
about the super ID and process access ID. For additional information on stopping
a process, see the description of the PROCESS_STOP_ or STOP procedure.
Considerations
•
The default stop mode is 1 when a process is created.
•
If a process’s stop mode is 1 when a PROCESS_STOP_ or STOP procedure call
is issued against it by a process without the authority to stop it, the process does
not stop; the process is deleted, however, if and when the stop mode is changed to
0.
•
If a process’s stop mode is 2 when a PROCESS_STOP_ or STOP procedure call
is issued against it by another process, the stop is queued until the process is in a
stoppable mode.
•
If a process’s stop mode is 2 when an unhandled trap or signal occurs, it causes a
processor halt. Such a halt occurs, for example, if an unmirrored disk volume that
the process is using as a swap volume goes down.
OSS Considerations
An OSS process can be stopped only according to the rules specified for the OSS
kill() function. Stop mode 0 is therefore not allowed for OSS processes. See the
kill(2) function reference pages either online or in the Open System Services
System Calls Reference Manual
for details.
Example
LAST^MODE := SETSTOP ( NEW^MODE );
Related Programming Manual
For programming information about the SETSTOP procedure, see the Guardian
Programmer’s Guide.