1PPTPD(8)                    System Manager's Manual                   PPTPD(8)
2
3
4

NAME

6       pptpd - PPTP VPN daemon
7

SYNOPSIS

9       pptpd [ options ]
10

DESCRIPTION

12       pptpd  is  the  Poptop PPTP daemon, which manages tunnelled PPP connec‐
13       tions encapsulated in GRE using the PPTP VPN protocol.  It may  contain
14       features like IP address management and TCP wrappers if compiled in.
15

OPTIONS

17       Here  we document the command line options.  See pptpd.conf(5) for con‐
18       figuration directives, IP address  allocation,  routing,  and  firewall
19       rules.
20
21
22       -b|--bcrelay internal-interface
23              specifies that broadcasts received on the server's internal net‐
24              work interface should be relayed to the clients.
25
26
27       -c|--conf conf-file
28              specifies   the   configuration   file   for   pptpd    (default
29              /etc/pptpd.conf)
30
31
32       -d|--debug
33              turns  on  debugging mode, causing more debugging messages to be
34              sent to syslog.
35
36
37       -e|--ppp pppd-program
38              use pppd-program in place of the default pppd(8).
39
40
41       -f|--fg
42              run in the foreground instead of detaching from terminal
43
44
45       -h|--help
46              display program usage.
47
48
49       -i|--noipparam
50              do not send the client's IP address to ip-up  scripts  (required
51              if  you are using the pppd(8) ipparam option for some other pur‐
52              pose).
53
54
55       -l|--listen x.x.x.x
56              specifies the local interface IP address to listen on.
57
58
59       -o|--option ppp-conf-file
60              specifies that pptpd should specify an  alternate  configuration
61              file   for   the   ppp   daemon   (the   default   is   normally
62              /etc/ppp/options but may vary depending on your ppp daemon).
63
64
65       -p|--pidfile pid-file
66              specifies an alternate location to store  the  process  ID  file
67              (default /var/run/pptpd.pid).
68
69
70       -s|--speed baud
71              specifies that the speed baud should be passed to the ppp daemon
72              as the tty speed to use (in some cases this is  ignored  by  the
73              ppp daemon).
74
75
76       -t|--stimeout seconds
77              specifies  the  number  of  seconds to wait for the first packet
78              before dropping the connection. This is a denial of service pro‐
79              tection feature.
80
81
82       -w|--logwtmp
83              update wtmp(5) as users connect and disconnect.  See wtmp(1).
84
85
86       -C|--connections n
87              limits  the  number  of client connections that may be accepted.
88              Corresponds to the connections option in pptpd.conf.   If  pptpd
89              is  allocating  IP addresses (e.g.  --delegate is not used) then
90              the number of connections is also limited by the remoteip option
91              in pptpd.conf.
92
93
94       -D|--delegate
95              delegates  the  allocation  of  client  IP addresses to pppd(8).
96              Without this option, which is the  default,  pptpd  manages  the
97              list  of  IP  addresses  for  clients  and  passes the next free
98              address to pppd.  With this  option,  pptpd  does  not  pass  an
99              address,  and so pppd may use radius or chap-secrets to allocate
100              an address.
101
102
103       -V|--vrf vrf-name
104              specifies the VRF to be used for listening in.
105
106
107       -v|--version
108              displays the current version of the pptp daemon.
109
110

FILES

112       /etc/pptpd.conf
113       /var/run/pptpd.pid
114
115

DEBUGGING

117       To turn on debugging, add  'debug'  to  /etc/pptpd.conf  and  your  PPP
118       options file, and restart pptpd.
119
120       Typically  the PPP options file is options.pptpd in /etc/ppp, though on
121       some distributions it may be pptpd-options.  Use your  package  manager
122       to  find  it,  e.g. 'rpm -ql pptpd | grep options' or 'dpkg --listfiles
123       pptpd | grep options'.
124
125       You may need to configure syslogd to catch debug messages.   e.g.  edit
126       /etc/syslog.conf  and  add something similar to the example below, then
127       restart syslogd.
128
129       # debug logging
130       *.debug;mail.none                                       /var/log/debug
131
132       This  will  log  all  debug  information,  except  mail,  to  the  file
133       /var/log/debug.  Note that this is a lot of information and might flood
134       your disks.  If performance is an issue, you can try turning  off  sync
135       during your debugging, by prefixing the destination with '-'.
136
137       # debug logging
138       *.debug;mail.none                                       -/var/log/debug
139
140       Disable this line and restart syslog after you are done debugging.  See
141       the syslog man pages for more details.
142

AUTHORS

144       Poptop is written by Matthew  Ramsay  <matthewr@moreton.com.au>,  David
145       Luyer  <luyer@ucs.uwa.edu.au>,  Kevin  Thayer <tmk@netmagic.net>, Peter
146       Galbavy <Peter.Galbavy@knowledge.com> and others. Development has  been
147       moved   to   SourceForge   and   worked   on   by   Richard  de  Vroede
148       <r.devroede@linvision.com> since June 26, 2002.
149
151       Copyright © 1999 Matthew Ramsay and others.
152
153       Poptop is free software; you can redistribute it and/or modify it under
154       the  terms  of  the GNU General Public License as published by the Free
155       Software Foundation; either version 2, or (at your  option)  any  later
156       version.
157
158       Poptop  is  distributed in the hope that it will be useful, but WITHOUT
159       ANY WARRANTY; without even the implied warranty of  MERCHANTABILITY  or
160       FITNESS  FOR  A PARTICULAR PURPOSE.  See the GNU General Public License
161       for more details.
162
163       You should have received a copy of the GNU General Public License along
164       with  Poptop; see the file COPYING.  If not, write to the Free Software
165       Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
166

AVAILABILITY

168       The most recent version  of  Poptop  is  available  for  download  from
169       SourceForge at http://sourceforge.net/projects/poptop.
170

SEE ALSO

172       pppd(8), pptpd(8), pptpd.conf(5).
173
174
175
176                               29 December 2005                       PPTPD(8)
Impressum