linux-kernel - [PATCH] Documentation: ioctl-number: Update outdated submission info

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>] [thread-next>] [day] [month] [year] [list]

Message-ID: <20250502074504.26933-2-bagasdotme@gmail.com>
Date: Fri,  2 May 2025 14:45:05 +0700
From: Bagas Sanjaya <bagasdotme@...il.com>
To: Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
	Linux Documentation <linux-doc@...r.kernel.org>
Cc: Jonathan Corbet <corbet@....net>,
	Greg Kroah-Hartman <gregkh@...uxfoundation.org>,
	Frederic Barrat <fbarrat@...ux.ibm.com>,
	Andrew Donnellan <ajd@...ux.ibm.com>,
	Michael Ellerman <mpe@...erman.id.au>,
	Alyssa Ross <hi@...ssa.is>,
	Rodolfo Giometti <giometti@...eenne.com>,
	Bagas Sanjaya <bagasdotme@...il.com>,
	Jason Gunthorpe <jgg@...pe.ca>,
	Nuno Das Neves <nunodasneves@...ux.microsoft.com>,
	Eric Biggers <ebiggers@...gle.com>,
	Jan Kara <jack@...e.cz>,
	Lukas Bulwahn <lukas.bulwahn@...hat.com>,
	Lee Jones <lee@...nel.org>,
	Lukas Bulwahn <lukas.bulwahn@...il.com>
Subject: [PATCH] Documentation: ioctl-number: Update outdated submission info

Much like device numbers that used to be assigned by LANANA (see commit
ebdf4040c16df5 ("Documentation: update the devices.txt documentation"),
ioctl numbers list is maintained by general kernel community nowadays
instead of contacting Michael directly as he's long stepped down from
kernel-related activity (his last LKML message was from 2003 [1] and
he's in CREDITS since the beginning of kernel's git history). Also,
patch (including one to update ioctl numbers list) submission now
follows process as described in
Documentation/process/submitting-patches.rst rather than sending
patches directly to Linus as in the distant past.

Update the docs to reflect that.

Link: https://lore.kernel.org/r/200305261446.h4QEkBVv023861@duracef.shout.net/ [1]
Signed-off-by: Bagas Sanjaya <bagasdotme@...il.com>
---
Cc: Lee Jones <lee@...nel.org>
Cc: Lukas Bulwahn <lukas.bulwahn@...il.com>

 Documentation/userspace-api/ioctl/ioctl-number.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/userspace-api/ioctl/ioctl-number.rst b/Documentation/userspace-api/ioctl/ioctl-number.rst
index 7a1409ecc238eb..83e5d2abdad694 100644
--- a/Documentation/userspace-api/ioctl/ioctl-number.rst
+++ b/Documentation/userspace-api/ioctl/ioctl-number.rst
@@ -28,10 +28,10 @@ or number from the table below.  Because of the large number of drivers,
 many drivers share a partial letter with other drivers.
 
 If you are writing a driver for a new device and need a letter, pick an
-unused block with enough room for expansion: 32 to 256 ioctl commands.
-You can register the block by patching this file and submitting the
-patch to Linus Torvalds.  Or you can e-mail me at <mec@...ut.net> and
-I'll register one for you.
+unused block with enough room for expansion: 32 to 256 ioctl commands
+should suffice. You can register the block by patching this file and
+submitting the patch through :doc:`usual patch submission process
+</process/submitting-patches>`.
 
 The second argument to _IO, _IOW, _IOR, or _IOWR is a sequence number
 to distinguish ioctls from each other.  The third argument to _IOW,

base-commit: c0fe189b590c754f69e0cb87c5b5674cad535cf6
-- 
An old man doll... just what I always wanted! - Clara