TTYS.CONF(5) BSD Programmer's Manual TTYS.CONF(5)NAMEttys.conf - terminal line configuration file
SYNOPSIS
/etc/ttys.conf
/etc/ttys.conf.local
DESCRIPTION
The /etc/ttys.conf file contains entries referenced by the /etc/ttys file
as well user/group permissions/restrictions and destination information
for outgoing calls. The over all format of the file is defined in the
cgetent(3) manual page. Most entries may have more than a single value.
Values are separated by the | (pipe) symbol. For example:
:entry=value1|value2|value3:
To specify a | use \|.
Entries which define restrictions or permissions for a given user or
group are tagged by user-name or group-name.
The following are the standard entries. There is no limit on the names
for new entries.
allow A list of the special sequences allowed by this user. If not de-
fined, all special sequences not listed in the restrict entry are
allowed. The special sequences are defined by the map entry for
the chosen line. An example entry might be:
:allow=<DIALTONE>|<PAUSE>:
arguments
A list of arguments which should be sent to the scripts defined by
the condition, dialer, hangup, and watcher entries. The arguments
are names of entries for which the values should be passed. For
example:
:arguments=dte-speeds|term|line:
might cause the following arguments to be sent to a script
-dte-speeds 9600 -term unknown -line tty01
auth The type of authentication for this line. This type is used as
auth-type in the /etc/login.conf file.
banner
Banner to be displayed by the login(8) program.
calltype
Types of calls allowed on this line, or by this user or group.
The special type DIRECT implies the request is for the raw line
itself with no dialing or setup. Other types of calls are defined
by the /etc/dialer.rules file. By convention these are: LOCAL,
NATIONAL, INTL, ASSISTED-NATIONAL, and ASSISTED-INTL.
command
The name of the command to execute when carrier is enabled on the
line. By default this is /usr/bin/login.
compression
Types of automatic data compression available from the modem.
While this value may be used to help select a line, the default
dialing scripts provided with the system do not attempt to use
this information.
condition
Script called to condition a modem to accept incoming calls. The
script should leave the modem in such a state that it will auto-
matically answer incoming calls. The synopsis of the script is:
condition [-f file] [arguments]
The file argument is the file associated with the line, typically
/dev/fd/xx. The arguments are the arguments specified by the
arguments entry.
cost The relative cost of the line. If multiple lines match the re-
quest, and a speed was requested, the line with the lowest cost is
used. By default the cost of a line is the maximum value in the
speed entry for the line. If the request does not specify a
speed, the lowest cost line with the highest available speed is
used.
dce-speeds
The DCE speeds available for this modem. The DCE speed is the
speed the modem communicates with the serial line.
destination
The name of a single entry in the database to merge with the re-
quest. This entry only has use in a request and has no effects on
line definitions. A destination typically includes the phone num-
ber or numbers as well as the optimum dialing speeds.
dialer
Script to dial a number on a modem. The synopsis of the script
is:
dialer [-f file] [arguments]
The file argument is the file associated with the line, typically
/dev/fd/xx. The arguments are the union of the arguments specified
by the arguments entry and entry which matched between the request
and the entry for the line.
dialin
This line is marked to accept incoming calls. This is used for
both hardwired and modem connected lines.
dialout
This line is marked to allow outgoing calls. See gettyd(8) for
more information.
dte-speeds
The DTE speeds available for this line (or the dte speeds de-
sired). The DTE speed is the speed at which the serial line com-
municates with the modem. When both dte-speeds and dce-speeds are
specified, the actual set of DTE speeds is the intersection of
dte-speeds and dce-speeds.
error-correction
The types of error correction available from the modem. While
this value may be used to help select a line, the default dialing
scripts provided with the system do not attempt to use this infor-
mation.
flow The types of flow control available from the modem. While this
value may be used to help select a line, the default dialing
scripts provided with the system do not attempt to use this infor-
mation. Use the flowcontrol field to specify a specific type of
flow control.
flowcontrol
Without a value, enable hardware flow control. If a value is
specified it must be one of:
hardware
Enable hardware flow control for this line. (The same as
not specifying a value). May also be abbreviated as hw.
none No flow control is enabled.
software
Enable software flow control for this line. May also be
abbreviated as sw.
groups
A list of groups allowed to access this line.
hangup
A script similar to condition, however, it simply assures the
phone is hung up and the line is ready for another dialout ses-
sion. It is only called on dialout lines. The synopsis for
hangup is the same as that of the condition script.
hcondition
hdial
hhangup
hinit
hquiet
hreset
See the hayes(8) manual page for details on these fields.
issue The name of a file to be displayed after the login(8) program
prints the login banner (specified by the banner field.) No er-
rors are generated if the file pointed to does not exist.
line The list of devices to select from for this connection. It may
only be specified as part of a request (or in a destination defi-
nition).
manager
The name of the program which manages this line. This does not
cause the named program to be run. It is used by a program when
it is searching for entries which it should control. If this has
no value, or is specified to be none, then the line is not man-
aged. Enabled lines normally have the value of gettyd, or init
for compatability with older systems.
map A mapping of special sequences to strings used by the modem. Each
entry is of the form: <sequence>string. For example, a hayes com-
patible modem might have the entry:
:map=<FLASH>!|<TONE>T|<PULSE>P|<DIALTONE>W|<REVERSE>~
|<SILENCE>@|<PAUSE>,:
modemcontrol
Enable modem control for this line.
modemtype
A verbose description of the modem. In general its presence indi-
cates this entry is describing a modem.
modulation
The types of modulation (i.e., bell103, v.21, v.34...) available
from the modem. While this value may be used to help select a
line, the default dialing scripts provided with the system do not
attempt to use this information.
number
The list of phone numbers to dial. Phone number may be of the
form @name in which case name is looked up in /etc/phones. Vari-
able expansion, represented by {variable}, is performed on the fi-
nal number. Variables are defined in the /etc/dialer.rules file.
(See dialer.rules(5).) Special sequences are represented as
<SPECIAL>. (See the map entry and dialer.rules(5).)
porttype
A verbose description of the type of serial port. In general its
presence indicates this entry is describing a serial port.
ppp Program called by login(8) when PPP LCP negotiation is detected.
This defaults to the ppp(8) program.
pppname
Name passed to the ppp(8) program by login(8) when PPP LCP negoti-
ation is detected. This defaults to ppp_direct.
required
A list of fields that must be present in the request in order to
match this entry. A common example might be:
:required=number:
restrict
A list of special sequences not allowed.
secure
This line is marked as secure. A secure line allows direct root
logins.
speaker
Describes the various settings the speaker may be set to. While
this value may be used to help select a line, the default dialing
scripts provided with the system do not attempt to use this infor-
mation.
speed The various modulation speeds available with the connected modem.
The modulation speed is the speed at which the modems communicate.
The is different from dte-speeds and dce-speeds.
stty-modes
Additional modes to set on the line. See stty(1) for a list of
modes.
term The default terminal type for this line.
users A list of users allowed to access this line.
uucplocking
This boolean option indicates of uucp style locking needs to be
done on this line.
verbose
Request the dialer to be verbose with what it is doing.
volume
Describes the volume settings that may be set for the modem.
While this value may be used to help select a line, the default
dialing scripts provided with the system do not attempt to use
this information.
watcher
A script similar to condition, however, it does not return unless
there was an error in initializing the modem. Normally it answers
the phone and directly starts the getty program specified. The
synopsis for watcher is the same as that of the condition script.
window
The name of the window manager to use on this line. This is ar-
chaic and is only present for backwards compatibility. It is only
used by init(8).
SEE ALSOdialer.rules(5), ttys(5), gettyd(8), gettystat(8), hayes-
condition(8), init(8), login(8)BSDI BSD/OS October 16, 1997 5
