From nobody Mon Dec 15 18:51:54 2025 Received: from mail-pj1-f54.google.com (mail-pj1-f54.google.com [209.85.216.54]) (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 77FC7321448 for ; Wed, 29 Oct 2025 08:26:29 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.54 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726391; cv=none; b=GlJPdgZkRqw53Dr6cmwta8gMRZ6pm7fE9rutfdstvb8u6vv2WHgMkWMk/igEvEbqV4Nd5cEZ4BfzDQaCYgzGG2gH5/xeGArcTS8lcwCUJ7mco+k3cF0PbM+7ASLfdoDHwyIkz82RxxHm88b3lYgCNgXjZ0IXiRxS97Mqkl7KyKE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726391; c=relaxed/simple; bh=nyCZSmt1D2HnBq6FkYiMqYxTiXGKqyUbzskuCw+9U/Y=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=jsHUcAFOgNf91mTAF0heTRNDd7cngTo1sygQPQU3oHs7gtDPt8gSuzNIQQVbD775QL7CRXtq6YLKpN8v//9veL/6vJ7zGuOT+DS71GTLdv6ZGm3ULq6ePu/9yZ5zbAL6108HSXv2s9BN+V5mmc4E1VI91V15kkS92RpM/0AO6Ec= 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=gQ4Y24FI; arc=none smtp.client-ip=209.85.216.54 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="gQ4Y24FI" Received: by mail-pj1-f54.google.com with SMTP id 98e67ed59e1d1-33b5a3e8ae2so688590a91.1 for ; Wed, 29 Oct 2025 01:26:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761726389; x=1762331189; 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=Z6KBv+9LBo3P3W+l1WrAwkIVp2BK7WV9DO0KdC2+trI=; b=gQ4Y24FIrYLGwFP1CDMVDSh9tT495PySd+Uok72QSadHsvG7IYpY4hdt1WbJkoha6V c5tCurjgQL8P49tiiO5STDT/l27HuuV+utchBh4iy7K17PXlEe4+O8qacN9j85ZIXmqv elvHpm3vTCfocfOBAH0AEGFEXtqbTV0BoX6Ku8eTKozmYTcsLkSz9T5UW+yOeT8t5+Dc ZFMZICimSFNLgMEAu8Ee/0POsUjPcAxGuDZdfG4jolDNAtxX9Y7Q1C+RIOHTjNHrMtxE NceL4socaw+iUjI1L6m3KiaMKgEp0oXklq0HG1Gd857SiafntseFksH9ibE9jAMT+gFA DOOw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761726389; x=1762331189; 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=Z6KBv+9LBo3P3W+l1WrAwkIVp2BK7WV9DO0KdC2+trI=; b=rcBti0Q6NI6x++AoVSLoe77HMq/YxgRG4FSlHITV1X2ahnF4Cs5Iy0LTCkS3XiNIVp ZnkSMgY4RqgBWU12R39uToC9X2VzR7V92CBjEdvm35Tj9/dxXjFlwdDSEvNwverScoAn 6G9FwZeG4TLmemt1z9vwFDCKr7uEcXKUq5gy04i68F6xzt2PTIv9ppGT14F1Sufdf+ob NCRDD9bl3l2YPzOlPOaem33gejJ5z28yBz8uhj+4HJGv83Xzy6EqjiTF8FZ+FUUPq+gJ B99TFXhYvpC1VThOl7HgIqlVGU6AWgAUQ5U58MTdabxrlr5LPizRw2iGbXtjcA006FnQ 7Ukw== X-Gm-Message-State: AOJu0Yym0lg7SczZlre+gSqPM1OkYxELQtEse/2lzmHQiQOs5MgOh8Xr 0UR61sY4qvxvyd59vZrF4V4Wz6NFsjWGxqZ84C1wdD9dayfTa5BdCvlqYZYE3vaty58= X-Gm-Gg: ASbGncvgHWuqWt64TdNvLpEseMExqMvCblfeia68RszAiORp3NycEXOuMeHk3/QUmG7 ulRgHsS8b7FxocmEKBm4dGMmTo1nLUG6qlwqY1sB3H2SViE8JLfmNv1kyG9fGkVJipq2qX23RS3 u0E3DeWJAYB2ECuSrOjqBB6aQK/GK1IQgMVz5XnZORq6xLgFxZujYjjyvEFd3nb5pkmzg4AobiN 2k5qeytqa6y155uqeOtrwOO6JlLwZv+95j08FiN4E3iA61lP4oXvE7o4Y4MrMApllev2DbVkPtp YuoiI+GsJjK2xZJ4w4PllNfkUyAMkQ0sxgG2ugbPHrb3SqIoxlHWgU5d+P6izNNXfIaLOfmvMMo U/fgKo1+6Bsaq+LJCQGHnSTJ2+QrzcCozPr/btMaBq2ui/oIOJL7sDvMTU67aOJDUVp6rmyxmZg l7DBEnJb0hhRI= X-Google-Smtp-Source: AGHT+IFEMctQ1glWsB5FN3W+UH1ALcUxipYIN+xXnYZnB3spEDqZoPtSw+8CX6fNdREkn3EzAPpmnA== X-Received: by 2002:a17:90b:280b:b0:32b:7d35:a7e6 with SMTP id 98e67ed59e1d1-340396eb178mr2640689a91.18.1761726388553; Wed, 29 Oct 2025 01:26:28 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b8087fac6d5sm7538006a12.15.2025.10.29.01.26.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Oct 2025 01:26:27 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 3D735420A6BF; Wed, 29 Oct 2025 15:26:19 +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 Subject: [PATCH net-next 1/6] Documentation: xfrm_device: Wrap iproute2 snippets in literal code block Date: Wed, 29 Oct 2025 15:26:09 +0700 Message-ID: <20251029082615.39518-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251029082615.39518-1-bagasdotme@gmail.com> References: <20251029082615.39518-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=1413; i=bagasdotme@gmail.com; h=from:subject; bh=nyCZSmt1D2HnBq6FkYiMqYxTiXGKqyUbzskuCw+9U/Y=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJmM5zVsT2rF9Xw1WfpGmUmQmenQnZeaX84Erus1XZxr+ Xd2xWTljlIWBjEuBlkxRZZJiXxNp3cZiVxoX+sIM4eVCWQIAxenAEzkZg4jQ1u4S61VnT7Pxy5m ltoXrEuZ8k+oLlo+Y1aO6aMbJ5JthRgZll9oOlV47/2FCIO5gvd+Jp1VLjVaF1Us3eb5Un0ugwM vAwA= 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. Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- 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 Mon Dec 15 18:51:54 2025 Received: from mail-pf1-f170.google.com (mail-pf1-f170.google.com [209.85.210.170]) (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 9723F32E6B9 for ; Wed, 29 Oct 2025 08:26:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.170 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726394; cv=none; b=KUkam4BB5w1GR9cScY1ZP9GIHQ5ava0A7IW0Iv+HL8Oou541bneqG/rNh4/rbNw90/5P9gBBMGs7wxBG4D2goD6bzqziygE74VRjwR35D3J+1sSdUnUswffmLlSl28SqbsvSqTkeT8XMCNIL+m3eXy4F5ztua1OK96PO5tzIn+U= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726394; c=relaxed/simple; bh=sF2dC0yEoZfqsMqlw23WcrsBb8sQVqBQWtlJoeU/pAs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=MzktLAUd4xfFx+OIg04Geoxzsa50y5idUXMcxQOTOsUFqsFkh89rAgWoNZyjG2s02Ze+8m1PI2IO4kuuFdV/wo84R/DqIkk7dvNm//6jsa0/P2QoYdAQuzcplmqOEwb2uA2JCGTdoqIcJTMYM4VRfDiy1QwMFQRSCRN3t9wPFQI= 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=AhOUqMRB; arc=none smtp.client-ip=209.85.210.170 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="AhOUqMRB" Received: by mail-pf1-f170.google.com with SMTP id d2e1a72fcca58-7a26dab3a97so4343608b3a.0 for ; Wed, 29 Oct 2025 01:26:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761726392; x=1762331192; 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=yn0tHntcIm9TXsQwef8sNUxYfqf9R0uILDPExZJh0QE=; b=AhOUqMRBS0xyASLrnCRYf2ZPSq2eR/Raby/ourfh6kYxEsV7ujJHtGrmXM+ULGpxqt rT3kuYxau9VH8bVDKI2NqtsgnebKxoRrMdVBgGd2DCPBHlLeIXWRg64u3Jehw28MOyOn KfhTzGlXHSGMwcaHkaIUhJ7j/v766QFjOdjBRAqcelELGsVsfRb1KCf/jCGwokFoHMSM FwlBEvAuqYdBjkKVgmIYPwYArQmPKeoC9drjm9nLGR3LFBmTw+1d1f7UKtlnO+0EDCWi Yyz58rdzOHR5blTztCaZpw4otDtfDWzegKjf8tnMlmb3hJXHh0RARiXpkKZpt7rCjSW5 5nmA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761726392; x=1762331192; 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=yn0tHntcIm9TXsQwef8sNUxYfqf9R0uILDPExZJh0QE=; b=C+rAPNgK9KhzN1AU6zMxLwD20VnUDOxudvrNj/ljt9iHjOzgKhVu2VzNkklo1YK3i8 XlxyZXSpemVYF7EtP3KUsKT1oDXY/DvJV4SCmAD+YNkeoNikc389CNaIYeFKhk0BwllS HD3KjY+UMnt0b34+IJGERJdodZFAysesEnLY5i5CZY51jVm+91LNmOXxQmKr/dGYMvIF nqSaylAYVa2f5IKXAl7JyKtW7+dCtebLkLPDCJr7SmT5J4o+B3ESRVPuhjZjYt3kT5+Y 7adG1i70TFQhqLAHf51BG8+EA/HSoRm1NSD63JO0SCLNPnKFW9Acsx1FEtSjM30dO0xy A47g== X-Gm-Message-State: AOJu0Yy5NGXqyFd0Gdt6ACekRTPwjVNVUyDzMpYcIl+zK4iVtMhyUkUt olc8HC34GfVPNF6uM/5pb6EHYv1XYGVwzXqyVwh8AngIo6y7cCeRpub3 X-Gm-Gg: ASbGncuqmriGu5Xnhb07twe6yt67YoD9aWt2+gSMOqnFLoeZzZBoAJFv6WrxcSaBThk GWKgFJkvECkpBrrtAQyTppPrN0WS6dMwPafmN9VGCP+J1xQ9hShRCOLVjU9yv/uyfUzrWWZI2XV 9gZa0uVpGzl2+isiLCiRtwZLh+RjLDjHttarJVhmQjGBh6NuZyoTtqQ5VWoblwqZuBThpOZfit5 iSIqEj0F9yvMpIlSGP9tFmFmnlusUwc9SfcEUiptbQ9Wrwu1+SGNyzr+4aX8yBoSxYCwiNJWGfx ySfY1kP+VZxB9fyl16Qbm8c9PTtU5xdP4E8hgr3pG3m1g6/NBC+zmbrWeUcucl5pj1lcYPPf+hG Okh9Mx+ADl3DNIsc4OBGsOSlw1AaP2VlcCRCbbkMTm5eBKnWOnE2uqEYfP3RG7t5hT5kJmZPwRG ZjjWNNxwzUPGs= X-Google-Smtp-Source: AGHT+IGaPtjJNURBFreVhHociDTVO8Qt3Z5yfA7jdZER+9HScrmDJ5QCPbGQTLP2IHCC1IeBVmLIIA== X-Received: by 2002:a05:6a20:4328:b0:263:4717:53d with SMTP id adf61e73a8af0-3465381698fmr2495369637.48.1761726391775; Wed, 29 Oct 2025 01:26:31 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b7127bf6accsm13075614a12.14.2025.10.29.01.26.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Oct 2025 01:26:29 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 4EE824201B81; Wed, 29 Oct 2025 15:26:19 +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 Subject: [PATCH net-next 2/6] Documentation: xfrm_device: Use numbered list for offloading steps Date: Wed, 29 Oct 2025 15:26:10 +0700 Message-ID: <20251029082615.39518-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251029082615.39518-1-bagasdotme@gmail.com> References: <20251029082615.39518-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=1691; i=bagasdotme@gmail.com; h=from:subject; bh=sF2dC0yEoZfqsMqlw23WcrsBb8sQVqBQWtlJoeU/pAs=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJmM5zUM9v13EGe3tvn6LGGFpkSJcNtu3neHdaPPH9v+T /f7rjD5jlIWBjEuBlkxRZZJiXxNp3cZiVxoX+sIM4eVCWQIAxenAExkazYjw4Ir2UHbpfU4bh8I +d3Xec7o4ZqlBavYLjF6bl0TOSsmKpaRYWKL+KoWH+3XKvIPVz+7vPilZoDbHRmPd2W/N7U5emW u5AUA 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. Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- 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 Mon Dec 15 18:51:54 2025 Received: from mail-pg1-f175.google.com (mail-pg1-f175.google.com [209.85.215.175]) (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 7BCB630FF1C for ; Wed, 29 Oct 2025 08:26:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.175 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726392; cv=none; b=uAJW8t2Y7/ObWvtIBNDz0W8RcrEI6/KY50NS/xv3xyudIOEdC5Vcc9vwWIqLk6BJNH90S11FCspoct/dlmSir9nI27Si4JuVAKzIXIiUplKFlrLdkg1v11fw2D7lUy6f4LeHkq5mvZBQL8GtDTgBvmbFmeq2WK+oTpKrmqRlYjM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726392; c=relaxed/simple; bh=GSr0LS5xRxsWE7V64rIkueqh60w0KTfl0+hSyY9hdd8=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=f5DWl0ir+dZMj5udlXpwaUiSCMfr1A9dTuf7GcxZMvRDAN9bU8q3VsSpJFZBiFqR+vbj7RryuhCeAKWOt+sDTRMqrlGVhlzHSyEQH92XVV9EpbTaEJCZBp98TmcxTsmZBRmMsfvzrfJBwgmOPPkwqIlvSES+HdITZN6+25v8wvo= 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=hi47WkX7; arc=none smtp.client-ip=209.85.215.175 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="hi47WkX7" Received: by mail-pg1-f175.google.com with SMTP id 41be03b00d2f7-b6cdba2663dso5024243a12.2 for ; Wed, 29 Oct 2025 01:26:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761726390; x=1762331190; 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=gJm0KiVPvaLAcS9A4OHuh4FHLPmznInTZwPY/pYOieI=; b=hi47WkX7L+4AmaZBemN8wXeCvyQNDxfT9jocZbXUJsrtUGWRy5ElEs5J0MuOUEXjwy afyz2Lnxwu2TK8C5zg+wU/FkD63GWslsiROM31bCzFgZU27dOUg/XFRJj/VM05y1m9Ja KBTAW4tKcIVAvFvnEqyjcPs2i5Dn+4KsyvNjnBWRKlNLWuZ5JY14ctrpnhoJrQ2b2Qba cBiCgXSp0zgNmEug6Aqbs94bJqSbo1rOGohiWI2GPTFhmeFpTZtjocXHxi1ap65z1Y8S 4nm9yeSs4neoe7uCujJIuVr7LUKXMuHpSw5YbpknqHQZNjj1k71/LXjlTYPLF8b46kKc rStQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761726390; x=1762331190; 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=gJm0KiVPvaLAcS9A4OHuh4FHLPmznInTZwPY/pYOieI=; b=VH6gTxVypfyuSwyNRtPHJqh1boCP+SqHQYFCySJMAuSfEqpjNZWPJtFbwgNnCoY84L tjZMwjVXSNWBoVTtEZaYyYNgPhHPHvWfSV2F8RuAl4DdYUDW/kqjxZeJI6ppiaBZQuTw MdgiId+3ayeXGQbYVvEwEUdps/Ux9QC0RAbDJ/oV8pF+EVFPJVowuHtboFsOiUlQF5Ii adieywGyqw0GrCMnyDExy5glQ2frxZSRTaTgxoG9p+aYJyarC1f9anMD0HPr3EMLNE83 GmnPGcd1hyGj0/3SgBkbh3ensyVDA46TUZCeprf5d5GFbZf8ICoX8OwOtlOWp2McosR1 tqxg== X-Gm-Message-State: AOJu0YzAVQPLoocC7pAfHFoTEvFK+o3xfwAabiElXsEfcNOOkMkgPQrz lJoSoOU8ntTXPE4JFltWiqp2JeHeLi2EFBvk8K32kyTCIZUITjEbblQI X-Gm-Gg: ASbGncuNGGzw6BkZAUmj2kB3Lg7ZDhkeeTJgNkIBHTNFXhT3iu+gyhREfaL+h1LZRSp yKy0s2QPIikR8e0o8pbKATZsGWB7zjYveZFLkjQcgGzeDvGLSQX8wq+vvHQkESlZ4Sf9E2s7DGC m2djHzVd/+ZhUX/ILTKOAa/Aqmd4g+IyMer0xU1xxq75ppDT/sKOLTw42rTxb+mXeQqI4pYj1ST CgrITaJwC4cIwhhqqjQ1Jtc8nI9upGvqJeLaADRQaQrHypyl4OWMpfgDtHfjNqMVCBGPHUfcHPW u/NVje8Q6I60QCNLRGRSLm99hvQy10p7aUoEYhud3aMkblW5DKPDnQtjpe/AOoSpdhEpiJfRki0 ATHlMwLwK1KInuj0i9Kh3gtcaLCftz0tsuQPZO4c3+ZLxZVTPT8f1plE0kmSM2eGjIqDrkKL5Lm Hk X-Google-Smtp-Source: AGHT+IHA303tZEZ4a/W4KwtMHRrxESLDrc7p5KrCU2dbSpWS63eCceiJLPKnu2iFdf9no/xqvg36SQ== X-Received: by 2002:a17:902:d58e:b0:294:cc1d:e289 with SMTP id d9443c01a7336-294dee12965mr24835135ad.15.1761726389381; Wed, 29 Oct 2025 01:26:29 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-29498d0c414sm142891175ad.44.2025.10.29.01.26.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Oct 2025 01:26:28 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 8A4B541FA3A2; Wed, 29 Oct 2025 15:26:19 +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 Subject: [PATCH net-next 3/6] Documentation: xfrm_device: Separate hardware offload sublists Date: Wed, 29 Oct 2025 15:26:11 +0700 Message-ID: <20251029082615.39518-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251029082615.39518-1-bagasdotme@gmail.com> References: <20251029082615.39518-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=1192; i=bagasdotme@gmail.com; h=from:subject; bh=GSr0LS5xRxsWE7V64rIkueqh60w0KTfl0+hSyY9hdd8=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJmM5zVaz89epr/u1qt1N/LvrDZK6Nvyx+PCYaOpopcSA k7tZL7xs6OUhUGMi0FWTJFlUiJf0+ldRiIX2tc6wsxhZQIZwsDFKQATmfOV4X9o6L9T+WsqxCS5 3Lzjz7O7fFTy6ehyeaCXeOlEboB0pQnDH87vK1mtH6cw+ckpOG54ZfGY4Zb7TdYgyWoZLb3zPrn /OAE= 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. Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- 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 Mon Dec 15 18:51:54 2025 Received: from mail-pf1-f174.google.com (mail-pf1-f174.google.com [209.85.210.174]) (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 E285A3218A6 for ; Wed, 29 Oct 2025 08:26:29 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.174 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726391; cv=none; b=jAlY/ozncrOXFUPLGwIc7Epe3Q0k3DqDj9mnoF3XJ7tBbLjRLKfRXOjSEDq4+jyRJdMcNELR1OgStvLhcuaZaZiVLp1HLzxvskcxMZwmM9M6lTdbwflFEDVPMBz0GtFDPIKRqqW5tG/H173TauTwXahFtVvR97VRxJHKBu9HxF4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726391; c=relaxed/simple; bh=4MPxuhmy5nJtQg44BOr1viQz0zlGXaFe6yyLuJ1q6mM=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=M3QWUIuyxcqit9yQtK8ezIxA3S0s+XPWIRru7tiZGlnXZ9E1oVMD1jP3FpE1PwRZapa+iCfB4uYvxn7ZN/cqhRBS7gz1rH0QNoiWa0bF4yQ1LgMfv7VL9EIKdLMdDVwgZ+6y1y8bv1ZkOVvXUrhpocZ/+fq+B9xL2rRs/YAIIVE= 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=kuycjSt7; arc=none smtp.client-ip=209.85.210.174 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="kuycjSt7" Received: by mail-pf1-f174.google.com with SMTP id d2e1a72fcca58-7a26ea3bf76so9191749b3a.2 for ; Wed, 29 Oct 2025 01:26:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761726389; x=1762331189; 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=TmJgtaD3VOE42H71f0f9vmdpsFlxWZJ2RsN6RcT0X7I=; b=kuycjSt7V9+qt7ZB34ktqd57aCR05Ues8/gXb5ClE0Zt0Y9/B9thp3u8Aie15UZkm1 UfctvafGf4Am2jdlEpd32g0xSDcHSmqVtvkRc5xjisru63shIAUzF8lYJToYCDhnBBRc z9DjZLCtrE0YiDQVovL0JbnDM+fNWGIaMHxfquwBrtkI3G8ozdvo7P1xh56fpaax39zY 5FuXT9uFrK9PEzYjMVKlEBOZ1zS3ZR1sn3wDzsTnzpvovlVxP5gNiNkJZsjAffY6ovjM 7LZ0oY+s65eNWFCuZEAWCbPsti1QtaS6GfOfydLiY4Cc/olBebvmQNmwmt9wgxRTNiF3 kNKw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761726389; x=1762331189; 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=TmJgtaD3VOE42H71f0f9vmdpsFlxWZJ2RsN6RcT0X7I=; b=Q42QhiB2AlbyWfl48ADDw3/m0KPjsRxAp4GYX15TKCsxhxqr+ZwRUecYGLp+jtcu3S 1elejjaOJSIqWWMGJPUnMSTRJ318UvYX7U1YsCLjgs2Ze76WnnKMngOb/HXgAHYBEMZf V3oddkvhY3F28RGwypKVD1huXH7CZCAqidrpjkqEAJD5gmT2XARqh34L52fneSkgv20c NAAc8qdx7jQT19LaWIVUSS7A3f9s/2IbvpQ7VBGStbiABnS81le7+xLC4Nkj+toE01hR sN8HSYJI4Zj50pz3xIkEHpxwrcBc1KEqeRLqaJNCZOtmzZeU/VUItwC5X12o1XyxF2+f 7Y/w== X-Gm-Message-State: AOJu0YyqsFuG2PRdM2PktJuSg85OJNe2KmJBrRjP34itooqRlAhZZ+DZ u6KPgQ8aSdfq+PhYHEo+DYSaViIQrtMwfVyTLrG332MecEA+jnMJeDn3 X-Gm-Gg: ASbGncu1O84uenL0iEhyVe9Ax9DA1ngxV/vvRQ+hArdN0KewjvMvGd7Gb+C2qMfxwrg 8sja6O+iOzlXVwkLbbY6XlMrYVFgUgFDLcI5U8GGbY80/5m0RHHZVpadFWIkGN8Smy2dT+SkJFU qN82zFV76BmeVPnIFoQT0R9gX3LNKkd/+Jp1/cuR3kcESYSvO3tGk3WynWkcqR5IGOe0cxdb9DE qlT9W3jIQWhVLaqvAP5Ob7nS0XYMYHn+h5DiRl/s0Bj5B6a5o9FMV9Xm5vd8gHtbtXQnqR8utJX rnWbEZot1ZCXVBFirS72GaQI2bDfQq+J7y85dJiI/RGRFN4KWiqTvVi/Ps+XPI4fOka2XC/f6WP pz6AKleSC0PVckJ9vuYFTQEULIC4a7UuazNgLD51J8tjzTKzA3YQtezuuXFdIBOnN2+9Gc0S1HD 9oB9Bj0JObrDc= X-Google-Smtp-Source: AGHT+IEaWHg5ICq6Q4nvgM2fkEUKMxN3d+EvOaH9Z/76/nQrMU6XkXCcuh45+9ekQqeyE37MxMHcrA== X-Received: by 2002:a05:6a21:6da1:b0:341:77c4:bf0b with SMTP id adf61e73a8af0-34659c310afmr2602056637.42.1761726388965; Wed, 29 Oct 2025 01:26:28 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7a41403fa75sm14342488b3a.28.2025.10.29.01.26.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Oct 2025 01:26:27 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id A426941FA3A3; Wed, 29 Oct 2025 15:26:19 +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 Subject: [PATCH net-next 4/6] Documentation: xfrm_sync: Properly reindent list text Date: Wed, 29 Oct 2025 15:26:12 +0700 Message-ID: <20251029082615.39518-5-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251029082615.39518-1-bagasdotme@gmail.com> References: <20251029082615.39518-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=5839; i=bagasdotme@gmail.com; h=from:subject; bh=4MPxuhmy5nJtQg44BOr1viQz0zlGXaFe6yyLuJ1q6mM=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJmM5zXiHXZevr6TNeZM9pGJ5wOEN2id92Sc1ZCY+NZPX fjPVN6qjlIWBjEuBlkxRZZJiXxNp3cZiVxoX+sIM4eVCWQIAxenAExk93GG/6XBxeI/2ibH3t+5 vKTtU7Eym1CrzszYxdNfXlfOtJ6+RpbhN+vE0y7q55p+HDXNOnQwV0GE2TBAUWJHdkOIStHc7j/ buQE= 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. Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- 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 Mon Dec 15 18:51:54 2025 Received: from mail-pj1-f47.google.com (mail-pj1-f47.google.com [209.85.216.47]) (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 D1D09322A27 for ; Wed, 29 Oct 2025 08:26:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.47 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726401; cv=none; b=sPbphRAZKw19YgH51AvTsqn8qco4FujYpB6bdaCIzBA3m5G7690ucA2PGfCBlPuqQF/pUrfLqqAWklPUbwcLmj97D87RbO038qR+2uMDR55VNxTaUScHrUb8fX+ujUyw5Oho8XkbY3SN26o3SVbRX0n/6KyI2ZQEFZl6lSf/XAw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726401; c=relaxed/simple; bh=msTipho8IapyKvYc4ZCZhrcjYAYQP0E8B7eT922sMuE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=taMx1XjkDjA23M4CN5etf8q8t4DQ/g59jTEQgOUTuFyFyBUb+e662yCkLw7rNVNq9MnuVmbV5J6g1wp/a9YbPIIsVJJuCfp63kxUh21mUnlzYLW/XPVN+fUvfFaRTmom+qGuFZu07w3jtUADl1YRYkS50r9F6BUQjwv6eIAoomI= 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=Y00a+Lut; arc=none smtp.client-ip=209.85.216.47 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="Y00a+Lut" Received: by mail-pj1-f47.google.com with SMTP id 98e67ed59e1d1-34029c5beabso2067488a91.1 for ; Wed, 29 Oct 2025 01:26:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761726399; x=1762331199; 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=724md1U4WT0JWoYomELwngfgSd1J1DSSQs97O/mGLwo=; b=Y00a+LutSyVoPWdp1R/Vv3gkpFFVz34UsLKQDSbqfc3/KxkgKsdYssnsvHEtIFU0oC eNQ8aQhcAQ5lHY8Kndc+lgwq9XNhXR8uJ3ZSsW2NOd/x0vVFL/GOkKqTWt4E7Esal44c 549rsSaLt7AsNObkwzchOZxCex47nV99MqvfyJNHRUwiPG/+23tiFpTrDVlqxhuJ+zIz Wnn7Vtkbsp+Jj9ZwYZXrs4Bw/6EBXebSN7hNKwFgJb0X9fUdwjUbH1kdKOl29QQEy8PV gyTYQA3AgfCO62IS1u9OH+kYIz+4LvI+a77csgQX8wI+YDzx7yoqcLBuK/pE9sfqv49V lnfw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761726399; x=1762331199; 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=724md1U4WT0JWoYomELwngfgSd1J1DSSQs97O/mGLwo=; b=RHK3dv0+bi5ySapSQujaSSbjU/4mQCirDAngsamUlWsuXHLGWTOwAosVQ/jPWUSHt2 ILA1bBa1zC5mZZCQMCKl4uh7XexY+im2ed+fFHt+qfpwZY6KXo5UcyBfHco4SRvs7Is/ aZS5RmefUpVPNtFYccEXMXcMrTNDiWIQ1Jmgl44lpKVep1v71HBGTLK0AGHmE9rOF29s wSOYtsXYeCkC+5CZgFKoiZ8G8sjCUomF6528gdzF5KGzvpUwCPIrJDIttCzu6/wRNVUL cLsKaDOJmzColUl4OkWkGN/wds5yp6Ti1pbUKkMzJNdAOSIjoLFjn+FidxIERoDFsqtL Y5hw== X-Gm-Message-State: AOJu0YzPCsIm096w3v4aMOf56nvq3iEjQKAw2zxP1rNfhZr420IspOYk qrmyQbAcjzL+Kc4ZGUocaoh9h/PSgdeLqnaJiOyLexFifYttmUsVGaC9 X-Gm-Gg: ASbGnctPouAMG7Kl+te8OGYkqEP5B9hyp0D1CL6puzLBw+/rcrrX0/GKKOx1yDXpKj1 /YtQs8U5ejisIxr0tFHh0cdi4aBffaXOG0H+m9wOMg5MsO1Uf2R0UTaPgQ/OtKm5cwlKveHzw4T FQ+Ict+cCICpcxWFVa7y6Hp/+aY22XngFE4aaH0YgwhnhLpelhSkkj+e39uPRsAYYB93DSfFK+U 1iNtzUCIESUdEs6npxukJMSupmz2dh8eBaHtr79JDB4Jxk5Ynsh7GawVAqXzzq3pBSYupUNmE7b v8Yo0J2jm4lxe53KeFAatS0Fg44RBJnjBj0dRRjK7XdnLx0oO52zP7FMcK5PnzpDr0Tg/gVqeir 5GMbe2Gg18wspOCffaO19mg2H//LQR337eKOKX7Uheu6pvzttKInb4NKpTZqhA8vhr/lnb1eo2G Q1dVvae9Qxf+U= X-Google-Smtp-Source: AGHT+IGvp+cwrgt8OMCZqzHHFM6ZOoUpiPkKrvXKUyf4rpA+sgc4jr/n7s7EXCqnyDL4anB2BFkZSg== X-Received: by 2002:a17:90b:5843:b0:32b:bac7:5a41 with SMTP id 98e67ed59e1d1-3403a2a60aamr2565260a91.37.1761726399021; Wed, 29 Oct 2025 01:26:39 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-33fed73a7b7sm14544045a91.5.2025.10.29.01.26.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Oct 2025 01:26:38 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id AEF1D41FA3A7; Wed, 29 Oct 2025 15:26:19 +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 Subject: [PATCH net-next 5/6] net: Move XFRM documentation into its own subdirectory Date: Wed, 29 Oct 2025 15:26:13 +0700 Message-ID: <20251029082615.39518-6-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251029082615.39518-1-bagasdotme@gmail.com> References: <20251029082615.39518-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=3193; i=bagasdotme@gmail.com; h=from:subject; bh=msTipho8IapyKvYc4ZCZhrcjYAYQP0E8B7eT922sMuE=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJmM5zVcJOp3MnLNbqt5UhuSKa6ufSh7pnr5yoW/2Paw3 dzX4jqxo5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABORmsnIsEBLZ1X6i/93pIr7 1kxfPSP0Q+Kq2v2nX8nJes+vrs/4PZuRoSNrS7nuq8pV+jttQwWrBFdqPlw2Yb7+4lcZnvkRuwo OMQEA 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. Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- 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 c811c3edfa571a..41a336e0e7345d 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 Mon Dec 15 18:51:54 2025 Received: from mail-pf1-f176.google.com (mail-pf1-f176.google.com [209.85.210.176]) (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 7956B322C80 for ; Wed, 29 Oct 2025 08:26:40 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.176 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726401; cv=none; b=HTZRmCgiUq+6sD/ha3QkVot7Ifndb+sjzgbPefaT7sRj0ocZseqmG+nzTQoKnthdeHf7z6/586JVslcE2C8BuM1wy/US9L0SwLUAhcVliURebt/OnKfEcpvh4+YPWCgdHf3SwkiyIrACYsrNLIRDSHlYEZlMDQaKGwDayp7G6ZM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761726401; c=relaxed/simple; bh=iwYylQ8AuV4Dwv48M1+UsyJjpTEomPIpnnYBgnEaLEI=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=ZaWgtVB7r5gIe3QTpq/N3YowkWWuX8BpYvsASq/Sm79EN6bZePMWt2F2tV731UP6IuCKWl8lZPMKhsYyCeoBLYAMuDVaSEf3O2a7PRft2sVEKN7Iquxw7ieNsnqHXjgQBPOeErlsqLberD+RrgE4i+5R5T6zQwRKhEc7QKGZd6U= 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=Mwexq6nr; arc=none smtp.client-ip=209.85.210.176 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="Mwexq6nr" Received: by mail-pf1-f176.google.com with SMTP id d2e1a72fcca58-76e2ea933b7so710836b3a.1 for ; Wed, 29 Oct 2025 01:26:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761726400; x=1762331200; 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=GWLMkuBEjPNHOX1jtcXuUOzSLXt4OK/n+U6maOQyI/U=; b=Mwexq6nroam4j/AVv6x33k7EOtq66tL0llBbYjbSzj9/bzhqsQYkd04oIHfA1+Iy1/ NlF5BbLHsnW4arOqX4gxBiOCOKyWZQqdENvVm1TVqRSlz36LLF+C9s0zQpsiy3iDN5r4 pifDlX0dTpu2R361MvoHjgfAG/opHZ7qC1389R+hMcNuGc6/gHzBJ0xvtI2vpKC2yc9o H19nvoAl+VG4QZotasOMDHI2+WK2oNHF/aT7/AEFrLfsvoqJ8wAQQJWBm7xmmiKhYHre hfGJBkfKjh/9uidZqb6teA0c7+Ggh7IC+egdor2qdANxPpZxicHJAnIVfEexkyNFFcR6 8FFQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761726400; x=1762331200; 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=GWLMkuBEjPNHOX1jtcXuUOzSLXt4OK/n+U6maOQyI/U=; b=pNLbSEqsEM0UXw9dZncoslAe1gO3xv+S434AHiPXmsubwFNQC8KdDMwNRl8ZqvtD6v a6hgG9NEvXOl3ON8+P7uATO9KJsz5k8LhQWV2BzCTfm95JzH9rZ5BUCAZtuj01Ys+XEa SVO9M8FDCZLwvhuQgNmw0qT8Gjw23b7isP5NEKKCoz5K5xtDcnkNFSTLNcTjJtyyyqBD 8FvMGzgFwvp/aEgHaegjuNbbi6tumNaqiIHZs2ff+SnkFvwTi4zdK8jjrbnbDB3jvxzT X6F6wC2FDrwylRXoD4NDeXfpAbjz1nPiPBgzkfbvBQaVoKaMud1C7SrDeOTuDEwpzndO 2owA== X-Gm-Message-State: AOJu0Ywm2i8pgQc1f3AVZqTKrp/4WzL+yu9kCn5Lp/nrU5l5fJbMLgBk wSELI+Y68CaedQGTBNuJ+VmXir+bbA+tSIWwxGuMgzGKF+qN/Fepdttv X-Gm-Gg: ASbGnctmSKgj+Et2abdnp9g5U+CAy4L1hcax0lnBuwG03BwNA7bDxmO0SxU++iAX6+7 mvRZf6zInha2rbnLsadty1Tvsc+3pZKuEl5RcB4XsRC+R7KZc3IkZLJd4YT+H/IT1jaWlSgd4L5 b+FeEbGo3sohC1zN6dkdS0zN2M0Agk5RLP9Wk1MYxKufIyZGWwzIpqDUxDZn9WlLHcS8Yw8+FiS KhuKdsEFj30XJWmLO6HCGBB0fD1B/1whsQAODeBHwIJ/oylnfyg51jxjUATtsEhag9fJUfYSi21 tefK2P1ELFCN/l2Q9nphLSuhm8aoWHjdAHoprlWd1xNz+H/P557TQDK/JY23/8TSRjXzLfl3F1u KNWOi58KcSiizwUaxP5Vw7QH2xu46dlgj+bXmsRT/vB6Y6yW8e2YgzMmb9+JXdtxr/gWJqXqVLA 5Tzh8eEBqkwvJ0DTBq4731Vg== X-Google-Smtp-Source: AGHT+IFVPQNroTDXnGwGmdI4qVP/vYNEi7i6hJaoqjIk6/GCV39T3NC2T1TRLTj4se14ABHn/IHX7g== X-Received: by 2002:a05:6a00:130f:b0:77f:43e6:ce65 with SMTP id d2e1a72fcca58-7a442cc2c03mr6582791b3a.0.1761726399703; Wed, 29 Oct 2025 01:26:39 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7a41402e570sm14326342b3a.15.2025.10.29.01.26.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Oct 2025 01:26:38 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id BF4CC41FA3A8; Wed, 29 Oct 2025 15:26:19 +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 Subject: [PATCH net-next 6/6] MAINTAINERS: Add entry for XFRM documentation Date: Wed, 29 Oct 2025 15:26:14 +0700 Message-ID: <20251029082615.39518-7-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1 In-Reply-To: <20251029082615.39518-1-bagasdotme@gmail.com> References: <20251029082615.39518-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=770; i=bagasdotme@gmail.com; h=from:subject; bh=iwYylQ8AuV4Dwv48M1+UsyJjpTEomPIpnnYBgnEaLEI=; b=kA0DAAoW9rmJSVVRTqMByyZiAGkBzymgretmajEH8Gt4qs6FZhwcqEbXXScnAOlKIf01L2iEJ oh1BAAWCgAdFiEEkmEOgsu6MhTQh61B9rmJSVVRTqMFAmkBzykACgkQ9rmJSVVRTqMvwwD/Z5O5 PPrnPq81NjHLoWYI8Yx0P+6QRHzuZpcnCK+3HJMBAKApdR5dLHiz6ANWO1EodYtf3Z0vGB9tRZn B1HdrDGUN 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. Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- MAINTAINERS | 1 + 1 file changed, 1 insertion(+) diff --git a/MAINTAINERS b/MAINTAINERS index d652f4f27756ef..4f33daad40bed6 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -18041,6 +18041,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