improve the load balancing text; ok mpi

1 files changed, 16 insertions, 14 deletions

diff --git a/share/man/man4/carp.4 b/share/man/man4/carp.4
index c4d5df95585..42ed7d7460e 100644
--- a/share/man/man4/carp.4
+++ b/share/man/man4/carp.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: carp.4,v 1.37 2015/11/02 15:18:51 mpi Exp $
+.\"	$OpenBSD: carp.4,v 1.38 2015/11/03 17:45:32 jmc Exp $
 .\"
 .\" Copyright (c) 2003, Ryan McBride.  All rights reserved.
 .\"
@@ -23,7 +23,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: November 2 2015 $
+.Dd $Mdocdate: November 3 2015 $
 .Dt CARP 4
 .Os
 .Sh NAME
@@ -108,16 +108,14 @@ The default value is 2, which limits logging to changes in CARP state.
 .El
 .Sh LOAD BALANCING
 .Nm
-provides a mechanism to load balance incoming traffic
+uses IP balancing to load balance incoming traffic
 over a group of
 .Nm
-hosts: IP balancing.
-IP balancing is not dependent on ARP and therefore also works
+hosts.
+IP balancing is not dependent on ARP and therefore works
 for traffic that comes over a router.
-This method should work in all environments.
-The downside of IP balancing is that it requires the traffic
-that is destined towards the load balanced IP addresses
-to be received by all
+However it requires the traffic that is destined towards
+the load balanced IP addresses to be received by all
 .Nm
 hosts.
 While this is always the case when connected to a hub,
@@ -167,7 +165,7 @@ state of the carpnode.
 IP balancing is activated by setting the
 .Cm balancing
 mode to
-.Ar ip .
+.Cm ip .
 This is the recommended default setting.
 In this mode, carp uses a multicast MAC address, so that a switch
 sends incoming traffic towards all nodes.
@@ -248,13 +246,17 @@ The
 .Cm advskew
 of 100 on the second carpnode entry means that its advertisements will be sent
 out slightly less frequently and will therefore become the designated backup.
-.Pp
-.Dl # ifconfig carp0 192.168.1.10 carpdev em0 carpnodes 1:0,2:100 balancing ip
+.Bd -literal -offset indent
+# ifconfig carp0 192.168.1.10 carpdev em0 carpnodes 1:0,2:100 \e
+	balancing ip
+.Ed
 .Pp
 The configuration for host B is identical, except the skew is on
 the carpnode entry with virtual host 1 rather than virtual host 2.
-.Pp
-.Dl # ifconfig carp0 192.168.1.10 carpdev em0 carpnodes 1:100,2:0 balancing ip
+.Bd -literal -offset indent
+# ifconfig carp0 192.168.1.10 carpdev em0 carpnodes 1:100,2:0 \e
+	balancing ip
+.Ed
 .Pp
 If a different mode of load balancing is desired the
 .Cm balancing