From nobody Sat Feb 7 18:21:05 2026 Received: from mail-pg1-f171.google.com (mail-pg1-f171.google.com [209.85.215.171]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 30A7D22173D for ; Sat, 1 Nov 2025 09:48:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.171 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990482; cv=none; b=u55dpAnVM5BCjUyMZgmsXTAB/icTD9F+NY0Bohqb5HzhESiXLBVx/nn4BXRcREjYBXTikA/pOi501Ijz7NCPhlRKftLQrOTSdP6QXZI+vcFOdjm/GLXCXLJ6bgOT4zcJeOpC3TcEvkyjQ+isdsO0yZUjKt9aTHBTvBEaY8xnpBw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990482; c=relaxed/simple; bh=WsMaVYjhEX5xzYsbLkIYbNUU/KAzYM8jBkJPwJqvx+Y=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=XgEOSc4+8l7i231exW2Okx16igbYO+Xbz6dqGFxhMVB9AkiV8Kfn8r8GaGOqmSR8XydFf9Aa4vhiVTZAnJ/ORQYT2TFpogKhAB2BbGe+y13mnTZ7Uz2xENLmSjRduJudTuwtzvQ5OJ+pCA1eKdGdfD/aQI8g+kKi4uKOuO1eans= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=i2KBum1A; arc=none smtp.client-ip=209.85.215.171 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="i2KBum1A" Received: by mail-pg1-f171.google.com with SMTP id 41be03b00d2f7-b593def09e3so2240001a12.2 for ; Sat, 01 Nov 2025 02:48:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761990480; x=1762595280; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=ys+iXshBYZnizwFhgQPeQbnnGsPPwsLlRfA8FiXKhyI=; b=i2KBum1A1oetCqXn/NH0NnP0kM1of8OivYXErx5FS7wf5Ny6rLV6nSuuL2EeZ39B8W f4Y9NFPAAcVYr6FMaeebliczS9IxyZHoU+XPuceX/CG8SeVQNII4jeHZ3ydiLw1dl2UO yfxMIEkpjrzfmZ5ddQHbkR+VPGJGnsF46AesdYLNDBRustXeFjRqPJGyhDHuOw/DcVcJ hzwYzmzqD8LIdbbiLAV1PQtYA5PaW7WvfQgBlyjUpLOQb4smhQEcS1nMx5tGS/ql5LtM EcLwk0qLrAamMbgUOxo7lvOPf/VZfMbaWo8+VaarpW0ayar61mFa6EiLXH/OzQgdIe9M qtBA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761990480; x=1762595280; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=ys+iXshBYZnizwFhgQPeQbnnGsPPwsLlRfA8FiXKhyI=; b=FPvhyiOiGCogJK7A8dCEjUQX9dHSQ66nrSkq2E/MGIzDH3+AyYVnQSiezQjHdhIpoj 6wPI0edTUQJlWosI4GfUOuLoV56erZrBAB09cLfRpf4wWLbFyurnvyWF0BgdgXKDcirW mKsXeBOe0LLr2BVzNkGvCwK61DDc1BZBftR9QffDLGgKX5DMGDJ5J1kc9QqsNZdZ0Yhr Ic08CLzqMpHPDF7K+rIY4rSxnu88tXb4sijdcSe9rKyXNrnDKAxfC37UtqJQKdWqO4m2 OZbqoR0BlcOZGxoi3L2dFaU4z1cXKdzA632AlqKwpjbP/TFPzbDb+OTrdm7eVxHwXe0S efmQ== X-Gm-Message-State: AOJu0YyYNA+NQswKYyVWXRgf6NDLYZ6f+oVD7zV+b47t6+YpURQX0VNd VB9+Bo6BVNumjpBpNzc+KyNiZlPM9q3JA4Xp6muyegUpTHSRnUdFc4T2 X-Gm-Gg: ASbGncvrHhlFvh60AKh3AyDux032ks8LuMYUSSYcw/pN2XXkYll71XIfvPFK0HuzIz1 psr2WCeSa+GYBXonFQp9l9YX0yx8MmMo1YkSUtXcGLavIs/1lnIlUpt3HjSfsWh6j9YgzQM3X/q okFBb6QjDC7HSP6+Rwb0wZ9br/iCd6WPZYKyU4NTdq5kZ7jplyaukV4bY5CxlgmbzcLvoj2+zPH LiXghePss7NhiFXWZB4UWxdiRVSXmN+41Hol23T6/6p/Y/e1VWNh7HIc4MrpDE3gZtcGK65e7Iw dcFXDXZRjZEnywcipcNtzxeayb1CrWo5G9XIniDX/WKOTjlYSjTtiN7e2SyHipgZ+jCAcy9nrTf OKSj64sTz9ZLsbCe8EgH5HEqD39J2/SS+ZKA0Ex5Iy9wnWUYggysPoR6hCT8P295c8O716IUDTr qh X-Google-Smtp-Source: AGHT+IEuf2OXCpVvj5mt9JoXkTV63btzK3GM762PmBpPq77R+yTBCtQ7CzPQQFc+4UmjQ7/sOnLiHQ== X-Received: by 2002:a17:902:e5d2:b0:246:e1b6:f9b0 with SMTP id d9443c01a7336-2951a38af0amr90955605ad.18.1761990480237; Sat, 01 Nov 2025 02:48:00 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-295268d10e9sm50868325ad.50.2025.11.01.02.47.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 01 Nov 2025 02:47:59 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 64F3D4209E90; Sat, 01 Nov 2025 16:47:56 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Networking Cc: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Steffen Klassert , Herbert Xu , Bagas Sanjaya , Randy Dunlap Subject: [PATCH net-next v2 1/8] Documentation: xfrm_device: Wrap iproute2 snippets in literal code block Date: Sat, 1 Nov 2025 16:47:37 +0700 Message-ID: <20251101094744.46932-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251101094744.46932-1-bagasdotme@gmail.com> References: <20251101094744.46932-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1513; i=bagasdotme@gmail.com; h=from:subject; bh=WsMaVYjhEX5xzYsbLkIYbNUU/KAzYM8jBkJPwJqvx+Y=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJms13Kblm6rb3ryI+T9Q+WPFs0pi1svRc3x2Oq64MTPF 0zlH6+d6ShlYRDjYpAVU2SZlMjXdHqXkciF9rWOMHNYmUCGMHBxCsBEpPMY/kr62J815jXz/FLd 2HP0xr50vrL37DMXPGjLnBejwvieo5KR4e/D+bXTT/7i4HW9dY7Tc9VR2b5lk1fuPj6N0SA9zPy 2OScA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" iproute2 snippets (ip x) are shown in long-running definition lists instead. Format them as literal code blocks that do the semantic job better. Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap Signed-off-by: Bagas Sanjaya --- Documentation/networking/xfrm_device.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/networking/xfrm_device.rst b/Documentation/netwo= rking/xfrm_device.rst index 122204da0fff69..7a13075b5bf06a 100644 --- a/Documentation/networking/xfrm_device.rst +++ b/Documentation/networking/xfrm_device.rst @@ -34,7 +34,7 @@ Right now, there are two types of hardware offload that k= ernel supports. Userland access to the offload is typically through a system such as libreswan or KAME/raccoon, but the iproute2 'ip xfrm' command set can be handy when experimenting. An example command might look something -like this for crypto offload: +like this for crypto offload:: =20 ip x s add proto esp dst 14.0.0.70 src 14.0.0.52 spi 0x07 mode transport= \ reqid 0x07 replay-window 32 \ @@ -42,7 +42,7 @@ like this for crypto offload: sel src 14.0.0.52/24 dst 14.0.0.70/24 proto tcp \ offload dev eth4 dir in =20 -and for packet offload +and for packet offload:: =20 ip x s add proto esp dst 14.0.0.70 src 14.0.0.52 spi 0x07 mode transport= \ reqid 0x07 replay-window 32 \ --=20 An old man doll... just what I always wanted! - Clara From nobody Sat Feb 7 18:21:05 2026 Received: from mail-pf1-f182.google.com (mail-pf1-f182.google.com [209.85.210.182]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8C2EC25A2AE for ; Sat, 1 Nov 2025 09:48:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.182 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990483; cv=none; b=VNW4P4T9Lfy9Zw33qGR/OhzhiJLeYCUn0zNFnH8j04H9U45l5lgsxLqS2Hd5bBoLidc9l5flTNaPMOl7lBW6Ei2oa7OHeSbg/lpbtuNOmTk0vkeKEib6dKNwQldCkn22LULO+Xo99p1MiP1xAK6P+KbQl5pg5qVTfvnbn3iidXs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990483; c=relaxed/simple; bh=jBrlYcqe70CRFPI8eWpEHN0i3WJ0kusKzZ2MB0TsxBA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=pqdJ+P5jx8tJ/fiEn6y1df8dS8Q1LLCCEUXIg132Nxzmv3lHz7UcXRwAjFt2ZIm5rZSYGErln8N6AhCelRXyedNBp8DiLR6LvCsJp1zbCsRfv5N7P7IVCnkl6T3+nFl2KSjEjfe9eaCiFIGBfLEnO74NDXSPmLPDuSfUKjfT4Kg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=iWI0kLND; arc=none smtp.client-ip=209.85.210.182 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="iWI0kLND" Received: by mail-pf1-f182.google.com with SMTP id d2e1a72fcca58-7a27053843bso4433685b3a.1 for ; Sat, 01 Nov 2025 02:48:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761990481; x=1762595281; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=Lh5XxpkroE5dbbQU8eQ46vBGwFwM21sJCPsPPmpqn7w=; b=iWI0kLNDq0YVYUEvGD4n/ernbNX8wov24hfn67Ze73ActdyyW5tCL2kuidCd311M+v pJbDsUxjSBOTtnjF2g608v5CSqTh2Ce9J58jzkgQIgJKgeV0/P7s4ZYXnnqMJLAK7IJ9 YohKRbGe/Cyoe7B+h2ZgZtgCEcmarpv3rjE81wceIFVTFxB2WqpXzvwumAK/l2qht3xS Fwlo+qOy5PREHWLXXK50+Fui6kOzMEIAS1Bm4mDw3KyOxHT2u+TL+QU0E2vEEcJaTdtz QEyXPSbmw5kf0FSZQ4yI/0vTz9maHolKlmCyTO0C2IVx/ugemoW2gvceiNP8mdYl91sy oDmQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761990481; x=1762595281; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=Lh5XxpkroE5dbbQU8eQ46vBGwFwM21sJCPsPPmpqn7w=; b=qjRpvPCRlK3LIFFyGjykYfBme+kABIDnttEnU++9jMcweeOeBqCpdvQ6Qv6PBj5a10 aBT0R+FOXyUODQ6AdBKKnHpH6kbuSmaAPyw7CgbYED799EKHPtyQ3JnA2He7D44EAifp i3PiYvOECSdQ+0EeFCADZq1QTfn1krnVFcXFleP+2XU8Xs7b4R+lTTmA48fDzk8znVtF 7YBnCTlBSktcekbMeB6eqLBqyLL+qfinDqCapW5Ew+2MVF6/gdX4JaFR5eKqNxMVgBDV 3AlYWJQeRJw4DpHVXqe0NDKufp4+IVfZ4KewywmcuILtheJQc+IvUewQzrTGQjPaqqtm fXjA== X-Gm-Message-State: AOJu0YwQ0dt8MpFD1w8Bf9WcLjNi5G70E0EkQXYv4lNSzN0fTPVnsxMB vdVfi6mzTFn37JA0eY4QolHEB2wILi8HpWM5AXD4PjdfMCyq2DAhNvQt X-Gm-Gg: ASbGnctvS8EjCovbM8TFJ6zJWQEhc+emKiLO9cwFFKm8fs9V42RfbKBTg/CwRZd5AOp U0mEGCsYY1BuoltD857HjOhtOHOXpf1tUlz0JXIUk6YwtIA/2AtjfAjIPvvdSTmLjFHToVja1yV PXBMnW9JiOQBNyDSsyt4GboYxxThMPxrh3GdGH/tm1JkRAia9zd0izsDrurXGWOhEU/QVOR30V+ zPTU2uv5yDjKFsUb0XhbfqkjVfNYAVRK7OAsXg5Kcg904yKAhXWbzHadGnlTuXhHBh6y1lacPyQ cci028sqSjaY0uxZgP00aTOD7nnCkh6EfklfmsZzSAHCBvSZQypv4cGp2flLR7y7nR3iS55BZ6v uHy4iID5SO+f20J08n3jtOp/XMluItybvQgdfWRC5FGl8XuCQ+t7DF/NgdCSB/1vL6FhE48BLmN aH X-Google-Smtp-Source: AGHT+IGpZ8T1BxXQj+tbJHhY/gv3ZX3xWUHXlnenPWSDSg5J509xuNLz5YpbVfswDuRWy+McMfmuBg== X-Received: by 2002:a05:6a20:4308:b0:340:fbd5:15ae with SMTP id adf61e73a8af0-348cca03eb6mr8335718637.47.1761990480655; Sat, 01 Nov 2025 02:48:00 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7a7db67cbdfsm4802995b3a.49.2025.11.01.02.47.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 01 Nov 2025 02:47:59 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 7E23C4201B81; Sat, 01 Nov 2025 16:47:56 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Networking Cc: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Steffen Klassert , Herbert Xu , Bagas Sanjaya , Randy Dunlap Subject: [PATCH net-next v2 2/8] Documentation: xfrm_device: Use numbered list for offloading steps Date: Sat, 1 Nov 2025 16:47:38 +0700 Message-ID: <20251101094744.46932-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251101094744.46932-1-bagasdotme@gmail.com> References: <20251101094744.46932-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1791; i=bagasdotme@gmail.com; h=from:subject; bh=jBrlYcqe70CRFPI8eWpEHN0i3WJ0kusKzZ2MB0TsxBA=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJms13J35gp+ZJa+2bAoSvDmR+96dvEwhfae2W3d39dl1 ukkzdzbUcrCIMbFICumyDIpka/p9C4jkQvtax1h5rAygQxh4OIUgIloeTH8Myn1yi+4rL9gmeQe 2WtnAuqnr5HkjrzZ1P1ZyPy4TM0sE0aGF7tjvMTqzaYFzHguxN/9N/N0SfwippfKF3kjv/QuWmX MDQA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Format xfrm offloading steps as numbered list. Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap Signed-off-by: Bagas Sanjaya --- Documentation/networking/xfrm_device.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/networking/xfrm_device.rst b/Documentation/netwo= rking/xfrm_device.rst index 7a13075b5bf06a..86db3f42552dd0 100644 --- a/Documentation/networking/xfrm_device.rst +++ b/Documentation/networking/xfrm_device.rst @@ -153,26 +153,26 @@ the packet's skb. At this point the data should be d= ecrypted but the IPsec headers are still in the packet data; they are removed later up the stack in xfrm_input(). =20 - find and hold the SA that was used to the Rx skb:: +1. Find and hold the SA that was used to the Rx skb:: =20 - get spi, protocol, and destination IP from packet headers + /* get spi, protocol, and destination IP from packet headers */ xs =3D find xs from (spi, protocol, dest_IP) xfrm_state_hold(xs); =20 - store the state information into the skb:: +2. Store the state information into the skb:: =20 sp =3D secpath_set(skb); if (!sp) return; sp->xvec[sp->len++] =3D xs; sp->olen++; =20 - indicate the success and/or error status of the offload:: +3. Indicate the success and/or error status of the offload:: =20 xo =3D xfrm_offload(skb); xo->flags =3D CRYPTO_DONE; xo->status =3D crypto_status; =20 - hand the packet to napi_gro_receive() as usual +4. Hand the packet to napi_gro_receive() as usual. =20 In ESN mode, xdo_dev_state_advance_esn() is called from xfrm_replay_advance_esn() for RX, and xfrm_replay_overflow_offload_esn for= TX. --=20 An old man doll... just what I always wanted! - Clara From nobody Sat Feb 7 18:21:05 2026 Received: from mail-pj1-f50.google.com (mail-pj1-f50.google.com [209.85.216.50]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id AB0852C3274 for ; Sat, 1 Nov 2025 09:48:03 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.50 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990485; cv=none; b=XuAEaw/0KkoFBnhK+UN0EvqznSfw9FKWCcgln2G3t1GwS/4xmexy9sJD1+dNnvl8xz5mExe5eM12+eWBo7jow0d/FMCp/XeQN81uFlIeLcOhv0zBwY31UlyZgbVKf6McX881MlwTqQvp1Cr7Tro95Dx63tGE7vCjWkvEtAxejs8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990485; c=relaxed/simple; bh=0r/UGJ3UaHLl4TwoicvZX0eMMWSJJZ+kcuaobIcvNx8=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=YnQ2eyFmNLb1/bulcrK+kSOcx0swAepWtmuKX4c0zlIh/VCKZfLh92fqh2W6aLnsEvvvkZBacVJzDyDyj3jp+KhzYHkpvXxOAGnS7xb2LIKqKcn143AfDJR9JQoOciTrsULKqH+e1qWi360dnPoz2jmNvxXmoB/66yNN1K7+wRw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=lU2izvzU; arc=none smtp.client-ip=209.85.216.50 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="lU2izvzU" Received: by mail-pj1-f50.google.com with SMTP id 98e67ed59e1d1-33255011eafso2687147a91.1 for ; Sat, 01 Nov 2025 02:48:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761990483; x=1762595283; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=1KN/frS9jg4jcQJc1DwfaOMBwxNMdwpEGRN00rohe3M=; b=lU2izvzUaCbol2zZGwLYF/TRdhnjXAZbWWTsInBfdVoWcaRE0aI3FprLoCSgj6E26f b3zV2UmSOoFeh11m54G2diji5oUmxUSqN02cszQiowxgSKE1UXW0QBX9SMidVlynYvz8 98rK+arP9GF3ehUYW6bStoDX8ziNkaNIljQ0+Xm+4za98rrtzN3lW3Ftc6hEU96wSEmw m4X6QGCwRwm5wJ8N6h3trA14E140l5S9bxqAKR22bRBPYV65cXMB897dv1MA8Lqve7kO I9qTe18o1X/kGRKvynnHlMPV7sz+w1xhVOyD8+q1n5idwMF/WG0T1ypTlWdCgGkxugvh a2xA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761990483; x=1762595283; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=1KN/frS9jg4jcQJc1DwfaOMBwxNMdwpEGRN00rohe3M=; b=szy1OCnRPYnwZAeWxZ6dO7Zz4kbplLocBi7gIh62fov9uBq2FxJotPPdIBjYhhmGkx WZUkSbwRepzb+sPsGjcglArVG7jXiJCxqBuQufxAkBSBagO1PrdOkB1npU35l9dR/HjU JRUqx1BUoUgBpk043ufa6b6Wv7WovnGxZKOvDpeujAV7qt6CiZwYZfh5k0ovMbwft3on mTldKMDfI/Msf7geN9Lf96qsx/Uy3RndpTQQMvpFPddYRSOLxTPFoWN/+lFcDgU/yMwk ct8U2CTVgT8dsk0W2PgywkkTaI12aC+d6mctF0LcIFCaZ6t/jArJD3etQ46bXTpj46OT mTRQ== X-Gm-Message-State: AOJu0YwBB3Ap6g+aR2bwdn2ywkJMqBq0C/VVG94qoKYb0wBUMKX7FFIX O+x00G2MMMNzxcmO4o6eAP7Ni3mtFdLhumaU0mD/c3VymuKUMttu/hKg X-Gm-Gg: ASbGnctP/68GQIXY2yroz/+ZoOzw4JsQ3l7uozKLwi3vdXW/BlT1/Am7KLoa9EnxdVi yjMVGq6HgiwmSXgJzqIO4Y/XIREl4XJoKmQ3wjPp47zZ88sVwuNZc8KOjm5WHFSqs2cpgHv7L43 4bMc8dTUmjBR/tJW9cBCvGQ+LpwDXrEeMRzPjsBeDIq82O5JV0WZ0Xh1hAud0SHe4ofFwwbROTa ckP+L9EzVtL5dj9vaa5V8skshimnNFRdiLmiB3bKw6xZ9wO9GDEBMS9xxbw+UmMHaIEQfRehuit gpxmlRgXHb29l9vBUH3RB05Ve1aj5Ms6N+dallv9WLy7IEsZJyJN7/n1E9TeUsaN8ZXvwheI6z8 S6JNpu0xtakuI2Aw3ZM8Jf4m4SKDUcWyNDqmUzzW7RQYiaEYb3AWwfthlgw81KBSJYzGIycc+yp 2TL2ZaWiDkkLc= X-Google-Smtp-Source: AGHT+IGsYXtd1T7KUQJwUmXpPfa8NKulKKA88l/h+qYrG9Wj+FnsHwCW+OhVIOHiRESe6quJKXaOlg== X-Received: by 2002:a17:90b:3f4b:b0:327:9e88:7714 with SMTP id 98e67ed59e1d1-3408309dafdmr9468011a91.37.1761990483094; Sat, 01 Nov 2025 02:48:03 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-34092d69b89sm4609672a91.20.2025.11.01.02.47.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 01 Nov 2025 02:48:00 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 9BBA041FA3A2; Sat, 01 Nov 2025 16:47:56 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Networking Cc: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Steffen Klassert , Herbert Xu , Bagas Sanjaya , Randy Dunlap Subject: [PATCH net-next v2 3/8] Documentation: xfrm_device: Separate hardware offload sublists Date: Sat, 1 Nov 2025 16:47:39 +0700 Message-ID: <20251101094744.46932-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251101094744.46932-1-bagasdotme@gmail.com> References: <20251101094744.46932-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1292; i=bagasdotme@gmail.com; h=from:subject; bh=0r/UGJ3UaHLl4TwoicvZX0eMMWSJJZ+kcuaobIcvNx8=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJms13L/N23ty73Xvau/VKZ5goLNL6vkoKQL65l3/NLJ3 bXRkvVvRykLgxgXg6yYIsukRL6m07uMRC60r3WEmcPKBDKEgYtTACYSdZSRYcOHbU2fPJ7Jxb5o eSQb6JvpJK7hv5LR9lP/7XcGTkaq5owM+21jc5bXSz4//43dq53LPiuMTXjxwQXurTExz74HTZ3 KBAA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Sublists of hardware offload type lists are rendered in combined paragraph due to lack of separator from their parent list. Add it. Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap Signed-off-by: Bagas Sanjaya --- Documentation/networking/xfrm_device.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Documentation/networking/xfrm_device.rst b/Documentation/netwo= rking/xfrm_device.rst index 86db3f42552dd0..b0d85a5f57d1d5 100644 --- a/Documentation/networking/xfrm_device.rst +++ b/Documentation/networking/xfrm_device.rst @@ -20,11 +20,15 @@ can radically increase throughput and decrease CPU util= ization. The XFRM Device interface allows NIC drivers to offer to the stack access to the hardware offload. =20 -Right now, there are two types of hardware offload that kernel supports. +Right now, there are two types of hardware offload that kernel supports: + * IPsec crypto offload: + * NIC performs encrypt/decrypt * Kernel does everything else + * IPsec packet offload: + * NIC performs encrypt/decrypt * NIC does encapsulation * Kernel and NIC have SA and policy in-sync --=20 An old man doll... just what I always wanted! - Clara From nobody Sat Feb 7 18:21:05 2026 Received: from mail-pl1-f172.google.com (mail-pl1-f172.google.com [209.85.214.172]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DF04D284883 for ; Sat, 1 Nov 2025 09:48:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990483; cv=none; b=pA0MIBqzSgSpr22nxgg2uWIVh9iyKWAdMcM9NEuZ6d4QhHQjSUri9PFP1uTzKea+QTGBjUOWtCaYKnKUAticsH1xPHhlEmY/U/K+ltc67c0JtKmbl+L8WzirZzk91HhmZvXUn6gJ+WViFxeanClplzSSGsDsOoszOvRvgvH3Ez8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990483; c=relaxed/simple; bh=GTa5PMbqingrx9UUvDQwwryRQXi1hbUYeu/uDR+oix4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=hj3hoIeaADGzk7CwZ9gumtdUAnG0nk1aAyAg34Qy+gzf2ELo1gJa/fEPiGpdR+kyFffZcXt7NtrE4aSZDDpqjTG5kZjSZGDJqSZiKRPokXrT/9qfVVm9NreLNeZVcUOSIZwr+g1Chjx5E1TjBmdFNWsbbH5sOVic1C3cL0A1duY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Jd4W8sSb; arc=none smtp.client-ip=209.85.214.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Jd4W8sSb" Received: by mail-pl1-f172.google.com with SMTP id d9443c01a7336-28e7cd6dbc0so38171735ad.0 for ; Sat, 01 Nov 2025 02:48:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761990481; x=1762595281; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=PjjrDgD3WOpxSbQxw9z6dYOn0RSDkCVjfKdY81mup90=; b=Jd4W8sSbOIwUQnCojzItd/DQHSJ3ozqbsRZdBoZALQd77rwQT4g9x1uQvW62f9s6Zs VQU6vyUQDywSL3Sd6Ax+HGKZS89YdmlDmeeHBQDnwyteyJlnRLElWZgR5piBpUIred+D hRbJFQXA+P04Mzqiduh5v9xcta9PXxOcMFRb/mNA6wxn/m7uDU5G1XSumXJDF00R5ae4 vuD4won6tIB24+N0vWVFWYnCsmbQ9kdEjPesqTg4yJm0ms8RcT85/zI4AZlgLHmrU4mX emGA1BiMskEc+DTgbSFeIHUiOnQIBR+ZCWtHaSDPQK6JW4XiQNCH/j0/ytNQzoFSfF3M YXpA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761990481; x=1762595281; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=PjjrDgD3WOpxSbQxw9z6dYOn0RSDkCVjfKdY81mup90=; b=ZhknNkzePdWLg5UzktNHpH1R7whCSdFti+nU+Hj6v9UPozdE/GZBlguBGkpolrhrdm nCuGxWwEKyPswee/zffAHWGtmm6RoEmoQg6HQECA/2h4MsMKioVpd2NibB0IC+u9YAF5 aeVz7beNa+7XvjshAMfDWoDNSBW0KfQvgeKYqTCjwfgEqEfsabhVh7XkrRUVF6lwOPjs CIxlvSptQnlcvDjbyrfUBgPJ2ToiP/ZxKDpUAFoR6Q0UdEDLFlcUxH1SvJfoaVGH6xJn Af0/m3RqbMcJxLm87yNhsnl2TO99nxsWPzjVOIXGZVkNv7EFmnkOA77D41BYPw464SF+ AV+A== X-Gm-Message-State: AOJu0YwXBTQgCG46Z+E+x+oT0QDlUQjE8FtUGNsYI2ev3YauNHhMvKLJ xDcik7Iyzz7m8r+hfETEm9YIXcKv/FpUUQTYU5Hv3KTgVzSspq7mA0tq X-Gm-Gg: ASbGncuSRvqu4TnbCOBtcePzbMEyX8mFZttJZKEnMRt+DxU4292o2H6Z8Q4AFoGev0a 4V915eyecF9MLC/i7GZt8tdxNn+C5iyhCQ5qR6OGWJ52UoPI4mohLFLq3Qgo/CsFiwOxAKXKh7i 0DIEpXPk+ghwQNwc+ZZTmo516s+RfV4Ryb1NNpSAsxWLjSRZidWOwaGMp+IpHEiU94+haUVD1aa Q5Lt6dG6Sptu6D1B1e3RDwMbqRfEL5dCGJLtnIPf0oHYQQa03taj7W1psMEtrFiupAwvLODlujT nNu7nKQQOLZdUNShuoX3pfP/Cfx/r3OAjnUEJzV9SFxXRVMD7gEMSdNBYauCo7KC/rdRG1RBPzg qBuonHXC1pbTwzGoM+zVc6tFIy1D6N8KFroWuSkE9a5akbZznSX/Okntno18A934R+elMaH4ajV goMktTpipBOdo= X-Google-Smtp-Source: AGHT+IG5sgTmPbr5SKGt4RZnfYGQcR5jMn0NQ+QLpl4Gj+BxopLRKO/fYUff15QKvawPU7JdQEXTEg== X-Received: by 2002:a17:902:c408:b0:288:e46d:b32b with SMTP id d9443c01a7336-2951a3b7984mr101577005ad.17.1761990481194; Sat, 01 Nov 2025 02:48:01 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-295268a629csm51068175ad.30.2025.11.01.02.47.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 01 Nov 2025 02:47:59 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id BB5E841FA3A3; Sat, 01 Nov 2025 16:47:56 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Networking Cc: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Steffen Klassert , Herbert Xu , Bagas Sanjaya , Randy Dunlap Subject: [PATCH net-next v2 4/8] Documentation: xfrm_sync: Properly reindent list text Date: Sat, 1 Nov 2025 16:47:40 +0700 Message-ID: <20251101094744.46932-5-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251101094744.46932-1-bagasdotme@gmail.com> References: <20251101094744.46932-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=5939; i=bagasdotme@gmail.com; h=from:subject; bh=GTa5PMbqingrx9UUvDQwwryRQXi1hbUYeu/uDR+oix4=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJms13Lb2I51F8/KKf0g6XPr8eqTnq26xtVGkc/tKtl/X HpYZv6go5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABOZqsPwP8+1NHHz0blnTx3X NW2JmTazMfq0dRpPudRi8fLstLLtjAz/w8xP5nFvqP59RpNtS0Pis7zdVydEPPvfPPX5wmKtiM3 zGQA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" List texts are currently aligned at the start of column, rather than after the list marker. Reindent them. Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap Signed-off-by: Bagas Sanjaya --- Documentation/networking/xfrm_sync.rst | 77 +++++++++++++------------- 1 file changed, 40 insertions(+), 37 deletions(-) diff --git a/Documentation/networking/xfrm_sync.rst b/Documentation/network= ing/xfrm_sync.rst index 6246503ceab2d2..c811c3edfa571a 100644 --- a/Documentation/networking/xfrm_sync.rst +++ b/Documentation/networking/xfrm_sync.rst @@ -88,23 +88,23 @@ to get notified of these events. =20 a) byte value (XFRMA_LTIME_VAL) =20 -This TLV carries the running/current counter for byte lifetime since -last event. + This TLV carries the running/current counter for byte lifetime since + last event. =20 -b)replay value (XFRMA_REPLAY_VAL) +b) replay value (XFRMA_REPLAY_VAL) =20 -This TLV carries the running/current counter for replay sequence since -last event. + This TLV carries the running/current counter for replay sequence since + last event. =20 -c)replay threshold (XFRMA_REPLAY_THRESH) +c) replay threshold (XFRMA_REPLAY_THRESH) =20 -This TLV carries the threshold being used by the kernel to trigger events -when the replay sequence is exceeded. + This TLV carries the threshold being used by the kernel to trigger even= ts + when the replay sequence is exceeded. =20 d) expiry timer (XFRMA_ETIMER_THRESH) =20 -This is a timer value in milliseconds which is used as the nagle -value to rate limit the events. + This is a timer value in milliseconds which is used as the nagle + value to rate limit the events. =20 3) Default configurations for the parameters: --------------------------------------------- @@ -121,12 +121,14 @@ in case they are not specified. the two sysctls/proc entries are: =20 a) /proc/sys/net/core/sysctl_xfrm_aevent_etime -used to provide default values for the XFRMA_ETIMER_THRESH in incremental -units of time of 100ms. The default is 10 (1 second) + + Used to provide default values for the XFRMA_ETIMER_THRESH in increment= al + units of time of 100ms. The default is 10 (1 second) =20 b) /proc/sys/net/core/sysctl_xfrm_aevent_rseqth -used to provide default values for XFRMA_REPLAY_THRESH parameter -in incremental packet count. The default is two packets. + + Used to provide default values for XFRMA_REPLAY_THRESH parameter + in incremental packet count. The default is two packets. =20 4) Message types ---------------- @@ -134,42 +136,43 @@ in incremental packet count. The default is two packe= ts. a) XFRM_MSG_GETAE issued by user-->kernel. XFRM_MSG_GETAE does not carry any TLVs. =20 -The response is a XFRM_MSG_NEWAE which is formatted based on what -XFRM_MSG_GETAE queried for. + The response is a XFRM_MSG_NEWAE which is formatted based on what + XFRM_MSG_GETAE queried for. =20 -The response will always have XFRMA_LTIME_VAL and XFRMA_REPLAY_VAL TLVs. -* if XFRM_AE_RTHR flag is set, then XFRMA_REPLAY_THRESH is also retrieved -* if XFRM_AE_ETHR flag is set, then XFRMA_ETIMER_THRESH is also retrieved + The response will always have XFRMA_LTIME_VAL and XFRMA_REPLAY_VAL TLVs. + + * if XFRM_AE_RTHR flag is set, then XFRMA_REPLAY_THRESH is also retri= eved + * if XFRM_AE_ETHR flag is set, then XFRMA_ETIMER_THRESH is also retri= eved =20 b) XFRM_MSG_NEWAE is issued by either user space to configure or kernel to announce events or respond to a XFRM_MSG_GETAE. =20 -i) user --> kernel to configure a specific SA. + i) user --> kernel to configure a specific SA. =20 -any of the values or threshold parameters can be updated by passing the -appropriate TLV. + any of the values or threshold parameters can be updated by passing = the + appropriate TLV. =20 -A response is issued back to the sender in user space to indicate success -or failure. + A response is issued back to the sender in user space to indicate su= ccess + or failure. =20 -In the case of success, additionally an event with -XFRM_MSG_NEWAE is also issued to any listeners as described in iii). + In the case of success, additionally an event with + XFRM_MSG_NEWAE is also issued to any listeners as described in iii). =20 -ii) kernel->user direction as a response to XFRM_MSG_GETAE + ii) kernel->user direction as a response to XFRM_MSG_GETAE =20 -The response will always have XFRMA_LTIME_VAL and XFRMA_REPLAY_VAL TLVs. + The response will always have XFRMA_LTIME_VAL and XFRMA_REPLAY_VAL = TLVs. =20 -The threshold TLVs will be included if explicitly requested in -the XFRM_MSG_GETAE message. + The threshold TLVs will be included if explicitly requested in + the XFRM_MSG_GETAE message. =20 -iii) kernel->user to report as event if someone sets any values or - thresholds for an SA using XFRM_MSG_NEWAE (as described in #i above). - In such a case XFRM_AE_CU flag is set to inform the user that - the change happened as a result of an update. - The message will always have XFRMA_LTIME_VAL and XFRMA_REPLAY_VAL TLV= s. + iii) kernel->user to report as event if someone sets any values or + thresholds for an SA using XFRM_MSG_NEWAE (as described in #i abov= e). + In such a case XFRM_AE_CU flag is set to inform the user that + the change happened as a result of an update. + The message will always have XFRMA_LTIME_VAL and XFRMA_REPLAY_VAL = TLVs. =20 -iv) kernel->user to report event when replay threshold or a timeout - is exceeded. + iv) kernel->user to report event when replay threshold or a timeout + is exceeded. =20 In such a case either XFRM_AE_CR (replay exceeded) or XFRM_AE_CE (timeout happened) is set to inform the user what happened. --=20 An old man doll... just what I always wanted! - Clara From nobody Sat Feb 7 18:21:05 2026 Received: from mail-pj1-f43.google.com (mail-pj1-f43.google.com [209.85.216.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7EB222D5921 for ; Sat, 1 Nov 2025 09:48:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.43 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990489; cv=none; b=dBrxKkvC0DDUNy5FpsgAzjkrs3J0LwijrEenbO0Ah8CLbsfejJHJJ4DDncLlVuSobLrlvn6/Cr2jRm/arqPM19bmJOzxZgbWe8NkcDQR2CYGa1alPoCkTGY1kABGWW95l5XyXrNslGSBUfCe5kzFVsXrGM0F/R1q+h1XouD+zDI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990489; c=relaxed/simple; bh=pOYQYpe/p2QLe1BjNGnDKFKMgBDeR7vUGryegGJSYW4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=XK6TzM3m7Dz7SDfDThoZmkmEZEhMEgyTRLaXPCl9e2L9jtqunvtFVmKGtC781tiveZ0M8eaq5bCcd0UkaOwPkP5YlYz7KRJ8xDwCHzyRL0paCsBpqRq24gNaOa6oNFMepmdEco7JlFGKohv23lKF9+imz6YWOsBXEHUTPfDWVRI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=EthWXMUe; arc=none smtp.client-ip=209.85.216.43 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="EthWXMUe" Received: by mail-pj1-f43.google.com with SMTP id 98e67ed59e1d1-33b9dc8d517so2904842a91.0 for ; Sat, 01 Nov 2025 02:48:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761990486; x=1762595286; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=itKwJGhZdbxlkpaaw8hh/vRlQCwh4eBKAzIwk/pIlYA=; b=EthWXMUeY9lkzfb6iFId1nEUr9wmyk7ZbkLOhThmn4nuEKSHGZjVRH9+4iOuZzEoTa DSAZBTzBAdFh2gdzFoD11zyLDsC86DbpSNYnX/mvD9926cLCDYmsbVJLtuVjFKdye8Or Cvazgtkl5+SIovxrLStWPxp8gu31hppEjVj8j+UHh9n8qr9mEotsrMBuBw4qhB0n9xPy nLgtVdq4y928Bul13GZjJV6Am4pEv2WLg0fpg/03781qeTt/QjJcH5PS+rKCy7B7Uj0I Za2RVaX2LRnvQ30pUJnxG16nTC7iYSA/017tgBXAvS+z5wNqlVK2AE3jYmEAzcgsxZmq pYUA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761990486; x=1762595286; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=itKwJGhZdbxlkpaaw8hh/vRlQCwh4eBKAzIwk/pIlYA=; b=tHXTPdzUsYnUsMur1RUiOjTb8HQ4ZFp78HopbSmR5kdIMcHnJLqUT2cuvoaX7Fvdik jnYGfWgvGZ1vDUe/rHAiUn1Rr3H3ITtMajEu1utWRIJeFOTS9dBxQTgmzJmyWwWLwLM7 0m1Fc3o4Mq9YBJeB0sASI1F+C8utzbPZZ9k/skFNznnDVI1wOSvRS8mrn0fvdNFXEUWn JBrdjdY//b4HIm8m9bnYphyOGnZbTYSgF8ooM1iyNvberaWGkYzLxwvlhhHg1jgbUmww TS4OxP83YvAkPHl9wp5hrd2y6tcNdQZnbgUJDJlWBjYYUGv4NelLvHpufBcy1ULA6RiP YNfA== X-Gm-Message-State: AOJu0YxJG2uhzSTpT3J9CPCYZkOdzuMLMSVGdCD7arZgxKfx0YlnUuBy dq8TyrTtLTAL4HNl7nSIfzHnUumyDNf1Obzi6hdjRApkGsHgea3oE6fI X-Gm-Gg: ASbGncscxBHPZTowIFvqbzHr6zqK5bg5ABMs1MzlamIXsKIsbgRvENDY3pxgJg0gybo sz6P/nwgUobKnL/OtaM2oNWaGuqO8DnY31FirinqqY15nx9Gz7XGC+aMaXXryyXsEud6Wkgg2YF FYgp18/2Cj/rFLi1NPkwCGJO+YNNc5MwHbn0zbxrySmeMpiJjGtt3ZeAnG8WPAm1HbuNLjQXeCi wCx/ESJJPGCKksPo2eGqbGdCt+mETHXrmX3MjlzChVL4Aj5c/vcb6vXRodmbsmI2WlTqu0OJiwl 0GNDX8xl/p0p7OeylS1hHWzedAARytA2dxvOU3jg5lP3Gqh35SR4nDFM91zaj47Xk2TkrNyup17 R197CQDzFQqdAJa35eyCfzO9oMXCF9HCAAoo9HGidlPsBqkamXMyH9CTT9mfhECQCDQuhGN3Phw Go X-Google-Smtp-Source: AGHT+IGmSKAUBfWmJQyRevQMSinNhEHGk8mmuhO/TF63IeIvW13vO2DcRHYCG0bn6xcNqmxzXv7kqg== X-Received: by 2002:a17:902:e84f:b0:295:507c:4b80 with SMTP id d9443c01a7336-295507c4c3cmr31484355ad.61.1761990485598; Sat, 01 Nov 2025 02:48:05 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-29554cba950sm21531135ad.97.2025.11.01.02.48.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 01 Nov 2025 02:48:03 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id C5F6541FA3A7; Sat, 01 Nov 2025 16:47:56 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Networking Cc: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Steffen Klassert , Herbert Xu , Bagas Sanjaya , Randy Dunlap Subject: [PATCH net-next v2 5/8] Documentation: xfrm_sync: Trim excess section heading characters Date: Sat, 1 Nov 2025 16:47:41 +0700 Message-ID: <20251101094744.46932-6-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251101094744.46932-1-bagasdotme@gmail.com> References: <20251101094744.46932-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1815; i=bagasdotme@gmail.com; h=from:subject; bh=pOYQYpe/p2QLe1BjNGnDKFKMgBDeR7vUGryegGJSYW4=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJms13KNlx4KFSxULsk3LP3JtY35sWGfXpg2k+SFYP+X2 3yT70V2lLIwiHExyIopskxK5Gs6vctI5EL7WkeYOaxMIEMYuDgFYCKibowMZ0r6ZqdFrjr9f4q2 2kWJGVwLvtyy2M357c0KznVcGYJSGxgZbh9tPhniE+L+LnVzSdOyM2f2XuKyycic2vwn+d9mc6M L7AA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The first section "Message Structure" has excess underline, while the second and third one ("TLVS reflect the different parameters" and "Default configurations for the parameters") have trailing colon. Trim them. Suggested-by: Randy Dunlap Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/networking/xfrm_sync.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/networking/xfrm_sync.rst b/Documentation/network= ing/xfrm_sync.rst index c811c3edfa571a..de4da4707037ea 100644 --- a/Documentation/networking/xfrm_sync.rst +++ b/Documentation/networking/xfrm_sync.rst @@ -36,7 +36,7 @@ is not driven by packet arrival. - the replay sequence for both inbound and outbound =20 1) Message Structure ----------------------- +-------------------- =20 nlmsghdr:aevent_id:optional-TLVs. =20 @@ -83,8 +83,8 @@ when going from kernel to user space) A program needs to subscribe to multicast group XFRMNLGRP_AEVENTS to get notified of these events. =20 -2) TLVS reflect the different parameters: ------------------------------------------ +2) TLVS reflect the different parameters +---------------------------------------- =20 a) byte value (XFRMA_LTIME_VAL) =20 @@ -106,8 +106,8 @@ d) expiry timer (XFRMA_ETIMER_THRESH) This is a timer value in milliseconds which is used as the nagle value to rate limit the events. =20 -3) Default configurations for the parameters: ---------------------------------------------- +3) Default configurations for the parameters +-------------------------------------------- =20 By default these events should be turned off unless there is at least one listener registered to listen to the multicast --=20 An old man doll... just what I always wanted! - Clara From nobody Sat Feb 7 18:21:05 2026 Received: from mail-pj1-f52.google.com (mail-pj1-f52.google.com [209.85.216.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id B80F12D46C0 for ; Sat, 1 Nov 2025 09:48:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.52 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990488; cv=none; b=lFqLhRalG7ntshufuhmXkhjHK53cd3W36SbfE3BF7cTuazi6AEJpJ60I0MG5iDAM/KCeE2lohAVxX2Cz9J5+rZw7gXpCMuAyH70/WbrVYEKhnp1dqyk9bwb/qrhIhK0KrnVB+HZlNl1ZAsNvHj0KuiR/J+/OFGidMOI8aQ33C7I= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990488; c=relaxed/simple; bh=VFD6GtIua5YG7zFmjDzL7GA/HqAr0MELlfN71DmH60w=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=lq4Z5ppz8RoR9xecNDuhQ3gRZwLoQ8ayGalBUw5mdR2PupcK/i5mRJrN8sOeijOkyH0UL5x3wCFFf3Z2UAv/Lkd5BHvHBjdFHbcPRttpbyqki8JC8zp8IQAhE5YWkLDM5t0ObmNg1htds8Ms9YlqWBU71PXPXfPPX5SAvRRJU/4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=ABdQt3g0; arc=none smtp.client-ip=209.85.216.52 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="ABdQt3g0" Received: by mail-pj1-f52.google.com with SMTP id 98e67ed59e1d1-33e27a3b153so3180429a91.3 for ; Sat, 01 Nov 2025 02:48:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761990485; x=1762595285; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=i163pqyR8qyoX26TG357PYVJu78JzhXd/RDPq6ZRj24=; b=ABdQt3g0TTlpYbMo/ARof8OQvjUtMB9l/em7aVs0+wNr3lVgeNbcOcvF5Lqm9n7VVD vTvFntx52tMokyCjK4vCOvaS1p8vHy4YVC3qyFa6MhkZqbWaLBELOxsvMsMcYbaRwF6h rB07DSBxfK59rWuOm7a+bvr2SXGSUBJmBid9R3kM8DFZ24y4UaJB31OZPtNiM8mWxCMS sSK0sTPawyD0exRkqKY0XMwyOeodnBaSUbzdF2AnSjBtUgOPGX1n/+6YXAe7dwZtrvAG pYrsqIhEPD+/L+eCaQkdEagedk+UqnuEtZqxFzTfvACRNtzB5mz8CbAOJE6LVC6LKuJO 23Vg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761990485; x=1762595285; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=i163pqyR8qyoX26TG357PYVJu78JzhXd/RDPq6ZRj24=; b=cuVW0NfNG7lqx1BmrxSapoylxTjz695JFw9I7pYI5AmJu8ytDIpL2nxBmqX02oftTh xeftibL+YWr6tCIlWlDEMsC+yL+4vyIdgQ7X3l7KutBVJgTsz07hVnitm4uVO2W8hhRy Ly9Ukg7ABTMzfRrKJapAo+O+pmjsJXVUHqX1Uc7ntGNKLMpmo8TxewkT6AGK7lWjFzbU regs+oFs2boehQb0vOcRUrtFz791od+9RyceKfp+OqJUwy7yITLxrTDbvxJ0vCfQu2lU mxWP2JgW5n8acXAd3SVX4OvHpGGXm1nQj22TQ+1dJ334QeNp+vzsoVdCGDXfEXsnb5DH A+Lg== X-Gm-Message-State: AOJu0YxfRJb4gNJx85bT75/HzXuNUshH5/fUpESGW/8rpBQCxLfNn8v7 snstcGb4QK+pmFsfcHWy76c7TPxX5xA/Ymqdd+fkM9UU/PqRTGXEbwXV X-Gm-Gg: ASbGncsZItyzbNHKP36uoQRgj7ZYMh4tZOZgrMO7hi6MOOkc+EXR4xmEeBGL3KZby5h jLD7epSguaT6P6dejwBbdQkSYoE+jFhux6aCS9a6ywAFdwbR3F/Omz/OzX7PCMZxi9I9WHvMLBp 86fx5QylQcrqJ4/GBvtTj0VbsYidkUSIHKAZOaFTVR2z1HdqBbiscU4lk2P83+0lvS2kcTBBF7c 9acyRr0pWBSZF4z76AbTbV9WTrU02HjCrJieqlsD4o7I6okhMiWawV1+Encw47RhHkHjP/MHO0G tNG4uCz8ePDbOJiCY8p9IRF/5unq+y3ab0W0wQ6wEt2H6+BU9+5E43neSBFLJkuh9lLjNxmoJkp t6tB4+xVbjU4dpUP2jAPz8C71k00ch+Up8h2opAI9oXr6XAjGGIvwjvbYdINDncvKMYRS+uHF8q Dj X-Google-Smtp-Source: AGHT+IGGaTpxpgNC8ciQSQqiqJUywpj2+O3W4oFH7FhMd41eXjxSmQvEhN4sZcxR4XzrFlG6iXv0kA== X-Received: by 2002:a17:90b:1c07:b0:340:d511:e163 with SMTP id 98e67ed59e1d1-340d511e58amr540915a91.8.1761990485008; Sat, 01 Nov 2025 02:48:05 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7a7d8982117sm4722357b3a.15.2025.11.01.02.48.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 01 Nov 2025 02:48:03 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id DB82841FA3A8; Sat, 01 Nov 2025 16:47:56 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Networking Cc: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Steffen Klassert , Herbert Xu , Bagas Sanjaya , Randy Dunlap Subject: [PATCH net-next v2 6/8] Documentation: xfrm_sync: Number the fifth section Date: Sat, 1 Nov 2025 16:47:42 +0700 Message-ID: <20251101094744.46932-7-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251101094744.46932-1-bagasdotme@gmail.com> References: <20251101094744.46932-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1096; i=bagasdotme@gmail.com; h=from:subject; bh=VFD6GtIua5YG7zFmjDzL7GA/HqAr0MELlfN71DmH60w=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJms1/J61eMXh5r+5VtpuJ9Vae2HZ5pck3/9ZC9+wrTmo CDvkzsLO0pZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjARUUNGhp2cd7vve3/YPVXf p5gnfWOM2NMCjeUTV6z6s+aziv7rI38Y/tl3/V3BVPIkw0ZqYnR3IM8kj2mXPBdYrq8qvHHN4sh LWy4A X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Number the fifth section ("Exception to threshold settings") to be consistent with the rest of sections. Suggested-by: Randy Dunlap Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/networking/xfrm_sync.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/networking/xfrm_sync.rst b/Documentation/network= ing/xfrm_sync.rst index de4da4707037ea..112f7c102ad043 100644 --- a/Documentation/networking/xfrm_sync.rst +++ b/Documentation/networking/xfrm_sync.rst @@ -179,8 +179,8 @@ happened) is set to inform the user what happened. Note the two flags are mutually exclusive. The message will always have XFRMA_LTIME_VAL and XFRMA_REPLAY_VAL TLVs. =20 -Exceptions to threshold settings --------------------------------- +5) Exceptions to threshold settings +----------------------------------- =20 If you have an SA that is getting hit by traffic in bursts such that there is a period where the timer threshold expires with no packets --=20 An old man doll... just what I always wanted! - Clara From nobody Sat Feb 7 18:21:05 2026 Received: from mail-pf1-f172.google.com (mail-pf1-f172.google.com [209.85.210.172]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7EA7E2D5920 for ; Sat, 1 Nov 2025 09:48:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990489; cv=none; b=WfMCMd/GRaEIfVnjtggxeFVQR39TC4XDgmmL4fxLlaRGPA7d5OAdfGHEIN+RxJjHf0Ygd0yduyVUvhFkuoJeUjj1RfmB7EOM48NYrY2Fqq4rpovhDJFiKKU506bKsWHSOK3Ll+Jq5RnCM/redgA+XLMl+r2VMofdfOxRVLjnxlM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990489; c=relaxed/simple; bh=scKBOtDHVqKDIQ1wnHzvccmWbCFHaFUh0A9SeEEBF5o=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=k+9lBm+IBwZvGkcey0Mt2GBelwSqKSHmrdi8Vch3NBP2+Z5Yib358CvtP9bhGezK6fCmLRpZHRtZJd9nBHxihGHS1DsuuIWDprYk7/SG1ws0OZVNFiUQaKgyabcongo8avBd9jrVUU3hwX2oVDRBmzqrl4kBlpLcRzS/Ine3yMU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=DDnb9KjM; arc=none smtp.client-ip=209.85.210.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="DDnb9KjM" Received: by mail-pf1-f172.google.com with SMTP id d2e1a72fcca58-7930132f59aso4434575b3a.0 for ; Sat, 01 Nov 2025 02:48:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761990487; x=1762595287; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=FlhKMqWLH6Ttx9Tu79F/62Lvn4ZGhBAbvbXeziFMbEs=; b=DDnb9KjM1YHI1mBpiMqrKD0cvFxzifXJvRB6JhZBPbGUy55vUph+n1JP8wYa5hyX1i 3xxmcblTOENIMF1dgfkRAzShTlerm5liklOiuOCtd3DxO81OaQ8k9mCPk5h+0UsuUL+E uIXFDHFiaZI8UY9lcEcALcWVa417dT4ZsIOir/X9ngk0o7GFE7QPljtnWMfAXesS59g9 ByREjh9uwu8r9Ac2156iO8dqjWyJGQmMwJknXq/L6PrXUR/dyKnLFZPE1flzGiBv8jEY P96FmGWUTr9Lofpq0zHLnIeOWxXtCmRVEviwWkw+Ecx5AMklf2Qv3BrXv+aoIh0I9VJe PJXw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761990487; x=1762595287; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=FlhKMqWLH6Ttx9Tu79F/62Lvn4ZGhBAbvbXeziFMbEs=; b=HQvvwk3tB0y62BZdCJxwhArL3tlECJVTZH+SIuzr68M76wSqi4Kt49MWG3pWAISmMa NZL9+MP2yMG/BWS5CgEm0h1KiN83HZVTGIc5a6OpN65Fy3GzMyCVc6XF7XSmCe++ugrW ZxlMOkPrtBpx4mDaSyFR0Gfm2x3uaikHoLlPYe68LHQosOrOQQEoB9jad6utA5LMzJ7N Baks2f2KGv7DANPCpO3vmEMBM6naK5qYY4bVWJZsX8WRoYJA6jcFHDJcnQzBi2zaiUip sALQMHuIW1sEJwJzRsDUgrAn+xX9g1XSgRkGP2jk/A6x6bAZv1+V2NfwFz+6PspA7gNK NP4A== X-Gm-Message-State: AOJu0YyZZxMHbReps3V4HNn3tZh+2vroLJuFwqJqDUilnarVzXZhrEPB 6V2QnxQyv1zcpuaw1N5MxUiDkyAlImbbdsTdEHh5IW1XjrPit/lRnTZv X-Gm-Gg: ASbGnculyI/bYZ1al4zH2kwCnVh3PjGAgcThsgS8G+TsV5I0PwtOfs+MH6GnLP9b4st XvQaxLiEwG5RcmYulPy+aDtqa+VMAj0huQ0W4jiZ5zN7GiZ34pHfhfqcg6fN+wOXbr5Bg7VzoRQ W3hkDlQ/VpRHUiwT8OBCgx3Iv8DxE5tinxibgs6eAWEKjFjwPFdLwohzAFWMZF2cLt3oZJOTS4u 5x2lP/DL6OzbbTpVIOYkUq0DSaQhwK8Aixs8Z6bQewgH54xH2KvwLaorNF9LWOlaaVi1xZR7kbC HHEkwy+7cy5q/FxFIbawHT0eTvFEvSFtk+4yOQzE+BPwTry+GiaTGkCzbmMwihLL6Q+zZ2bcM31 fdIJEV5ivfc6v0E0tkI/F6sBeMkq2WwHmbL8O3Djm2ZixwqiQ/8JjfzD1JDxtXs/ymexr0nHBDB +mLvgXXbmTx8Q= X-Google-Smtp-Source: AGHT+IFkBjadAlRvhWq+7eM46hxZBHaQSQ5gXKI08Y3+aBwkshix92V65FN8ebBWTu8xjYudEyFEDA== X-Received: by 2002:a05:6a20:3947:b0:2e6:b58a:ddec with SMTP id adf61e73a8af0-348cc2c2872mr9266465637.36.1761990486624; Sat, 01 Nov 2025 02:48:06 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b93be4f8cccsm4550093a12.30.2025.11.01.02.48.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 01 Nov 2025 02:48:03 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id E65EB4218354; Sat, 01 Nov 2025 16:47:56 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Networking Cc: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Steffen Klassert , Herbert Xu , Bagas Sanjaya , Randy Dunlap Subject: [PATCH net-next v2 7/8] net: Move XFRM documentation into its own subdirectory Date: Sat, 1 Nov 2025 16:47:43 +0700 Message-ID: <20251101094744.46932-8-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251101094744.46932-1-bagasdotme@gmail.com> References: <20251101094744.46932-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=3293; i=bagasdotme@gmail.com; h=from:subject; bh=scKBOtDHVqKDIQ1wnHzvccmWbCFHaFUh0A9SeEEBF5o=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJms1/JSknh6zi5oWKbks+j+lfM/Q4/p9Xc7a02LzmNWf iSfv8Suo5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABPpyGdkWCBUkaK565PuO8fk s4fP1BtpNEskrn5p0R7kFj3DMHKKM8P/PEZFXSeBhNwzZauOF+Wsl+rdIL/65nz1xfpLP9QYbqv iBQA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" XFRM docs are currently reside in Documentation/networking directory, yet these are distinctive as a group of their own. Move them into xfrm subdirectory. Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap Signed-off-by: Bagas Sanjaya --- Documentation/networking/index.rst | 5 +---- Documentation/networking/xfrm/index.rst | 13 +++++++++++++ Documentation/networking/{ =3D> xfrm}/xfrm_device.rst | 0 Documentation/networking/{ =3D> xfrm}/xfrm_proc.rst | 0 Documentation/networking/{ =3D> xfrm}/xfrm_sync.rst | 6 +++--- Documentation/networking/{ =3D> xfrm}/xfrm_sysctl.rst | 0 6 files changed, 17 insertions(+), 7 deletions(-) create mode 100644 Documentation/networking/xfrm/index.rst rename Documentation/networking/{ =3D> xfrm}/xfrm_device.rst (100%) rename Documentation/networking/{ =3D> xfrm}/xfrm_proc.rst (100%) rename Documentation/networking/{ =3D> xfrm}/xfrm_sync.rst (99%) rename Documentation/networking/{ =3D> xfrm}/xfrm_sysctl.rst (100%) diff --git a/Documentation/networking/index.rst b/Documentation/networking/= index.rst index c775cababc8c17..75db2251649b85 100644 --- a/Documentation/networking/index.rst +++ b/Documentation/networking/index.rst @@ -131,10 +131,7 @@ Contents: vxlan x25 x25-iface - xfrm_device - xfrm_proc - xfrm_sync - xfrm_sysctl + xfrm/index xdp-rx-metadata xsk-tx-metadata =20 diff --git a/Documentation/networking/xfrm/index.rst b/Documentation/networ= king/xfrm/index.rst new file mode 100644 index 00000000000000..7d866da836fe76 --- /dev/null +++ b/Documentation/networking/xfrm/index.rst @@ -0,0 +1,13 @@ +.. SPDX-License-Identifier: GPL-2.0 + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +XFRM Framework +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +.. toctree:: + :maxdepth: 2 + + xfrm_device + xfrm_proc + xfrm_sync + xfrm_sysctl diff --git a/Documentation/networking/xfrm_device.rst b/Documentation/netwo= rking/xfrm/xfrm_device.rst similarity index 100% rename from Documentation/networking/xfrm_device.rst rename to Documentation/networking/xfrm/xfrm_device.rst diff --git a/Documentation/networking/xfrm_proc.rst b/Documentation/network= ing/xfrm/xfrm_proc.rst similarity index 100% rename from Documentation/networking/xfrm_proc.rst rename to Documentation/networking/xfrm/xfrm_proc.rst diff --git a/Documentation/networking/xfrm_sync.rst b/Documentation/network= ing/xfrm/xfrm_sync.rst similarity index 99% rename from Documentation/networking/xfrm_sync.rst rename to Documentation/networking/xfrm/xfrm_sync.rst index 112f7c102ad043..dfc2ec0df380c4 100644 --- a/Documentation/networking/xfrm_sync.rst +++ b/Documentation/networking/xfrm/xfrm_sync.rst @@ -1,8 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0 =20 -=3D=3D=3D=3D -XFRM -=3D=3D=3D=3D +=3D=3D=3D=3D=3D=3D=3D=3D=3D +XFRM sync +=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 The sync patches work is based on initial patches from Krisztian and others and additional patches diff --git a/Documentation/networking/xfrm_sysctl.rst b/Documentation/netwo= rking/xfrm/xfrm_sysctl.rst similarity index 100% rename from Documentation/networking/xfrm_sysctl.rst rename to Documentation/networking/xfrm/xfrm_sysctl.rst --=20 An old man doll... just what I always wanted! - Clara From nobody Sat Feb 7 18:21:05 2026 Received: from mail-pj1-f48.google.com (mail-pj1-f48.google.com [209.85.216.48]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 25CC32D63F6 for ; Sat, 1 Nov 2025 09:48:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990489; cv=none; b=ak38lA+JwDeM1HXo5qx+NpAjF/WUFk2uDfDUqUlrQOsU6a6RUOn2e4x2GnblFM762/8xE4SWbHruesL7dXl0sd9YpKbDJ7paCIpqQPNFXrNFIBxnkecyOThMTcVQaDTzv34L0mlnrXI9l4xmPyEghLxTBZVlhGThdLk/V0mOBxE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761990489; c=relaxed/simple; bh=xYbBu2fMf0do2Y8PFkgmZ44ePl1qKHbhlD2bXGI6s6k=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=eRTIDnMYE6CjfuvWPr0pf+m6ZcybyLIwVFlHS/4juALyyD4Z1EzJImFe4pCOMDJelwf2dk8uLyfPdXWmTiWPPdg+R2b7ksvh7xYB3TxWrkIKwcR0KIk8ChyWrd8D1EWqyCR/kJw+OvEYobjUS42aNUjLmetg119G/+t+Yi738DE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=g2fT6k+o; arc=none smtp.client-ip=209.85.216.48 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="g2fT6k+o" Received: by mail-pj1-f48.google.com with SMTP id 98e67ed59e1d1-330b4739538so2997310a91.3 for ; Sat, 01 Nov 2025 02:48:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761990487; x=1762595287; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=bDAfAMTS/DdBYBQoTuWYXo0/wYkGq/INrH1coTZQ7c0=; b=g2fT6k+oZRO33cDif/qtBO0hUpagFP88NJv7YeIcoz6wEmPQC8Fkz5Xh//Jf/BsZpD yjKMc5EOBrLPG1TtvBWSEtYMUMJ33HQpbsoXyR6Oco+3eDzZRVGyzZiSnCHe1mWdSwdq TGPnWj7YZ1ZfFNy+zRGfNK6ZZteKZ5CvG0wkrLhxfhMB3hQDtYHPAhqGhBV9iyVGJODQ q2mYkbMORflXRV5F0YdyMXrMv17VGVj9lWOzIfzl1O2ARTVYdzWqLs2ipqmTsU6Isqu+ UhBmkjOXq5TJhLmexmpRsniCMkH5VLh5H1VfcvVKbaFtvdqM8w5QeT/DW70lEI9x1rpR DUmA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761990487; x=1762595287; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=bDAfAMTS/DdBYBQoTuWYXo0/wYkGq/INrH1coTZQ7c0=; b=g5Lqac9Z29qh9tz7eysxENEd8IiQqGwRBImjwlgUtbdG6/tfGPc2a4N4hfNqx+nREx redi84bDr6Lu5gqpYc0XznuvC0PwL65XOs1Z8stUxD5yKZveatEl3qt2tz0dMQUtTfgb SgZtv3/I3SmTdO4g2O2Yc/aq1bU9Vm5N3KOsg71HqFnGO9+ywCV5HXFAFSbjUn8wcZUK SJt9OiOez/ZPikIsZ8f2JftwuYUX4ZU8sHTtRxDaYIW+os3ArEa0xy0XpIp7tfzHZaNU srVFQFC0zmnnCLIPm6Nw8lALU88UcDBSuH48YJbiYLOof9R64Rw9PIfhnqOlABy//pa6 7G0A== X-Gm-Message-State: AOJu0YwLR0WU+4c4Gui7tlG+xoR0VC5tdOHXZgCa8hjQWVZg846Oro41 1U4BkTeyQUXMeN0MYiYpm+2yszMMJN1Ch08lwr17zdCmNKq/5xC9jHua X-Gm-Gg: ASbGnct7at4u6fvKGvx3Bm6TUGWTDYGIhAQ7kGDafECUucLSluZX54tfo9gsumufqNA IxTdTmA7d+qVHNq4KAazADsFg75sQdQKf7C2Bkl7g8S5TSH1EEKXpWwfXaH9oPkcwdT3VOu2W/A Ngs00AV3A0Qcvc7uyRZHxb0S438E8Y4atmy9IPLr4DqRQUG7bm0YLZwLW+mVsYA/sYP5dblwbco Yuu1MUKVXlNK5iOhNs5ejjg3TXIUDZqQamVw1ZnnChjU6Aw3mkMPCav6riLwgayd0bUAQ6tpsaM tES0y7YOGskHKYLT7S+F5g2ajOcp7E6R+05Ktu26IPy1P69zVsR9IzhUlG90HFfvSDXuRwKQ8+q bEKaf6uARR/bfJrsCaMweGycgy66Xmwg3jK4EfEUhKkZfmkStteQHTX5WMpnEX/tkt8I/UZV2zL 0dqpQkFT0NDu0= X-Google-Smtp-Source: AGHT+IGy1cfZoCwULFLYqE6Bb4moe4uWpY+1tqcKqVLgBJzC6ePt7PtJtSMS5a4wl0/9ag5xmaq1CA== X-Received: by 2002:a17:90b:388e:b0:340:7f2b:3e33 with SMTP id 98e67ed59e1d1-34082fd9d6amr9568347a91.16.1761990487435; Sat, 01 Nov 2025 02:48:07 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-3407f28fe27sm2913985a91.5.2025.11.01.02.48.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 01 Nov 2025 02:48:03 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 028DE42229A6; Sat, 01 Nov 2025 16:47:57 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Networking Cc: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Steffen Klassert , Herbert Xu , Bagas Sanjaya , Randy Dunlap Subject: [PATCH net-next v2 8/8] MAINTAINERS: Add entry for XFRM documentation Date: Sat, 1 Nov 2025 16:47:44 +0700 Message-ID: <20251101094744.46932-9-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251101094744.46932-1-bagasdotme@gmail.com> References: <20251101094744.46932-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=870; i=bagasdotme@gmail.com; h=from:subject; bh=xYbBu2fMf0do2Y8PFkgmZ44ePl1qKHbhlD2bXGI6s6k=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJms1/IS30YlyQdeeefsdyyyIUi2ScFp/n2boy4bDJ++c vDY4XW1o5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABMp12NkOLTuH3cC+9Ic75nq nhmql56nLqmPn1HWynJ4ub6j0vfsOoZ/VgUsHxc1P1ooG1Cg077nzM21FZmbzMoq8//pTp++/OZ pRgA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" XFRM patches are supposed to be sent to maintainers under "NETWORKING [IPSEC]" heading, but it doesn't cover XFRM docs yet. Add the entry. Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap Signed-off-by: Bagas Sanjaya --- MAINTAINERS | 1 + 1 file changed, 1 insertion(+) diff --git a/MAINTAINERS b/MAINTAINERS index 1ab7e87462993b..6d2906b2600376 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -18051,6 +18051,7 @@ L: netdev@vger.kernel.org S: Maintained T: git git://git.kernel.org/pub/scm/linux/kernel/git/klassert/ipsec.git T: git git://git.kernel.org/pub/scm/linux/kernel/git/klassert/ipsec-next.g= it +F: Documentation/networking/xfrm/ F: include/net/xfrm.h F: include/uapi/linux/xfrm.h F: net/ipv4/ah4.c --=20 An old man doll... just what I always wanted! - Clara