gettytab.5 (9875) | gettytab.5 (15645) |
---|---|
1.\" Copyright (c) 1983, 1991 The Regents of the University of California. 2.\" All rights reserved. | 1.\" Copyright (c) 1983, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. |
3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the --- 13 unchanged lines hidden (view full) --- 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" | 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the --- 13 unchanged lines hidden (view full) --- 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" |
32.\" @(#)gettytab.5 6.7 (Berkeley) 5/10/91 33.\" 34.Dd May 10, 1991 | 32.\" from: @(#)gettytab.5 8.4 (Berkeley) 4/19/94 33.\" $Id: gettytab.5,v 1.1.1.3 1996/04/13 15:33:07 joerg Exp $ 34.\" " 35.Dd April 19, 1994 |
35.Dt GETTYTAB 5 36.Os BSD 4.2 37.Sh NAME 38.Nm gettytab 39.Nd terminal configuration data base 40.Sh SYNOPSIS 41.Nm gettytab 42.Sh DESCRIPTION --- 28 unchanged lines hidden (view full) --- 71.Em default 72column below lists defaults obtained if there is 73no entry in the table obtained, nor one in the special 74.Em default 75table. 76.Bl -column Namexx /usr/bin/login Default 77.It Sy Name Type Default Description 78.It "ap bool false terminal uses any parity" | 36.Dt GETTYTAB 5 37.Os BSD 4.2 38.Sh NAME 39.Nm gettytab 40.Nd terminal configuration data base 41.Sh SYNOPSIS 42.Nm gettytab 43.Sh DESCRIPTION --- 28 unchanged lines hidden (view full) --- 72.Em default 73column below lists defaults obtained if there is 74no entry in the table obtained, nor one in the special 75.Em default 76table. 77.Bl -column Namexx /usr/bin/login Default 78.It Sy Name Type Default Description 79.It "ap bool false terminal uses any parity" |
79.It "bd num 0 backspace delay" | |
80.It "bk str 0377 alternate end of line character (input break)" | 80.It "bk str 0377 alternate end of line character (input break)" |
81.It "cb bool false use crt backspace mode" 82.It "cd num 0 carriage-return delay" | 81.It "c0 num unused tty control flags to write messages" 82.It "c1 num unused tty control flags to read login name" 83.It "c2 num unused tty control flags to leave terminal as" |
83.It "ce bool false use crt erase algorithm" 84.It "ck bool false use crt kill algorithm" | 84.It "ce bool false use crt erase algorithm" 85.It "ck bool false use crt kill algorithm" |
85.It "cl str" Ta Dv NULL Ta | 86.It "cl str" Ta Dv NULL Ta |
86.No "screen clear sequence" 87.It "co bool false console - add" 88.Ql \en 89after login prompt 90.It "ds str" Ta So Li ^Y Sc Ta 91.No "delayed suspend character" 92.It "dx bool false set" 93.Dv DECCTLQ 94.It "ec bool false leave echo" 95.Tn OFF 96.It "ep bool false terminal uses even parity" 97.It "er str" Ta So Li ^? Sc Ta 98.No "erase character" 99.It "et str" Ta So Li ^D Sc Ta 100.No "end of text" 101.Pq Dv EOF 102character | 87.No "screen clear sequence" 88.It "co bool false console - add" 89.Ql \en 90after login prompt 91.It "ds str" Ta So Li ^Y Sc Ta 92.No "delayed suspend character" 93.It "dx bool false set" 94.Dv DECCTLQ 95.It "ec bool false leave echo" 96.Tn OFF 97.It "ep bool false terminal uses even parity" 98.It "er str" Ta So Li ^? Sc Ta 99.No "erase character" 100.It "et str" Ta So Li ^D Sc Ta 101.No "end of text" 102.Pq Dv EOF 103character |
103.It "ev str" Ta Dv NULL Ta | 104.It "ev str" Ta Dv NULL Ta |
104.No "initial environment" 105.It "f0 num unused tty mode flags to write messages" 106.It "f1 num unused tty mode flags to read login name" 107.It "f2 num unused tty mode flags to leave terminal as" | 105.No "initial environment" 106.It "f0 num unused tty mode flags to write messages" 107.It "f1 num unused tty mode flags to read login name" 108.It "f2 num unused tty mode flags to leave terminal as" |
108.It "fd num 0 form-feed (vertical motion) delay" | |
109.It "fl str" Ta So Li ^O Sc Ta 110.No "output flush character" 111.It "hc bool false do" 112.Tn NOT 113hangup line on last close | 109.It "fl str" Ta So Li ^O Sc Ta 110.No "output flush character" 111.It "hc bool false do" 112.Tn NOT 113hangup line on last close |
114.It "he str" Ta Dv NULL Ta | 114.It "he str" Ta Dv NULL Ta |
115.No "hostname editing string" 116.It "hn str hostname hostname" 117.It "ht bool false terminal has real tabs" | 115.No "hostname editing string" 116.It "hn str hostname hostname" 117.It "ht bool false terminal has real tabs" |
118.It "i0 num unused tty input flags to write messages" 119.It "i1 num unused tty input flags to read login name" 120.It "i2 num unused tty input flags to leave terminal as" |
|
118.It "ig bool false ignore garbage characters in login name" 119.It "im str" Ta Dv NULL Ta 120.No "initial (banner) message" 121.It "in str" Ta So Li ^C Sc Ta 122.No "interrupt character" 123.It "is num unused input speed" 124.It "kl str" Ta So Li ^U Sc Ta 125.No "kill character" | 121.It "ig bool false ignore garbage characters in login name" 122.It "im str" Ta Dv NULL Ta 123.No "initial (banner) message" 124.It "in str" Ta So Li ^C Sc Ta 125.No "interrupt character" 126.It "is num unused input speed" 127.It "kl str" Ta So Li ^U Sc Ta 128.No "kill character" |
126.It "lc bool false terminal has lower case" | 129.It "l0 num unused tty local flags to write messages" 130.It "l1 num unused tty local flags to read login name" 131.It "l2 num unused tty local flags to leave terminal as" |
127.It "lm str login: login prompt" 128.It "ln str" Ta So Li ^V Sc Ta 129.No "``literal next'' character" 130.It "lo str" Ta Pa /usr/bin/login Ta 131.No "program to exec when name obtained" | 132.It "lm str login: login prompt" 133.It "ln str" Ta So Li ^V Sc Ta 134.No "``literal next'' character" 135.It "lo str" Ta Pa /usr/bin/login Ta 136.No "program to exec when name obtained" |
132.It "nd num 0 newline (line-feed) delay" | 137.It "mb bool false do flow control based on carrier" |
133.It "nl bool false terminal has (or might have) a newline character" | 138.It "nl bool false terminal has (or might have) a newline character" |
134.It "np bool false terminal uses no parity (8bit chars)" | 139.It "np bool false terminal uses no parity (i.e. 8-bit characters)" |
135.It "nx str default next table (for auto speed selection)" | 140.It "nx str default next table (for auto speed selection)" |
141.It "o0 num unused tty output flags to write messages" 142.It "o1 num unused tty output flags to read login name" 143.It "o2 num unused tty output flags to leave terminal as" |
|
136.It "op bool false terminal uses odd parity" 137.It "os num unused output speed" 138.It "pc str" Ta So Li \e0 Sc Ta 139.No "pad character" 140.It "pe bool false use printer (hard copy) erase algorithm" 141.It "pf num 0 delay" 142between first prompt and following flush (seconds) 143.It "ps bool false line connected to a" --- 9 unchanged lines hidden (view full) --- 153.It "sp num unused line speed (input and output)" 154.It "su str" Ta So Li ^Z Sc Ta 155.No "suspend character" 156.It "tc str none table continuation" 157.It "to num 0 timeout (seconds)" 158.It "tt str" Ta Dv NULL Ta 159.No "terminal type (for environment)" 160.It "ub bool false do unbuffered output (of prompts etc)" | 144.It "op bool false terminal uses odd parity" 145.It "os num unused output speed" 146.It "pc str" Ta So Li \e0 Sc Ta 147.No "pad character" 148.It "pe bool false use printer (hard copy) erase algorithm" 149.It "pf num 0 delay" 150between first prompt and following flush (seconds) 151.It "ps bool false line connected to a" --- 9 unchanged lines hidden (view full) --- 161.It "sp num unused line speed (input and output)" 162.It "su str" Ta So Li ^Z Sc Ta 163.No "suspend character" 164.It "tc str none table continuation" 165.It "to num 0 timeout (seconds)" 166.It "tt str" Ta Dv NULL Ta 167.No "terminal type (for environment)" 168.It "ub bool false do unbuffered output (of prompts etc)" |
161.It "uc bool false terminal is known upper case only" | |
162.It "we str" Ta So Li ^W Sc Ta 163.No "word erase character" | 169.It "we str" Ta So Li ^W Sc Ta 170.No "word erase character" |
164.It "xc bool false do | 171.It xc bool false do |
165.Tn NOT 166echo control chars as 167.Ql ^X 168.It "xf str" Ta So Li ^S Sc Ta Dv XOFF 169(stop output) character 170.It "xn str" Ta So Li ^Q Sc Ta Dv XON 171(start output) character | 172.Tn NOT 173echo control chars as 174.Ql ^X 175.It "xf str" Ta So Li ^S Sc Ta Dv XOFF 176(stop output) character 177.It "xn str" Ta So Li ^Q Sc Ta Dv XON 178(start output) character |
179.It "Lo str C the locale name used for \&%d in the banner message" |
|
172.El 173.Pp | 180.El 181.Pp |
182The following capabilities are no longer supported by getty(8): 183.Bl -column Namexx /usr/bin/login Default 184.It "bd num 0 backspace delay" 185.It "cb bool false use crt backspace mode" 186.It "cd num 0 carriage-return delay" 187.It "fd num 0 form-feed (vertical motion) delay" 188.It "lc bool false terminal has lower case" 189.It "nd num 0 newline (line-feed) delay" 190.It "uc bool false terminal is known upper case only" 191.El 192.Pp |
|
174If no line speed is specified, speed will not be altered 175from that which prevails when getty is entered. 176Specifying an input or output speed will override 177line speed for stated direction only. 178.Pp 179Terminal modes to be used for the output of the message, 180for input of the login name, 181and to leave the terminal set as upon completion, 182are derived from the boolean flags specified. 183If the derivation should prove inadequate, 184any (or all) of these three may be overridden 185with one of the | 193If no line speed is specified, speed will not be altered 194from that which prevails when getty is entered. 195Specifying an input or output speed will override 196line speed for stated direction only. 197.Pp 198Terminal modes to be used for the output of the message, 199for input of the login name, 200and to leave the terminal set as upon completion, 201are derived from the boolean flags specified. 202If the derivation should prove inadequate, 203any (or all) of these three may be overridden 204with one of the |
186.Em \&f0 , 187.Em \&f1 , | 205.Em \&c0 , 206.Em \&c1 , 207.Em \&c2 , 208.Em \&i0 , 209.Em \&i1 , 210.Em \&i2 , 211.Em \&l0 , 212.Em \&l1 , 213.Em \&l2 , 214.Em \&o0 , 215.Em \&o1 , |
188or | 216or |
189.Em \&f2 | 217.Em \&o2 |
190numeric specifications, which can be used to specify 191(usually in octal, with a leading '0') 192the exact values of the flags. | 218numeric specifications, which can be used to specify 219(usually in octal, with a leading '0') 220the exact values of the flags. |
193Local (new tty) flags are set in the top 16 bits 194of this (32 bit) value. | 221These flags correspond to the termios 222.Em c_cflag , 223.Em c_iflag , 224.Em c_lflag , 225and 226.Em c_oflag 227fields, respectively. Each these sets must be completely specified to be 228effective. 229The 230.Em \&f0 , 231.Em \&f1 , 232and 233.Em \&f2 234are excepted for backwards compatibility with a previous incarnation of 235the TTY sub-system. In these flags the bottom 16 bits of the (32 bits) 236value contain the sgttyb 237.Em sg_flags 238field, while the top 16 bits represent the local mode word. |
195.Pp 196Should | 239.Pp 240Should |
197.Xr getty | 241.Xr getty 8 |
198receive a null character 199(presumed to indicate a line break) 200it will restart using the table indicated by the 201.Em nx 202entry. If there is none, it will re-use its original table. 203.Pp 204Delays are specified in milliseconds, the nearest possible 205delay available in the tty driver will be used. --- 7 unchanged lines hidden (view full) --- 213of milliseconds of delay required (a la termcap). 214This delay is simulated by repeated use of the pad character 215.Em \&pc . 216.Pp 217The initial message, and login message, 218.Em \&im 219and 220.Em \&lm | 242receive a null character 243(presumed to indicate a line break) 244it will restart using the table indicated by the 245.Em nx 246entry. If there is none, it will re-use its original table. 247.Pp 248Delays are specified in milliseconds, the nearest possible 249delay available in the tty driver will be used. --- 7 unchanged lines hidden (view full) --- 257of milliseconds of delay required (a la termcap). 258This delay is simulated by repeated use of the pad character 259.Em \&pc . 260.Pp 261The initial message, and login message, 262.Em \&im 263and 264.Em \&lm |
221may include the character sequence 222.Em \&%h 223or 224.Em \&%t 225to obtain 226the hostname or tty name respectively. 227.Pf ( Em %% 228obtains a single '%' character.) 229The hostname is normally obtained from the system, 230but may be set by the | 265may include any of the following character sequences, which expand to 266information about the environment in which 267.Xr getty 8 268is running. 269.Pp 270.Bl -tag -width \&%xxx -compact 271.It \&%d 272The current date and time in the locale's representation as of the 273.Em \&Lo 274string 275(the \&%+ format of 276.Xr strftime 3 ). 277.It \&%h 278The hostname of the machine, which is normally obtained from the 279system using 280.Xr gethostname 2 , 281but may also be overridden by the |
231.Em \&hn 232table entry. | 282.Em \&hn 283table entry. |
233In either case it may be edited with 234.Em \&he . 235The | 284In either case it may be edited with the |
236.Em \&he | 285.Em \&he |
237string is a sequence of characters, each character that 238is neither '@' nor '#' is copied into the final hostname. | 286string. |
239A '@' in the 240.Em \&he | 287A '@' in the 288.Em \&he |
241string, causes one character from the real hostname to | 289string causes one character from the real hostname to |
242be copied to the final hostname. 243A '#' in the 244.Em \&he | 290be copied to the final hostname. 291A '#' in the 292.Em \&he |
245string, causes the next character of the real hostname | 293string causes the next character of the real hostname |
246to be skipped. | 294to be skipped. |
295Each character that 296is neither '@' nor '#' is copied into the final hostname. |
|
247Surplus '@' and '#' characters are ignored. | 297Surplus '@' and '#' characters are ignored. |
298.It \&%t 299The tty name. 300.It "\&%m, \&%r, \&%s, \&%v" 301The type of machine, release of the operating system, name of the 302operating system, and version of the kernel, respectively, as 303returned by 304.Xr uname 2 . 305.It \&%% 306A 307.Dq % 308character. 309.El |
|
248.Pp 249When getty execs the login process, given 250in the 251.Em \&lo 252string (usually 253.Dq Pa /usr/bin/login ) , 254it will have set 255the environment to include the terminal type, as indicated --- 9 unchanged lines hidden (view full) --- 265.Em name=value . 266.Pp 267If a non-zero timeout is specified, with 268.Em \&to , 269then getty will exit within the indicated 270number of seconds, either having 271received a login name and passed control 272to | 310.Pp 311When getty execs the login process, given 312in the 313.Em \&lo 314string (usually 315.Dq Pa /usr/bin/login ) , 316it will have set 317the environment to include the terminal type, as indicated --- 9 unchanged lines hidden (view full) --- 327.Em name=value . 328.Pp 329If a non-zero timeout is specified, with 330.Em \&to , 331then getty will exit within the indicated 332number of seconds, either having 333received a login name and passed control 334to |
273.Xr login , | 335.Xr login 1 , |
274or having received an alarm signal, and exited. 275This may be useful to hangup dial in lines. 276.Pp 277Output from | 336or having received an alarm signal, and exited. 337This may be useful to hangup dial in lines. 338.Pp 339Output from |
278.Xr getty | 340.Xr getty 8 |
279is even parity unless 280.Em \&op | 341is even parity unless 342.Em \&op |
343or 344.Em \&np |
|
281is specified. 282The 283.Em \&op 284string 285may be specified with 286.Em \&ap 287to allow any parity on input, but generate odd parity output. 288Note: this only applies while getty is being run, 289terminal driver limitations prevent a more complete 290implementation. | 345is specified. 346The 347.Em \&op 348string 349may be specified with 350.Em \&ap 351to allow any parity on input, but generate odd parity output. 352Note: this only applies while getty is being run, 353terminal driver limitations prevent a more complete 354implementation. |
291.Xr Getty | 355.Xr Getty 8 |
292does not check parity of input characters in 293.Dv RAW 294mode. 295.Sh SEE ALSO 296.Xr login 1 , | 356does not check parity of input characters in 357.Dv RAW 358mode. 359.Sh SEE ALSO 360.Xr login 1 , |
361.Xr gethostname 2 , 362.Xr uname 2 , |
|
297.Xr termcap 5 , 298.Xr getty 8 . 299.Sh BUGS 300The special characters (erase, kill, etc.) are reset to system defaults 301by 302.Xr login 1 . 303In 304.Em all --- 20 unchanged lines hidden --- | 363.Xr termcap 5 , 364.Xr getty 8 . 365.Sh BUGS 366The special characters (erase, kill, etc.) are reset to system defaults 367by 368.Xr login 1 . 369In 370.Em all --- 20 unchanged lines hidden --- |