Dialers(4bnu)

Dialers -- BNU dial-up chat script file

Synopsis

dialer substitutions expect-send...

Description

The /etc/uucp/Dialers file specifies the initial conversation that must take place on a line before the line can be made available for transferring data. This conversation usually consists of a sequence of character strings to be transmitted and expected. The character strings are typically used to dial a telephone number using an Automatic Call Unit (ACU) dial modem.

The fifth and subsequent odd-numbered fields in the Devices(4bnu) file are indexes into the Dialers file, or into an internal list of special dialer types (CS, 801, TLI, or TLIS). If a match is found, the Dialers entry is interpreted to perform the dialer conversation.

Each entry in the Dialers file consists of the following fields:

   #dialer substitutions expect-send...

Blank lines, and lines that begin with white space, a tab, or a hash sign (#) are ignored.

The fields in the Dialers file are defined as follows:

dialer

This field matches the fifth and subsequent odd numbered fields in the Devices file.

substitutions

Supplies a translation string, where the first of each pair of characters is mapped to the second character in the pair. This field is usually used to translate ``='' and ``-'' into whatever the dialer requires for ``wait for dial tone'' and ``pause''.

expect-send

Contains character strings that make up the chat script used to dial the device.

The following escape characters can be used in the chat script:

\b: send or expect a backspace character
\c: if at the end of a string, suppress the newline that is normally sent; ignored otherwise
\d: delay two seconds before sending or reading more characters
\p: pause for approximately ¼ to ½ second
\E: start echo checking (from this point on, whenever a character is transmitted, it will wait for the character to be received before doing anything else)
\e: echo check off
\M: turn on CLOCAL flag
\m: turn off CLOCAL flag
\n: send a newline character
\r: send or expect a carriage-return
\s: send or expect a space character
\t: send or expect a tab character
\\: send or expect a ``\'' character
BREAK: send or expect a BREAK character
\D: telephone number or token without Dialcodes translation
EOT: send or expect EOT newline twice
\K: same as BREAK
\N: send or expect a null character (ASCII NUL)
\T: telephone number or token with Dialcodes translation
\ddd: collapse the octal digits ddd into a single character
~nn: specify the timeout by appending nn to the expect string, where nn is the timeout time in seconds (this will override the default value of 45 seconds, or the device-specific value provided in the Devconfig(4bnu) file)

The keyword ABORT may be used in an ``expect'' field to indicate that the chat script should fail upon receipt of the string specified in the ``send'' field, without waiting for a timeout. This may save time when used to handle strings like ``BUSY'' returned from dialing devices.

Files

/etc/uucp/Devices
/etc/uucp/Dialcodes
/etc/uucp/Dialers
/etc/uucp/Systems

Usage

The Dialers file works closely with the Devices(4bnu), Systems(4bnu) and Dialcodes(4bnu) files. Note that a change to an entry in one file may require a change to a related entry in another file.

Examples

This example uses the system-supplied Dialers file entry for the att2212c device shown here:

   att2212C =+-, "" atzod,o12=y,o4=n\r\c \006 atT\T\r\c ed

As is the case with most Dialers file entries, the att2212c entry is processed in two steps:

The telephone number argument is translated as follows:
- any equals sign (=) is replaced by a plus sign (+)
- any minus sign (-) is replaced by a comma (,)
The plus sign and comma in the translated telephone number argument have the following meanings:

+
wait for dial tone

,
pause
The handshake given by the remainder of the line is interpreted as follows:

``
wait for nothing; that is, proceed to the expect-send string

atzod
enter command mode, reset modem, set options to default

o12=y
set option 12 to ``y'' (transparent data mode)

o4=n\r\c
set option 4 to ``n'' (don't disconnect on received spaces); terminate with a carriage return but no newline

\006
wait for acknowledge signal (ACK).

atT\T\r\c
enter command mode; use tone dialing; translate the phone number and terminate with a carriage return, but no newline

ed
expect ed (as in the last two letters of answered)

References

Config(4bnu), Devconfig(4bnu), Devices(4bnu), Dialcodes(4bnu), Grades(4bnu), Limits(4bnu), Permissions(4bnu), Poll(4bnu), Sysfiles(4bnu), Systems(4bnu)