acucap - Automatic call unit capabilities file
/etc/acucap
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 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: capability=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 available 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 initialization. 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 routine 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 synchronization. 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 synchronization
characters (in seconds unless the ls Boolean
is specified.) (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.
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:
Commands: tip(1), sleep(3).
Files: remote(4). delim off
acucap(4)
[ Back ] | 