PPTPD(8)						      System Manager's Manual							  PPTPD(8)

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  man-
       ager 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 (C) 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 Soft-
       ware 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)