Annotation of cci/usr/src/man/man5/gettytab.5, revision 1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.