xref: /csrg-svn/libexec/getty/ttys.5 (revision 49083)
1*49083Scael.\" Copyright (c) 1985, 1991 The Regents of the University of California.
239177Sbostic.\" All rights reserved.
320785Smckusick.\"
4*49083Scael.\" %sccs.include.redist.roff%
539177Sbostic.\"
6*49083Scael.\"     @(#)ttys.5	6.8 (Berkeley) 05/04/91
739177Sbostic.\"
8*49083Scael.Dd
9*49083Scael.Dt TTYS 5
10*49083Scael.Os
11*49083Scael.Sh NAME
12*49083Scael.Nm ttys
13*49083Scael.Nd terminal initialization information
14*49083Scael.Sh DESCRIPTION
15*49083ScaelThe file
16*49083Scael.Nm ttys
17*49083Scaelcontains information that is used by various routines to initialize
1839177Sbosticand control the use of terminal special files.
1939177SbosticThis information is read with the
20*49083Scael.Xr getttyent 3
2120787Smckusicklibrary routines.
22*49083ScaelThe
2320786SmckusickThere is one line in the
24*49083Scael.Nm ttys
25*49083Scaelfile per special device file.
2620787SmckusickFields are separated by tabs and/or spaces.
2739177SbosticFields comprised of more than one word should be enclosed in double
2839177Sbosticquotes (``"'').
2939177SbosticBlank lines and comments may appear anywhere in the file; comments
3039177Sbosticare delimited by hash marks (``#'') and new lines.
3139177SbosticAny unspecified fields will default to null.
32*49083Scael.Pp
33*49083ScaelThe first field is the
34*49083Scaelname of the terminal special file as it is found in
35*49083Scael.Pa /dev .
36*49083Scael.Pp
3720787SmckusickThe second field of the file is the command to execute for the line,
38*49083Scaelusually
39*49083Scael.Xr getty 8 ,
40*49083Scaelwhich initializes and opens the line, setting the speed, waiting for
41*49083Scaela user name and executing the
42*49083Scael.Xr login 1
43*49083Scaelprogram.
4428314SkarelsIt can be, however, any desired command, for example
4528265Slepreauthe start up for a window system terminal emulator or some other
4628267Slepreaudaemon process, and can contain multiple words if quoted.
47*49083Scael.Pp
4839177SbosticThe third field is the type of terminal usually connected to that
4939177Sbostictty line, normally the one found in the
50*49083Scael.Xr termcap 5
5120787Smckusickdata base file.
52*49083ScaelThe environment variable
53*49083Scael.Dv TERM
54*49083Scaelis initialized with the value by
5539177Sbosticeither
56*49083Scael.Xr getty 8
5739177Sbosticor
58*49083Scael.Xr login 1 .
59*49083Scael.Pp
6028265SlepreauThe remaining fields set flags in the
61*49083Scael.Fa ty_status
6220787Smckusickentry (see
63*49083Scael.Xr getttyent 3 )
6428265Slepreauor specify a window system process that
65*49083Scael.Xr init 8
6620787Smckusickwill maintain for the terminal line.
67*49083Scael.Pp
6839177SbosticAs flag values, the strings ``on'' and ``off'' specify that
69*49083Scael.Xr init
7039177Sbosticshould (should not) execute the command given in the second field,
7139177Sbosticwhile ``secure'' (if ``on'' is also specified) allows users with a
7239177Sbosticuid of 0 to login on
7339177Sbosticthis line.
7439177SbosticThese flag fields should not be quoted.
75*49083Scael.Pp
7639177SbosticThe string ``window='' may be followed by a quoted command
7728265Slepreaustring which
78*49083Scael.Xr init
7939177Sbosticwill execute
80*49083Scael.Em before
8139177Sbosticstarting the command specified by the second field.
82*49083Scael.Sh EXAMPLES
83*49083Scael.Bd -literal
8439177Sbostic# root login on console at 1200 baud
8543524Strentconsole	"/usr/libexec/getty std.1200"	vt100	on secure
8639177Sbostic# dialup at 1200 baud, no root logins
8743524Strentttyd0	"/usr/libexec/getty d1200"	dialup	on	# 555-1234
8839177Sbostic# Mike's terminal: hp2621
8943524Strentttyh0	"/usr/libexec/getty std.9600"	hp2621-nl	on	# 457 Evans
9039177Sbostic# John's terminal: vt100
9143524Strentttyh1	"/usr/libexec/getty std.9600"	vt100	on		# 459 Evans
9239177Sbostic# terminal emulate/window system
9343524Strentttyv0	"/usr/new/xterm -L :0"		vs100	on window="/usr/new/Xvs100 0"
9439177Sbostic# Network pseudo ttys -- don't enable getty
9528314Skarelsttyp0	none	network
9628314Skarelsttyp1	none	network	off
97*49083Scael.Ed
98*49083Scael.Sh FILES
99*49083Scael.Bl -tag -width /etc/ttys -compact
100*49083Scael.It Pa /etc/ttys
101*49083Scael.El
102*49083Scael.Sh SEE ALSO
103*49083Scael.Xr login 1 ,
104*49083Scael.Xr getttyent 3 ,
105*49083Scael.Xr ttyslot 3 ,
106*49083Scael.Xr gettytab 5 ,
107*49083Scael.Xr termcap 5 ,
108*49083Scael.Xr getty 8 ,
109*49083Scael.Xr init 8
110*49083Scael.Sh HISTORY
111*49083ScaelA
112*49083Scael.Nm
113*49083Scaelfile appeared in
114*49083Scael.At v6 .
115