2 .\" SS subsection heading
4 .\" IP indented paragraph
7 .\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
8 .\" other parms are allowed: see man(7), man(1)
13 .I "<pptp-server-IP> <pptp-options> [ppp-options] ..."
17 establishes the client side of a Virtual Private Network (VPN) using
18 the Point-to-Point Tunneling Protocol (PPTP). Use this program to
19 connect to an employer's PPTP based VPN, or to certain cable and ADSL
22 By default, \fBpptp\fR establishes the PPTP call to the PPTP server,
23 and then starts an instance of \fBpppd\fR to manage the data transfer.
24 However, \fBpptp\fR can also be run as a connection manager within
28 The first non\-option argument on the \fBpptp\fR command line must be the host
29 name or IP address of the PPTP server.
31 All long options (starting with "\-\-")
32 are interpreted as pptp options, and a fatal error occurs if an
33 unrecognised option is used.
35 All command\-line arguments which do not start
36 with "\-" are interpreted as ppp options, and passed as is to \fBpppd\fR unless
37 \fB\-\-nolaunchpppd\fR is given.
40 Pass <number> to remote host as phone number
45 but use stdin as the network connection. Use this flag when including
49 connection process using the
54 Work around a buggy PPTP implementation, adopts special case handling for
55 particular PPTP servers and ADSL modems.
56 Currently recognised values are BEZEQ_ISRAEL only
59 Run in foreground (for debugging with gdb)
62 Enable Synchronous HDLC (pppd must use it too)
65 Time to wait for reordered packets (0.01 to 10 secs)
68 Completely disables buffering and reordering of packets.
69 Any \-\-timeout specified will be ignored.
71 .B \-\-idle-wait <secs>
72 Time to wait before sending a control connection echo request.
73 The RFC2637 default is 60 seconds.
75 .B \-\-max-echo-wait <secs>
76 Time to wait for an echo reply before closing the control connection.
77 The RFC2637 default is 60 seconds.
79 .B \-\-logstring <name>
80 Use <name> instead of 'anon' in syslog messages
82 .B \-\-localbind <addr>
83 Bind to specified IP address instead of wildcard
85 .B \-\-loglevel <level>
86 Sets the debugging level (0=low, 1=default, 2=high)
90 Enable packet reordering tests that damage the integrity of the packet
91 stream to the server. Use this only when testing servers. Zero is
92 the default, and means that packets are sent in the correct order. A
93 value of one (1) causes a single swap between two packets, such that
94 the sequence numbers might be 1 2 3 4 6 5 7 8 9. A value of two (2)
95 causes ten packets to be buffered, then sent out of order but
96 ascending, such that the sequence numbers might be 1 2 3 4 16 6 7 8 9
97 10 11 12 13 14 15 17 18 19 20. A value of three (3) causes ten
98 packets to be buffered, then sent in the reverse order, like this; 1 2
99 3 4 16 15 14 13 12 11 10 9 8 7 6 5 17 18 19 20.
103 Sets the number of packets to pass before causing a reordering test.
104 Default is 100. Has no effect if test-type is zero. The result of
105 test types 2 and 3 are undefined if this value is less than ten.
112 modifies packets to interoperate with Orckit ADSL modems on the BEZEQ
117 .B Connection to a Microsoft Windows VPN Server
120 pppd noauth nobsdcomp nodeflate require\-mppe\-128 name domain\\\\\\\\username remotename PPTP pty "pptp 10.0.0.5 \-\-nolaunchpppd"
122 Note that the \fBchap\-secrets\fR file used by \fBpppd\fR must include an entry for domain\\\\username
125 The pptp process collects statistics when sending and receiving
126 GRE packets. They are intended to be useful for debugging poor PPTP
127 performance and for general monitoring of link quality. The statistics
128 are cumulative since the pptp process was started.
130 The statistics can be viewed by sending a SIGUSR1 signal to the
131 "GRE-to-PPP Gateway" process, which will cause it to dump them
132 to the system logs (at the LOG_NOTICE level). A better way to present
133 the statistics to applications is being sought (e.g. SNMP?).
135 The following statistics are collected at the time of writing (April 2003):
138 the number of GRE packets successfully passed to PPP
141 the number of packets never received, and presumed lost in the network
144 the number of packets which were duplicates or had old sequence numbers
145 (this might be caused by a packet-reordering network if your reordering
146 timeout is set too low)
149 the number of packets which were too far ahead in the sequence to be
150 reordered (might be caused by loss of more than 300 packets in a row)
153 the number of packets which were slightly ahead of sequence, and were
154 either buffered for reordering, or if buffering is disabled, accepted
155 immediately (resulting in the intermediate packets being discarded).
158 the number of times where the operating system reported an error when
159 we tried to read a packet
162 the number of times we received a packet which was shorter than the
163 length implied by the GRE header
166 the number of times we received a packet which had invalid or unsupported
167 flags set in the header, wrong version, or wrong protocol.
170 the number of pure acknowledgements received (without data). Too many
171 of these will waste bandwidth, and might be solved by tuning the remote host.
174 the number of GRE packets sent with data
177 the number of packets we tried to send, but the OS reported an error
180 the number of times the OS would not let us write a complete packet
183 the number of times we sent a pure ack, without data
186 the number of times we couldn't send a packet because it was over
187 PACKET_MAX bytes long
190 the estimated round-trip time in milliseconds
196 .IR /usr/share/doc/pptp
198 This manual page was written by James Cameron
199 <james.cameron@hp.com> from text contributed by Thomas Quinot
200 <thomas@debian.org>, for the Debian GNU/Linux system.
201 The description of the available statistics was written by Chris Wilson
202 <chris@netservers.co.uk>. Updates for the Debian distribution by
203 Ola Lundqvist <opal@debian.org>.
OSDN Git Service
