Commit:     97d8f83cb734525f96992fd61e4f7323ab3d549c
Parent:     36cf3b5c3b7228bcf5124c530d50080b61a59f69
Author:     Andrew Morton <[EMAIL PROTECTED]>
AuthorDate: Sun Jul 15 23:41:20 2007 -0700
Committer:  Linus Torvalds <[EMAIL PROTECTED]>
CommitDate: Mon Jul 16 09:05:49 2007 -0700

    Add Documentation/sysctl/ctl_unnumbered.txt
    Poeple keep on adding new numbered sysctls, when they're supposed not to.
    Add a documentation file which explain why new sysctls should use
    CTL_UNNUMBERED.  The next patch will sprinkle pointers to this throughout
    Eric provided the text (thanks)
    Cc: "Eric W. Biederman" <[EMAIL PROTECTED]>
    Signed-off-by: Andrew Morton <[EMAIL PROTECTED]>
    Signed-off-by: Linus Torvalds <[EMAIL PROTECTED]>
 Documentation/sysctl/ctl_unnumbered.txt |   22 ++++++++++++++++++++++
 1 files changed, 22 insertions(+), 0 deletions(-)

diff --git a/Documentation/sysctl/ctl_unnumbered.txt 
new file mode 100644
index 0000000..23003a8
--- /dev/null
+++ b/Documentation/sysctl/ctl_unnumbered.txt
@@ -0,0 +1,22 @@
+Except for a few extremely rare exceptions user space applications do not use
+the binary sysctl interface.  Instead everyone uses /proc/sys/...  with
+readable ascii names.
+Recently the kernel has started supporting setting the binary sysctl value to
+CTL_UNNUMBERED so we no longer need to assign a binary sysctl path to allow
+sysctls to show up in /proc/sys.
+Assigning binary sysctl numbers is an endless source of conflicts in sysctl.h,
+breaking of the user space ABI (because of those conflicts), and maintenance
+problems.  A complete pass through all of the sysctl users revealed multiple
+instances where the sysctl binary interface was broken and had gone undetected
+for years.
+So please do not add new binary sysctl numbers.  They are unneeded and
+If you really need a new binary sysctl number please first merge your sysctl
+into the kernel and then as a separate patch allocate a binary sysctl number.
+([EMAIL PROTECTED], June 2007)
To unsubscribe from this list: send the line "unsubscribe git-commits-head" in
the body of a message to [EMAIL PROTECTED]
More majordomo info at

Reply via email to