BSD 4_3 release

[unix-history] / usr / man / man5 / ttys.5

diff --git a/usr/man/man5/ttys.5 b/usr/man/man5/ttys.5
index 730ed10..2d86d7b 100644 (file)
--- a/usr/man/man5/ttys.5
+++ b/usr/man/man5/ttys.5
@@ -1,36 +1,86 @@
-.TH TTYS 5  "18 July 1983"
+.\"    @(#)ttys.5      6.4 (Berkeley) 5/20/86
+.\"
+.TH TTYS 5  "May 20, 1986"
+.AT 3

 .SH NAME
 ttys \- terminal initialization data
 .SH DESCRIPTION
 The
 .I ttys
 .SH NAME
 ttys \- terminal initialization data
 .SH DESCRIPTION
 The
 .I ttys

-file is read by the
-.I init
-program and specifies which terminal special files are to have
-a process created for them so that people can log in.
+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
+.IR getttyent (3)
+library routines.

 There is one line in the 
 .I ttys
 file per special file.
 There is one line in the 
 .I ttys
 file per special file.

-.PP
-The first character of a line in the 
-.I ttys
-file is either `0' or `1'.  If the first character on the line is a `0', the 
-.I init
-program ignores that line.  If the first character on the line is a `1', the
-.I init
-program creates a login process for that line.
-The second character on each line is used as an argument to
+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 null.
+The first field is the terminal's entry in the device directory, /dev.
+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 getty (8),
 which performs such tasks as baud-rate recognition, reading the login name,
 and calling

-.I login.
-For normal lines, the character is `0';
-other characters can be used, for example, with hard-wired terminals
-where speed recognition is unnecessary or which have special characteristics.
-.RI ( Getty
-will have to be fixed in such cases.)
-The remainder of the line is the terminal's entry in the device directory, /dev.
+.IR login (1).
+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 third field is the type of terminal normally connected to that
+tty line, as found in the
+.IR termcap (5)
+data base file.
+The remaining fields set flags in the
+.I ty_status
+entry (see
+.IR getttyent (3))
+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
+.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
+string which
+.I init
+will execute before starting
+.IR getty .
+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
+.nf
+.ta \w'console\ 'u +\w'"/etc/getty std.9600"\ \ \ 'u +\w'hp2621-nl\ \ \ \ 'u +.7i
+console        "/etc/getty std.1200"   vt100   on secure
+ttyd0  "/etc/getty d1200"      dialup  on      # 555-1234
+ttyh0  "/etc/getty std.9600"   hp2621-nl       on      # 254MC
+ttyh1  "/etc/getty std.9600"   plugboard       on      # John's office
+ttyp0  none    network
+ttyp1  none    network off
+ttyv0  "/usr/new/xterm -L :0"  vs100   on window="/usr/new/Xvs100 0"
+.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
+.I 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"

-gettytab(5), init(8), getty(8), login(1)
+login(1), getttyent(3), gettytab(5), init(8), getty(8)