From nobody Tue May 13 03:34:42 2025 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4ZxMXz2jN0z5wG8B; Tue, 13 May 2025 03:34:43 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4ZxMXz0tNlz3mlL; Tue, 13 May 2025 03:34:43 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1747107283; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=+eGYuYkfhMrh29mPv3O6bAuutB28egnVstDq9dM1frg=; b=da8bNpkedIY1KDoEVlmvsf/AAbKfcZeAbqyFj0mWbZhVigcWOMAgJmAhT2GJio2nSWUwJe k8hsIAd2Of7gTy0oGpc4TXkMX0/jRMmCddt7FBGq7t7vKuEFOHsFxU5ODSS37JcjBf5AxM 7r6dXLlweRaf3UvACHnkGu2zOptRD/kZcwxWxFjQXeWL8A8ydv3U1KyRFsG8tXrHmgQ8zI /ExgPiX2bNNvwN5PaYF72cbdJKte8SmsJeMsnQUb0T7tiPnkNaYWSu1v8H0hxI2msYRKd7 AciB596kPCoRuLCAV/3bTQEEK1hzYnFXDKh10vutWmdFZhh7SOZAvuLVQ2t5Tw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1747107283; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=+eGYuYkfhMrh29mPv3O6bAuutB28egnVstDq9dM1frg=; b=UgpO/1adMI1hs/qvNje54iO67137Q8AsVO1cySX9UghFQs+pYUyB2uvHFa5ndMBsmQX2U0 C2Z0Iw3lFjRuurOWQRUrbPoQNMGZqfMAHZ4JoGj0APRYk2ju5LGEacZ8bcL/3g84n6nhFo sNY1xDAkKRB3etNvEpod2sB9NqSUS/Oq67mro4r3RUmjXuUIjvbyGJsDMFtfZZkL9kNGxD 00lYUzOn21Avuo5tIoQICbjKAx8B/Y/K+5VWQLR/90MJk2x8TP6yBiFEg4jjr7U3iRrt3D Neg4XbQ/UMndrGSLNDSN+TMfT0rlrIY+067OkRyqmxm8vKNt7FuMUW5O8yRDpA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1747107283; a=rsa-sha256; cv=none; b=pvddusPX3GK2m9b4J/8fQLbvQeiJtgB/Ubm2yGN+Mfjkl9uyzix4TB8krp3UnaHvBZCIB3 OhP4LH4EDjdWOy3RcijgHFrcAHcTjbocXAyNPQcicAPLbeGq87JEV39Ptqz9fsWKraYgfc Y1yM7Wv/eKx4x5FlGqh11ktpLgrLfhgyjK9XzLsE5yiXcteKKL3G/eLfFruiFOBtfYww1m Aak01EHwq1KR8m+NeACK1Krc2yvoa6gJ7oME+COUkhwUrx2OHR9+cGkeKSV8FEc6h6nqTC OW+/3tye98zIPIu79wcAepWb1ooOMTg04jY6Qksbs+8xMDt1wipZsiQToaWixw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4ZxMXz0JtNzTtq; Tue, 13 May 2025 03:34:43 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 54D3YgIo041106; Tue, 13 May 2025 03:34:42 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 54D3YgU4041103; Tue, 13 May 2025 03:34:42 GMT (envelope-from git) Date: Tue, 13 May 2025 03:34:42 GMT Message-Id: <202505130334.54D3YgU4041103@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Adrian Chadd Subject: git: afb0eadf97b2 - main - net80211: clean up the documentation for ieee80211_fragment() List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: adrian X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: afb0eadf97b22844dda6d9761782cb1526f83091 Auto-Submitted: auto-generated The branch main has been updated by adrian: URL: https://cgit.FreeBSD.org/src/commit/?id=afb0eadf97b22844dda6d9761782cb1526f83091 commit afb0eadf97b22844dda6d9761782cb1526f83091 Author: Adrian Chadd AuthorDate: 2025-05-13 03:34:05 +0000 Commit: Adrian Chadd CommitDate: 2025-05-13 03:34:05 +0000 net80211: clean up the documentation for ieee80211_fragment() In particular, frame it with @brief and move the summary description where it belongs. Reviewed by: bz --- sys/net80211/ieee80211_output.c | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/sys/net80211/ieee80211_output.c b/sys/net80211/ieee80211_output.c index 506c90991800..1ebf7fa8723f 100644 --- a/sys/net80211/ieee80211_output.c +++ b/sys/net80211/ieee80211_output.c @@ -1969,7 +1969,12 @@ ieee80211_free_mbuf(struct mbuf *m) } while ((m = next) != NULL); } -/* +/** + * @brief Fragment the frame according to the specified mtu. + * + * This implements the fragmentation part of 802.11-2016 10.2.7 + * (Fragmentation/defragmentation overview.) + * * Fragment the frame according to the specified mtu. * The size of the 802.11 header (w/o padding) is provided * so we don't need to recalculate it. We create a new @@ -1995,10 +2000,6 @@ ieee80211_free_mbuf(struct mbuf *m) * @param hdrsize header size to reserver * @param ciphdrsize crypto cipher header size to reserve * @param mtu maximum fragment size - * - * This implements the fragmentation part of 802.11-2016 10.2.7 - * (Fragmentation/defragmentation overview.) - * * @retval 1 if successful, with the mbuf pointed at by m0 * turned into an mbuf list of fragments (with the original * mbuf being truncated.)