summaryrefslogtreecommitdiff
path: root/libexec/getty
diff options
context:
space:
mode:
authorfair <fair@NetBSD.org>1998-12-12 19:04:54 +0000
committerfair <fair@NetBSD.org>1998-12-12 19:04:54 +0000
commitbf3b9adb93a8b6d3f6f144ade86a84dcf965bc1c (patch)
treecb864a5e7f22889ec84790b37cced6439551f896 /libexec/getty
parentbdaefe06f31dc7772284d509d53e69d315dea1b8 (diff)
Document (or expand documentation about) the ability of getty(8) to
recognize a PPP bringup sequence and invoke something appropriate, per PR#6462
Diffstat (limited to 'libexec/getty')
-rw-r--r--libexec/getty/getty.843
-rw-r--r--libexec/getty/gettytab.534
2 files changed, 56 insertions, 21 deletions
diff --git a/libexec/getty/getty.8 b/libexec/getty/getty.8
index 38779577b28..5309969179a 100644
--- a/libexec/getty/getty.8
+++ b/libexec/getty/getty.8
@@ -1,4 +1,4 @@
-.\" $NetBSD: getty.8,v 1.11 1998/08/29 17:31:56 tsarna Exp $
+.\" $NetBSD: getty.8,v 1.12 1998/12/12 19:04:54 fair Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -33,13 +33,13 @@
.\"
.\" from: @(#)getty.8 8.1 (Berkeley) 6/4/93
.\"
-.Dd June 4, 1993
+.Dd December 12, 1998
.Dt GETTY 8
.Os BSD 4
.Sh NAME
.Nm getty ,
.Nm uugetty
-.Nd set terminal mode
+.Nd set terminal modes for system access
.Sh SYNOPSIS
.Nm
.Oo
@@ -64,11 +64,33 @@ The devices on which to run
are normally determined by
.Xr ttys 5 .
.Pp
+The
+.Nm
+program can also recognize a Point to Point Protocol
+.Pq Tn PPP
+negotiation, and, if the
+.Sy pp
+attribute in
+.Xr gettytab 5
+is set, invoke the program given by that string, e.g.
+.Xr pppd 8 ,
+instead of
+.Xr login 1 .
+This makes it possible to use a single serial port for either a
+.Qq shell
+account with command line interface, or a
+.Tn PPP
+network link.
+.Pp
The argument
.Ar tty
is the special device file in
.Pa /dev
-to open for the terminal (for example, ``ttyh0'').
+to open for the terminal
+.Po
+for example,
+.Qq ttyh0
+.Pc .
If there is no argument or the argument is
.Ql Fl ,
the tty line is assumed to be open as file descriptor 0.
@@ -98,7 +120,10 @@ the system hostname.
.Nm
uses the
.Xr ttyaction 3
-facility with an action of "getty" and user "root"
+facility with an action of
+.Qq getty
+and user
+.Qq root
to execute site-specific commands when it starts.
.Pp
Most of the default actions of
@@ -109,8 +134,7 @@ table.
.Pp
The
.Nm
-program
-can be set to timeout after some interval,
+program 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.
.Pp
@@ -143,11 +167,12 @@ does not exist.
.Sh SEE ALSO
.Xr gettytab 5 ,
.Xr init 8 ,
-.Xr login 1 ,
.Xr ioctl 2 ,
+.Xr login 1 ,
.Xr pidlock 3 ,
-.Xr ttyaction 3 ,
+.Xr pppd 8 ,
.Xr tty 4 ,
+.Xr ttyaction 3 ,
.Xr ttys 5
.Sh HISTORY
A
diff --git a/libexec/getty/gettytab.5 b/libexec/getty/gettytab.5
index 1864d9efa52..a275494f678 100644
--- a/libexec/getty/gettytab.5
+++ b/libexec/getty/gettytab.5
@@ -1,4 +1,4 @@
-.\" $NetBSD: gettytab.5,v 1.20 1998/10/12 18:03:48 tsarna Exp $
+.\" $NetBSD: gettytab.5,v 1.21 1998/12/12 19:04:54 fair Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -231,16 +231,16 @@ These flags correspond to the termios
.Em c_lflag ,
and
.Em c_oflag
-fields, respectively. Each these sets must be completely specified to be
-effective.
+fields, respectively.
+Each these sets must be completely specified to be effective.
The
.Em \&f0 ,
.Em \&f1 ,
and
.Em \&f2
are excepted for backwards compatibility with a previous incarnation of
-the TTY sub-system. In these flags the bottom 16 bits of the (32 bits)
-value contain the sgttyb
+the TTY sub-system.
+In these flags the bottom 16 bits of the (32 bits) value contain the sgttyb
.Em sg_flags
field, while the top 16 bits represent the local mode word.
.Pp
@@ -250,7 +250,8 @@ receive a null character
(presumed to indicate a line break)
it will restart using the table indicated by the
.Em nx
-entry. If there is none, it will re-use its original table.
+entry.
+If there is none, it will re-use its original table.
.Pp
Delays are specified in milliseconds, the nearest possible
delay available in the tty driver will be used.
@@ -362,16 +363,25 @@ mode.
.Pp
If
.Em \&pp
-string is specified and a PPP link bringup sequence is recognized,
-getty will invoke the program referenced by the pp option. This
-can be used to handle incoming PPP calls.
+string is specified and a Point to Point Protocol
+.Pq Tn PPP
+link bringup sequence is recognized,
+.Xr getty 8
+will invoke the program referenced by the
+.Em \&pp
+string, e.g.
+.Xr pppd 8 .
+This can be used to handle incoming
+.Tn PPP
+calls.
.Sh SEE ALSO
-.Xr login 1 ,
.Xr gethostname 3 ,
-.Xr uname 3 ,
+.Xr getty 8 ,
+.Xr login 1 ,
+.Xr pppd 8 ,
.Xr termcap 5 ,
.Xr ttys 5 ,
-.Xr getty 8 .
+.Xr uname 3
.Sh BUGS
The special characters (erase, kill, etc.) are reset to system defaults
by