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.
You may discover which processes are currently active by using 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 (CTRL/Q)). 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.
$