[src/trunk]: src/libexec/getty Deal with PR 9427 - add wording to clarify wha...

[fair <fair%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c1554497ff21
branches:  trunk
changeset: 486256:c1554497ff21
user:      fair <fair%NetBSD.org@localhost>
date:      Wed May 17 09:22:11 2000 +0000

description:
Deal with PR 9427 - add wording to clarify what sending SIGHUP to init(8)
does and does not do. Also, while we're here, make the list of flags more
readable.

diffstat:

 libexec/getty/ttys.5 |  85 ++++++++++++++++++++++++++++++++++++++-------------
 1 files changed, 63 insertions(+), 22 deletions(-)

diffs (129 lines):

diff -r d6c3045098a2 -r c1554497ff21 libexec/getty/ttys.5
--- a/libexec/getty/ttys.5      Wed May 17 09:16:44 2000 +0000
+++ b/libexec/getty/ttys.5      Wed May 17 09:22:11 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ttys.5,v 1.12 1999/01/15 18:47:49 tsarna Exp $
+.\"    $NetBSD: ttys.5,v 1.13 2000/05/17 09:22:11 fair Exp $
 .\"
 .\" Copyright (c) 1985, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -47,6 +47,7 @@
 This information is read with the
 .Xr getttyent 3
 library routines.
+.Pp
 There is one line in the
 .Nm
 file per special device file.
@@ -68,9 +69,9 @@
 a user name and executing the
 .Xr login 1
 program.
-It can be, however, any desired command, for example
-the start up for a window system terminal emulator or some other
-daemon process, and can contain multiple words if quoted.
+However, it can be any desired command, for example the start up
+for a window system terminal emulator or some other daemon process,
+and can contain multiple words if quoted.
 .Pp
 The third field is the type of terminal usually connected to that
 tty line, normally the one found in the
@@ -78,8 +79,7 @@
 data base file.
 The environment variable
 .Dv TERM
-is initialized with the value by
-either
+is initialized with the value by either
 .Xr getty 8
 or
 .Xr login 1 .
@@ -93,24 +93,52 @@
 will maintain for the terminal line
 or a key into a database of tty attributes (currently unused).
 .Pp
-As flag values, the strings ``on'' and ``off'' specify that
+.Bl -tag -width softcar
+.It Sy on No or Sy off
 .Xr init 8
-should (should not) execute the command given in the second field,
-while ``secure'' (if ``on'' is also specified) allows users with a
-uid of 0 to login on
-this line.
-The flags ``local'', ``rtscts'', ``mdmbuf'', and ``softcar''
+should (or should not) execute the command given in the second field.
+.It Sy secure
+If
+.Sy on
+is specified, allows users with a uid of 0
+.Pq e.g. Qq root
+to login on this line.
+.It Sy local
+Sets
+.Dv CLOCAL
+.Xr termios 4
+flag for the device.
+Tells device to ignore modem control signal lines.
+.It Sy softcar
+Causes the driver to ignore hardware carrier on the line.
+.It Sy rtscts
+Sets
+.Dv CRTSCTS
+.Xr termios 4
+flag for the device to enable
+.Tn RTS /
+.Tn CTS
+.Qq hardware
+flow control.
+.It Sy mdmbuf
+Sets
+.Dv MDMBUF
+.Xr termios 4
+flag for the device to enable
+.Tn DTR /
+.Tn DCD
+.Qq hardware
+flow control.
+.El
+.Pp
+The flags
+.Qq local ,
+.Qq rtscts ,
+.Qq mdmbuf ,
+and
+.Qq softcar
 modify the default behaviour of the terminal line, and their actions
-are driver dependent.
-The ``local'' flag causes the driver to
-treat the line as if it locally connected.
-The ``rtscts'' flag
-instructs the driver to use RTS/CTS hardware flow control, if
-possible.
-The ``mdmbuf'' flag instructs the driver to use
-DTR/DCD flow control, if possible.
-The ``softcar'' flag causes the driver to ignore
-hardware carrier on the line.
+are device driver dependent.
 These flag fields should not be quoted.
 .Pp
 The string ``window='' may be followed by a quoted command
@@ -141,6 +169,19 @@
 file and spawn any necessary
 .Xr getty 8
 processes.
+.Pp
+.Sy Nota Bene:
+Sending
+.Dv SIGHUP
+to
+.Xr init 8
+does
+.Em not
+change the state of the various
+.Xr termios 4
+device flags listed above; the
+.Xr ttyflags 8
+program must be run for changes in those flags to take effect on the devices.
 .Sh EXAMPLES
 .Bd -literal
 # root login on console at 1200 baud