Commit 4880739c17b502d00a removed DNS randomization, and the dual-stack
patches for 2.4 completely changed the getaddrinfo() result handling again,
but neither fact ever made it into the man page.

Trac #411

Signed-off-by: Gert Doering <g...@greenie.muc.de>
---
 doc/openvpn.8 | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/doc/openvpn.8 b/doc/openvpn.8
index 67e6ddd..d2b6359 100644
--- a/doc/openvpn.8
+++ b/doc/openvpn.8
@@ -268,9 +268,16 @@ not match
 If
 .B host
 is a DNS name which resolves to multiple IP addresses,
-one will be randomly
-chosen, providing a sort of basic load-balancing and
-failover capability.
+OpenVPN will try them in the order that the system getaddrinfo()
+presents them, so priorization and DNS randomization is done
+by the system library.  Unless an IP version is forced by the
+protocol specification (4/6 suffix), OpenVPN will try both IPv4
+and IPv6 addresses, in the order getaddrinfo() returns them.
+(Internally, multiple addresses are mutated into individual
+.B <connection>
+blocks, so
+.B \-\-remote\-random
+will randomize the order across all hosts and addresses)
 .\"*********************************************************
 .TP
 .B \-\-remote\-random\-hostname
-- 
2.3.6


Reply via email to