10.0;sigp (signal_process), revision 1.0, 88/03/31
sigp (signal_process) -- Signal a Process.
usage: sigp process_name... [-quit|-stop|-blast|-code]
-u[id] high.low [-l] {CL}
DESCRIPTION
sigp causes a quit or stop fault in a process. This is particularly
useful for stopping background processes such as those created by the cpo
(create_process_only) and cps (create_process_server) Display Manager
commands.
Only users with p or w access rights to the /sys/node_data/node_owners
file at the time the sigp command is issued can signal processes they do
not own. The /sys/node_data/node_owners file is used to grant rights for
certain 'owner'-type operations on a node.
Note that security policies established by the the lprotect command do
not supersede the requirement that only users with p or w access rights
to the /sys/node_data/node_owners can signal a process they do not own.
To list the processes that are currently active, use the pst
(process_status) command.
ARGUMENTS
process_name (optional)
Specify name of process to be signaled. Multiple process
names are permitted.
Default if omitted: -uid required (below)
OPTIONS
-q[uit] (default)
Cause a quit fault in the process (like the Display Manager
command dq, or either CTRL/C or CTRL/Q (depending on your key
definitions)). Executing programs halt, but the process
remains active.
-s[top] Ask the entire process to stop cleanly (closing streams,
etc.).
-b[last] Stop the process in the nucleus (don't go to user mode). This
brings everything to a halt without letting the system
attempt to clean up.
-c[ode] fault
Signal the process with the hexadecimal status code fault.
-uid high low
-uid high.low
Stop the process with the given UID. high and low indicate
the two halves of the UID.
-l List processes signaled.
-pg[roup] Deliver the signal to the entire process group specified,
rather than only the process itself.
EXAMPLES
Generate a quit fault in process_7, which will halt the program currently
running there, but leave process_7 itself active.
$ sigp process_7 -quit
$
Stop process_7 completely.
$ sigp process_7 -stop -l
"process_7" stopped.
$
SEE ALSO