unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



acucap(4)							    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 speci-
  fied 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	can-
  not 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 fol-
  lowed	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 ini-
      tialized.	 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 syn-
      chronization characters (in seconds unless the ls	Boolean	is speci-
      fied.)

  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	initializa-
      tion 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).