ppp.Dialers(4) ppp.Dialers(4)
NAME [Toc] [Back]
ppp.Dialers - PPP dialer description file format
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
ppp.Dialers(4) ppp.Dialers(4)
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).
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
ppp.Dialers(4) ppp.Dialers(4)
\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.
EXAMPLE [Toc] [Back]
#
# 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 [Toc] [Back]
ppp.Dialers was developed by the Progressive Systems.
SEE ALSO [Toc] [Back]
ppp.Auth(4), ppp.Devices(4), ppp.Filter(4), ppp.Keys(4),
ppp.Systems(4), pppd(1), RFC 1548, RFC 1332, RFC 1144, RFC 1055.
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003 [ Back ] |
