Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src/libexec/getty Improve (hopefully) mark up of the capabilitie...



details:   https://anonhg.NetBSD.org/src/rev/48b196f34ae8
branches:  trunk
changeset: 457681:48b196f34ae8
user:      uwe <uwe%NetBSD.org@localhost>
date:      Fri Jul 12 03:32:41 2019 +0000

description:
Improve (hopefully) mark up of the capabilities tables.

diffstat:

 libexec/getty/gettytab.5 |  201 ++++++++++++++++++++++++++--------------------
 1 files changed, 113 insertions(+), 88 deletions(-)

diffs (240 lines):

diff -r be0aedc64320 -r 48b196f34ae8 libexec/getty/gettytab.5
--- a/libexec/getty/gettytab.5  Fri Jul 12 02:39:37 2019 +0000
+++ b/libexec/getty/gettytab.5  Fri Jul 12 03:32:41 2019 +0000
@@ -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 @@
 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 @@
 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 ,



Home | Main Index | Thread Index | Old Index