From nobody Fri Apr 17 06:15:33 2026 Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E01D63502A9; Mon, 23 Feb 2026 10:13:04 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=94.136.29.106 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771841586; cv=none; b=dgiFNHwxII3Ut33l4EefEvqsLNOYUkytvb6g4svFyDCiYZ2G/bHmm/J+8s/1g+MQjdviJd/ZN/uHWKt5Gg0vXcoXtIT/YqvfVTZIiD02rhoTryzNqB80B74sgj2seX6OHtLeKob7iV/pjOPCyKRZD9uhfLc1yAD0i/A3tm+i/wc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771841586; c=relaxed/simple; bh=zwS2JvK5j6OUItPsvrHexmjPufJl4RQImGnHKAn+Ano=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=FLwKewR4CkYFgDhbkrR4zmQLMPenZVYRUtblv2jcMe/VMQom/J72JDhTkM/NVcPHFjutpPScE/yVRd341Hzj25mmyRHGvk3CMSn12MD6Ax66FXdJPZBLtPyy4eVjUGwZxRgMTUBIWLA4vJXhvkxbS/Fcb3Gyr+flak5yxFieK7U= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=proxmox.com; spf=pass smtp.mailfrom=proxmox.com; arc=none smtp.client-ip=94.136.29.106 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=proxmox.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=proxmox.com Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id DD86347D3D; Mon, 23 Feb 2026 11:13:02 +0100 (CET) From: Gabriel Goller To: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Shuah Khan Cc: netdev@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH net-next v2] docs: net: document neigh gc_stale_time sysctl Date: Mon, 23 Feb 2026 11:12:54 +0100 Message-ID: <20260223101257.47563-1-g.goller@proxmox.com> X-Mailer: git-send-email 2.47.3 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Bm-Milter-Handled: 55990f41-d878-4baa-be0a-ee34c49e34d2 X-Bm-Transport-Timestamp: 1771841568260 Content-Type: text/plain; charset="utf-8" Add missing documentation for a neighbor table garbage collector sysctl parameter in ip-sysctl.rst: neigh/default/gc_stale_time: controls how long an unused neighbor entry is kept before becoming eligible for garbage collection (default: 60 seconds) Signed-off-by: Gabriel Goller --- Changelog: v1: * removed documentation for gc_interval, as that sysctl is not used anymore and doesn't do anything. * mention gc_stale_time only being used when we have more than gc_thresh1 neighbors. Documentation/networking/ip-sysctl.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/Documentation/networking/ip-sysctl.rst b/Documentation/network= ing/ip-sysctl.rst index 28c7e4f5ecf9..85fda3759534 100644 --- a/Documentation/networking/ip-sysctl.rst +++ b/Documentation/networking/ip-sysctl.rst @@ -202,6 +202,17 @@ neigh/default/gc_thresh3 - INTEGER =20 Default: 1024 =20 +neigh/default/gc_stale_time - INTEGER + Determines how long a neighbor entry can remain unused before it is + considered stale and eligible for garbage collection. Entries that have + not been used for longer than this time will be removed by the garbage + collector, unless they have active references, are marked as PERMANENT, + or carry the NTF_EXT_LEARNED or NTF_EXT_VALIDATED flag. Stale entries + are only removed by the periodic GC when there are at least gc_thresh1 + neighbors in the table. + + Default: 60 seconds + neigh/default/unres_qlen_bytes - INTEGER The maximum number of bytes which may be used by packets queued for each unresolved address by other network layers. --=20 2.47.3