system_cmds-433.8.tar.gz

[apple/system_cmds.git] / getty.tproj / ttys.5

diff --git a/getty.tproj/ttys.5 b/getty.tproj/ttys.5
index 3a2fc45bba6a055a26c86f55bbeb4feb0a088ceb..9a0a77c2d7700594afafb4b0485f67a5ecbff0cf 100644 (file)
--- a/getty.tproj/ttys.5
+++ b/getty.tproj/ttys.5
@@ -30,9 +30,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)ttys.5       8.1 (Berkeley) 6/4/93
 .\" 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
 .Dt TTYS 5
 .Os
 .Sh NAME


@@ -40,14 +40,14 @@
 .Nd terminal initialization information
 .Sh DESCRIPTION
 The file
 .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.
 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
 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


@@ -56,9 +56,11 @@ Blank lines and comments may appear anywhere in the file; comments
 are delimited by hash marks (``#'') and new lines.
 Any unspecified fields will default to null.
 .Pp
 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 .
 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
 .Pp
 The second field of the file is the command to execute for the line,
 usually


@@ -76,7 +78,7 @@ tty line, normally the one found in the
 .Xr termcap 5
 data base file.
 The environment variable
 .Xr termcap 5
 data base file.
 The environment variable

-.Dv TERM
+.Ev TERM

 is initialized with the value by
 either
 .Xr getty 8
 is initialized with the value by
 either
 .Xr getty 8


@@ -86,13 +88,13 @@ or
 The remaining fields set flags in the
 .Fa ty_status
 entry (see
 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
 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
 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


@@ -113,30 +115,43 @@ These flag fields should not be quoted.
 .Pp
 The string ``window='' may be followed by a quoted command
 string which
 .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.
 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
 .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
 # 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
 # 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
 # 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
 # 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
 .Ed

-.Sh FILES
-.Bl -tag -width /etc/ttys -compact
-.It Pa /etc/ttys
-.El

 .Sh SEE ALSO
 .Xr login 1 ,
 .Xr getttyent 3 ,
 .Sh SEE ALSO
 .Xr login 1 ,
 .Xr getttyent 3 ,


@@ -144,8 +159,8 @@ ttyp1       none    network off
 .Xr gettytab 5 ,
 .Xr termcap 5 ,
 .Xr getty 8 ,
 .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
 .Sh HISTORY
 A
 .Nm