Document (or expand documentation about) the ability of getty(8) to
recognize a PPP bringup sequence and invoke something appropriate, per PR#6462
This commit is contained in:
fair
parent
bdaefe06f3
commit
bf3b9adb93
@ -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
|
||||
|
||||
@ -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
|
||||
|
||||
Loading…
Reference in New Issue
Block a user