From: Bagas Sanjaya <bagasdotme@gmail.com>
To: Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
Linux Documentation <linux-doc@vger.kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>,
Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
Frederic Barrat <fbarrat@linux.ibm.com>,
Andrew Donnellan <ajd@linux.ibm.com>,
Michael Ellerman <mpe@ellerman.id.au>, Alyssa Ross <hi@alyssa.is>,
Rodolfo Giometti <giometti@enneenne.com>,
Bagas Sanjaya <bagasdotme@gmail.com>,
Jason Gunthorpe <jgg@ziepe.ca>,
Nuno Das Neves <nunodasneves@linux.microsoft.com>,
Eric Biggers <ebiggers@google.com>, Jan Kara <jack@suse.cz>,
Lukas Bulwahn <lukas.bulwahn@redhat.com>,
Lee Jones <lee@kernel.org>,
Lukas Bulwahn <lukas.bulwahn@gmail.com>
Subject: [PATCH] Documentation: ioctl-number: Update outdated submission info
Date: Fri, 2 May 2025 14:45:05 +0700 [thread overview]
Message-ID: <20250502074504.26933-2-bagasdotme@gmail.com> (raw)
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@gmail.com>
---
Cc: Lee Jones <lee@kernel.org>
Cc: Lukas Bulwahn <lukas.bulwahn@gmail.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@shout.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
next reply other threads:[~2025-05-02 7:45 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-05-02 7:45 Bagas Sanjaya [this message]
2025-05-06 13:03 ` [PATCH] Documentation: ioctl-number: Update outdated submission info Jonathan Corbet
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250502074504.26933-2-bagasdotme@gmail.com \
--to=bagasdotme@gmail.com \
--cc=ajd@linux.ibm.com \
--cc=corbet@lwn.net \
--cc=ebiggers@google.com \
--cc=fbarrat@linux.ibm.com \
--cc=giometti@enneenne.com \
--cc=gregkh@linuxfoundation.org \
--cc=hi@alyssa.is \
--cc=jack@suse.cz \
--cc=jgg@ziepe.ca \
--cc=lee@kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=lukas.bulwahn@gmail.com \
--cc=lukas.bulwahn@redhat.com \
--cc=mpe@ellerman.id.au \
--cc=nunodasneves@linux.microsoft.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox