Open System Services Programmer's Guide

Table 14 Guardian Process-Management Procedures (continued)
OSS NotesGuardian Procedure
For 64-bit OSS process creation details, beginning with
the H06.24 and J06.13 RVUs, see “64-Bit OSS Processes”
(page 286).
OSS SEEP consultation, beginning with the J06.15 and
H06.26 RVUs. For OSS SEEP details, see “Accessing OSS
SEEP-Protected Files” (page 83).
An OSS parent process receives a SIGCHLD signal and
the OSS process termination status.
PROCESS_STOP_
Terminates a process.
A Guardian parent process receives a process-termination
system message.
When used to stop a process other than the caller, the
process handle must be specified.
The security rules are the same as when using the OSS
kill() function to terminate a process.
Has the similar effect to calling the OSS kill() function
with SIGSTOP as the value of the signal parameter.
PROCESS_SUSPEND_
Places a process into a suspended state.
Prior to the J06.14 and H06.25 RVUs, OSS processes
cannot belong to process pairs. For details of OSS process
pairs, see “OSS Process Pairs” (page 158).
PROCESSHANDLE_COMPARE_
Compares two process handles and reports whether they
are identical, represent different processes of the same
process pair, or are different.
PROCESSHANDLE_DECOMPOSE_
Returns one or more parts of a process handle.
PROCESSHANDLE_GETMINE_
Gets the process handle of the calling process.
PROCESSHANDLE_NULLIT_
Initializes a process handle to a null value.
PROCESSHANDLE_TO_CRTPID_
Converts a process handle to the corresponding Guardian
process ID (CRTPID).
PROCESSHANDLE_TO_FILENAME_
Converts a process handle to a Guardian (process)
filename.
PROCESSHANDLE_TO_STRING_
Converts a process handle to a process string, which can
identify a process or set of processes.
PROCESSNAME_CREATE_
Returns a unique process name that is suitable for passing
to the PROCESS_CREATE_ or PROCESS_SPAWN_
procedures.
Beginning with the H06.24 and J06.13 RVUs, an
additional attribute is provided to determine whether the
PROCESSOR_GETINFOLIST_
Gets configuration information and statistics about a
processor. specified (local or remote) system is capable of running
64-bit (LP64) processes.. See “New
PROCESSOR_GETINFOLIST_ Attribute” (page 288) for
details.
PROCESSSTRING_SCAN_
Scans an input string for a process string and returns the
corresponding process handle or a single component of
the process string converted to internal form.
Guardian Process-Management Procedures 157