acucap(4)acucap(4)NAMEacucap - Automatic call unit capabilities file
SYNOPSIS
/etc/acucap
DESCRIPTION
The /etc/acucap file lists the types of autodial modems and describes
their attributes. Whenever tip encounters an at field in /etc/remote
file description, it searches /etc/acucap file description.
If the at string there matches a name entry in /etc/acucap, the tip
generic dialing routine places an outgoing call according to the
attributes specified for the modem in the acucap file.
Each line in the file describes how to dial a given type of modem.
This description consists of strings, time delays, and flags used to
control the action of any modem. Fields are separated by a colon (:).
Entries that end in a backslash character (\) followed by a newline are
continued on the next line.
The first entry is the name or names of the modem. If there is more
than one name for a modem, each is separated by a vertical bar (|).
There cannot be any blank spaces or other characters between the first
column and the modem name.
The fields of the description follow the name. A field name followed
by an equal sign (=) indicates that a string value follows. A field
name followed by a pound sign (#) indicates that a numeric value fol‐
lows. A field name followed by the separating colon (:) represents a
Boolean.
CAPABILITIES
The fields following the name of the modem define the capabilities of
the modem. Capabilities are either strings (str), numbers (num), or
Boolean flags (bool). A string capability is of the form: capabil‐
ity=value
An example is: ss=^A^B
A numeric capability is of the form: capability#value
An example is: sd#1
A Boolean capability is specified simply by listing it. Strings that
are not specified cause nothing to be issued. The following are avail‐
able capabilities: (str) Abort string. This string is sent to the
modem if tip is aborted. (num) Completion delay. This number gives
the time to wait between completion string characters (in seconds,
unless the ls Boolean is specified). (bool) Setting this Boolean
causes the program to wait in the generic dial routine until the modem
senses a carrier. (str) A modem command string which instructs the
modem to change from the default speed to the speed specified by the xs
field. (str) Completion string. The modem issues this string after
receiving and responding to synchronization and dial strings. (num)
Dial acknowledge. This number gives the time to wait before looking
for a dial response (in seconds). (bool) Debug mode. Setting this
Boolean causes the generic dialer to give more information as it dials.
(num) Dial delay. This number gives the time between dial characters
(in seconds) unless the ls Boolean is specified. (str) Dial initial‐
ization. This string is used to start a dialing sequence (placed just
before the number to dial.) (str) Dial response. The modem sends this
string if a dialing sequence that was just issued is successful. (str)
Disconnect string. This string is sent to the modem when tip is
finally disconnected. (str) Dial termination. This string is used to
terminate a dialing sequence (placed just after the number to dial.)
(num) Full delay. This number is the time to wait for a carrier to be
detected (in seconds). If the call is not completed in this time, an
error is returned. (bool) This Boolean causes the modem to hang up the
phone if the line goes away. (num) This number specifies the speed at
which the modem must be initialized. The conversation speed will later
be set as specified by the xs field. (bool) Use an internal sleep rou‐
tine rather than sleep(3) for delays. Thus, all delays are given in
microseconds rather than seconds. (str) Online string. The modem
sends this string after carrier has been detected. (bool) Causes a
1-second delay after toggling dtr (data terminal ready). This action
will only be taken if re is also set. (bool) This Boolean causes the
modem to toggle dtr (data terminal ready) before beginning synchroniza‐
tion. It is used to reset the present condition of the modem. (str)
Replacement string. This string is a single character that will be
substituted for an equal sign (=) or dash (-) in the number to be
dialed; used so that delay characters can be represented uniformly, but
allowing the correct delay character to be passed to a given modem.
(num) Synchronization delay. This number gives the time between syn‐
chronization characters (in seconds unless the ls Boolean is speci‐
fied.) (bool) This modem is attached to an interface that cannot
return any characters until carrier is detected. The DMF32 interface
acts in this way. (str) Synchronization response. What the modem
sends in response to a synchronization string. (str) Synchronization
string. The first string the modem expects to receive; a check to see
if the modem is operating. (num) Specifies the speed the modem will
operate at after initialization at the default speed in the is field.
EXAMPLES
The following example shows an entry for a DF03 modem: df03|DF03|dec
df03:\ :cr:hu:re:di=^A^B:dd#1:os=A:ds=^A:fd#40:
RELATED INFORMATION
Commands: tip(1), sleep(3).
Files: remote(4). delim off
acucap(4)