1 .TH PPTPD 8 "29 December 2005"
3 pptpd - PPTP VPN daemon
12 is the Poptop PPTP daemon, which manages tunnelled PPP connections
13 encapsulated in GRE using the PPTP VPN protocol. It may contain
14 features like IP address management and TCP wrappers if compiled in.
17 Here we document the command line options. See
19 for configuration directives, IP address allocation, routing, and
23 \fB-b\fR|\fB--bcrelay \fIinternal-interface
24 specifies that broadcasts received on the server's internal
25 network interface should be relayed to the clients.
28 \fB-c\fR|\fB--conf \fIconf-file
29 specifies the configuration file for
36 turns on debugging mode, causing more debugging messages to be sent
40 \fB-e\fR|\fB--ppp \fIpppd-program
43 in place of the default
48 run in the foreground instead of detaching from terminal
52 display program usage.
56 do not send the client's IP address to ip-up scripts (required if you are using the
59 option for some other purpose).
62 \fB-l\fR|\fB--listen \fIx.x.x.x
63 specifies the local interface IP address to listen on.
66 \fB-o\fR|\fB--option \fIppp-conf-file
67 specifies that pptpd should specify an alternate configuration file
68 for the ppp daemon (the default is normally
70 but may vary depending on your ppp daemon).
73 \fB-p\fR|\fB--pidfile \fIpid-file
74 specifies an alternate location to store the process ID file (default
75 .IR /var/run/pptpd.pid ).
78 \fB-s\fR|\fB--speed \fIbaud
79 specifies that the speed
81 should be passed to the ppp daemon as the tty speed to use (in some
82 cases this is ignored by the ppp daemon).
85 \fB-t\fR|\fB--stimeout \fIseconds
86 specifies the number of seconds to wait for the first packet before
87 dropping the connection. This is a denial of service protection
94 as users connect and disconnect. See
98 \fB-C\fR|\fB--connections \fIn
99 limits the number of client connections that may be accepted. Corresponds to the
103 If pptpd is allocating IP addresses (e.g.
105 is not used) then the number of connections is also limited by the
112 delegates the allocation of client IP addresses to
114 Without this option, which is the default, pptpd manages the list of
115 IP addresses for clients and passes the next free address to pppd.
116 With this option, pptpd does not pass an address, and so pppd may use
117 radius or chap-secrets to allocate an address.
121 displays the current version of the pptp daemon.
129 To turn on debugging, add 'debug' to /etc/pptpd.conf and your
130 PPP options file, and restart pptpd.
133 Typically the PPP options file is options.pptpd in /etc/ppp, though on
134 some distributions it may be pptpd-options. Use your package manager
135 to find it, e.g. 'rpm -ql pptpd | grep options' or 'dpkg --listfiles
136 pptpd | grep options'.
139 You may need to configure syslogd to catch debug messages. e.g. edit
140 /etc/syslog.conf and add something similar to the example below, then
146 *.debug;mail.none /var/log/debug
149 This will log all debug information, except mail, to the file
150 /var/log/debug. Note that this is a lot of information and might
151 flood your disks. If performance is an issue, you can try turning off
152 sync during your debugging, by prefixing the destination with '-'.
157 *.debug;mail.none -/var/log/debug
160 Disable this line and restart syslog after you are done debugging.
161 See the syslog man pages for more details.
166 Poptop is written by Matthew Ramsay <matthewr@moreton.com.au>, David Luyer
167 <luyer@ucs.uwa.edu.au>, Kevin Thayer <tmk@netmagic.net>, Peter Galbavy
168 <Peter.Galbavy@knowledge.com> and others. Development has been moved to
169 SourceForge and worked on by Richard de Vroede <r.devroede@linvision.com>
172 Copyright \(co 1999 Matthew Ramsay and others.
174 Poptop is free software; you can redistribute it and/or modify it under
175 the terms of the GNU General Public License as published by the Free
176 Software Foundation; either version 2, or (at your option) any later
179 Poptop is distributed in the hope that it will be useful, but WITHOUT ANY
180 WARRANTY; without even the implied warranty of MERCHANTABILITY or
181 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
184 You should have received a copy of the GNU General Public License along
185 with Poptop; see the file COPYING. If not, write to the Free Software
186 Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
188 The most recent version of Poptop is available for download from
190 .IR http://sourceforge.net/projects/poptop .