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: