From: Paul Mackerras Date: Tue, 24 May 1994 11:27:08 +0000 (+0000) Subject: document xonxoff/-crtscts and lcp-echo-* options X-Git-Tag: ppp-2-1-2a~37 X-Git-Url: https://git.ozlabs.org/?p=ppp.git;a=commitdiff_plain;h=d9163dc83a0f7c50930cd254e9ff1e709a886548;ds=sidebyside document xonxoff/-crtscts and lcp-echo-* options and ip-up/down scripts. --- diff --git a/pppd/pppd.8 b/pppd/pppd.8 index 032eeb0..4c98197 100644 --- a/pppd/pppd.8 +++ b/pppd/pppd.8 @@ -1,5 +1,5 @@ .\" manual page [] for pppd 2.0 -.\" $Id: pppd.8,v 1.4 1994/05/09 02:40:39 paulus Exp $ +.\" $Id: pppd.8,v 1.5 1994/05/24 11:27:08 paulus Exp $ .\" SH section heading .\" SS subsection heading .\" LP paragraph @@ -74,6 +74,14 @@ dial the modem and start the remote ppp session. Use hardware flow control (i.e. RTS/CTS) to control the flow of data on the serial port. .TP +.B xonxoff +Use software flow control (i.e. XON/XOFF) to control the flow of data on +the serial port. This option is not implemented on BSD or Ultrix systems +at present. +.TP +.B -crtscts +A synonym for \fBxonxoff\fR. +.TP .B defaultroute Add a default route to the system routing tables, using the peer as the gateway, when IPCP negotiation is successfully completed. @@ -82,7 +90,8 @@ This entry is removed when the PPP connection is broken. .B disconnect \fI

Run the executable or shell command specified by \fI

\fR after \fIpppd\fR has terminated the link. This script could, for example, -issue commands to the modem to cause it to hang up. +issue commands to the modem to cause it to hang up if hardware modem +control signals were not available. .TP .B escape \fIxx,yy,... Specifies that certain characters should be escaped on transmission @@ -288,6 +297,25 @@ hostname. With this option, the peer will have to supply the local IP address during IPCP negotiation (unless it specified explicitly on the command line or in an options file). .TP +.B lcp-echo-interval \fI +If this option is given, \fIpppd\fR will send an LCP echo-request +frame to the peer every \fIn\fR seconds. Under Linux, the +echo-request is sent when no packets have been received from the peer +for \fIn\fR seconds. Normally the peer should respond to the +echo-request by sending an echo-reply. This option can be used with +the \fIlcp-echo-failure\fR option to detect that the peer is no longer +connected. +.TP +.B lcp-echo-failure \fI +If this option is given, \fIpppd\fR will presume the peer to be dead +if \fIn\fR LCP echo-requests are sent without receiving a valid LCP +echo-reply. If this happens, \fIpppd\fR will terminate the +connection. Use of this option requires a non-zero value for the +\fIlcp-echo-interval\fR parameter. This option can be used to enable +\fIpppd\fR to terminate after the physical connection has been broken +(e.g., the modem has hung up) in situations where no hardware modem +control lines are available. +.TP .B lcp-restart \fI Set the LCP restart interval (retransmission timeout) to seconds (default 3). @@ -355,7 +383,7 @@ remote IP address was specified in an option. .SH OPTIONS FILES Options can be taken from files as well as the command line. .I pppd -reads options from the files /etc/ppp/options and $HOME/.ppprc before +reads options from the files /etc/ppp/options and ~/.ppprc before looking at the command line. An options file is parsed into a series of words, delimited by whitespace. Whitespace can be included in a word by enclosing the word in quotes ("). A backslash (\\) quotes the @@ -575,6 +603,28 @@ process. .B /var/run/ppp\fIn\fB.pid \fR(BSD), \fB/etc/ppp/ppp\fIn\fB.pid \fR(SunOS) Process-ID for \fIpppd\fR process on ppp interface unit \fIn\fR. .TP +.B /etc/ppp/ip-up +A program or script which is executed when the link is available for +sending and receiving IP packets (that is, IPCP has come up). It is +executed with the parameters \fIinterface-name tty-device speed +local-IP-address remote-IP-address\fR. +.IP +This program or script is executed with the same real and effective +user-ID as \fIpppd\fR, that is, at least the effective user-ID and +possibly the real user-ID will be \fBroot\fR. This is so that it can +be used to manipulate routes, run privileged daemons (e.g. +\fBsendmail\fR), etc. Be careful that the contents of the +/etc/ppp/ip-up and /etc/ppp/ip-down scripts do not compromise your +system's security. +.TP +.B /etc/ppp/ip-down +A program or script which is executed when the link is no longer +available for sending and receiving IP packets. This script can be +used for undoing the effects of the /etc/ppp/ip-up script. It is +invoked with the same parameters as the ip-up script, and the same +security considerations apply, since it is executed with the same +effective and real user-IDs as \fIpppd\fR. +.TP .B /etc/ppp/pap-secrets Usernames, passwords and IP addresses for PAP authentication. .TP @@ -586,7 +636,7 @@ System default options for .I pppd, read before user default options or command-line options. .TP -.B $HOME/.ppprc +.B ~/.ppprc User default options, read before command-line options. .SH SEE ALSO .TP