Subject: bin/5339: getty/gettytab man page does not indicate ttys(5) well
To: None <gnats-bugs@gnats.netbsd.org>
From: None <abs@mono.org>
List: netbsd-bugs
Date: 04/21/1998 21:26:13
>Number: 5339
>Category: bin
>Synopsis: getty/gettytab man page does not indicate ttys(5) well
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: bin-bug-people (Utility Bug People)
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Tue Apr 21 21:35:01 1998
>Last-Modified:
>Originator: David Brownlee
>Organization:
<a href="http://www.mono.org/">Monochrome</a>
>Release: 1.3.1
>Environment:
System: NetBSD lapton.anim.dreamworks.com 1.3.1 NetBSD 1.3.1 (_LAPTON_) #0: Tue Mar 24 14:27:08 PST 1998 root@lapton.anim.dreamworks.com:/usr/src/sys/arch/i386/compile/_LAPTON_ i386
>Description:
Neither gettytab(5), nor getty(8) reference ttys(5) well, making it
hard to work out what to modify to run getty.
>How-To-Repeat:
Try to setup a serial terminal. From 'man -k terminal' pick the
helpful looking "gettytab (5) - terminal configuration data base",
then from there have a very hard time finding that you actually
want ttys(5).
(I already know what to use - this was an exercise for a new NetBSD
user :)
>Fix:
Mention ttys(5) and (maybe) /etc/ttys.
--- gettytab.5.orig Tue Apr 21 21:10:59 1998
+++ gettytab.5 Tue Apr 21 21:20:12 1998
@@ -58,6 +58,11 @@
Each entry in the data base
is used to describe one class of terminals.
.Pp
+Where to run
+.Xr getty 8
+processes is normally defined by
+.Xr ttys 5 .
+.Pp
There is a default terminal class,
.Em default ,
that is used to set global defaults for all other classes.
@@ -358,6 +363,7 @@
.Xr gethostname 3 ,
.Xr uname 3 ,
.Xr termcap 5 ,
+.Xr ttys 5 ,
.Xr getty 8 .
.Sh BUGS
The special characters (erase, kill, etc.) are reset to system defaults
--- getty.8.orig Tue Apr 21 21:14:43 1998
+++ getty.8 Tue Apr 21 21:17:41 1998
@@ -59,6 +59,10 @@
.Xr init 8
to open and initialize the tty line, read a login name, and invoke
.Xr login 1 .
+The devices on which to run
+.Nm
+are normally determined by
+.Xr ttys 5 .
.Pp
The argument
.Ar tty
@@ -128,6 +132,7 @@
.Sh FILES
.Bl -tag -width /var/spool/lock/LCK..ttyXX -compact
.It Pa /etc/gettytab
+.It Pa /etc/ttys
.It Pa /var/spool/lock/LCK..ttyXX
.El
.Sh SEE ALSO
>Audit-Trail:
>Unformatted: