acucap(5)							File Formats Manual							 acucap(5)

Name
       acucap - Automatic call unit capabilities file

Description
       The file lists the types of autodial modems and describes their attributes.

       The  program searches the file when it encounters an field in the file description. If the string matches a name entry in the file, the and
       generic dialing routines are used to place an outgoing call according to the attributes specified for the modem in the file.

       The program uses the same procedure for deciding how to activate an autodialer modem, except that searches for the brand name field of  the
       file in the database.

       Each  line  in  the file describes how to dial a given type of modem. This description consists of strings, time delays, and flags that are
       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, the names are separated by vertical bars
       (|).

       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.

Options
       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 specified as capability=value; for example, ``ss=^A^B''.  A numeric capability is specified
       by capability#value; for example, ``sd#1''.  A Boolean capability is specified by simply listing the  capability.   Strings  that  are  not
       specified cause nothing to be issued.

       ab (str)  Abort string.	This string is sent to the modem if is aborted.

       cd (num)  Completion  delay.   This  number  gives the time to wait between completion string characters (in seconds, unless the Boolean is
		 specified).

       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 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 is finally disconnected.

       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 goes away.

       is (num)  This  number  specifies the speed the modem must be initialized at.  The conversation speed will later be set as specified by the
		 xs field.

       ls (bool) Use an internal sleep routine rather than for delays.	Thus, all delays are given in microseconds rather than seconds.

       os (str)  Online string.  The modem sends this string after carrier has been detected.

       rd (bool) Causes a 1-second delay after toggling dtr.  This action will only be taken if the re flag 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 synchronization characters (in seconds unless the Boolean is
		 specified.)

       si (bool) This modem is attached to an interface that cannot return any characters until carrier is detected.   Digital's  DMF32  interface
		 acts in this way.

       sr (str)  Synchronization response.  What the modem sends in response to a synchronization string.

       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 initialization at the default speed per the is field.

Examples
       The following example shows an entry for a Digital DF03 modem:
       df03|DF03|dec df03:
	    :cr:hu:re:di=^A^B:dd#1:os=A:ds=^A:fd#40:

Files
       Shared autodial modem data base

See Also
       tip(1c), uucp(1c)

																	 acucap(5)