Return to getty.8 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / libexec / getty

Annotation of 43BSDReno/libexec/getty/getty.8, revision 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)

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