Browse code

Documented --ip-win32 adaptive.

git-svn-id: http://svn.openvpn.net/projects/openvpn/branches/BETA21/openvpn@768 e7ae566f-a301-0410-adde-c780ea21d3b5

james authored on 2005/11/03 11:46:31
Showing 3 changed files
... ...
@@ -11,7 +11,8 @@ $Id$
11 11
 * Moved easy-rsa 2.0 scripts to easy-rsa/2.0 to
12 12
   be compatible with 2.0.x distribution.
13 13
 * Documented --route-nopull.
14
-
14
+* Documented --ip-win32 adaptive.
15
+	
15 16
 2005.11.01 -- Version 2.1-beta6
16 17
 
17 18
 * Security fix (merged from 2.0.4) -- Affects non-Windows
... ...
@@ -4169,7 +4169,7 @@ adapter manually and indicating the IP/netmask which
4169 4169
 OpenVPN expects the adapter to be set to.
4170 4170
 
4171 4171
 .B dynamic [offset] [lease-time] --
4172
-(Default) Automatically set the IP address and netmask by replying to
4172
+Automatically set the IP address and netmask by replying to
4173 4173
 DHCP query messages generated by the kernel.  This mode is
4174 4174
 probably the "cleanest" solution
4175 4175
 for setting the TCP/IP properties since it uses the well-known
... ...
@@ -4220,6 +4220,35 @@ that it works okay in practice.  If you use this option,
4220 4220
 it is best to leave the TCP/IP properties for the TAP-Win32
4221 4221
 adapter in their default state, i.e. "Obtain an IP address
4222 4222
 automatically."
4223
+
4224
+.B adaptive --
4225
+(Default) Try
4226
+.B dynamic
4227
+method initially and fail over to
4228
+.B netsh
4229
+if the DHCP negotiation with the TAP-Win32 adapter does
4230
+not succeed in 20 seconds.  Such failures have been known
4231
+to occur when certain third-party firewall packages installed
4232
+on the client machine block the DHCP negotiation used by
4233
+the TAP-Win32 adapter.
4234
+Note that if the
4235
+.B netsh
4236
+failover occurs, the TAP-Win32 adapter
4237
+TCP/IP properties will be reset from DHCP to static, and this
4238
+will cause future OpenVPN startups using the
4239
+.B adaptive
4240
+mode to use
4241
+.B netsh
4242
+immediately, rather than trying
4243
+.B dynamic
4244
+first.  To "unstick" the
4245
+.B adaptive
4246
+mode from using
4247
+.B netsh,
4248
+run OpenVPN at least once using the
4249
+.B dynamic
4250
+mode to restore the TAP-Win32 adapter TCP/IP properties
4251
+to a DHCP configuration.
4223 4252
 .\"*********************************************************
4224 4253
 .TP
4225 4254
 .B --route-method m
... ...
@@ -499,8 +499,8 @@ static const char usage_message[] =
499 499
   "\n"
500 500
   "Windows Specific:\n"
501 501
   "--ip-win32 method : When using --ifconfig on Windows, set TAP-Win32 adapter\n"
502
-  "                    IP address using method = manual, netsh, ipapi, or\n"
503
-  "                    dynamic (default = ipapi).\n"
502
+  "                    IP address using method = manual, netsh, ipapi,\n"
503
+  "                    dynamic, or adaptive (default = adaptive).\n"
504 504
   "                    Dynamic method allows two optional parameters:\n"
505 505
   "                    offset: DHCP server address offset (> -256 and < 256).\n"
506 506
   "                            If 0, use network address, if >0, take nth\n"