first pass for new make

[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 a06477f..2849fd2 100644 (file)
--- a/usr/src/libexec/getty/getty.8
+++ b/usr/src/libexec/getty/getty.8
@@ -2,7 +2,7 @@
 .\" 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     6.2 (Berkeley) %G%
+.\"    @(#)getty.8     6.5 (Berkeley) %G%

 .\"
 .TH GETTY 8  ""
 .UC 4
 .\"
 .TH GETTY 8  ""
 .UC 4


@@ -10,12 +10,12 @@
 getty  \- set terminal mode
 .SH SYNOPSIS
 .B /etc/getty
 getty  \- set terminal mode
 .SH SYNOPSIS
 .B /etc/getty

-[ type ] [ tty ]
+[ type [ tty ] ]

 .SH DESCRIPTION
 .I Getty
 is usually invoked by
 .IR  init (8)
 .SH DESCRIPTION
 .I Getty
 is usually invoked by
 .IR  init (8)

-to intialize the tty line, read a login name, and invoke
+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
 .IR login (1).
 .I getty
 attempts to adapt the system to the speed and type of terminal


@@ -23,9 +23,9 @@ being used.
 .PP
 The argument
 .I tty
 .PP
 The argument
 .I tty

-is the special device file in /dev to open for the terminal (e.g., 'ttyh0').
+is the special device file in /dev to open for the terminal (e.g., ``ttyh0'').

 If there is no argument or the argument is
 If there is no argument or the argument is

-"\-", the tty line is assumed to be open as file descriptor 0.
+``\-'', the tty line is assumed to be open as file descriptor 0.

 .PP
 The
 .I type
 .PP
 The
 .I type


@@ -46,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


@@ -84,8 +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
+gettytab(5), init(8), login(1), ioctl(2), tty(4), ttys(5)