1*61429Sbostic.\" Copyright (c) 1980, 1991, 1993 2*61429Sbostic.\" The Regents of the University of California. All rights reserved. 318874Smckusick.\" 448706Scael.\" %sccs.include.redist.roff% 518874Smckusick.\" 6*61429Sbostic.\" @(#)getty.8 8.1 (Berkeley) 06/04/93 748706Scael.\" 848706Scael.Dd 948706Scael.Dt GETTY 8 1048706Scael.Os BSD 4 1148706Scael.Sh NAME 1248706Scael.Nm getty 1348706Scael.Nd set terminal mode 1448706Scael.Sh SYNOPSIS 1548706Scael.Nm getty 1648706Scael.Oo 1748706Scael.Ar type 1848706Scael.Op Ar tty 1948706Scael.Oc 2048706Scael.Sh DESCRIPTION 2148706ScaelThe 2248706Scael.Nm getty 2348706Scaelprogram 2448706Scaelis called by 2548706Scael.Xr init 8 2628301Skarelsto open and initialize the tty line, read a login name, and invoke 2748706Scael.Xr login 1 . 2848706Scael.Pp 2918876SmckusickThe argument 3048706Scael.Ar tty 3148706Scaelis the special device file in 3248706Scael.Pa /dev 3348706Scaelto open for the terminal (for example, ``ttyh0''). 3418876SmckusickIf there is no argument or the argument is 3548706Scael.Ql Fl , 3648706Scaelthe tty line is assumed to be open as file descriptor 0. 3748706Scael.Pp 3818876SmckusickThe 3948706Scael.Ar type 4018876Smckusickargument can be used to make 4148706Scael.Nm getty 4218876Smckusicktreat the terminal line specially. 4318875SmckusickThis argument is used as an index into the 4448706Scael.Nm gettytab 5 4518875Smckusickdatabase, to determine the characteristics of the line. 4618875SmckusickIf there is no argument, or there is no such table, the 4748706Scael.Em default 4818875Smckusicktable is used. 4918875SmckusickIf there is no 5048706Scael.Pa /etc/gettytab 5118875Smckusicka set of system defaults is used. 5218875SmckusickIf indicated by the table located, 5348706Scael.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. 5948706Scael.Pp 6018875SmckusickMost of the default actions of 6148706Scael.Nm getty 6218875Smckusickcan be circumvented, or modified, by a suitable 6348706Scael.Nm gettytab 6418875Smckusicktable. 6548706Scael.Pp 6648706ScaelThe 6748706Scael.Nm getty 6848706Scaelprogram 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. 7248706Scael.Sh DIAGNOSTICS 7348706Scael.Bl -diag 7448706Scael.It "ttyxx: No such device or address." 7548706Scael.It "ttyxx: No such file or address." 7628561SkarelsA terminal which is turned 7748706Scaelon in the 7848706Scael.Xr ttys 7948706Scaelfile 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, 8248706Scaelor the special file in 8348706Scael.Pa /dev 8448706Scaeldoes not exist. 8548706Scael.El 8648706Scael.Sh FILES 8748706Scael.Bl -tag -width /etc/gettytab -compact 8848706Scael.It Pa /etc/gettytab 8948706Scael.El 9048706Scael.Sh SEE ALSO 9148706Scael.Xr gettytab 5 , 9248706Scael.Xr init 8 , 9348706Scael.Xr login 1 , 9448706Scael.Xr ioctl 2 , 9548706Scael.Xr tty 4 , 9648706Scael.Xr ttys 5 9748706Scael.Sh HISTORY 9848706ScaelA 9948706Scael.Nm getty 10048706Scaelprogram appeared in 10148706Scael.At v6 . 102