From owner-svn-src-all@freebsd.org Mon Oct 3 19:02:23 2016 Return-Path: Delivered-To: svn-src-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id C9E33AF380B; Mon, 3 Oct 2016 19:02:23 +0000 (UTC) (envelope-from vangyzen@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 8494479A; Mon, 3 Oct 2016 19:02:23 +0000 (UTC) (envelope-from vangyzen@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id u93J2M4M062237; Mon, 3 Oct 2016 19:02:22 GMT (envelope-from vangyzen@FreeBSD.org) Received: (from vangyzen@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id u93J2MR8062236; Mon, 3 Oct 2016 19:02:22 GMT (envelope-from vangyzen@FreeBSD.org) Message-Id: <201610031902.u93J2MR8062236@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: vangyzen set sender to vangyzen@FreeBSD.org using -f From: Eric van Gyzen Date: Mon, 3 Oct 2016 19:02:22 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r306652 - head/usr.sbin/arp X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 03 Oct 2016 19:02:23 -0000 Author: vangyzen Date: Mon Oct 3 19:02:22 2016 New Revision: 306652 URL: https://svnweb.freebsd.org/changeset/base/306652 Log: Update arp(4) to document the net.link.ether.inet.garp_rexmit_count sysctl. Submitted by: David A. Bright Requested by: markj Reviewed by: markj, badger MFC after: 4 weeks X-MFC with: r306577 Sponsored by: Dell EMC Differential Revision: https://reviews.freebsd.org/D8136 Modified: head/usr.sbin/arp/arp.4 Modified: head/usr.sbin/arp/arp.4 ============================================================================== --- head/usr.sbin/arp/arp.4 Mon Oct 3 18:20:58 2016 (r306651) +++ head/usr.sbin/arp/arp.4 Mon Oct 3 19:02:22 2016 (r306652) @@ -28,7 +28,7 @@ .\" @(#)arp4.4 6.5 (Berkeley) 4/18/94 .\" $FreeBSD$ .\" -.Dd November 5, 2013 +.Dd October 3, 2016 .Dt ARP 4 .Os .Sh NAME @@ -126,6 +126,24 @@ 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. +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. +The interval between retransmissions is doubled each time, so the +retransmission intervals are: {1, 2, 4, 8, 16, ...} (seconds). +The default value of zero means only the initial GARP is sent; no +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. .It Va log_arp_movements Should the kernel log movements of IP addresses from one hardware address to an other.