Guardian Procedure Calls Reference Manual

SETSTOP Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameter

Returned Value

Considerations

OSS Considerations

Example

Related Programming Manual

Summary

The SETSTOP procedure permits a process to protect itself from being deleted by any process other

than itself or its creator.

Syntax for C Programmers

#include <cextdecs(SETSTOP)>

short SETSTOP ( short stop-mode );

Syntax for TAL Programmers

last-stop-mode := SETSTOP ( stop-mode ); ! i

Parameter

stop-mode

input

INT:value

is a value specifying a new stop mode. The modes are:

Stoppable by any process. This mode is never set by any system software; it must be set by the user with

this procedure specifically for an application. This mode cannot be set by an OSS process.

Stoppable only by (normal system default value)1

• The super ID

• A process whose process access ID = this process' creator access ID (CAID) or the CAID group manager

• A process whose process access ID = this process' process access ID (PAID) or the PAID group manager

(this includes the caller to STEPMOM)

Unstoppable by any other process. This mode is available only when the caller of SETSTOP is privileged.2

For additional information about the super ID and process access ID, 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 on stopping a process, see the description

of the PROCESS_STOP_ Procedure (page 1121) or STOP Procedure (Superseded by

PROCESS_STOP_ Procedure) (page 1398).

SETSTOP Procedure 1353