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