1GETTYTAB(5)                   File Formats Manual                  GETTYTAB(5)
2
3
4

NAME

6       gettytab - terminal configuration data base
7

SYNOPSIS

9       /etc/gettytab
10

DESCRIPTION

12       Gettytab  is  a  simplified version of the termcap(5) data base used to
13       describe terminal lines.  The initial terminal login  process  getty(8)
14       accesses the gettytab file each time it starts, allowing simpler recon‐
15       figuration of terminal characteristics.  Each entry in the data base is
16       used to describe one class of terminals.
17
18       There  is a default terminal class, default, that is used to set global
19       defaults for all other classes.  (That is, the default entry  is  read,
20       then  the  entry  for the class required is used to override particular
21       settings.)
22

CAPABILITIES

24       Refer to termcap(5) for a description of the file layout.  The  default
25       column  below lists defaults obtained if there is no entry in the table
26       obtained, nor one in the special default table.
27
28       Name   Type  Default        Description
29       ap     bool  false          terminal uses any parity
30       bk     str   0377           alternate end of line character (input break)
31       cb     bool  false          use crt backspace mode
32       ce     bool  false          use crt erase algorithm
33       ck     bool  false          use crt kill algorithm
34       cl     str   NULL           screen clear sequence
35       co     bool  false          console - add \n after login prompt
36       ds     str   ^Y             delayed suspend character
37       dx     bool  false          set DECCTLQ
38       ec     bool  false          leave echo OFF
39       ep     bool  false          terminal uses even parity
40       er     str   ^?             erase character
41       et     str   ^D             end of text (EOF) character
42       ev     str   NULL           initial enviroment
43       f0     num   unused         tty mode flags to write messages
44       f1     num   unused         tty mode flags to read login name
45       f2     num   unused         tty mode flags to leave terminal as
46       fl     str   ^O             output flush character
47       hc     bool  false          do NOT hangup line on last close
48       he     str   NULL           hostname editing string
49       hf     bool  false          enable hardware (rts/cts) flow control
50       hn     str   hostname       hostname
51       ht     bool  false          terminal has real tabs
52       ig     bool  false          ignore garbage characters in login name
53       im     str   NULL           initial (banner) message
54       in     str   ^C             interrupt character
55       is     num   unused         input speed
56       kl     str   ^U             kill character
57       lc     bool  false          terminal has lower case
58       lm     str   login:         login prompt
59       ln     str   ^V             ``literal next'' character
60       lo     str   /bin/login     program to exec when name obtained
61       nl     bool  false          terminal has (or might have) a newline character
62       nx     str   default        next table (for auto speed selection)
63       op     bool  false          terminal uses odd parity
64       os     num   unused         output speed
65       pc     str   \0             pad character
66       pe     bool  false          use printer (hard copy) erase algorithm
67       pf     num   0              delay between first prompt and following flush (seconds)
68       ps     bool  false          line connected to a MICOM port selector
69       qu     str   ^\             quit character
70       rp     str   ^R             line retype character
71       rw     bool  false          do NOT use raw for input, use cbreak
72       sp     num   unused         line speed (input and output)
73       su     str   ^Z             suspend character
74       tc     str   none           table continuation
75       to     num   0              timeout (seconds)
76       tt     str   NULL           terminal type (for enviroment)
77       ub     bool  false          do unbuffered output (of prompts etc)
78       we     str   ^W             word erase character
79       xc     bool  false          do NOT echo control chars as ^X
80       xf     str   ^S             XOFF (stop output) character
81       xn     str   ^Q             XON (start output) character
82
83       If no line speed is specified, speed will  not  be  altered  from  that
84       which  prevails  when  getty is entered.  Specifying an input or output
85       speed will override line speed for stated direction only.
86
87       Terminal modes to be used for the output of the message, for  input  of
88       the  login  name, and to leave the terminal set as upon completion, are
89       derived from the boolean flags specified.   If  the  derivation  should
90       prove inadequate, any (or all) of these three may be overriden with one
91       of the f0, f1, or f2 numeric specifications, which can be used to spec‐
92       ify  (usually  in  octal,  with  a leading '0') the exact values of the
93       flags.  Local (new tty) flags are set in the top 16 bits  of  this  (32
94       bit) value.
95
96       Should  getty  receive  a  null  character (presumed to indicate a line
97       break) it will restart using the table indicated by the  nx  entry.  If
98       there is none, it will re-use its original table.
99
100       The  cl  screen  clear  string may be preceded by a (decimal) number of
101       milliseconds of delay required (a la termcap).  This delay is simulated
102       by repeated use of the pad character pc.
103
104       The initial message, and login message, im and lm may include the char‐
105       acter sequence %h or %t to obtain the  hostname  or  tty  name  respec‐
106       tively.  (%% obtains a single '%' character.)  The hostname is normally
107       obtained from the system, but may be set by the  hn  table  entry.   In
108       either  case  it may be edited with he.  The he string is a sequence of
109       characters, each character that is neither '@' nor '#' is  copied  into
110       the  final hostname.  A '@' in the he string, causes one character from
111       the real hostname to be copied to the final hostname.  A '#' in the  he
112       string,  causes  the next character of the real hostname to be skipped.
113       Surplus '@' and '#' characters are ignored.
114
115       When getty execs the login process, given in  the  lo  string  (usually
116       "/bin/login"),  it will have set the enviroment to include the terminal
117       type, as indicated by the tt string (if it exists).  The ev string, can
118       be used to enter additional data into the environment.  It is a list of
119       comma separated strings, each of which will presumably be of  the  form
120       name=value.
121
122       If  a  non-zero  timeout  is  specified,  with to, then getty will exit
123       within the indicated number of seconds, either having received a  login
124       name  and  passed control to login, or having received an alarm signal,
125       and exited.  This may be useful to hangup dial in lines.
126
127       Output from getty is even parity unless op is  specified.   Op  may  be
128       specified with ap to allow any parity on input, but generate odd parity
129       output.  Note: this only applies while getty  is  being  run,  terminal
130       driver  limitations prevent a more complete implementation.  Getty does
131       not check parity of input characters in RAW mode.
132

SEE ALSO

134       login(1), termcap(5), getty(8).
135

BUGS

137       The special characters (erase, kill, etc.) are reset to system defaults
138       by  login(1).   In all cases, '#' or '^H' typed in a login name will be
139       treated as an erase character, and '@' will be treated as a kill  char‐
140       acter.
141
142       The  delay  stuff is a real crock.  It has been removed from the system
143       entirely.  The he capability is stupid.
144
145       Termcap format is horrid, something more rational should have been cho‐
146       sen.
147
148
149
1504.2 Berkeley Distribution       March 28, 1997                     GETTYTAB(5)
Impressum