HP-UX Reference (11i v2 03/08) - 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 neighbor-
ing 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. Continua-
tions 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 2: August 2003 − 1 − Hewlett-Packard Company Section 4−−241