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
/usr/lib/uucp/Dialers-
full pathname of Dialers
See also
Configuration(F),
Devices(F),
dial(ADM),
uucico(ADM),
uucp(C),
uux(C),
uuxqt(ADM)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003