include/linux/device.h | 1 + 1 file changed, 1 insertion(+)
Even though nobody should use this value (except when declaring the
"flags" bitmap), kernel-doc still gets upset that it's not documented.
It reports:
WARNING: ../include/linux/device.h:519
Enum value 'DEV_FLAG_COUNT' not described in enum 'struct_device_flags'
Add the description of DEV_FLAG_COUNT.
Fixes: a2225b6e834a ("driver core: Don't let a device probe until it's ready")
Reported-by: Randy Dunlap <rdunlap@infradead.org>
Closes: https://lore.kernel.org/f318cd43-81fd-48b9-abf7-92af85f12f91@infradead.org
Signed-off-by: Douglas Anderson <dianders@chromium.org>
---
include/linux/device.h | 1 +
1 file changed, 1 insertion(+)
diff --git a/include/linux/device.h b/include/linux/device.h
index 1c27505476bb..9c8fde6a3d86 100644
--- a/include/linux/device.h
+++ b/include/linux/device.h
@@ -512,6 +512,7 @@ struct device_physical_location {
*
* @DEV_FLAG_READY_TO_PROBE: If set then device_add() has finished enough
* initialization that probe could be called.
+ * @DEV_FLAG_COUNT: Number of defined struct_device_flags.
*/
enum struct_device_flags {
DEV_FLAG_READY_TO_PROBE = 0,
--
2.54.0.rc0.605.g598a273b03-goog
On Mon, 13 Apr 2026 19:59:11 -0700, Douglas Anderson wrote:
> [PATCH] driver core: Add kernel-doc for DEV_FLAG_COUNT enum value
Applied, thanks!
Branch: driver-core-linus
Tree: git://git.kernel.org/pub/scm/linux/kernel/git/driver-core/driver-core.git
[1/1] driver core: Add kernel-doc for DEV_FLAG_COUNT enum value
commit: 5b484311507b
The patch will appear in the next linux-next integration (typically within 24
hours on weekdays.)
The patch is queued up for Linus's tree and should land in the next -rc release.
On 4/13/26 7:59 PM, Douglas Anderson wrote:
> Even though nobody should use this value (except when declaring the
> "flags" bitmap), kernel-doc still gets upset that it's not documented.
> It reports:
>
> WARNING: ../include/linux/device.h:519
> Enum value 'DEV_FLAG_COUNT' not described in enum 'struct_device_flags'
>
> Add the description of DEV_FLAG_COUNT.
>
> Fixes: a2225b6e834a ("driver core: Don't let a device probe until it's ready")
> Reported-by: Randy Dunlap <rdunlap@infradead.org>
> Closes: https://lore.kernel.org/f318cd43-81fd-48b9-abf7-92af85f12f91@infradead.org
> Signed-off-by: Douglas Anderson <dianders@chromium.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Thanks.
> ---
>
> include/linux/device.h | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/include/linux/device.h b/include/linux/device.h
> index 1c27505476bb..9c8fde6a3d86 100644
> --- a/include/linux/device.h
> +++ b/include/linux/device.h
> @@ -512,6 +512,7 @@ struct device_physical_location {
> *
> * @DEV_FLAG_READY_TO_PROBE: If set then device_add() has finished enough
> * initialization that probe could be called.
> + * @DEV_FLAG_COUNT: Number of defined struct_device_flags.
> */
> enum struct_device_flags {
> DEV_FLAG_READY_TO_PROBE = 0,
--
~Randy
© 2016 - 2026 Red Hat, Inc.