From nobody Fri Apr 3 09:50:23 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 4F9BD1EB9E1; Thu, 19 Feb 2026 16:28:56 +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=1771518540; cv=none; b=Nca3P8EF0Fnylv4e4OH2GPG6z0PLtMM7ugr8gupyPxtbzkI0jbb7MEbrz1ZAVRIJcQLm8L5UyXjIivO8LPtMB2lfZTtkkBFoyJ+m6TEng9+xNngWV41MqFn++1gjJkwmDXNww+esPiWqTJpir0wesz2+fBw5tZcTr1DtFcAdq+I= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771518540; c=relaxed/simple; bh=Lc8htHD2TqjT/LzXCol2qwK8bhaGPjt6Ytomi4CXJoI=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=MzjJl20Z0YYvHKknvV1/49eNKZUkHHXoo5JmXRL0GaGOg/UsPTuDN1fhXxyTSeXQ+3+jOLnFlOA/fy32cb0V/Yby7pA1xI+YPQ23pA6IS7sWwSr0kgamLLcqBkDpmSXCvqw5qhDoxj+hz4O+Qgx9OoPsv9MlDlQPLiKugZl3uJA= 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 EEA03475E3; Thu, 19 Feb 2026 17:22:06 +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] docs: net: document neigh gc_interval and gc_stale_time sysctls Date: Thu, 19 Feb 2026 17:21:58 +0100 Message-ID: <20260219162200.510325-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: 1771518116948 Content-Type: text/plain; charset="utf-8" Add missing documentation for two neighbor table garbage collector sysctl parameters in ip-sysctl.rst: * neigh/default/gc_interval: controls how often the garbage collector runs for neighbor entries (default: 30 seconds) * 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 Reviewed-by: Jacob Keller --- Documentation/networking/ip-sysctl.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/Documentation/networking/ip-sysctl.rst b/Documentation/network= ing/ip-sysctl.rst index 28c7e4f5ecf9..033e18303d79 100644 --- a/Documentation/networking/ip-sysctl.rst +++ b/Documentation/networking/ip-sysctl.rst @@ -202,6 +202,21 @@ neigh/default/gc_thresh3 - INTEGER =20 Default: 1024 =20 +neigh/default/gc_interval - INTEGER + How often the garbage collector for neighbor entries should run. This + value applies to the entire table, not individual entries. + + Default: 30 seconds + +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. + + 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