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).
- \ddd
Send or receive a character, specified in octal digits.
- \p
Pause for .25 second before proceeding (send only).
- \d
Delay for two seconds before proceeding (send only).
- \K
Send a break (.25 second of zero bits).
- \M
Disable hangups (sets CLOCAL or LNOHANG).
- \m
enable hangups (unsets CLOCAL or LNOHANG) (the default).
- \c
Don't append a carriage return character after sending the preceding string (send only).
- \q
Don't print succeeding send strings (e.g., a password) in any
debugging or logging output.
Subsequent
\q
sequences toggle
quiet
mode.
- \T
Insert the telephone number (found in the fifth field of
Systems)
here.
EXAMPLES
#
# Dialers - PPP dialers file
#
#Dialer Chat script
T1600 ABORT NO\sCARRIER ABORT NO\sDIALTONE ABORT BUSY \
ABORT RRING\r\n\r\nRRING\r\n\r\nRRING \
ABORT ERROR TIMEOUT 5 "" AT OK-AT-OK \
ATS111=0DT\T TIMEOUT 30 CONNECT
#
T2500-PEP \
ABORT NO\sCARRIER ABORT NO\sDIALTONE ABORT BUSY \
ABORT RRING\r\n\r\nRRING\r\n\r\nRRING \
ABORT ERROR TIMEOUT 5 "" AT OK-AT-OK \
ATS111=0DT\T TIMEOUT 30 CONNECT\sFAST
#
USRv32bis \
ABORT ERROR ABORT NO\sANSWER ABORT NO\sCARRIER \
ABORT BUSY ABORT RRING\r\n\r\nRRING\r\n\r\nRRING \
ABORT NO\sDIAL\sTONE TIMEOUT 5 "" AT&F \
OK-ATQ0-OK ATB0E0X7&B1&H1&I0&K3&R2&S1 OK-AT-OK \
ATS01=1S02=255S19=0 OK-AT-OK ATDT\T TIMEOUT 30 \
CONNECT
AUTHOR
ppp.Dialers
was developed by the Progressive Systems.
Printable version
