diff options
| author | fair <fair@NetBSD.org> | 1998-12-12 19:04:54 +0000 |
|---|---|---|
| committer | fair <fair@NetBSD.org> | 1998-12-12 19:04:54 +0000 |
| commit | bf3b9adb93a8b6d3f6f144ade86a84dcf965bc1c (patch) | |
| tree | cb864a5e7f22889ec84790b37cced6439551f896 /libexec/getty | |
| parent | bdaefe06f31dc7772284d509d53e69d315dea1b8 (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.8 | 43 | ||||
| -rw-r--r-- | libexec/getty/gettytab.5 | 34 |
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 |
