Annotation of 43BSDReno/libexec/getty/getty.8, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)getty.8     6.5 (Berkeley) 11/17/87
                      6: .\"
                      7: .TH GETTY 8  "November 17, 1987"
                      8: .UC 4
                      9: .SH NAME
                     10: getty  \- set terminal mode
                     11: .SH SYNOPSIS
                     12: .B /etc/getty
                     13: [ type [ tty ] ]
                     14: .SH DESCRIPTION
                     15: .I Getty
                     16: is usually invoked by
                     17: .IR  init (8)
                     18: to open and initialize the tty line, read a login name, and invoke
                     19: .IR login (1).
                     20: .I getty
                     21: attempts to adapt the system to the speed and type of terminal
                     22: being used.
                     23: .PP
                     24: The argument
                     25: .I tty
                     26: is the special device file in /dev to open for the terminal (e.g., ``ttyh0'').
                     27: If there is no argument or the argument is
                     28: ``\-'', the tty line is assumed to be open as file descriptor 0.
                     29: .PP
                     30: The
                     31: .I type
                     32: argument can be used to make
                     33: .I getty
                     34: treat the terminal line specially.
                     35: This argument is used as an index into the
                     36: .IR gettytab (5)
                     37: database, to determine the characteristics of the line.
                     38: If there is no argument, or there is no such table, the
                     39: .B default
                     40: table is used.
                     41: If there is no
                     42: .B /etc/gettytab
                     43: a set of system defaults is used.
                     44: If indicated by the table located,
                     45: .I getty
                     46: will clear the terminal screen,
                     47: print a banner heading,
                     48: and prompt for a login name.
                     49: Usually either the banner or the login prompt will include
                     50: the system hostname.
                     51: Then the user's name is read, a character at a time.
                     52: If a null character is received, it is assumed to be the result
                     53: of the user pushing the `break' (`interrupt') key.
                     54: The speed is usually then
                     55: changed and the `login:' is typed again;
                     56: a second `break' changes the speed again and the `login:'
                     57: is typed once more.
                     58: Successive `break' characters cycle through the
                     59: same standard set of speeds.
                     60: .PP
                     61: The user's name is terminated by a new-line or
                     62: carriage-return character.
                     63: The latter results in the system being set to
                     64: treat carriage returns appropriately (see
                     65: .IR  tty (4)).
                     66: .PP
                     67: The user's name is scanned to see if
                     68: it contains any lower-case alphabetic characters; if not,
                     69: and if the name is nonempty, the
                     70: system is told to map any future upper-case characters
                     71: into the corresponding lower-case characters.
                     72: .PP
                     73: Finally,
                     74: .I login
                     75: is called with the user's name as an argument.
                     76: .PP
                     77: Most of the default actions of
                     78: .I getty
                     79: can be circumvented, or modified, by a suitable
                     80: .I gettytab
                     81: table.
                     82: .PP
                     83: .I Getty
                     84: can be set to timeout after some interval,
                     85: which will cause dial up lines to hang up
                     86: if the login name is not entered reasonably quickly.
                     87: .SH DIAGNOSTICS
                     88: \fIttyxx\fR\|\fB: No such device or address\fR.
                     89: \fIttyxx\fR\|\fB: No such file or address\fR.
                     90: A terminal which is turned
                     91: on in the \fIttys\fR file cannot be opened, likely because the requisite
                     92: lines are either not configured into the system, the associated device
                     93: was not attached during boot-time system configuration,
                     94: or the special file in /dev does not exist.
                     95: .SH FILES
                     96: /etc/gettytab
                     97: .SH "SEE ALSO"
                     98: gettytab(5), init(8), login(1), ioctl(2), tty(4), ttys(5)

unix.superglobalmegacorp.com

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