xref: /csrg-svn/libexec/getty/ttys.5 (revision 61431)
1*61431Sbostic.\" Copyright (c) 1985, 1991, 1993
2*61431Sbostic.\"	The Regents of the University of California.  All rights reserved.
320785Smckusick.\"
449083Scael.\" %sccs.include.redist.roff%
539177Sbostic.\"
6*61431Sbostic.\"     @(#)ttys.5	8.1 (Berkeley) 06/04/93
739177Sbostic.\"
849083Scael.Dd
949083Scael.Dt TTYS 5
1049083Scael.Os
1149083Scael.Sh NAME
1249083Scael.Nm ttys
1349083Scael.Nd terminal initialization information
1449083Scael.Sh DESCRIPTION
1549083ScaelThe file
1649083Scael.Nm ttys
1749083Scaelcontains information that is used by various routines to initialize
1839177Sbosticand control the use of terminal special files.
1939177SbosticThis information is read with the
2049083Scael.Xr getttyent 3
2120787Smckusicklibrary routines.
2220786SmckusickThere is one line in the
2349083Scael.Nm ttys
2449083Scaelfile per special device file.
2520787SmckusickFields are separated by tabs and/or spaces.
2639177SbosticFields comprised of more than one word should be enclosed in double
2739177Sbosticquotes (``"'').
2839177SbosticBlank lines and comments may appear anywhere in the file; comments
2939177Sbosticare delimited by hash marks (``#'') and new lines.
3039177SbosticAny unspecified fields will default to null.
3149083Scael.Pp
3249083ScaelThe first field is the
3349083Scaelname of the terminal special file as it is found in
3449083Scael.Pa /dev .
3549083Scael.Pp
3620787SmckusickThe second field of the file is the command to execute for the line,
3749083Scaelusually
3849083Scael.Xr getty 8 ,
3949083Scaelwhich initializes and opens the line, setting the speed, waiting for
4049083Scaela user name and executing the
4149083Scael.Xr login 1
4249083Scaelprogram.
4328314SkarelsIt can be, however, any desired command, for example
4428265Slepreauthe start up for a window system terminal emulator or some other
4528267Slepreaudaemon process, and can contain multiple words if quoted.
4649083Scael.Pp
4739177SbosticThe third field is the type of terminal usually connected to that
4839177Sbostictty line, normally the one found in the
4949083Scael.Xr termcap 5
5020787Smckusickdata base file.
5149083ScaelThe environment variable
5249083Scael.Dv TERM
5349083Scaelis initialized with the value by
5439177Sbosticeither
5549083Scael.Xr getty 8
5639177Sbosticor
5749083Scael.Xr login 1 .
5849083Scael.Pp
5928265SlepreauThe remaining fields set flags in the
6049083Scael.Fa ty_status
6120787Smckusickentry (see
6249083Scael.Xr getttyent 3 )
6328265Slepreauor specify a window system process that
6449083Scael.Xr init 8
6520787Smckusickwill maintain for the terminal line.
6649083Scael.Pp
6739177SbosticAs flag values, the strings ``on'' and ``off'' specify that
6849083Scael.Xr init
6939177Sbosticshould (should not) execute the command given in the second field,
7039177Sbosticwhile ``secure'' (if ``on'' is also specified) allows users with a
7139177Sbosticuid of 0 to login on
7239177Sbosticthis line.
7339177SbosticThese flag fields should not be quoted.
7449083Scael.Pp
7539177SbosticThe string ``window='' may be followed by a quoted command
7628265Slepreaustring which
7749083Scael.Xr init
7839177Sbosticwill execute
7949083Scael.Em before
8039177Sbosticstarting the command specified by the second field.
8149083Scael.Sh EXAMPLES
8249083Scael.Bd -literal
8339177Sbostic# root login on console at 1200 baud
8443524Strentconsole	"/usr/libexec/getty std.1200"	vt100	on secure
8539177Sbostic# dialup at 1200 baud, no root logins
8643524Strentttyd0	"/usr/libexec/getty d1200"	dialup	on	# 555-1234
8739177Sbostic# Mike's terminal: hp2621
8843524Strentttyh0	"/usr/libexec/getty std.9600"	hp2621-nl	on	# 457 Evans
8939177Sbostic# John's terminal: vt100
9043524Strentttyh1	"/usr/libexec/getty std.9600"	vt100	on		# 459 Evans
9139177Sbostic# terminal emulate/window system
9243524Strentttyv0	"/usr/new/xterm -L :0"		vs100	on window="/usr/new/Xvs100 0"
9339177Sbostic# Network pseudo ttys -- don't enable getty
9428314Skarelsttyp0	none	network
9528314Skarelsttyp1	none	network	off
9649083Scael.Ed
9749083Scael.Sh FILES
9849083Scael.Bl -tag -width /etc/ttys -compact
9949083Scael.It Pa /etc/ttys
10049083Scael.El
10149083Scael.Sh SEE ALSO
10249083Scael.Xr login 1 ,
10349083Scael.Xr getttyent 3 ,
10449083Scael.Xr ttyslot 3 ,
10549083Scael.Xr gettytab 5 ,
10649083Scael.Xr termcap 5 ,
10749083Scael.Xr getty 8 ,
10849083Scael.Xr init 8
10949083Scael.Sh HISTORY
11049083ScaelA
11149083Scael.Nm
11249083Scaelfile appeared in
11349083Scael.At v6 .
114