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 c38f58e..234a217 100644 (file)
--- a/usr/src/libexec/getty/ttys.5
+++ b/usr/src/libexec/getty/ttys.5
@@ -1,39 +1,105 @@
-.\"    @(#)ttys.5      5.1 (Berkeley) %G%
+.\" Copyright (c) 1985 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.TH TTYS 5  "18 July 1983"
+.\" 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
 .SH DESCRIPTION
 The
 .I ttys
 .AT 3
 .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.

+Fields are separated by tabs and/or spaces.
+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
 .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
+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 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.
+.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.
+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
+.IR getttyent (3))
+or specify a window system process that
+.IR init (8)
+will maintain for the terminal line.
+.PP
+As flag values, the strings ``on'' and ``off'' specify that
+.I init
+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
+will execute
+.B before
+starting the command specified by the second field.
+.SH EXAMPLES
+.nf
+# 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

 .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), ttyslot(3), gettytab(5), termcap(5), getty(8), init(8)