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)