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|--vrf vrf-name
              specifies the VRF to be used for listening in.

       -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                                        PPTPD(8)