Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

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)   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 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 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.

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

  -L                 List processes signaled.

  This command 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.
       $

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026