From: Joel Granados <joel.granados@kernel.org>
Date: Fri, 12 Dec 2025 12:44:20 +0000 (+0100)
Subject: sysctl: Add kernel doc to proc_douintvec_conv
X-Git-Tag: v7.0-rc1~52^2~2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b3af263b8a83f2ed033ae83fe008004b061b84f4;p=thirdparty%2Fkernel%2Flinux.git

sysctl: Add kernel doc to proc_douintvec_conv

This commit is making sure that all the functions that are part of the
API are documented.

Signed-off-by: Joel Granados <joel.granados@kernel.org>
---

diff --git a/kernel/sysctl.c b/kernel/sysctl.c
index 00df21b84900..54deced9ab69 100644
--- a/kernel/sysctl.c
+++ b/kernel/sysctl.c
@@ -656,6 +656,22 @@ static int do_proc_douintvec(const struct ctl_table *table, int dir,
 	return do_proc_douintvec_r(table, buffer, lenp, ppos, conv);
 }
 
+/**
+ * proc_douintvec_conv - read a vector of unsigned ints with a custom converter
+ *
+ * @table: the sysctl table
+ * @dir: %TRUE if this is a write to the sysctl file
+ * @buffer: the user buffer
+ * @lenp: the size of the user buffer
+ * @ppos: file position
+ * @conv: Custom converter call back
+ *
+ * Reads/writes up to table->maxlen/sizeof(unsigned int) unsigned integer
+ * values from/to the user buffer, treated as an ASCII string. Negative
+ * strings are not allowed.
+ *
+ * Returns 0 on success
+ */
 int proc_douintvec_conv(const struct ctl_table *table, int dir, void *buffer,
 			size_t *lenp, loff_t *ppos,
 			int (*conv)(unsigned long *u_ptr, unsigned int *k_ptr,