RELOGIN(ADM)                       UNIX System V



     Name
          relogin - rename login entry to show current layer


     Syntax
          /usr/lib/layersys/relogin [-s] [line]


     Description
          The relogin command changes the terminal  line  field  of  a
          user's  utmp(F)  entry to the name of the windowing terminal
          layer attached to standard input.  write(C) messages sent to
          this  user  are  directed  to  this layer.  In addition, the
          who(C) command will  show  the  user  associated  with  this
          layer.   The  relogin  command  may  only  be  invoked under
          layers(C).

          relogin is invoked automatically by  layers(C)  to  set  the
          utmp(F)  entry  to  the  terminal  line  of  the first layer
          created upon startup and to reset the utmp(F) entry  to  the
          real  line  on  termination.  It may be invoked by a user to
          designate a different layer to receive write(C) messages.

          -s      Suppress error messages.

          line    Specifies  which  utmp(F)  entry  to  change.    The
                  utmp(F)  file  is  searched  for  an  entry with the
                  specified line field.  That field is changed to  the
                  line  associated  with the standard input.  To learn
                  what lines are associated with  a  given  user,  say
                  jdoe, enter:
                  ps -f -u jdoe
                  and note the values shown  in  the  TTY  field  [see
                  ps(C)].


     Files
          /etc/utmp     data base of users versus terminals


     Diagnostics
          Returns 0 upon successful completion, 1 otherwise.


     See Also
          layers(C), mesg(C), ps(C), who(C), write(C), utmp(F)


     Notes
          If line does not belong to  the  user  issuing  the  relogin
          command or standard input is not associated with a terminal,
          relogin will fail.


     (printed 8/23/89)                                  RELOGIN(ADM)