NAME
pptpd - PPTP VPN daemon
SYNOPSIS
pptpd [ options ]
DESCRIPTION
pptpd is the Poptop PPTP daemon, which manages tunnelled PPP
connections encapsulated in GRE using the PPTP VPN protocol. It may
contain features like IP address management and TCP wrappers if
compiled in.
OPTIONS
Here we document the command line options. See pptpd.conf(5) for
configuration directives, IP address allocation, routing, and firewall
rules.
-b|--bcrelay internal-interface
specifies that broadcasts received on the server’s internal
network interface should be relayed to the clients.
-c|--conf conf-file
specifies the configuration file for pptpd (default
/etc/pptpd.conf)
-d|--debug
turns on debugging mode, causing more debugging messages to be
sent to syslog.
-e|--ppp pppd-program
use pppd-program in place of the default pppd(8).
-f|--fg
run in the foreground instead of detaching from terminal
-h|--help
display program usage.
-i|--noipparam
do not send the client’s IP address to ip-up scripts (required
if you are using the pppd(8) ipparam option for some other
purpose).
-l|--listen x.x.x.x
specifies the local interface IP address to listen on.
-o|--option ppp-conf-file
specifies that pptpd should specify an alternate configuration
file for the ppp daemon (the default is normally
/etc/ppp/options but may vary depending on your ppp daemon).
-p|--pidfile pid-file
specifies an alternate location to store the process ID file
(default /var/run/pptpd.pid).
-s|--speed baud
specifies that the speed baud should be passed to the ppp daemon
as the tty speed to use (in some cases this is ignored by the
ppp daemon).
-t|--stimeout seconds
specifies the number of seconds to wait for the first packet
before dropping the connection. This is a denial of service
protection feature.
-w|--logwtmp
update wtmp(5) as users connect and disconnect. See wtmp(1).
-C|--connections n
limits the number of client connections that may be accepted.
Corresponds to the connections option in pptpd.conf. If pptpd
is allocating IP addresses (e.g. --delegate is not used) then
the number of connections is also limited by the remoteip option
in pptpd.conf.
-D|--delegate
delegates the allocation of client IP addresses to pppd(8).
Without this option, which is the default, pptpd manages the
list of IP addresses for clients and passes the next free
address to pppd. With this option, pptpd does not pass an
address, and so pppd may use radius or chap-secrets to allocate
an address.
-v|--version
displays the current version of the pptp daemon.
FILES
/etc/pptpd.conf
/var/run/pptpd.pid
DEBUGGING
To turn on debugging, add ’debug’ to /etc/pptpd.conf and your PPP
options file, and restart pptpd.
Typically the PPP options file is options.pptpd in /etc/ppp, though on
some distributions it may be pptpd-options. Use your package manager
to find it, e.g. ’rpm -ql pptpd | grep options’ or ’dpkg --listfiles
pptpd | grep options’.
You may need to configure syslogd to catch debug messages. e.g. edit
/etc/syslog.conf and add something similar to the example below, then
restart syslogd.
# debug logging
*.debug;mail.none /var/log/debug
This will log all debug information, except mail, to the file
/var/log/debug. Note that this is a lot of information and might flood
your disks. If performance is an issue, you can try turning off sync
during your debugging, by prefixing the destination with ’-’.
# debug logging
*.debug;mail.none -/var/log/debug
Disable this line and restart syslog after you are done debugging. See
the syslog man pages for more details.
AUTHORS
Poptop is written by Matthew Ramsay <matthewr@moreton.com.au>, David
Luyer <luyer@ucs.uwa.edu.au>, Kevin Thayer <tmk@netmagic.net>, Peter
Galbavy <Peter.Galbavy@knowledge.com> and others. Development has been
moved to SourceForge and worked on by Richard de Vroede
<r.devroede@linvision.com> since June 26, 2002.
COPYRIGHT
Copyright © 1999 Matthew Ramsay and others.
Poptop is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.
Poptop is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License along
with Poptop; see the file COPYING. If not, write to the Free Software
Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
AVAILABILITY
The most recent version of Poptop is available for download from
SourceForge at http://sourceforge.net/projects/poptop.
SEE ALSO
pppd(8), pptpd(8), pptpd.conf(5).
29 December 2005