linux-kernel - [PATCH] linux/bitopts.h: Add for_each_set

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-Id: <20191016161825.301082-1-vilhelm.gray@gmail.com>
Date:   Wed, 16 Oct 2019 12:18:25 -0400
From:   William Breathitt Gray <vilhelm.gray@...il.com>
To:     akpm@...ux-foundation.org
Cc:     linux-kernel@...r.kernel.org, andriy.shevchenko@...ux.intel.com,
        William Breathitt Gray <vilhelm.gray@...il.com>
Subject: [PATCH] linux/bitopts.h: Add for_each_set_clump8 documentation

Document in kerneldoc form the for_each_set_clump8 macro.

Signed-off-by: William Breathitt Gray <vilhelm.gray@...il.com>
---
 include/linux/bitops.h | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/include/linux/bitops.h b/include/linux/bitops.h
index fb94a10f7853..76ec8f0ce3e8 100644
--- a/include/linux/bitops.h
+++ b/include/linux/bitops.h
@@ -40,6 +40,13 @@ extern unsigned long __sw_hweight64(__u64 w);
 	     (bit) < (size);					\
 	     (bit) = find_next_zero_bit((addr), (size), (bit) + 1))
 
+/**
+ * for_each_set_clump8 - iterate over bitmap for each 8-bit clump with set bits
+ * @start: bit offset to start search and to store the current iteration offset
+ * @clump: location to store copy of current 8-bit clump
+ * @bits: bitmap address to base the search on
+ * @size: bitmap size in number of bits
+ */
 #define for_each_set_clump8(start, clump, bits, size) \
 	for ((start) = find_first_clump8(&(clump), (bits), (size)); \
 	     (start) < (size); \
-- 
2.23.0