Index: usr.sbin/arp/arp.4 =================================================================== --- usr.sbin/arp/arp.4 +++ usr.sbin/arp/arp.4 @@ -28,7 +28,7 @@ .\" @(#)arp4.4 6.5 (Berkeley) 4/18/94 .\" $FreeBSD$ .\" -.Dd October 3, 2016 +.Dd October 7, 2016 .Dt ARP 4 .Os .Sh NAME @@ -121,14 +121,13 @@ MIB. .Bl -tag -width "log_arp_permanent_modify" .It Va allow_multicast -Should the kernel install ARP entries with multicast bit set in -the hardware address. +Install ARP entries with multicast bit set in the hardware address. Installing such entries is RFC 1812 violation, but some prorietary load balancing techniques require routers on network to do so. Turned off by default. .It Va garp_rexmit_count -Should the kernel retransmit gratuitous ARP (GARP) packets when an IPv4 address -is added to an interface. +Retransmit gratuitous ARP (GARP) packets when an IPv4 address is added to an +interface. A GARP is always transmitted when an IPv4 address is added to an interface. A non-zero value of this sysctl will cause the GARP packet to be retransmitted the stated number of times. @@ -138,30 +137,28 @@ additional GARP packets are retransmitted. The maximum value is sixteen. .Pp -Although a single GARP packet (the default behavior) is usually sufficient, in -some circumstances, such as when a shared address is passed between cluster -nodes, this single GARP may be dropped or lost. -This can lead to neighbors on the network link working with a stale ARP cache -and sending packets destined for that address to the node that previously owned -the address, which may not respond. +The default behavior of a single GARP packet is usually sufficient. +However, a single GARP might be dropped or lost in some circumstances. +This is particularly harmful when a shared address is passed between cluster +nodes. +Neighbors on the network link might then work with a stale ARP cache and send +packets destined for that address to the node that previously owned the +address, which might not respond. .It Va log_arp_movements -Should the kernel log movements of IP addresses from one hardware -address to an other. +Log movements of IP addresses from one hardware address to an other. See .Sx DIAGNOSTICS below. Turned on by default. .It Va log_arp_permanent_modify -Should the kernel log attempts of remote host on network to modify a -permanent ARP entry. +Log attempts by a remote host on the network to modify a permanent ARP entry. See .Sx DIAGNOSTICS below. Turned on by default. .It Va log_arp_wrong_iface -Should the kernel log attempts to insert an ARP entry on an interface -when the IP network the address belongs to is connected to an other -interface. +Log attempts to insert an ARP entry on an interface when the IP network the +address belongs to is connected to another interface. See .Sx DIAGNOSTICS below.