acucap(4) Kernel Interfaces Manual acucap(4)
NAME
acucap - 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 follows. 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: 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.
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)