Commit | Line | Data |
---|---|---|
dc704da8 KB |
1 | .\" Copyright (c) 1983 The Regents of the University of California. |
2 | .\" All rights reserved. | |
853a5afb | 3 | .\" |
dc704da8 KB |
4 | .\" %sccs.include.redist.man% |
5 | .\" | |
243f4d86 | 6 | .\" @(#)gettytab.5 6.6 (Berkeley) %G% |
853a5afb | 7 | .\" |
c523bb4a | 8 | .TH GETTYTAB 5 "" |
853a5afb KM |
9 | .UC 5 |
10 | .SH NAME | |
11 | gettytab \- terminal configuration data base | |
12 | .SH SYNOPSIS | |
13 | /etc/gettytab | |
14 | .SH DESCRIPTION | |
15 | .I Gettytab | |
16 | is a simplified version of the | |
17 | .IR termcap (5) | |
18 | data base | |
19 | used to describe terminal lines. | |
20 | The initial terminal login process | |
21 | .IR getty (8) | |
22 | accesses the | |
23 | .I gettytab | |
24 | file each time it starts, allowing simpler | |
25 | reconfiguration of terminal characteristics. | |
26 | Each entry in the data base | |
27 | is used to describe one class of terminals. | |
28 | .PP | |
29 | There is a default terminal class, | |
30 | .IR default , | |
31 | that is used to set global defaults for all other classes. | |
32 | (That is, the | |
33 | .I default | |
34 | entry is read, then the entry for the class required | |
35 | is used to override particular settings.) | |
36 | .SH CAPABILITIES | |
37 | Refer to | |
38 | .IR termcap (5) | |
39 | for a description of the file layout. | |
40 | The | |
41 | .I default | |
42 | column below lists defaults obtained if there is | |
43 | no entry in the table obtained, nor one in the special | |
44 | .I default | |
45 | table. | |
46 | .nf | |
47 | ||
858e9f7e | 48 | .ta \w'k0-k9 'u +\w'Type 'u +\w'``/usr/bin/login" 'u |
853a5afb KM |
49 | \fBName Type Default Description\fR |
50 | ap bool false terminal uses any parity | |
51 | bd num 0 backspace delay | |
52 | bk str 0377 alternate end of line character (input break) | |
53 | cb bool false use crt backspace mode | |
54 | cd num 0 carriage-return delay | |
55 | ce bool false use crt erase algorithm | |
56 | ck bool false use crt kill algorithm | |
57 | cl str NULL screen clear sequence | |
58 | co bool false console - add \\n after login prompt | |
59 | ds str ^Y delayed suspend character | |
60a81354 | 60 | dx bool false set DECCTLQ |
853a5afb KM |
61 | ec bool false leave echo \s-2OFF\s0 |
62 | ep bool false terminal uses even parity | |
63 | er str ^? erase character | |
64 | et str ^D end of text (\s-2EOF\s0) character | |
65 | ev str NULL initial enviroment | |
66 | f0 num unused tty mode flags to write messages | |
67 | f1 num unused tty mode flags to read login name | |
68 | f2 num unused tty mode flags to leave terminal as | |
69 | fd num 0 form-feed (vertical motion) delay | |
70 | fl str ^O output flush character | |
71 | hc bool false do \s-2NOT\s0 hangup line on last close | |
72 | he str NULL hostname editing string | |
73 | hn str hostname hostname | |
74 | ht bool false terminal has real tabs | |
75 | ig bool false ignore garbage characters in login name | |
76 | im str NULL initial (banner) message | |
77 | in str ^C interrupt character | |
78 | is num unused input speed | |
79 | kl str ^U kill character | |
80 | lc bool false terminal has lower case | |
81 | lm str login: login prompt | |
82 | ln str ^V ``literal next'' character | |
858e9f7e | 83 | lo str /usr/bin/login program to exec when name obtained |
853a5afb KM |
84 | nd num 0 newline (line-feed) delay |
85 | nl bool false terminal has (or might have) a newline character | |
243f4d86 | 86 | np bool false terminal uses all 8 bits for display, thus no parity |
853a5afb KM |
87 | nx str default next table (for auto speed selection) |
88 | op bool false terminal uses odd parity | |
89 | os num unused output speed | |
90 | pc str \\0 pad character | |
91 | pe bool false use printer (hard copy) erase algorithm | |
92 | pf num 0 delay between first prompt and following flush (seconds) | |
93 | ps bool false line connected to a MICOM port selector | |
94 | qu str ^\\ quit character | |
95 | rp str ^R line retype character | |
96 | rw bool false do \s-2NOT\s0 use raw for input, use cbreak | |
97 | sp num unused line speed (input and output) | |
98 | su str ^Z suspend character | |
99 | tc str none table continuation | |
100 | to num 0 timeout (seconds) | |
101 | tt str NULL terminal type (for enviroment) | |
102 | ub bool false do unbuffered output (of prompts etc) | |
103 | uc bool false terminal is known upper case only | |
104 | we str ^W word erase character | |
105 | xc bool false do \s-2NOT\s0 echo control chars as ^X | |
106 | xf str ^S XOFF (stop output) character | |
107 | xn str ^Q XON (start output) character | |
108 | .br | |
109 | .fi | |
110 | .PP | |
111 | If no line speed is specified, speed will not be altered | |
112 | from that which prevails when getty is entered. | |
113 | Specifying an input or output speed will override | |
114 | line speed for stated direction only. | |
115 | .PP | |
116 | Terminal modes to be used for the output of the message, | |
117 | for input of the login name, | |
118 | and to leave the terminal set as upon completion, | |
119 | are derived from the boolean flags specified. | |
120 | If the derivation should prove inadequate, | |
121 | any (or all) of these three may be overriden | |
122 | with one of the | |
123 | .BR f0 , | |
124 | .BR f1 ", or" | |
125 | .B f2 | |
126 | numeric specifications, which can be used to specify | |
127 | (usually in octal, with a leading '0') | |
128 | the exact values of the flags. | |
129 | Local (new tty) flags are set in the top 16 bits | |
130 | of this (32 bit) value. | |
131 | .PP | |
132 | Should | |
133 | .I getty | |
134 | receive a null character | |
135 | (presumed to indicate a line break) | |
136 | it will restart using the table indicated by the | |
137 | .B nx | |
138 | entry. If there is none, it will re-use its original table. | |
139 | .PP | |
140 | Delays are specified in milliseconds, the nearest possible | |
141 | delay available in the tty driver will be used. | |
142 | Should greater certainty be desired, delays | |
143 | with values 0, 1, 2, and 3 are interpreted as | |
144 | choosing that particular delay algorithm from the driver. | |
145 | .PP | |
146 | The | |
147 | .B cl | |
148 | screen clear string may be preceded by a (decimal) number | |
149 | of milliseconds of delay required (a la termcap). | |
150 | This delay is simulated by repeated use of the pad character | |
151 | .BR pc . | |
152 | .PP | |
153 | The initial message, and login message, | |
154 | .B im | |
155 | and | |
156 | .B lm | |
c523bb4a KM |
157 | may include the character sequence \fB%h\fP or \fB%t\fP to obtain |
158 | the hostname or tty name respectively. | |
159 | (\fB%%\fP obtains a single '%' character.) | |
853a5afb KM |
160 | The hostname is normally obtained from the system, |
161 | but may be set by the | |
162 | .B hn | |
163 | table entry. | |
164 | In either case it may be edited with | |
165 | .BR he . | |
166 | The | |
167 | .B he | |
168 | string is a sequence of characters, each character that | |
169 | is neither '@' nor '#' is copied into the final hostname. | |
170 | A '@' in the | |
171 | .B he | |
172 | string, causes one character from the real hostname to | |
173 | be copied to the final hostname. | |
174 | A '#' in the | |
175 | .B he | |
176 | string, causes the next character of the real hostname | |
177 | to be skipped. | |
178 | Surplus '@' and '#' characters are ignored. | |
179 | .PP | |
180 | When getty execs the login process, given | |
181 | in the | |
182 | .B lo | |
858e9f7e | 183 | string (usually "/usr/bin/login"), it will have set |
853a5afb KM |
184 | the enviroment to include the terminal type, as indicated |
185 | by the | |
186 | .B tt | |
187 | string (if it exists). | |
188 | The | |
189 | .B ev | |
190 | string, can be used to enter additional data into | |
191 | the environment. | |
192 | It is a list of comma separated strings, each of which | |
193 | will presumably be of the form | |
194 | .IR name=value . | |
195 | .PP | |
196 | If a non-zero timeout is specified, with | |
197 | .BR to , | |
198 | then getty will exit within the indicated | |
199 | number of seconds, either having | |
200 | received a login name and passed control | |
201 | to | |
202 | .IR login , | |
203 | or having received an alarm signal, and exited. | |
204 | This may be useful to hangup dial in lines. | |
205 | .PP | |
206 | Output from | |
207 | .I getty | |
208 | is even parity unless | |
209 | .B op | |
210 | is specified. | |
211 | .B Op | |
212 | may be specified with | |
213 | .B ap | |
214 | to allow any parity on input, but generate odd parity output. | |
215 | Note: this only applies while getty is being run, | |
216 | terminal driver limitations prevent a more complete | |
217 | implementation. | |
243f4d86 WN |
218 | For terminals that use the full eight bit for character set (like the |
219 | IBM PC console and DEC VT 220 terminals), | |
220 | .B np | |
221 | may be specified to provide no parity on output, which superceeds the | |
222 | above mentioned parity options. | |
853a5afb KM |
223 | .I Getty |
224 | does not check parity of input characters in | |
225 | .I RAW | |
226 | mode. | |
227 | .SH "SEE ALSO" | |
d317681e | 228 | login(1), |
853a5afb KM |
229 | termcap(5), |
230 | getty(8). | |
231 | .SH BUGS | |
d317681e MK |
232 | The special characters (erase, kill, etc.) are reset to system defaults |
233 | by | |
234 | .IR login (1). | |
853a5afb KM |
235 | In |
236 | .B all | |
237 | cases, '#' or '^H' typed in a login name will be treated as | |
238 | an erase character, and '@' will be treated as a kill character. | |
239 | .PP | |
240 | The delay stuff is a real crock. | |
241 | Apart form its general lack of flexibility, some | |
242 | of the delay algorithms are not implemented. | |
243 | The terminal driver should support sane delay settings. | |
244 | .PP | |
853a5afb KM |
245 | The |
246 | .B he | |
247 | capability is stupid. | |
248 | .PP | |
249 | .I Termcap | |
250 | format is horrid, something more rational should | |
251 | have been chosen. |