DIALERS(F) UNIX System V
Name
dialers - format of UUCP Dialers file
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 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 entry in the Dialers file has
the following format:
dialer substitutions expect-send ...
The dialer field matches the fifth and additional odd
numbered fields in the Devices file. The substitutions
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.''
The remaining expect-send fields are character strings.
Below are some character strings distributed with the UUCP
package in the Dialers file.
__________________________________________________________________________
| Dialers file entries |
|_________________________________________________________________________|
| |
|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 1/4 to 1/2 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 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 1/2
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.
See Also
dial(ADM), uucico(ADM), uucp(C), uux(C), uuxqt(C),
devices(F)
Notes
Dialer binaries (located in /usr/lib/uucp) are preferred
over Dialers entries. Binaries are more reliable. Refer to
the dial man page for more information on creating your own
dialer binaries.
(printed 8/23/89) DIALERS(F)