relogin(1M)        UNIX System V(Layers Windowing Utilities)        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

SEE ALSO
      layers(1), mesg(1), ps(1), who(1), write(1), in the User's Reference
      Manual
      utmp(4)

DIAGNOSTICS
      Returns 0 upon successful completion, 1 otherwise.

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













10/89                                                                    Page 1