Man Linux: Main Page and Category List

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