ttys(F)

ttys -- terminal control database file

Format

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 using the Terminal Manager.

The following keyword identifiers are supported:

t_devname: 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 t_devname field should contain ``tty01''.
t_failures: The number of consecutive unsuccessful login attempts to the terminal device.
t_lock: This flag indicates whether the terminal device has been locked or not. This field may be manipulated by authorized administrators only.
t_logdelay: The login delay enforced by authentication programs between unsuccessful login attempts as a time_t value. This slows the rate of penetration attempts on a terminal device.
t_login_timeout: 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.
t_logtime: The last successful login time to the terminal device as a time_t value.
t_maxtries: 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.
t_prevtime: The system time of last logout associated with this terminal device as a time_t value.
t_prevuid: The user ID of the last user to log out from the system using the terminal device.
t_uid: The user name of the last user to successfully log in using the terminal device.
t_unsuctime: The last unsuccessful login time to the terminal device as a time_t value.
t_unsucuid: 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

Standards conformance