Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ crp — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought

9.0;crp (create_process), revision 9.0, 85/02/14
CRP (CREATE_A_PROCESS) -- Create a process on a remote node.
usage:  CRP [command line] -ON node_id [-CP [-NWP]] | -CPO | -CPS] [-N name]
                                        [-LOGIN name [password] | -ME ]


FORMAT

  CRP [command line] -ON node_id [options]


  CRP creates a process on a remote node.


ARGUMENTS

  command line
  (optional)          Specify command line to be executed by the remote process.
                     If the command string contains embedded blanks, enclose  it
                     in quotation marks.

                     Default if omitted:  execute /COM/SH (the Shell).


OPTIONS

  The following option which specifies the remote node is REQUIRED:


  -ON node_id         Specify either hexadecimal node_id or entry directory name
                     of any volume on the selected remote node.

  One of the following options may be specified (default option is indicated  by
  a "(D)"):


  -CP          (D)    Create  a  remote  process  running  with standard streams
                     connected to the current window.  Not valid if -CPO or -CPS
                     is  specified.    You may stop these processes by typing an
                     EEF (usually CTRL/Z) in the process input pad.

  -NWP               Do not create a window  pane  legend  indicating  that  the
                     local  window  is  connected to a remote process.  Use with
                     -CP option only.

  -CPO               Create a remote process without a connection to the current
                     window,  and an identity of 'user.none.none'.  Not valid if
                     -CP or -CPS is specified.  To  stop  these  processes,  you
                     must  first  create  a  visible  remote process running the
                     Shell, then issue the SIGP command to stop  the  background
                     process.

  -CPS               Create a remote process without a connection to the current
                     window, and an identity of 'user.server.none'.   Not  valid
                     if  -CP or -CPO is specified.  To stop these processes, you
                     must first create a  visible  remote  process  running  the
                     Shell,  then  issue the SIGP command to stop the background
                     process.

  -N name            Specify the name of the remote process.  If this option  is
                     not  specified,  the  default  is  "user id.node_id".  This
                     allows remote processes to be traced to their originator.

  -LOGIN name [password]
                     Specify  the  login  sequence for the remote process on the
                     command line.  If  the  password  is  omitted,  the  system
                     prompts  you  for  it.    A  null (zero-length) password is
                     specified by the null string ''.

                     Normally, -LOGIN appears with -CP.  You may,  however,  use
                     -LOGIN  with -CPO and -CPS as well.  If -LOGIN is specified
                     with either -CPO or -CPS, then the identity of the  created
                     process  is the same as that of the caller's (as opposed to
                     'user.none.none'  or   'user.server.none',   respectively).
                     This  means  that  -CPO and -CPS are identical if -LOGIN is
                     also specified.

                     If you use -LOGIN with -CPO or -CPS, you  must  place  both
                     the  name  and  the  password  on  the  command  line.   No
                     prompting is available in this case.

  -ME                -ME is typically specified instead of -LOGIN.   If  -ME  is
                     specified,  then  the  created  process  on the remote node
                     inherits the caller's working directory, naming  directory,
                     home directory text string and SID.  In some sense, this is
                     similar to popping up another Shell except that the process
                     is  running  on  another  node.    If -ME is specified with
                     either -CPO or -CPS,  then  the  identity  of  the  created
                     process  is  also  that  of  the  caller's  (as  opposed to
                     'user.none.none'  or   'user.server.none',   respectively).
                     This  means that -CPO and -CPS are identical if -ME is also
                     specified.


EXAMPLES

  $ crp -on 532 -login joe    Create a process on node 532 running the
                               Shell, and log in with the user id "joe".

  $ crp -on 0aef -me          Create a process on node AEF running the
                               Shell, and inherit the current process
                               state information.

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