1*48706Scael.\" Copyright (c) 1980, 1991 Regents of the University of California. 2*48706Scael.\" All rights reserved. 318874Smckusick.\" 4*48706Scael.\" %sccs.include.redist.roff% 518874Smckusick.\" 6*48706Scael.\" @(#)getty.8 6.6 (Berkeley) 04/25/91 7*48706Scael.\" 8*48706Scael.Dd 9*48706Scael.Dt GETTY 8 10*48706Scael.Os BSD 4 11*48706Scael.Sh NAME 12*48706Scael.Nm getty 13*48706Scael.Nd set terminal mode 14*48706Scael.Sh SYNOPSIS 15*48706Scael.Nm getty 16*48706Scael.Oo 17*48706Scael.Ar type 18*48706Scael.Op Ar tty 19*48706Scael.Oc 20*48706Scael.Sh DESCRIPTION 21*48706ScaelThe 22*48706Scael.Nm getty 23*48706Scaelprogram 24*48706Scaelis called by 25*48706Scael.Xr init 8 2628301Skarelsto open and initialize the tty line, read a login name, and invoke 27*48706Scael.Xr login 1 . 28*48706Scael.Pp 2918876SmckusickThe argument 30*48706Scael.Ar tty 31*48706Scaelis the special device file in 32*48706Scael.Pa /dev 33*48706Scaelto open for the terminal (for example, ``ttyh0''). 3418876SmckusickIf there is no argument or the argument is 35*48706Scael.Ql Fl , 36*48706Scaelthe tty line is assumed to be open as file descriptor 0. 37*48706Scael.Pp 3818876SmckusickThe 39*48706Scael.Ar type 4018876Smckusickargument can be used to make 41*48706Scael.Nm getty 4218876Smckusicktreat the terminal line specially. 4318875SmckusickThis argument is used as an index into the 44*48706Scael.Nm gettytab 5 4518875Smckusickdatabase, to determine the characteristics of the line. 4618875SmckusickIf there is no argument, or there is no such table, the 47*48706Scael.Em default 4818875Smckusicktable is used. 4918875SmckusickIf there is no 50*48706Scael.Pa /etc/gettytab 5118875Smckusicka set of system defaults is used. 5218875SmckusickIf indicated by the table located, 53*48706Scael.Nm getty 5418875Smckusickwill clear the terminal screen, 5518875Smckusickprint a banner heading, 5618875Smckusickand prompt for a login name. 5732626SbosticUsually either the banner or the login prompt will include 5818875Smckusickthe system hostname. 59*48706Scael.Pp 6018875SmckusickMost of the default actions of 61*48706Scael.Nm getty 6218875Smckusickcan be circumvented, or modified, by a suitable 63*48706Scael.Nm gettytab 6418875Smckusicktable. 65*48706Scael.Pp 66*48706ScaelThe 67*48706Scael.Nm getty 68*48706Scaelprogram 6918875Smckusickcan be set to timeout after some interval, 7018875Smckusickwhich will cause dial up lines to hang up 7118875Smckusickif the login name is not entered reasonably quickly. 72*48706Scael.Sh DIAGNOSTICS 73*48706Scael.Bl -diag 74*48706Scael.It "ttyxx: No such device or address." 75*48706Scael.It "ttyxx: No such file or address." 7628561SkarelsA terminal which is turned 77*48706Scaelon in the 78*48706Scael.Xr ttys 79*48706Scaelfile cannot be opened, likely because the requisite 8028561Skarelslines are either not configured into the system, the associated device 8128561Skarelswas not attached during boot-time system configuration, 82*48706Scaelor the special file in 83*48706Scael.Pa /dev 84*48706Scaeldoes not exist. 85*48706Scael.El 86*48706Scael.Sh FILES 87*48706Scael.Bl -tag -width /etc/gettytab -compact 88*48706Scael.It Pa /etc/gettytab 89*48706Scael.El 90*48706Scael.Sh SEE ALSO 91*48706Scael.Xr gettytab 5 , 92*48706Scael.Xr init 8 , 93*48706Scael.Xr login 1 , 94*48706Scael.Xr ioctl 2 , 95*48706Scael.Xr tty 4 , 96*48706Scael.Xr ttys 5 97*48706Scael.Sh HISTORY 98*48706ScaelA 99*48706Scael.Nm getty 100*48706Scaelprogram appeared in 101*48706Scael.At v6 . 102