mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
* [PATCH] random: Fix vgetrandom_opaque_params kernel-doc
@ 2026-09-09  6:37 Karl Mehltretter
  2026-09-16  9:53 ` Jason A. Donenfeld
  0 siblings, 1 reply; 2+ messages in thread
From: Karl Mehltretter @ 2026-09-09  6:37 UTC (permalink / raw)
  To: Theodore Ts'o, Jason A. Donenfeld; +Cc: Karl Mehltretter, linux-kernel

struct vgetrandom_opaque_params contains size_of_opaque_state, but its
kernel-doc describes size_per_opaque_state. This leaves the real member
undescribed and adds a nonexistent member to the generated
documentation.

Use the member's actual name.

Fixes: 4ad10a5f5f78 ("random: introduce generic vDSO getrandom() implementation")
Assisted-by: LLM
Signed-off-by: Karl Mehltretter <kmehltretter@gmail.com>
---
 include/uapi/linux/random.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/include/uapi/linux/random.h b/include/uapi/linux/random.h
index 1dd047ec98a1..ef6614d9c704 100644
--- a/include/uapi/linux/random.h
+++ b/include/uapi/linux/random.h
@@ -58,7 +58,7 @@ struct rand_pool_info {
 /**
  * struct vgetrandom_opaque_params - arguments for allocating memory for vgetrandom
  *
- * @size_per_opaque_state:	Size of each state that is to be passed to vgetrandom().
+ * @size_of_opaque_state:	Size of each state passed to vgetrandom().
  * @mmap_prot:			Value of the prot argument in mmap(2).
  * @mmap_flags:			Value of the flags argument in mmap(2).
  * @reserved:			Reserved for future use.

base-commit: 893e11787f78e43b534e252249ac3fff4d1333f8
-- 
2.53.0

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [PATCH] random: Fix vgetrandom_opaque_params kernel-doc
  2026-09-09  6:37 [PATCH] random: Fix vgetrandom_opaque_params kernel-doc Karl Mehltretter
@ 2026-09-16  9:53 ` Jason A. Donenfeld
  0 siblings, 0 replies; 2+ messages in thread
From: Jason A. Donenfeld @ 2026-09-16  9:53 UTC (permalink / raw)
  To: Karl Mehltretter; +Cc: Theodore Ts'o, linux-kernel

On Wed, Sep 09, 2026 at 08:37:44AM +0200, Karl Mehltretter wrote:
> struct vgetrandom_opaque_params contains size_of_opaque_state, but its
> kernel-doc describes size_per_opaque_state. This leaves the real member
> undescribed and adds a nonexistent member to the generated
> documentation.
> 
> Use the member's actual name.

Applied. Thank you.

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2026-09-16  9:53 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2026-09-09  6:37 [PATCH] random: Fix vgetrandom_opaque_params kernel-doc Karl Mehltretter
2026-09-16  9:53 ` Jason A. Donenfeld

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®