relogin(1M)                                              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 entry to the name of the windowing terminal layer
             attached to standard input.  write messages sent to this user
             are directed to this layer.  In addition, the who command will
             show the user associated with this layer.  relogin may only be
             invoked under layers.

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

             -s      Suppress error messages.

             line    Specifies which utmp entry to change.  The utmp 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
             /var/adm/utmp     database of users versus terminals

       REFERENCES
             mesg(1), ps(1), utmp(4), who(1), write(1)

       DIAGNOSTICS
             Returns 0 upon successful completion, 1 otherwise.

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





                           Copyright 1994 Novell, Inc.               Page 1