.\" SUCH DAMAGE.
.\"
.\" from: @(#)ttys.5 8.1 (Berkeley) 6/4/93
-.\" $Id: ttys.5,v 1.1 1999/05/02 04:21:29 wsanchez Exp $
-.\"
-.Dd June 4, 1993
+.\" $FreeBSD: src/libexec/getty/ttys.5,v 1.18 2005/06/14 08:40:10 ru Exp $
+.\" "
+.Dd May 27, 2005
.Dt TTYS 5
.Os
.Sh NAME
.Nd terminal initialization information
.Sh DESCRIPTION
The file
-.Nm ttys
+.Nm
contains information that is used by various routines to initialize
and control the use of terminal special files.
This information is read with the
.Xr getttyent 3
library routines.
-There is one line in the
-.Nm ttys
+There is one line in the
+.Nm
file per special device file.
Fields are separated by tabs and/or spaces.
Fields comprised of more than one word should be enclosed in double
are delimited by hash marks (``#'') and new lines.
Any unspecified fields will default to null.
.Pp
-The first field is the
+The first field is normally the
name of the terminal special file as it is found in
.Pa /dev .
+However, it can be any arbitrary string
+when the associated command is not related to a tty.
.Pp
The second field of the file is the command to execute for the line,
usually
.Xr termcap 5
data base file.
The environment variable
-.Dv TERM
+.Ev TERM
is initialized with the value by
either
.Xr getty 8
The remaining fields set flags in the
.Fa ty_status
entry (see
-.Xr getttyent 3 )
-or specify a window system process that
-.Xr init 8
+.Xr getttyent 3 ) ,
+specify a window system process that
+.Xr launchd 8
will maintain for the terminal line.
.Pp
As flag values, the strings ``on'' and ``off'' specify that
-.Xr init
+.Xr launchd 8
should (should not) execute the command given in the second field,
while ``secure'' (if ``on'' is also specified) allows users with a
uid of 0 to login on
.Pp
The string ``window='' may be followed by a quoted command
string which
-.Xr init
+.Xr launchd 8
will execute
.Em before
starting the command specified by the second field.
+.Sh FILES
+.Bl -tag -width /etc/ttys -compact
+.It Pa /etc/ttys
+.El
+.Sh NUMERIC SEQUENCES
+Numeric sequences of terminals can be represented in a more compact format.
+A matching pair of square bracket may enclose two numbers (the start and
+stop values), separated by a hyphen.
+The numbers are assumed to be decimal, unless prefixed with ``0x'', in which
+case they are interpreted as hexadecimal.
+The number of characters (not including any ``0x'') in the starting value gives
+the minimum width; sequence values are zero padded up to this width.
+Thus ``tty[00-07]'' represents the eight terminals ``tty00'' through ``tty07''.
.Sh EXAMPLES
.Bd -literal
# root login on console at 1200 baud
console "/usr/libexec/getty std.1200" vt100 on secure
# dialup at 1200 baud, no root logins
-ttyd0 "/usr/libexec/getty d1200" dialup on # 555-1234
+ttyd0 "/usr/libexec/getty d1200" dialup on # 555-1234
# Mike's terminal: hp2621
-ttyh0 "/usr/libexec/getty std.9600" hp2621-nl on # 457 Evans
+ttyh0 "/usr/libexec/getty std.9600" hp2621-nl on # 457 Evans
# John's terminal: vt100
-ttyh1 "/usr/libexec/getty std.9600" vt100 on # 459 Evans
+ttyh1 "/usr/libexec/getty std.9600" vt100 on # 459 Evans
# terminal emulate/window system
-ttyv0 "/usr/new/xterm -L :0" vs100 on window="/usr/new/Xvs100 0"
+ttyv0 "/usr/X11/bin/xterm -display :0" xterm on window="/usr/X11/bin/X :0"
+# the sequence of eight terminals tty00 through tty07
+tty[00-07] "/usr/libexec/getty std.9600" vt100 on
# Network pseudo ttys -- don't enable getty
-ttyp0 none network
-ttyp1 none network off
+ttyp0 none network
+ttyp1 none network off
+# All sixteen of a pseudo tty sequence
+ttyq[0x0-0xf] none network
.Ed
-.Sh FILES
-.Bl -tag -width /etc/ttys -compact
-.It Pa /etc/ttys
-.El
.Sh SEE ALSO
.Xr login 1 ,
.Xr getttyent 3 ,
.Xr gettytab 5 ,
.Xr termcap 5 ,
.Xr getty 8 ,
-.Xr init 8 ,
-.Xr ttyflags 8
+.Xr launchd 8
+.\" .Xr ttyflags 8
.Sh HISTORY
A
.Nm
projects / apple / system_cmds.git / blobdiff