Index for Section 4

Alphabetical listing for A

Bottom of page

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:

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

  cd  (num) Completion delay.  This number gives the time to wait between
      completion string characters (in seconds, unless the ls 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 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
      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 at which the modem must be
      initialized.  The conversation speed will later be set as specified by
      the xs field.

  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
      been detected.

  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
      synchronization characters (in seconds unless the ls Boolean is
      specified.)

  si  (bool) This modem is attached to an interface that cannot return any
      characters until carrier is detected.  The 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 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).

Index for Section 4

Alphabetical listing for A

Top of page