PPP.DIALERS(MST

PPP.DIALERS(MST_PPP)

NAME

ppp.Dialers - PPP dialer description file format

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

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 created by 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. 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

PPP.DIALERS(MST_PPP)

NAME

DESCRIPTION

FORMAT

CHAT SCRIPT PARTICULARS

EXAMPLE

SEE ALSO

COPYRIGHT INFORMATION