|
|
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.