unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



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



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 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 Release 11i: November 2000






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

 SEE ALSO
      tun(4), 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 Release 11i: November 2000