RELOGIN(1M)          INTERACTIVE UNIX System          RELOGIN(1M)



          NAME
               relogin - rename login entry to show current layer

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

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

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

               -s      Suppress error messages.

               line    Specifies which utmp(4) entry to change.  The
                       utmp(4) 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, type:
                                          ps -f -u jdoe
                       and note the values shown in the TTY field [see
                       ps(1)].

          FILES
               /etc/utmp     data base of users versus terminals

          EXIT STATUS
               Returns 0 upon successful completion, 1 otherwise.

          SEE ALSO
               layers(1), mesg(1), ps(1), who(1), write(1).
               utmp(4) in the INTERACTIVE SDS Guide and Programmer's Refer-
               ence Manual.

          NOTES
               If line does not belong to the user issuing the relogin com-
               mand or standard input is not associated with a terminal,
               relogin will fail.







          Rev. Base System                                           Page 1