GETTYTAB(5)	    UNIX Programmer's Manual	      GETTYTAB(5)


NAME
     gettytab - terminal configuration data base

SYNOPSIS
     /etc/gettytab

DESCRIPTION
     Gettytab is a simplified version of the termcap(5) data base
     used to describe terminal lines.  The initial terminal login
     process getty(8) accesses the gettytab file each time it
     starts, allowing simpler reconfiguration of terminal charac-
     teristics.  Each entry in the data base is used to describe
     one class of terminals.

     There is a default terminal class, default, that is used to
     set global defaults for all other classes.  (That is, the
     default entry is read, then the entry for the class required
     is used to override particular settings.)

CAPABILITIES
     Refer to termcap(5) for a description of the file layout.
     The default column below lists defaults obtained if there is
     no entry in the table obtained, nor one in the special
     default table.

     Name   Type  Default	 Description
     ap     bool  false          terminal uses any parity
     bk     str   0377		 alternate end of line character (input break)
     cb     bool  false          use crt backspace mode
     ce     bool  false          use crt erase algorithm
     ck     bool  false          use crt kill algorithm
     cl     str   NULL		 screen clear sequence
     co     bool  false          console - add \n after login prompt
     ds     str   ^Y		 delayed suspend character
     dx     bool  false          set DECCTLQ
     ec     bool  false          leave echo OFF
     ep     bool  false          terminal uses even parity
     er     str   ^?		 erase character
     et     str   ^D		 end of text (EOF) character
     ev     str   NULL		 initial enviroment
     f0     num   unused	 tty mode flags to write messages
     f1     num   unused	 tty mode flags to read login name
     f2     num   unused	 tty mode flags to leave terminal as
     fl     str   ^O		 output flush character
     hc     bool  false          do NOT hangup line on last close
     he     str   NULL		 hostname editing string
     hf     bool  false          enable hardware (rts/cts) flow control
     hn     str   hostname	 hostname
     ht     bool  false          terminal has real tabs
     ig     bool  false          ignore garbage characters in login name
     im     str   NULL		 initial (banner) message
     in     str   ^C		 interrupt character


Printed 11/26/99	 March 28, 1997                         1


GETTYTAB(5)	    UNIX Programmer's Manual	      GETTYTAB(5)


     is     num   unused	 input speed
     kl     str   ^U		 kill character
     lc     bool  false          terminal has lower case
     lm     str   login:	 login prompt
     ln     str   ^V		 ``literal next'' character
     lo     str   /bin/login	 program to exec when name obtained
     nl     bool  false          terminal has (or might have) a newline character
     nx     str   default	 next table (for auto speed selection)
     op     bool  false          terminal uses odd parity
     os     num   unused	 output speed
     pc     str   \0		 pad character
     pe     bool  false          use printer (hard copy) erase algorithm
     pf     num   0		 delay between first prompt and following flush (seconds)
     ps     bool  false          line connected to a MICOM port selector
     qu     str   ^\		 quit character
     rp     str   ^R		 line retype character
     rw     bool  false          do NOT use raw for input, use cbreak
     sp     num   unused	 line speed (input and output)
     su     str   ^Z		 suspend character
     tc     str   none		 table continuation
     to     num   0		 timeout (seconds)
     tt     str   NULL		 terminal type (for enviroment)
     ub     bool  false          do unbuffered output (of prompts etc)
     we     str   ^W		 word erase character
     xc     bool  false          do NOT echo control chars as ^X
     xf     str   ^S		 XOFF (stop output) character
     xn     str   ^Q		 XON (start output) character

     If no line speed is specified, speed will not be altered
     from that which prevails when getty is entered.  Specifying
     an input or output speed will override line speed for stated
     direction only.

     Terminal modes to be used for the output of the message, for
     input of the login name, and to leave the terminal set as
     upon completion, are derived from the boolean flags speci-
     fied.  If the derivation should prove inadequate, any (or
     all) of these three may be overriden with one of the f0, f1,
     or f2 numeric specifications, which can be used to specify
     (usually in octal, with a leading '0') the exact values of
     the flags.  Local (new tty) flags are set in the top 16 bits
     of this (32 bit) value.

     Should getty receive a null character (presumed to indicate
     a line break) it will restart using the table indicated by
     the nx entry. If there is none, it will re-use its original
     table.

     The cl screen clear string may be preceded by a (decimal)
     number of milliseconds of delay required (a la termcap).
     This delay is simulated by repeated use of the pad character
     pc.


Printed 11/26/99	 March 28, 1997                         2


GETTYTAB(5)	    UNIX Programmer's Manual	      GETTYTAB(5)


     The initial message, and login message, im and lm may
     include the character sequence %h or %t to obtain the host-
     name or tty name respectively.  (%% obtains a single '%'
     character.) The hostname is normally obtained from the sys-
     tem, but may be set by the hn table entry.  In either case
     it may be edited with he.	The he string is a sequence of
     characters, each character that is neither '@' nor '#' is
     copied into the final hostname.  A '@' in the he string,
     causes one character from the real hostname to be copied to
     the final hostname.  A '#' in the he string, causes the next
     character of the real hostname to be skipped.  Surplus '@'
     and '#' characters are ignored.

     When getty execs the login process, given in the lo string
     (usually "/bin/login"), it will have set the enviroment to
     include the terminal type, as indicated by the tt string (if
     it exists).  The ev string, can be used to enter additional
     data into the environment.  It is a list of comma separated
     strings, each of which will presumably be of the form
     name=value.

     If a non-zero timeout is specified, with to, then getty will
     exit within the indicated number of seconds, either having
     received a login name and passed control to login, or having
     received an alarm signal, and exited.  This may be useful to
     hangup dial in lines.

     Output from getty is even parity unless op is specified.  Op
     may be specified with ap to allow any parity on input, but
     generate odd parity output.  Note: this only applies while
     getty is being run, terminal driver limitations prevent a
     more complete implementation.  Getty does not check parity
     of input characters in RAW mode.

SEE ALSO
     login(1), termcap(5), getty(8).

BUGS
     The special characters (erase, kill, etc.) are reset to sys-
     tem defaults by login(1).	In all cases, '#' or '^H' typed
     in a login name will be treated as an erase character, and
     '@' will be treated as a kill character.

     The delay stuff is a real crock.  It has been removed from
     the system entirely.  The he capability is stupid.

     Termcap format is horrid, something more rational should
     have been chosen.


Printed 11/26/99	 March 28, 1997                         3


 
Generated: 2016-12-26
Generated by man2html V0.25
page hit count: 1403
Valid CSS Valid XHTML 1.0 Strict