From nobody Mon Feb 9 13:02:59 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