X-Git-Url: https://git.ozlabs.org/?p=ppp.git;a=blobdiff_plain;f=pppd%2Fpppd.8;h=82e90cf35a9615b83bc1c176d23e2eb56c3c8801;hp=984c01c80879c8172ddae040b95f3a70c3094709;hb=8b856ec46871a1386487cda562cafa627cf48c88;hpb=0be03bab7eb383372c99490a1450663966891fc4 diff --git a/pppd/pppd.8 b/pppd/pppd.8 index 984c01c..82e90cf 100644 --- a/pppd/pppd.8 +++ b/pppd/pppd.8 @@ -1,5 +1,5 @@ .\" manual page [] for pppd 2.0 -.\" $Id: pppd.8,v 1.6 1994/05/30 06:13:46 paulus Exp $ +.\" $Id: pppd.8,v 1.8 1994/09/16 02:32:09 paulus Exp $ .\" SH section heading .\" SS subsection heading .\" LP paragraph @@ -58,7 +58,7 @@ bit 31 (80000000) represents the character 0x1f or ^_. If multiple \fBasyncmap\fR options are given, the values are ORed together. If no \fBasyncmap\fR option is given, no async character map will be -negotiated for the receive direction; the peer will then escape +negotiated for the receive direction; the peer should then escape \fIall\fR control characters. .TP .B auth @@ -74,14 +74,17 @@ 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 -crtscts +Disable hardware flow control (i.e. RTS/CTS) on the serial port. If +neither the \fBcrtscts\fR nor the \fB\-crtscts\fR option is given, +the hardware flow control setting for the serial port is left +unchanged. +.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 +the serial port. This option is only implemented on Linux 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. @@ -135,7 +138,7 @@ will then just wait passively for a valid LCP packet from the peer With this option, .I pppd will not transmit LCP packets to initiate a connection until a valid -LCP packet is received from the peer (as for the "passive" option with +LCP packet is received from the peer (as for the `passive' option with old versions of \fIpppd\fR). .SH OPTIONS .TP @@ -228,6 +231,21 @@ Don't agree to authenticate using CHAP. Disable negotiation of Van Jacobson style IP header compression (use default, i.e. no compression). .TP +.B bsdcomp \fInr,nt +Request that the peer compress packets that it sends, using the +BSD-Compress scheme, with a maximum code size of \fInr\fR bits, and +agree to compress packets sent to the peer with a maximum code size of +\fInt\fR bits. If \fInt\fR is not specified, it defaults to the value +given for \fInr\fR. Values in the range 9 to 15 may be used for +\fInr\fR and \fInt\fR; larger values give better compression but +consume more kernel memory for compression dictionaries. +Alternatively, a value of 0 for \fInr\fR or \fInt\fR disables +compression in the corresponding direction. +.TP +.B \-bsdcomp +Disables compression; \fBpppd\fR will not request or agree to compress +packets using the BSD-Compress scheme. +.TP .B debug Increase debugging level (same as \fB\-d\fR). If this @@ -244,9 +262,16 @@ fully qualified domain name is porsche.Quotron.COM, you would use the domain option to set the domain name to Quotron.COM. .TP .B modem -Use the modem control lines. On Ultrix, this option implies hardware -flow control, as for the \fBcrtscts\fR option. (This option is not fully -implemented.) +Use the modem control lines. This option is the default. With this +option, +.B pppd +will wait for the carrier detect signal from the modem to be asserted +when opening the serial device +(unless a connect script is specified), and it will drop the data +terminal ready signal briefly when the connection is terminated and before +executing the connect script. +On Ultrix, this option implies hardware +flow control, as for the \fBcrtscts\fR option. .TP .B kdebug \fIn Enable debugging code in the kernel-level PPP driver. The argument @@ -256,7 +281,10 @@ received packets be printed, and 4 to request that the contents of transmitted packets be printed. .TP .B local -Don't use the modem control lines. +Don't use the modem control lines. With this option, +.B pppd +will ignore the state of the carrier detect signal from the modem and +will not change the state of the data terminal ready signal. .TP .B mtu \fI Set the MTU [Maximum Transmit Unit] value to \fI\fR. Unless the @@ -286,6 +314,10 @@ Add an entry to this system's ARP [Address Resolution Protocol] table with the IP address of the peer and the Ethernet address of this system. .TP +.B persist +Do not exit after a connection is terminated; instead try to reopen +the connection. +.TP .B login Use the system password database for authenticating the peer using PAP. @@ -591,23 +623,25 @@ This can be useful if the PPP negotiation does not succeed. If debugging is enabled at compile time, the \fBdebug\fR option also causes other debugging messages to be logged. .LP -Debugging can also be enabled by sending a +Debugging can also be enabled or disabled by sending a SIGUSR1 to the .I pppd -process. -Debugging may be disabled by sending a SIGUSR2 to the -.I pppd -process. +process. This signal acts as a toggle. .SH FILES .TP -.B /var/run/ppp\fIn\fB.pid \fR(BSD), \fB/etc/ppp/ppp\fIn\fB.pid \fR(SunOS) +.B /var/run/ppp\fIn\fB.pid \fR(BSD or Linux), \fB/etc/ppp/ppp\fIn\fB.pid \fR(others) 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. +executed with the parameters +.IP +\fIinterface-name tty-device speed local-IP-address +remote-IP-address\fR +.IP +and with its standard input, +output and error streams redirected to \fB/dev/null\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 @@ -679,20 +713,29 @@ The following signals have the specified effect when sent to the process. .TP .B SIGINT, SIGTERM -These signals cause \fIpppd\fR to terminate the link (by closing LCP), +These signals cause \fBpppd\fR to terminate the link (by closing LCP), restore the serial device settings, and exit. .TP .B SIGHUP -Indicates that the physical layer has been disconnected. \fIpppd\fR -will attempt to restore the serial device settings (this may produce -error messages on Suns), and then exit. -.SH BUGS -The use of the modem control lines and the effects of the \fBmodem\fR -and \fBlocal\fR options are not well defined. +This signal causes \fBpppd\fR to terminate the link, restore the +serial device settings, and close the serial device. If the +\fBpersist\fR option has been specified, \fBpppd\fR will try to reopen +the serial device and start another connection. Otherwise \fBpppd\fR +will exit. +.TP +.B SIGUSR2 +This signal causes +.B pppd +to renegotiate compression. This can be useful to re-enable +compression after it has been disabled as a result of a fatal +decompression error. With the BSD Compress scheme, fatal +decompression errors generally indicate a bug in one or other +implementation. + .SH AUTHORS Drew Perkins, Brad Clements, Karl Fox, Greg Christy, -Brad Parker (brad@fcr.com), -Paul Mackerras (paulus@cs.anu.edu.au) +Brad Parker, +Paul Mackerras (paulus@cs.anu.edu.au).