File: pptpd.8

package info (click to toggle)
pptpd 1.3.0-2etch2
  • links: PTS
  • area: main
  • in suites: etch
  • size: 1,036 kB
  • ctags: 856
  • sloc: ansic: 5,338; sh: 613; perl: 157; makefile: 130
file content (172 lines) | stat: -rw-r--r-- 4,658 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
.TH PPTPD 8 "24 May 2004"
.SH NAME
pptpd - PPTP VPN daemon
.SH SYNOPSIS
.PP
.B pptpd
[ 
.IR options
]
.SH DESCRIPTION
.B 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.
.SH OPTIONS

Here we document the command line options.  See 
.BR pptpd.conf (5)
for configuration directives, IP address allocation, routing, and
firewall rules.

.TP
\fB-b\fR|\fB--bcrelay \fIinternal-interface
specifies that broadcasts received on the server's internal 
network interface should be relayed to the clients.

.TP
\fB-c\fR|\fB--conf \fIconf-file
specifies the configuration file for
.B pptpd
(default
.IR /etc/pptpd.conf )

.TP
.BR -d | --debug
turns on debugging mode, causing more debugging messages to be sent
to syslog.

.TP
\fB-e\fR|\fB--ppp \fIpppd-program
use
.I pppd-program
in place of the default
.BR pppd (8).

.TP
.BR -f | --fg
run in the foreground instead of detaching from terminal

.TP
.BR -h | --help
display program usage.

.TP
.BR -i | --noipparam
do not send the client's IP address to ip-up scripts (required if you are using the 
.BR pppd (8)
.I ipparam
option for some other purpose).

.TP
\fB-l\fR|\fB--listen \fIx.x.x.x
specifies the local interface IP address to listen on.

.TP
\fB-o\fR|\fB--option \fIppp-conf-file
specifies that pptpd should specify an alternate configuration file
for the ppp daemon (the default is normally
.I /etc/ppp/options
but may vary depending on your ppp daemon).

.TP
\fB-p\fR|\fB--pidfile \fIpid-file
specifies an alternate location to store the process ID file (default
.IR /var/run/pptpd.pid ).

.TP
\fB-s\fR|\fB--speed \fIbaud
specifies that the speed
.I baud
should be passed to the ppp daemon as the tty speed to use (in some
cases this is ignored by the ppp daemon).

.TP
\fB-t\fR|\fB--stimeout \fIseconds
specifies the number of seconds to wait for the first packet before
dropping the connection. This is a denial of service protection
feature.

.TP
.BR -w | --logwtmp
update
.BR wtmp (5)
as users connect and disconnect.  See
.BR wtmp (1).

.TP
.BR -v | --version
displays the current version of the pptp daemon.

.SH FILES
/etc/pptpd.conf
.br
/var/run/pptpd.pid

.SH DEBUGGING
To turn on debugging, add 'debug' to /etc/pptpd.conf and your
PPP options file, and restart pptpd.
.br
.LP
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'.
.br
.LP
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.
.br
.LP
# debug logging
.br
*.debug;mail.none                                       /var/log/debug
.br
.LP
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 '-'.
.br
.LP
# debug logging
.br
*.debug;mail.none                                       -/var/log/debug
.br
.LP
Disable this line and restart syslog after you are done debugging.
See the syslog man pages for more details.
.br
.LP

.SH 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.
.SH COPYRIGHT
Copyright \(co 1999 Matthew Ramsay and others.
.LP
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.
.LP
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.
.LP
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.
.SH AVAILABILITY
The most recent version of Poptop is available for download from
SourceForge at
.IR http://sourceforge.net/projects/poptop .
.SH "SEE ALSO"
.BR pppd (8),
.BR pptpd (8),
.BR pptpd.conf (5).