1PPTPD(8) System Manager's Manual PPTPD(8)
2
3
4
6 pptpd - PPTP VPN daemon
7
9 pptpd [ options ]
10
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
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
112 /etc/pptpd.conf
113 /var/run/pptpd.pid
114
115
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
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
168 The most recent version of Poptop is available for download from
169 SourceForge at http://sourceforge.net/projects/poptop.
170
172 pppd(8), pptpd(8), pptpd.conf(5).
173
174
175
176 29 December 2005 PPTPD(8)