BSD 4_3_Reno release

[unix-history] / usr / src / libexec / getty / ttys.5

diff --git a/usr/src/libexec/getty/ttys.5 b/usr/src/libexec/getty/ttys.5
index 7a74540..234a217 100644 (file)
--- a/usr/src/libexec/getty/ttys.5
+++ b/usr/src/libexec/getty/ttys.5
@@ -1,6 +1,23 @@
-.\"    @(#)ttys.5      6.3 (Berkeley) %G%
+.\" Copyright (c) 1985 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.TH TTYS 5  ""
+.\" Redistribution and use in source and binary forms are permitted provided
+.\" that: (1) source distributions retain this entire copyright notice and
+.\" comment, and (2) distributions including binaries display the following
+.\" acknowledgement:  ``This product includes software developed by the
+.\" University of California, Berkeley and its contributors'' in the
+.\" documentation or other materials provided with the distribution and in
+.\" all advertising materials mentioning features or use of this software.
+.\" Neither the name of the University nor the names of its contributors may
+.\" be used to endorse or promote products derived from this software without
+.\" specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
+.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\"
+.\"    @(#)ttys.5      6.7 (Berkeley) 6/23/90
+.\"
+.TH TTYS 5  "June 23, 1990"

 .AT 3
 .SH NAME
 ttys \- terminal initialization data
 .AT 3
 .SH NAME
 ttys \- terminal initialization data


@@ -8,33 +25,42 @@ ttys \- terminal initialization data
 The
 .I ttys
 file contains information that is used by various routines to initialize
 The
 .I ttys
 file contains information that is used by various routines to initialize

-and control the use of terminal special files. This information is read
-with the
+and control the use of terminal special files.
+This information is read with the

 .IR getttyent (3)
 library routines.
 There is one line in the 
 .I ttys
 file per special file.
 Fields are separated by tabs and/or spaces.
 .IR getttyent (3)
 library routines.
 There is one line in the 
 .I ttys
 file per special file.
 Fields are separated by tabs and/or spaces.

-Some fields may contain more than one word and should be enclosed
-in double quotes.
-Blank lines and comments can appear anywhere in the file; comments
-are delimited by `#' and new line. Unspecified fields default to
-the empty string or zero as appropriate.
-The first field is the terminal's entry in the device directory, /dev.
+Fields comprised of more than one word should be enclosed in double
+quotes (``"'').
+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
+The first field is the terminal's entry in the device directory, ``/dev''.
+.PP

 The second field of the file is the command to execute for the line,
 typically
 .IR getty (8),
 which performs such tasks as baud-rate recognition, reading the login name,
 and calling
 .IR login (1).
 The second field of the file is the command to execute for the line,
 typically
 .IR getty (8),
 which performs such tasks as baud-rate recognition, reading the login name,
 and calling
 .IR login (1).

-It can be, however, any command you wish, for example
+It can be, however, any desired command, for example

 the start up for a window system terminal emulator or some other
 daemon process, and can contain multiple words if quoted.
 the start up for a window system terminal emulator or some other
 daemon process, and can contain multiple words if quoted.

-The third field is the type of terminal normally connected to that
-tty line, as found in the
+.PP
+The third field is the type of terminal usually connected to that
+tty line, normally the one found in the

 .IR termcap (5)
 data base file.
 .IR termcap (5)
 data base file.

+The environmental variable ``TERM'' is initialized with the value by
+either
+.IR getty (8)
+or
+.IR login (1).
+.PP

 The remaining fields set flags in the
 .I ty_status
 entry (see
 The remaining fields set flags in the
 .I ty_status
 entry (see


@@ -42,44 +68,38 @@ entry (see
 or specify a window system process that
 .IR init (8)
 will maintain for the terminal line.
 or specify a window system process that
 .IR init (8)
 will maintain for the terminal line.

-As flag values,
-the strings `on' and `off' specify whether
+.PP
+As flag values, the strings ``on'' and ``off'' specify that

 .I init
 .I init

-should execute the command
-given in the second field,
-while `secure' in addition to `on' allows root to login on
-this line.  These flag fields should not be quoted.
-The string `window=' is followed by a quoted command
+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
+this line.
+These flag fields should not be quoted.
+.PP
+The string ``window='' may be followed by a quoted command

 string which
 .I init
 string which
 .I init

-will execute.
-If the line ends in a comment, the comment is included in the
-.I ty_comment
-field of the ttyent structure.
-.PP
-Some examples:
-.PP
+will execute
+.B before
+starting the command specified by the second field.
+.SH EXAMPLES

 .nf
 .nf

-console "/etc/getty std.1200" vt100 on secure
-ttyd0 "/etc/getty d1200" dialup on
-ttyh0 "/etc/getty std.9600" hp2621-nl on
-ttyh1 "/etc/getty std.9600" plugboard on John's office
-ttyp0 none network
-ttyp1 none network off
-ttyv0 "/etc/xpty -L :0" vs100 on window="/etc/X 0"
+# 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
+# Mike's terminal: hp2621
+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
+# terminal emulate/window system
+ttyv0  "/usr/new/xterm -L :0"          vs100   on window="/usr/new/Xvs100 0"
+# Network pseudo ttys -- don't enable getty
+ttyp0  none    network
+ttyp1  none    network off

 .fi
 .fi

-.PP
-The first example permits root login on the console at 1200 baud,
-the second allows dialup at 1200 baud without root login,
-the third and fourth allow login at 9600 baud with terminal types of
-"hp2621-nl" and "plugboard" respectively,
-the fifth and sixth line are examples of network pseudo ttys, which
-should not have getty enabled on them,
-and the last example shows a terminal emulator and window system
-startup entry.

 .SH FILES
 /etc/ttys
 .SH "SEE ALSO"
 .SH FILES
 /etc/ttys
 .SH "SEE ALSO"

-getttyent(3), gettytab(5), init(8), getty(8), login(1)
-.SH BUGS
-The parsing of the flags, window, and comment fields is stupid.
+login(1), getttyent(3), ttyslot(3), gettytab(5), termcap(5), getty(8), init(8)