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