10.3;cps (create_process_server) *DM*, revision 2.0, 90/07/17
cps (create_process_server) create process independent of login
usage: cps [-n name ] [ -w ] pathname [args ...]
DESCRIPTION
cps creates a process (without associated pads or windows) that runs
whether anyone is logged in or not. This is desirable for utilities like
the prsvr (print_server) and netman. cps may appear in any of the DM
startup scripts. However, you may prefer to issue the cps command from
the keyboard on selected occasions, rather than include this function in
a startup script.
The created process is assigned the subject identifier (SID)
user.server.none.local_node regardless of the context in which the cps
command appears. Be sure that any files to be used by this process
(including the program specified by the pathname argument) give adequate
access to this SID. If the access control lists (ACLs) on the files do
not allow proper access to the server project name, the process
terminates. Because background processes are essentially invisible, no
error messages are returned to the display, making fault diagnosis
difficult.
ARGUMENTS
pathname (required)
Specify file to be executed by the new process.
args... (optional)
Specify any arguments to be passed to the program
pathname. If any of these arguments contain explicit
blanks, enclose those arguments in quotation marks.
Default if omitted: no arguments passed
OPTIONS
-n name Assign process name name. If you omit this option, the
process is not named.
-w Invoke "wait" mode. If this option is specified, the DM
suspends its activities until the newly created process
terminates. As long as the process runs, the DM will not
respond to keyboard or other input. USE THIS OPTION WITH
CAUTION. If the newly created process does not terminate,
the DM will appear to be hung. In addition, processes
created using -w CANNOT make any DM requests (via pad_$
requests or DM commands) because the DM is suspended and
will not respond.
EXAMPLE
Run the server mbx_helper:
cps /sys/mbx/mbx_helper -n mbx_helper
SEE ALSO
More information is available. Type the following at an Aegis shell
prompt:
help cp For details about creating processes with windows and pads
help cpo For details about creating non-server processes without
windows or pads
help sigp For details about stopping background processes
help servers For details about available server programs