relogin(ADM)                    19 June 1992                    relogin(ADM)


 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 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, enter:

            ps -f -u jdoe

            and note the values shown in the ``TTY'' field (see ps(C)).

 File

    /etc/utmp database 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 if
    standard input is not associated with a terminal, relogin will fail.