dialers(F)                    06 January 1993                     dialers(F)


 Name

    dialers - format of UUCP Dialers file

 Description

    The Dialers file (/usr/lib/uucp/Dialers) specifies the initial conversa-
    tion 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.

    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, when-
                          ever 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 func-
                          tion 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

    devices(F), dial(ADM), uucico(ADM), uucp(C), uux(C)

 Note

    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.