Dialers(F)

Dialers -- format of UUCP Dialers file

Format

dialer substitutions expect_send ...

Description

The Dialers file (/usr/lib/uucp/Dialers) specifies the initial conversation that must take place on a line before it can be made available for transferring data. This conversation is usually a sequence of ASCII strings that is transmitted and expected, and it is often used to dial a phone number using an ASCII dialer (such as the Automatic Dial Modem).

A modem that is used for dialing in and out may require a second Dialers entry. This is to reinitialize the line to dial-in after it has been used for dial-out. The name of the dial-in version of a dialer must begin with an ampersand. For example, the Dialers file contains a ``hayes2400'' and a ``&hayes2400'' entry.

The fifth field (dialer_token) in a Devices file entry is an index into the Dialers file or a special dialer type. Here an attempt is made to match the fifth field in the Devices file with the first field of each Dialers file entry. In addition, each odd numbered Devices field starting with the seventh position is used as an index into the Dialers file. If the match succeeds, the Dialers entry is interpreted to perform the dialer negotiations.

Each line in Dialers contains the following whitespace-separated fields:

dialer: this field matches the fifth (dialer_token) and additional odd numbered fields in the Devices file.
substitutions: this field is a translate string; the first of each pair of characters is mapped to the second character in the pair. This is usually used to translate ``='' and ``-'' into whatever the dialer requires for ``wait for dialtone'' and ``pause.''
expect_send ...: the remaining fields are character strings.

Examples

Below are some character strings distributed with the UUCP package in the Dialers file.

   penril	=W-P "" \d > s\p9\c )-W\p\r\ds\p9\c-) y\c : \E\TP > 9\c OK
   ventel	=&-% "" \r\p\r\c $ <K\T%%\r>\c ONLINE!
   hayes	=,-, "" \dAT\r\c OK\r \EATDT\T\r\c CONNECT
   rixon	=&-% "" \d\r\r\c $ s9\c )-W\r\ds9\c-) s\c : \T\r\c $ 9\c LINE
   vadiac	=K-K "" \005\p *-\005\p-*\005\p-* D\p BER? \E\T\e \r\c LINE
   develcon	"" "" \pr\ps\c est:\007 \E\D\e \007
   micom	""    "" \s\c NAME? \D\r\c GO
   direct
   att2212c	=+-,    "" \r\c :--: ato12=y,T\T\r\c red
   att4000	=,-,    "" \033\r\r\c DEM: \033s0401\c \006 \033s0901\c \
   	   \006 \033s1001\c \006 \033s1102\c \006 \033dT\T\r\c \006
   att2224	=+-,    "" \r\c :--: T\T\r\c red
   nls	    ""      "" NLPS:000:001:1\N\c

The meaning of some of the escape characters (those beginning with ``\'') used in the Dialers file are listed below:

\p pause (approximately ¼ to ½ second)
\d delay (approximately 2 seconds)
\D phone number or token without Dialcodes translation
\T phone number or token with Dialcodes translation
\K insert a BREAK
\E enable echo checking (for slow devices)
\e disable echo checking
\r carriage return
\c no new-line or carriage return
\n send new-line
\nnn send octal number.

Additional escape characters that may be used are listed in the System Administration Guide section discussing the Systems file.

The ``penril'' entry in the Dialers file is executed as follows. First, the phone number argument is translated, replacing any ``='' with a ``W'' (wait for dialtone) and replacing any ``-'' with a ``P'' (pause). The handshake given by the remainder of the line works as follows:

Wait for nothing.

\d: Delay for 2 seconds.
>: Wait for a ``>''.
s\p9\c: Send an ``s'', pause for ½ second, send a ``9'', send no terminating new-line.
)-W\p\r\ds\p9\c-): Wait for a ``)''. If it is not received, process the string between the ``-'' characters as follows: send a ``W'', pause, send a carriage-return, delay, send an ``s'', pause, send a ``9'', without a new-line, and then wait for the ``)''.
y\c: Send a ``y''.
:: Wait for a ``:''.
\E\TP: Enable echo checking. (From this point on, whenever a character is transmitted, it will wait for the character to be received before doing anything else.) Then, send the phone number. The \T means take the phone number passed as an argument and apply the Dialcodes translation and the modem function translation specified by field 2 of this entry. Then send a ``P''.
>: Wait for a ``>''.
9\c: Send a ``9'' without a new-line.
OK: Waiting for the string ``OK''.

Limitations

Dialer binaries (located in /usr/lib/uucp) are preferred over Dialers entries. Binaries are more reliable. Refer to dial(ADM) for more information on creating your own dialer binaries.

Files