Module Name: src
Committed By: uwe
Date: Fri Jul 12 03:32:41 UTC 2019
Modified Files:
src/libexec/getty: gettytab.5
Log Message:
Improve (hopefully) mark up of the capabilities tables.
To generate a diff of this commit:
cvs rdiff -u -r1.38 -r1.39 src/libexec/getty/gettytab.5
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/libexec/getty/gettytab.5
diff -u src/libexec/getty/gettytab.5:1.38 src/libexec/getty/gettytab.5:1.39
--- src/libexec/getty/gettytab.5:1.38 Fri Jul 12 01:53:45 2019
+++ src/libexec/getty/gettytab.5 Fri Jul 12 03:32:41 2019
@@ -1,4 +1,4 @@
-.\" $NetBSD: gettytab.5,v 1.38 2019/07/12 01:53:45 uwe Exp $
+.\" $NetBSD: gettytab.5,v 1.39 2019/07/12 03:32:41 uwe Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -88,110 +88,134 @@ column below lists defaults obtained if
no entry in the table obtained, nor one in the special
.Ic default
table.
-.Bl -column Namexx /usr/bin/login Default
-.It Sy Name Type Default Description
-.It "ab bool false Auto-baud speed select mechanism for the Micom 600 portselector. Selection is done by looking at how the character `\er' is garbled at 300, 1200, 4800, and 9600 baud."
-.It "al str NULL user to auto-login instead of prompting"
-.It "ap bool false terminal uses any parity"
-.It "bk str 0377 alternative end of line character (input break)"
-.It "b2 str 0377 alternative end of line character (input break)"
-.It "c0 num unused tty control flags to write messages"
-.It "c1 num unused tty control flags to read login name"
-.It "c2 num unused tty control flags to leave terminal as"
-.It "ce bool false use crt erase algorithm"
-.It "ck bool false use crt kill algorithm"
-.It "cl str" Ta Dv NULL Ta No "screen clear sequence"
-.It "co bool false console - add"
+.Bl -column ".Sy Name" ".Sy Type" "/usr/bin/login"
+.It Sy Name Ta Sy Type Ta Sy Default Ta Sy Description
+.It Ic \&ab Ta bool Ta false Ta Auto-baud speed select mechanism for the
+Micom 600 portselector. Selection is done by looking at how the
+character
+.Ql \er
+is garbled at 300, 1200, 4800, and 9600 baud.
+.It Ic \&al Ta str Ta Dv NULL Ta user to auto-login instead of prompting
+.It Ic \&ap Ta bool Ta false Ta terminal uses any parity
+.It Ic \&bk Ta str Ta Li \e377 Ta alternative end of line character (input break)
+.Pq Dv VEOL
+.It Ic \&b2 Ta str Ta Li \e377 Ta alternative end of line character (input break)
+.Pq Dv VEOL2
+.It Ic \&c0 Ta num Ta unused Ta tty control flags to write messages
+.It Ic \&c1 Ta num Ta unused Ta tty control flags to read login name
+.It Ic \&c2 Ta num Ta unused Ta tty control flags to leave terminal as
+.It Ic \&ce Ta bool Ta false Ta use Tn CRT erase algorithm
+.It Ic \&ck Ta bool Ta false Ta use Tn CRT kill algorithm
+.It Ic \&cl Ta str Ta Dv NULL Ta screen clear sequence
+.It Ic \&co Ta bool Ta false Ta console \(en add
.Ql \er\en
after login prompt
-.It "cs bool false clear screen based on terminal type in /etc/ttys"
-.It "ds str" Ta So Li ^Y Sc Ta No "delayed suspend character"
-.It "dx bool false set"
-.Dv DECCTLQ
-.It "ec bool false leave echo"
+.It Ic \&cs Ta bool Ta false Ta clear screen based on terminal type in
+.Pa /etc/ttys
+.It Ic \&ds Ta str Ta So Li "^Y" Sc Ta delayed suspend character
+.Pq Dv VDSUSP
+.It Ic \&dx Ta bool Ta false Ta set Dv DECCTLQ
+.It Ic \&ec Ta bool Ta false Ta leave echo
.Tn OFF
-.It "ep bool false terminal uses even parity"
-.It "er str" Ta So Li ^? Sc Ta No "erase character"
-.It "et str" Ta So Li ^D Sc Ta No "end of text"
-.Pq Dv EOF
+.It Ic \&ep Ta bool Ta false Ta terminal uses even parity
+.It Ic \&er Ta str Ta So Li ^? Sc Ta erase character
+.Pq Dv VERASE
+.It Ic \&et Ta str Ta So Li ^D Sc Ta end of text
+.Pq Dv VEOF
character
-.It "ev str" Ta Dv NULL Ta No "initial environment"
-.It "f0 num unused tty mode flags to write messages"
-.It "f1 num unused tty mode flags to read login name"
-.It "f2 num unused tty mode flags to leave terminal as"
-.It "fl str" Ta So Li ^O Sc Ta No "output flush character"
-.It "hc bool false do"
+.It Ic \&ev Ta str Ta Dv NULL Ta initial environment
+.It Ic \&f0 Ta num Ta unused Ta tty mode flags to write messages
+.It Ic \&f1 Ta num Ta unused Ta tty mode flags to read login name
+.It Ic \&f2 Ta num Ta unused Ta tty mode flags to leave terminal as
+.It Ic \&fl Ta str Ta So Li ^O Sc Ta output flush character
+.Pq Dv VDISCARD
+.It Ic \&hc Ta bool Ta false Ta do
.Tn NOT
hangup line on last close
-.It "he str" Ta Dv NULL Ta No "hostname editing string"
-.It "hn str hostname hostname"
-.It "ht bool false terminal has real tabs"
-.It "i0 num unused tty input flags to write messages"
-.It "i1 num unused tty input flags to read login name"
-.It "i2 num unused tty input flags to leave terminal as"
-.It "if str NULL display named file before prompt, like /etc/issue"
-.It "ig bool false ignore garbage characters in login name"
-.It "im str" Ta Dv NULL Ta No "initial (banner) message"
-.It "in str" Ta So Li ^C Sc Ta No "interrupt character"
-.It "is num unused input speed"
-.It "kl str" Ta So Li ^U Sc Ta No "kill character"
-.It "l0 num unused tty local flags to write messages"
-.It "l1 num unused tty local flags to read login name"
-.It "l2 num unused tty local flags to leave terminal as"
-.It "lc bool false terminal has lower case"
-.It "lm str login: login prompt"
-.It "ln str" Ta So Li ^V Sc Ta No "``literal next'' character"
-.It "lo str" Ta Pa /usr/bin/login Ta No "program to exec when name obtained"
-.It "mb bool false do flow control based on carrier"
-.It "nl bool false terminal has (or might have) a newline character"
-.It "nn bool false do not prompt for a login name"
-.It "np bool false terminal uses no parity (i.e. 8-bit characters)"
-.It "nx str default next table (for auto speed selection)"
-.It "o0 num unused tty output flags to write messages"
-.It "o1 num unused tty output flags to read login name"
-.It "o2 num unused tty output flags to leave terminal as"
-.It "op bool false terminal uses odd parity"
-.It "os num unused output speed"
-.It "pc str" Ta So Li \e0 Sc Ta No "pad character"
-.It "pe bool false use printer (hard copy) erase algorithm"
-.It "pf num 0 delay"
-between first prompt and following flush (seconds)
-.It "pp str unused PPP authentication program"
-.It "ps bool false line connected to a"
+.It Ic \&he Ta str Ta Dv NULL Ta hostname editing string
+.It Ic \&hn Ta str Ta hostname Ta hostname
+.It Ic \&ht Ta bool Ta false Ta terminal has real tabs
+.It Ic \&i0 Ta num Ta unused Ta tty input flags to write messages
+.It Ic \&i1 Ta num Ta unused Ta tty input flags to read login name
+.It Ic \&i2 Ta num Ta unused Ta tty input flags to leave terminal as
+.It Ic \&if Ta str Ta Dv NULL Ta display named file before prompt,
+like
+.Pa /etc/issue
+.It Ic \&ig Ta bool Ta false Ta ignore garbage characters in login name
+.It Ic \&im Ta str Ta Dv NULL Ta initial (banner) message
+.It Ic \&in Ta str Ta So Li ^C Sc Ta interrupt character
+.Pq Dv VINTR
+.It Ic \&is Ta num Ta unused Ta input speed
+.It Ic \&kl Ta str Ta So Li ^U Sc Ta kill character
+.Pq Dv VKILL
+.It Ic \&l0 Ta num Ta unused Ta tty local flags to write messages
+.It Ic \&l1 Ta num Ta unused Ta tty local flags to read login name
+.It Ic \&l2 Ta num Ta unused Ta tty local flags to leave terminal as
+.It Ic \&lc Ta bool Ta false Ta terminal has lower case
+.It Ic \&lm Ta str Ta login: Ta login prompt
+.It Ic \&ln Ta str Ta So Li ^V Sc Ta So literal next Sc character
+.Pq Dv VLNEXT
+.It Ic \&lo Ta str Ta /usr/bin/login Ta program to exec when name obtained
+.It Ic \&mb Ta bool Ta false Ta do flow control based on carrier
+.It Ic \&nl Ta bool Ta false Ta terminal has (or might have) a newline character
+.It Ic \&nn Ta bool Ta false Ta do not prompt for a login name
+.It Ic \&np Ta bool Ta false Ta terminal uses no parity (i.e. 8-bit characters)
+.It Ic \&nx Ta str Ta default Ta next table (for auto speed selection)
+.It Ic \&o0 Ta num Ta unused Ta tty output flags to write messages
+.It Ic \&o1 Ta num Ta unused Ta tty output flags to read login name
+.It Ic \&o2 Ta num Ta unused Ta tty output flags to leave terminal as
+.It Ic \&op Ta bool Ta false Ta terminal uses odd parity
+.It Ic \&os Ta num Ta unused Ta output speed
+.It Ic \&pc Ta str Ta So Li \e0 Sc Ta pad character
+.It Ic \&pe Ta bool Ta false Ta use printer (hard copy) erase algorithm
+.It Ic \&pf Ta num Ta 0 Ta delay between first prompt and following
+flush (seconds)
+.It Ic \&pp Ta str Ta unused Ta Tn PPP authentication program
+.It Ic \&ps Ta bool Ta false Ta line connected to a
.Tn MICOM
port selector
-.It "qu str" Ta So Li \&^\e Sc Ta No "quit character"
-.It "rp str" Ta So Li ^R Sc Ta No "line retype character"
-.It "rw bool false do"
+.It Ic \&qu Ta str Ta So Li \&^\e Sc Ta quit character
+.Pq Dv VQUIT
+.It Ic \&rp Ta str Ta So Li ^R Sc Ta line retype character
+.Pq Dv VREPRINT
+.It Ic \&rw Ta bool Ta false Ta do
.Tn NOT
-use raw for input, use cbreak
-.It "sp num unused line speed (input and output)"
-.It "st str" Ta So Li ^T Sc Ta No "status character"
-.It "su str" Ta So Li ^Z Sc Ta No "suspend character"
-.It "tc str none table continuation"
-.It "to num 0 timeout (seconds)"
-.It "tt str" Ta Dv NULL Ta No "terminal type (for environment)"
-.It "ub bool false do unbuffered output (of prompts etc)"
-.It "we str" Ta So Li ^W Sc Ta No "word erase character"
-.It "xc bool false do"
+use
+.Dv RAW
+for input, use
+.Dv CBREAK
+.It Ic \&sp Ta num Ta unused Ta line speed (input and output)
+.It Ic \&st Ta str Ta So Li ^T Sc Ta status character
+.Pq Dv VSTATUS
+.It Ic \&su Ta str Ta So Li ^Z Sc Ta suspend character
+.Pq Dv VSUSP
+.It Ic \&tc Ta str Ta none Ta table continuation
+.It Ic \&to Ta num Ta 0 Ta timeout (seconds)
+.It Ic \&tt Ta str Ta Dv NULL Ta terminal type (for environment)
+.It Ic \&ub Ta bool Ta false Ta do unbuffered output (of prompts etc)
+.It Ic \&we Ta str Ta So Li ^W Sc Ta word erase character
+.Pq Dv VWERASE
+.It Ic \&xc Ta bool Ta false Ta do
.Tn NOT
echo control chars as
.Ql ^X
-.It "xf str" Ta So Li ^S Sc Ta Dv XOFF
+.It Ic \&xf Ta str Ta So Li ^S Sc Ta Tn XOFF
(stop output) character
-.It "xn str" Ta So Li ^Q Sc Ta Dv XON
+.Pq Dv VSTOP
+.It Ic \&xn Ta str Ta So Li ^Q Sc Ta Tn XON
(start output) character
+.Pq Dv VSTART
.El
.Pp
The following capabilities are no longer supported by
.Xr getty 8 :
-.Bl -column Namexx /usr/bin/login Default
-.It "bd num 0 backspace delay"
-.It "cb bool false use crt backspace mode"
-.It "cd num 0 carriage-return delay"
-.It "fd num 0 form-feed (vertical motion) delay"
-.It "nd num 0 newline (line-feed) delay"
-.It "uc bool false terminal is known upper case only"
+.Bl -column ".Sy Name" ".Sy Type" "/usr/bin/login"
+.It Ic \&bd Ta num Ta 0 Ta backspace delay
+.It Ic \&cb Ta bool Ta false Ta use Tn CRT backspace mode
+.It Ic \&cd Ta num Ta 0 Ta carriage-return delay
+.It Ic \&fd Ta num Ta 0 Ta form-feed (vertical motion) delay
+.It Ic \&nd Ta num Ta 0 Ta newline (line-feed) delay
+.It Ic \&uc Ta bool Ta false Ta terminal is known upper case only
.El
.Pp
If no line speed is specified, speed will not be altered
@@ -220,7 +244,8 @@ with one of the
or
.Ic \&o2
numeric specifications, which can be used to specify
-(usually in octal, with a leading '0')
+(usually in octal, with a leading
+.Ql 0 )
the exact values of the flags.
These flags correspond to the termios
.Fa c_cflag ,
