ttys(F)                       06 January 1993                        ttys(F)


 Name

    ttys - terminal control database file

 Format

    See authcap(F)

 Description

    The ttys file (/etc/auth/system/ttys) contains entries for each terminal
    that can be used to log in to the system. Authentication programs use
    this database to determine if logging in is permitted on a particular
    terminal.

    Changes to this file are normally made by selecting Accounts -> Terminal
    in sysadmsh(ADM).

    The following keyword identifiers are supported:

    tdevname      This field defines the terminal device filename for the
                   entry (excluding the /dev pathname).  For example, if the
                   terminal entry describes the /dev/tty01 device, the
                   tdevname field should contain ``tty01''.

    tfailures     The number of consecutive unsuccessful login attempts to
                   the terminal device.

    tlock         This flag indicates whether the terminal device has been
                   locked or not. This field may be manipulated by authorized
                   administrators only.

    tlogdelay     The login delay enforced by authentication programs
                   between unsuccessful login attempts as a timet value.
                   This slows the rate of penetration attempts on a terminal
                   device.

    tlogintimeout
                   The login timeout value in seconds. If a login attempt is
                   initiated by entering a user name at the login prompt but
                   successful authentication is not completed within the
                   timeout interval specified, the login attempt will be
                   aborted.

    tlogtime      The last successful login time to the terminal device as a
                   timet value.

    tmaxtries     The maximum number of consecutive unsuccessful login
                   attempts permitted using the terminal before it is locked.
                   Once the terminal is locked, it must be unlocked by an
                   authorized administrator.

    tprevtime     The system time of last logout associated with this termi-
                   nal device as a timet value.

    tprevuid      The user ID of the last user to log out from the system
                   using the terminal device.

    tuid          The user name of the last user to successfully log in
                   using the terminal device.

    tunsuctime    The last unsuccessful login time to the terminal device as
                   a timet value.

    tunsucuid     The user name of the last user to unsuccessfully attempt
                   to log in using the terminal device.

 Examples

    The following is an example of a terminal control database entry:

       tty01:t_devname=tty01:\
               :t_uid=georgep:t_logtime#699633376:\
               :t_unsucuid=ianw:t_unsuctime#699268176:\
               :t_prevuid=steve:t_prevtime#699645302:\
               :t_lock@:chkent:

    This entry is for the device /dev/tty01. The most recent successful login
    session was for the user georgep. The most recent unsuccessful login
    attempt was by the user ianw.  Prior to the most recent successful login
    session, user steve was logged in. The entry records the system times for
    the current successful login, the end of the previous successful login
    session, and the most recent unsuccessful login attempt. This terminal is
    shown as not being locked.

 Files

    /etc/auth/system/ttys     terminal control database

 See also

    authcap(F), default(F), getprtcent(S), login(M), sysadmsh(ADM)

 Standards conformance

    ttys is not part of any currently supported standard; it is an extension
    of AT&T System V provided by The Santa Cruz Operation, Inc.