PPP.DIALERS(MST_PPP)

NAME

ppp.Dialers - PPP dialer description file format

DESCRIPTION

The file /usr/lib/mstppp/Dialers on SCO systems describes how to dial each type of modem attached to the UNIX system that is to be made available for outbound PPP calls. After looking for modem dialers in Dialers.local , Pppd examines /usr/lib/mstppp/Dialers when placing a call to a neighboring machine. Entries in Dialers.local take precedence over those in /usr/lib/mstppp/Dialers.

When pppd selects a line from Systems , it uses thespeed ' field to select an entry in Devices , from which it uses thedialer ' field to select an entry in Dialers . Pppd then interprets thechat script ' field from that dialer description. The `dialer ' field may also be the name of a binary dialer program.

FORMAT

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. At minimum, each pair consists of a field to expect the "remote" end to send, followed by a field to send in response. Unless asend' string ends with \ c , pppd will follow it by sending a carriage return character (ASCII 0x0d).

Chat scripts areexpect send expect send...', orexpect-send-expect send...', where thesend' 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 theexpect' 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 inexpect' strings. This is the default.
P_ZERO
Transmit characters with the parity bit set to 0
(8 bits, no parity ).
P_ONE
Transmit characters with the parity bit set to 1
P_EVEN
Transmit characters with even parity.
P_ODD
Transmit characters with odd parity.

In the midst of either anexpect' 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 d igits
\p
Pause for.25 second before proceeding (send only)
\d
Delay for 2 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 togglequiet' mode.
\T
Insert the telephone number found in the fifth field of Systems here

EXAMPLE

#
# 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

SEE ALSO

tun(MST_PPP), ppp.Auth (MST_PPP), ppp.Devices (MST_PPP), ppp.Filter (MST_PPP), ppp.Keys (MST_PPP), ppp.Systems (MST_PPP), pppd (MST_PPP), RFC 1661, RFC 1332, RFC 1144 , RFC 1055 .

COPYRIGHT INFORMATION

Copyright 1991, 1992, 1993, 1994, 1995, 1996 Morning Star Technologies Inc.; all rights reserved.