sigp — Apollo

1.0;sigp (signal process), revision 1.0, 82/03/24
SIGP (SIGNAL_PROCESS) -- Signal a process.
usage:  SIGP process_name... [-Quit|-Stop|-Blast]       {CL}


FORMAT

  SIGP [process_name ...] [options]


  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) DM 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 signalled.  Multiple
                   process names and wildcarding are permitted.
                   Default if omitted: -UID required (below)


OPTIONS

  (Default options are indicated by "(D)".)

  -Q[UIT]     (D)  Cause a quit fault in the process (like the DM
                   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.

  -UID high low    Stop the process with the given UID.  "high" and
                   "low" indicate the two halves of the UID.

  -L               List processes signaled.

  SIGP uses the command line parser, and so also accepts the standard
  command options listed in HELP CL.


EXAMPLES

  1. $ sigp process_7 -quit       Generate a quit fault in process_7,
     $                             which will halt the program currently
                                   running there, but leave process_7
                                   itself active.

  2. $ sigp process_7 -stop -L    Stop process_7 completely.
     "process_7" stopped.
     $
Museum
