HP-UX Reference (11i v3 07/02) - 4 File Formats (vol 8)

p
ppp.Dialers(4) ppp.Dialers(4)
NAME
ppp.Dialers - PPP dialer description file format
DESCRIPTION
The file /etc/ppp/Dialers
describes how to dial each type of modem attached to the UNIX system
that is to be made available for outbound PPP calls.
pppd examines it when placing a call to a neighboring
machine.
When
pppd selects a line from Systems
, it uses the speed field to select an entry in Devices, from
which it uses the
dialer field to select an entry in
Dialers. pppd then interprets the chat script
field from that dialer description.
Format
Entries are one to a line; blank lines are ignored. Comments begin with a
# and extend to the end of the
line. Upper/lower case distinctions in the dialer field are significant for matching purposes, as are strings
in the chat script. Fields on a line are separated by horizontal white space (blanks or tabs). If a chat script
ends with a backslash (
\), the next line is considered a continuation of the chat script. Continuations may
only occur in the midst of a chat script.
Each entry must contain these fields, in this order:
dialer The name of this dialer, to be matched against the dialer field in Devices
.
chat-script A description of the conversation that
pppd holds with the modem.
Chat Script Particulars
A chat script takes the form of a space-separated list of expect-send pairs. Each pair consists (at minimum)
of a field to expect the remote end to send, then a field to send in response. Unless a
send string ends
with
\c, pppd will follow it by sending a carriage return character (ASCII 0x0d).
Chat scripts are expect send expect send ... or expect-send-expect send ...
, where
the
send following the hyphen is executed if the preceding expect fails to match received text.
Certain special words may be used in the chat script to control the behavior of pppd as it attempts to dial.
Both ABORT and TIMEOUT must be in the
expect phase of the chat script.
ABORT abort-string If pppd sees abort-string while executing the remainder of the chat script,
abort the dialing attempt and note the failure in the log file.
TIMEOUT timeout-time While executing the current chat script, wait timeout-time seconds for a
response before considering the dialing attempt to have timed out. Writes
have a fixed 60-second timeout.
The expect-send couplet of ’"’ P_WORD sets the line parity accordingly:
P_AUTO Set transmission parity based on the parity observed in characters received in expect
strings. This is the default.
P_ZERO Transmit characters with the parity bit set to zero (8 bits, no parity).
P_ONE Transmit characters with the parity bit set to one.
P_EVEN Transmit characters with even parity.
P_ODD Transmit characters with odd parity.
In the midst of either an expect string or a send string, ˆx gets translated into the appropriate control
character, and \x gets translated into x. Other special sequences are:
\s Send or receive a space character (ASCII 0x20).
\t Send or receive a horizontal tab character (ASCII 0x09).
\n Send or receive a line feed character (ASCII 0x0a).
\r Send or receive a carriage return character (ASCII 0x0d).
\\ Send or receive a backslash character (ASCII 0x5c).
\ˆ Send or receive a carat character (ASCII 0x5e).
^character Send or receive the single character Ctrl-character (ASCII 0x00 through 0x1f).
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 313