siologin — Apollo

9.5;siologin (sio_line_login), revision 3.0, 86/01/29
SIOLOGIN (SIO_LINE_LOGIN) -- Invoke login sequence on an SIO line.

usage:  SIOLOGIN dev_name [[-DIALIN] [-N name] prog [args...]]


FORMAT

  SIOLOGIN dev_name [[options] prog [args...]]


  SIOLOGIN  listens for activity on an SIO line, invokes the login sequence when
  necessary, and, if the login is successful, runs a specified program.

  By  default,  SIOLOGIN  executes   the   Shell   startup   script   found   in
  `NODE_DATA/STARTUP_SIO.SH,  if  it  exists,  prior  to  invoking the specified
  program.  A sample script may be found in /SYS/SIOLOGIN/STARTUP_SIO.SH.   This
  sample  startup  script  resets  the  SIO  line  to default values in case the
  previous user of the line left it in a corrupt state (for example, set at  the
  wrong  speed).    It  can  also  be  used to force-unlock the line in case the
  previous user crashed and left the line locked.

  SIOLOGIN MUST BE MADE A MANAGER WITHIN THE LOGIN  PROTECTED  SUBSYSTEM  or  it
  will  not work.  (See 'HELP LOGIN WINDOW' and 'HELP PROTECTION PROTECTED_SUBS'
  for more information.)

  SIOLOGIN is most useful in conjunction with SIOMONIT.


ARGUMENTS

  dev_name
  (required)         Specify the name of the SIO device descriptor file.

  prog [args...]
  (optional)         Specify the name of the program to be invoked after  login,
                     followed  by any arguments to be passed to the program.  If
                     'prog' is present, it must follow any options specified.

                     Default if omitted:  invoke a Shell (/COM/SH).


OPTIONS

  If any options are specified, they must precede the 'prog' argument.

  -DIALIN            Specify that the SIO line connection is  remote.    If  the
                     line is remote, SIOLOGIN asks for an access password before
                     invoking the login sequence.   The  access  password  is  a
                     single  string  read from `NODE_DATA/SIOLOGIN_ACCESS.  Also
                     for remote lines, SIOLOGIN waits  for  carrier  detect  and
                     hangs  up  after  the  invoked  program  returns.    If the
                     connection  is  local,  SIOLOGIN  waits  for  a  CR  before
                     beginning  the login sequence.  SIOLOGIN logs invalid login
                     attempts in `NODE_DATA/SIOLOGIN_LOG.

  -N name            Specify the name to be assigned to the new process.   (This
                     option  takes  precedence  over  the -N option used in a CP
                     (CREATE_PROCESS) command when SIOLOGIN is invoked  directly
                     instead of through SIOMONIT.)


RELATED TOPICS

  More information is available.  Type:

  - HELP SIOMONIT
   for information about the SIO line monitor.
Museum

Related Articles
