Commit | Line | Data |
---|---|---|
3888ba97 KM |
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 | .\" | |
63c183b7 | 5 | .\" @(#)getty.8 6.4 (Berkeley) %G% |
3888ba97 | 6 | .\" |
3c4b8728 | 7 | .TH GETTY 8 "" |
3888ba97 KM |
8 | .UC 4 |
9 | .SH NAME | |
10 | getty \- set terminal mode | |
11 | .SH SYNOPSIS | |
12 | .B /etc/getty | |
3f890bb2 | 13 | [ type [ tty ] ] |
3888ba97 KM |
14 | .SH DESCRIPTION |
15 | .I Getty | |
3c4b8728 | 16 | is usually invoked by |
3888ba97 | 17 | .IR init (8) |
3f890bb2 | 18 | to open and initialize the tty line, read a login name, and invoke |
3c4b8728 | 19 | .IR login (1). |
3888ba97 KM |
20 | .I getty |
21 | attempts to adapt the system to the speed and type of terminal | |
22 | being used. | |
23 | .PP | |
3c4b8728 KM |
24 | The argument |
25 | .I tty | |
63c183b7 | 26 | is the special device file in /dev to open for the terminal (e.g., ``ttyh0''). |
3c4b8728 | 27 | If there is no argument or the argument is |
63c183b7 | 28 | ``\-'', the tty line is assumed to be open as file descriptor 0. |
3c4b8728 KM |
29 | .PP |
30 | The | |
31 | .I type | |
32 | argument can be used to make | |
3888ba97 | 33 | .I getty |
3c4b8728 | 34 | treat the terminal line specially. |
47fb95a0 KM |
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 of the login prompt will include | |
50 | the system hostname. | |
3888ba97 KM |
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. | |
47fb95a0 KM |
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 | |
19ecbc2b | 59 | same standard set of speeds. |
3888ba97 KM |
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 | |
47fb95a0 | 65 | .IR tty (4)). |
3888ba97 KM |
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 | |
3c4b8728 KM |
73 | Finally, |
74 | .I login | |
75 | is called with the user's name as an argument. | |
47fb95a0 KM |
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. | |
63c183b7 MK |
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. | |
47fb95a0 KM |
95 | .SH FILES |
96 | /etc/gettytab | |
3888ba97 | 97 | .SH "SEE ALSO" |
3f890bb2 | 98 | gettytab(5), init(8), login(1), ioctl(2), tty(4), ttys(5) |