acucap - Automatic call unit capabilities file
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 speci-
fied 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
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 can-
not 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 fol-
lowed by a pound sign (#) indicates that a numeric value follows. A field
name followed by the separating colon (:) represents a Boolean.
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:
An example is:
A numeric capability is of the form:
An example is:
A Boolean capability is specified simply by listing it. Strings that are
not specified cause nothing to be issued. The following are available
ab (str) Abort string. This string is sent to the modem if tip is
cd (num) Completion delay. This number gives the time to wait between
completion string characters (in seconds, unless the ls Boolean is
cr (bool) Setting this Boolean causes the program to wait in the generic
dial routine until the modem senses a carrier.
co (str) A modem command string which instructs the modem to change from
the default speed to the speed specified by the xs field.
cs (str) Completion string. The modem issues this string after receiving
and responding to synchronization and dial strings.
da (num) Dial acknowledge. This number gives the time to wait before
looking for a dial response (in seconds).
db (bool) Debug mode. Setting this Boolean causes the generic dialer to
give more information as it dials.
dd (num) Dial delay. This number gives the time between dial characters
(in seconds) unless the ls Boolean is specified.
di (str) Dial initialization. This string is used to start a dialing
sequence (placed just before the number to dial.)
dr (str) Dial response. The modem sends this string if a dialing sequence
that was just issued is successful.
ds (str) Disconnect string. This string is sent to the modem when tip is
dt (str) Dial termination. This string is used to terminate a dialing
sequence (placed just after the number to dial.)
fd (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.
hu (bool) This Boolean causes the modem to hang up the phone if the line
is (num) This number specifies the speed at which the modem must be ini-
tialized. The conversation speed will later be set as specified by the
ls (bool) Use an internal sleep routine rather than sleep(3) for delays.
Thus, all delays are given in microseconds rather than seconds.
os (str) Online string. The modem sends this string after carrier has
rd (bool) Causes a 1-second delay after toggling dtr (data terminal
ready). This action will only be taken if re is also set.
re (bool) This Boolean causes the modem to toggle dtr (data terminal
ready) before beginning synchronization. It is used to reset the
present condition of the modem.
rs (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.
sd (num) Synchronization delay. This number gives the time between syn-
chronization characters (in seconds unless the ls Boolean is speci-
si (bool) This modem is attached to an interface that cannot return any
characters until carrier is detected. The DMF32 interface acts in this
sr (str) Synchronization response. What the modem sends in response to a
ss (str) Synchronization string. The first string the modem expects to
receive; a check to see if the modem is operating.
xs (num) Specifies the speed the modem will operate at after initializa-
tion at the default speed in the is field.
The following example shows an entry for a DF03 modem:
Commands: tip(1), sleep(3).