2.0;siomonit (sio_process_monitor) revision 2.0, 83/10/07
Usage: SIOMONIT filename [-monit]
Usage: SIOMONIT filename [-monit]
SIOMONIT supports repeated logins over sio lines, independent of any
login/logout activity at the node terminal. The file, filename, contains
argument lists to be passed to invocations of siologin (see the description
of siologin for more information). A maximum of three argument lists (one
per sio line) are processed. SIOMONIT must be invoked as a server (CPS)
and SIOLOGIN must be a manager within the LOGIN protected subsystem for the
login procedure to be successful. (cf: siologin.hlp).
Each argument list in the file must have the form:
[-Repeat] siologin_arg_list
where
-Repeat means re-invoke this process each time it returns.
siologin_arg_list is an siologin argument list of the form:
/DEV/SIOx [[-dialin] [-n processname] prog [ args ...]]
For each argument list, siomonit invokes: /sys/siologin/siologin siologin_arg_list
Arguments are passed to siologin unvalidated except that the first one must
be /dev/siox, specifying the sio line to use. If the invocation fails,
or if a process returns from its invocation within 15 seconds, SIOMONIT
will wait 15 minutes before attempting to start the process again. SIOMONIT
re-reads the argument file each time a child process dies. An asynchronous
quit fault will cause SIOMONIT to re-read the argument file and try to
restart processes for unused lines. A stop fault causes SIOMONIT to
exit. (Processes that do not have the -repeat argument are given only one
successful start per reading of the input file.) The SIGP command may be
used to send stop and quit signals to SIOMONIT.
A frequent cause of failure of an siologin process to stay alive is a locked
sio line (/DEV/SIOx). If you free up a line, use SIGP to prod SIOMONIT into
trying again. If you add entries to the argument list file, you must SIGP
siomonit (or you may cause a child process to die). If you change or delete
an entry in the argument file, it will take effect only when the current
process for that sioline dies. You may usually kill an siologin process
with SIGP.
If SIOMONIT is stopped (sigp -s) while any of its child processes are still
alive, if it is reinvoked it will not recognize the death of an old child.
However if the name of an old child (-n option to siologin) is the same as
the name in the command list for that sioline, it will reinvoke the process
on that line within 15 minutes of when the old child dies.
SIOMONIT writes a log of certain events in `node_data/siomonit_log. The
-MONIT option causes SIOMONIT to also dump its tables each time it writes
to the siomonit_log. The log gets large and should be editted periodically.
Comments may be included in the siomonit file and must begin with #.