X-Git-Url: http://git.ozlabs.org/?p=ppp.git;a=blobdiff_plain;f=pppd%2Fpppd.8;h=b4bbdb035e5798114657d896fd81bb7e0ad26bdb;hp=5afc685e3e7a2a079f27a72c917d8991fe2d7a84;hb=1fae28ce79350b03f0cf8a69ad06dd68637cd6b1;hpb=2dc6b270ecf72688083f03d80df67d0682e1e02c diff --git a/pppd/pppd.8 b/pppd/pppd.8 index 5afc685..b4bbdb0 100644 --- a/pppd/pppd.8 +++ b/pppd/pppd.8 @@ -1,5 +1,5 @@ .\" manual page [] for pppd 2.3 -.\" $Id: pppd.8,v 1.27 1998/03/31 04:31:08 paulus Exp $ +.\" $Id: pppd.8,v 1.34 1999/03/12 06:07:19 paulus Exp $ .\" SH section heading .\" SS subsection heading .\" LP paragraph @@ -35,32 +35,16 @@ Control Protocol, IPCP). .I Communicate over the named device. The string "/dev/" is prepended if necessary. If no device name is given, or if the name of the terminal -connected to the standard input is given, pppd -will use that terminal, and will not fork to put itself in the -background. This option is privileged if the \fInoauth\fR option is -used. +connected to the standard input is given, pppd will use that terminal, +and will not fork to put itself in the background. A value for this +option from a privileged source cannot be overridden by a +non-privileged user. .TP .I Set the baud rate to (a decimal number). On systems such as 4.4BSD and NetBSD, any speed can be specified. Other systems (e.g. SunOS) allow only a limited set of speeds. .TP -.B active-filter \fIfilter-expression -Specifies a packet filter to be applied to data packets to determine -which packets are to be regarded as link activity, and therefore reset -the idle timer, or cause the link to be brought up in demand-dialling -mode. This option is useful in conjunction with the -\fBidle\fR option if there are packets being sent or received -regularly over the link (for example, routing information packets) -which would otherwise prevent the link from ever appearing to be idle. -The \fIfilter-expression\fR syntax is as described for tcpdump(1), -except that qualifiers which are inappropriate for a PPP link, such as -\fBether\fR and \fBarp\fR, are not permitted. Generally the filter -expression should be enclosed in single-quotes to prevent whitespace -in the expression from being interpreted by the shell. This option -is currently only available under NetBSD, and then only -if both the kernel and pppd were compiled with PPP_FILTER defined. -.TP .B asyncmap \fI Set the async character map to . This map describes which control characters cannot be successfully received over the serial @@ -76,7 +60,10 @@ characters, use the \fIescape\fR option. .TP .B auth Require the peer to authenticate itself before allowing network -packets to be sent or received. +packets to be sent or received. This option is the default if the +system has a default route. If neither this option nor the +\fInoauth\fR option is specified, pppd will only allow the peer to use +IP addresses to which the system does not already have a route. .TP .B call \fIname Read options from the file /etc/ppp/peers/\fIname\fR. This file may @@ -88,14 +75,34 @@ is described below. .B connect \fIscript Use the executable or shell command specified by \fIscript\fR to set up the serial line. This script would typically use the chat(8) -program to dial the modem and start the remote ppp session. This -option is privileged if the \fInoauth\fR option is used. +program to dial the modem and start the remote ppp session. A value +for this option from a privileged source cannot be overridden by a +non-privileged user. .TP .B crtscts -Use hardware flow control (i.e. RTS/CTS) to control the flow of data -on the serial port. If neither the \fIcrtscts\fR nor the -\fInocrtscts\fR option is given, the hardware flow control setting -for the serial port is left unchanged. +Use hardware flow control (i.e. RTS/CTS) to control the flow of +data on the serial port. If neither the \fIcrtscts\fR, the +\fInocrtscts\fR, the \fIcdtrcts\fR nor the \fInocdtrcts\fR option +is given, the hardware flow control setting for the serial port is +left unchanged. +Some serial ports (such as Macintosh serial ports) lack a true +RTS output. Such serial ports use this mode to implement +unidirectional flow control. The serial port will +suspend transmission when requested by the modem (via CTS) +but will be unable to request the modem stop sending to the +computer. This mode retains the ability to use DTR as +a modem control line. +.TP +.B cdtrcts +Use a non-standard hardware flow control (i.e. DTR/CTS) to control +the flow of data on the serial port. If neither the \fIcrtscts\fR, +the \fInocrtscts\fR, the \fIcdtrcts\fR nor the \fInocdtrcts\fR +option is given, the hardware flow control setting for the serial +port is left unchanged. +Some serial ports (such as Macintosh serial ports) lack a true +RTS output. Such serial ports use this mode to implement true +bi-directional flow control. The sacrifice is that this flow +control mode does not permit using DTR as a modem control line. .TP .B defaultroute Add a default route to the system routing tables, using the peer as @@ -108,8 +115,8 @@ Run the executable or shell command specified by \fIscript\fR after pppd has terminated the link. This script could, for example, issue commands to the modem to cause it to hang up if hardware modem control signals were not available. The disconnect script is not run if the -modem has already hung up. This option is privileged if the -\fInoauth\fR option is used. +modem has already hung up. A value for this option from a privileged +source cannot be overridden by a non-privileged user. .TP .B escape \fIxx,yy,... Specifies that certain characters should be escaped on transmission @@ -163,6 +170,22 @@ will not accept a different value from the peer in the IPCP negotiation, unless the \fIipcp-accept-local\fR and/or \fIipcp-accept-remote\fR options are given, respectively. .TP +.B active-filter \fIfilter-expression +Specifies a packet filter to be applied to data packets to determine +which packets are to be regarded as link activity, and therefore reset +the idle timer, or cause the link to be brought up in demand-dialling +mode. This option is useful in conjunction with the +\fBidle\fR option if there are packets being sent or received +regularly over the link (for example, routing information packets) +which would otherwise prevent the link from ever appearing to be idle. +The \fIfilter-expression\fR syntax is as described for tcpdump(1), +except that qualifiers which are inappropriate for a PPP link, such as +\fBether\fR and \fBarp\fR, are not permitted. Generally the filter +expression should be enclosed in single-quotes to prevent whitespace +in the expression from being interpreted by the shell. This option +is currently only available under NetBSD, and then only +if both the kernel and pppd were compiled with PPP_FILTER defined. +.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 @@ -242,6 +265,10 @@ specify \fIdomain Quotron.COM\fR. Pppd would then use the name and as the default name to send to the peer when authenticating itself to the peer. This option is privileged. .TP +.B hide-password +When logging the contents of PAP packets, this option causes pppd to +exclude the password string from the log. +.TP .B holdoff \fIn Specifies how many seconds to wait before re-initiating the link after it terminates. This option only has any effect if the \fIpersist\fR @@ -449,7 +476,9 @@ specified is ORed with the default netmask. The default netmask is chosen based on the negotiated remote IP address; it is the appropriate network mask for the class of the remote IP address, ORed with the netmasks for any non point-to-point network interfaces in the -system which are on the same network. +system which are on the same network. (Note: on some platforms, pppd +will always use 255.255.255.255 for the netmask, if that is the only +appropriate value for a point-to-point interface.) .TP .B noaccomp Disable Address/Control compression in both directions (send and @@ -457,7 +486,7 @@ receive). .TP .B noauth Do not require the peer to authenticate itself. This option is -privileged if the \fIauth\fR option is specified in /etc/ppp/options. +privileged. .TP .B nobsdcomp Disables BSD-Compress compression; \fBpppd\fR will not request or @@ -469,10 +498,14 @@ should only be required if the peer is buggy and gets confused by requests from pppd for CCP negotiation. .TP .B nocrtscts -Disable hardware flow control (i.e. RTS/CTS) on the serial port. If -neither the \fIcrtscts\fR nor the \fInocrtscts\fR option is given, -the hardware flow control setting for the serial port is left -unchanged. +Disable hardware flow control (i.e. RTS/CTS) on the serial port. +If neither the \fIcrtscts\fR nor the \fInocrtscts\fR nor the +\fIcdtrcts\fR nor the \fInodtrcts\fR option is given, the hardware +flow control setting for the serial port is left unchanged. +.TP +.B nodtrcts +This option is a synonym for \fInocrtscts\fR. Either of these options will +disable both forms of hardware flow control. .TP .B nodefaultroute Disable the \fIdefaultroute\fR option. The system administrator who @@ -582,6 +615,13 @@ compression, and agree to compress transmitted frames with Predictor-1 if requested. This option has no effect unless the kernel driver supports Predictor-1 compression. .TP +.B privgroup \fIgroup-name +Allows members of group \fIgroup-name\fR to use privileged options. +This is a privileged option. Use of this option requires care as +there is no guarantee that members of \fIgroup-name\fR cannot use pppd +to become root themselves. Consider it equivalent to putting the +members of \fIgroup-name\fR in the kmem or disk group. +.TP .B proxyarp 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 @@ -616,7 +656,8 @@ the `passive' option with ancient versions of pppd). .B usehostname Enforce the use of the hostname (with domain name appended, if given) as the name of the local system for authentication purposes (overrides -the \fIname\fR option). +the \fIname\fR option). This option is not normally needed since the +\fIname\fR option is privileged. .TP .B user \fIname Sets the name used for authenticating the local system to the peer to @@ -630,8 +671,8 @@ must be between 2 and 16 (inclusive). .B welcome \fIscript Run the executable or shell command specified by \fIscript\fR before initiating PPP negotiation, after the connect script (if any) has -completed. This option is privileged if the \fInoauth\fR option is -used. +completed. A value for this option from a privileged source cannot be +overridden by a non-privileged user. .TP .B xonxoff Use software flow control (i.e. XON/XOFF) to control the flow of data on @@ -657,22 +698,24 @@ options within an options file. provides system administrators with sufficient access control that PPP access to a server machine can be provided to legitimate users without fear of compromising the security of the server or the network it's -on. In part this is provided by the /etc/ppp/options file, where the -administrator can place options to restrict the ways in which pppd can -be used, and in part by the PAP and CHAP secrets files, where the -administrator can restrict the set of IP addresses which individual -users may use. +on. This control is provided through restrictions on which IP +addresses the peer may use, based on its authenticated identity (if +any), and through restrictions on which options a non-privileged user +may use. Several of pppd's options are privileged, in particular +those which permit potentially insecure configurations; these options +are only accepted in files which are under the control of the system +administrator, or if pppd is being run by root. .PP -The normal way that pppd should be set up is to have the \fIauth\fR -option in the /etc/ppp/options file. (This may become the default in -later releases.) If users wish to use pppd to dial out to a peer -which will refuse to authenticate itself (such as an internet service -provider), the system administrator should create an options file -under /etc/ppp/peers containing the \fInoauth\fR option, the name of -the serial port to use, and the \fIconnect\fR option (if required), -plus any other appropriate options. In this way, pppd can be set up -to allow non-privileged users to make unauthenticated connections only -to trusted peers. +The default behaviour of pppd is to allow an unauthenticated peer to +use a given IP address only if the system does not already have a +route to that IP address. For example, a system with a +permanent connection to the wider internet will normally have a +default route, and thus all peers will have to authenticate themselves +in order to set up a connection. On such a system, the \fIauth\fR +option is the default. On the other hand, a system where the +PPP link is the only connection to the internet will not normally have +a default route, so the peer will be able to use almost any IP address +without authenticating itself. .PP As indicated above, some security-sensitive options are privileged, which means that they may not be used by an ordinary non-privileged @@ -682,6 +725,17 @@ option. Privileged options may be used in /etc/ppp/options file or in an options file read using the \fIcall\fR option. If pppd is being run by the root user, privileged options can be used without restriction. +.PP +When opening the device, pppd uses either the invoking user's user ID +or the root UID (that is, 0), depending on whether the device name was +specified by the user or the system administrator. If the device name +comes from a privileged source, that is, /etc/ppp/options or an +options file read using the \fIcall\fR option, pppd uses full root +privileges when opening the device. Thus, by creating an appropriate +file under /etc/ppp/peers, the system administrator can allow users to +establish a ppp connection via a device which they would not normally +have permission to access. Otherwise pppd uses the invoking user's +real UID when opening the device. .SH AUTHENTICATION Authentication is the process whereby one peer convinces the other of its identity. This involves the first peer sending its name to the @@ -985,7 +1039,7 @@ authenticates itself. .B SPEED The baud rate of the tty device. .TP -.B UID +.B ORIG_UID The real user-id of the user who invoked pppd. .P Pppd invokes the following scripts, if they exist. It is not an error