new copyright notice

[unix-history] / usr / src / libexec / getty / getty.8

diff --git a/usr/src/libexec/getty/getty.8 b/usr/src/libexec/getty/getty.8
index 3ba82ed..2849fd2 100644 (file)
--- a/usr/src/libexec/getty/getty.8
+++ b/usr/src/libexec/getty/getty.8
@@ -2,35 +2,36 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"

-.\"    @(#)getty.8     5.1 (Berkeley) %G%
+.\"    @(#)getty.8     6.5 (Berkeley) %G%

 .\"
 .\"

-.TH GETTY 8  "18 July 1983"
+.TH GETTY 8  ""

 .UC 4
 .SH NAME
 getty  \- set terminal mode
 .SH SYNOPSIS
 .B /etc/getty
 .UC 4
 .SH NAME
 getty  \- set terminal mode
 .SH SYNOPSIS
 .B /etc/getty

-[ type ]
+[ type [ tty ] ]

 .SH DESCRIPTION
 .I Getty
 .SH DESCRIPTION
 .I Getty

-is invoked by
+is usually invoked by

 .IR  init (8)
 .IR  init (8)

-immediately after a terminal is opened,
-following the making of a connection.
-While reading the name
+to open and initialize the tty line, read a login name, and invoke
+.IR login (1).

 .I getty
 attempts to adapt the system to the speed and type of terminal
 being used.
 .PP
 .I getty
 attempts to adapt the system to the speed and type of terminal
 being used.
 .PP

-.I Init
-calls
-.I getty
-with an argument specified by the
-.I ttys
-file entry for the terminal line.
-The argument can be used to make
+The argument
+.I tty
+is the special device file in /dev to open for the terminal (e.g., ``ttyh0'').
+If there is no argument or the argument is
+``\-'', the tty line is assumed to be open as file descriptor 0.
+.PP
+The
+.I type
+argument can be used to make

 .I getty
 .I getty

-treat the line specially.
+treat the terminal line specially.

 This argument is used as an index into the
 .IR gettytab (5)
 database, to determine the characteristics of the line.
 This argument is used as an index into the
 .IR gettytab (5)
 database, to determine the characteristics of the line.


@@ -45,7 +46,7 @@ If indicated by the table located,
 will clear the terminal screen,
 print a banner heading,
 and prompt for a login name.
 will clear the terminal screen,
 print a banner heading,
 and prompt for a login name.

-Usually either the banner of the login prompt will include
+Usually either the banner or the login prompt will include

 the system hostname.
 Then the user's name is read, a character at a time.
 If a null character is received, it is assumed to be the result
 the system hostname.
 Then the user's name is read, a character at a time.
 If a null character is received, it is assumed to be the result


@@ -55,7 +56,7 @@ changed and the `login:' is typed again;
 a second `break' changes the speed again and the `login:'
 is typed once more.
 Successive `break' characters cycle through the
 a second `break' changes the speed again and the `login:'
 is typed once more.
 Successive `break' characters cycle through the

-some standard set of speeds.
+same standard set of speeds.

 .PP
 The user's name is terminated by a new-line or
 carriage-return character.
 .PP
 The user's name is terminated by a new-line or
 carriage-return character.


@@ -69,7 +70,9 @@ and if the name is nonempty, the
 system is told to map any future upper-case characters
 into the corresponding lower-case characters.
 .PP
 system is told to map any future upper-case characters
 into the corresponding lower-case characters.
 .PP

-Finally, login is called with the user's name as argument.
+Finally,
+.I login
+is called with the user's name as an argument.

 .PP
 Most of the default actions of
 .I getty
 .PP
 Most of the default actions of
 .I getty


@@ -81,15 +84,15 @@ table.
 can be set to timeout after some interval,
 which will cause dial up lines to hang up
 if the login name is not entered reasonably quickly.
 can be set to timeout after some interval,
 which will cause dial up lines to hang up
 if the login name is not entered reasonably quickly.

+.SH DIAGNOSTICS
+\fIttyxx\fR\|\fB: No such device or address\fR.
+\fIttyxx\fR\|\fB: No such file or address\fR.
+A terminal which is turned
+on in the \fIttys\fR file cannot be opened, likely because the requisite
+lines are either not configured into the system, the associated device
+was not attached during boot-time system configuration,
+or the special file in /dev does not exist.

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

-gettytab(5), init(8), login(1), ioctl(2), tty(4), ttys(5).
-.SH BUGS
-Currently, the format of
-.B /etc/ttys
-limits the permitted table names to a single character,
-this should be expanded.
-.PP
-.B /etc/ttys
-should be replaced completely.
+gettytab(5), init(8), login(1), ioctl(2), tty(4), ttys(5)