From 5dc3d7b78f732d7b18a75a3fdca78208f14550f8 Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Mon, 9 Dec 2019 22:20:29 +0100
Subject: [PATCH] sysctl.2: This system call was removed in Linux 5.5; adjust
 the page accordingly

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
---
 man2/sysctl.2 | 38 ++++++++++++++++----------------------
 1 file changed, 16 insertions(+), 22 deletions(-)

diff --git a/man2/sysctl.2 b/man2/sysctl.2
index 0b9693a67..5cdbbf694 100644
--- a/man2/sysctl.2
+++ b/man2/sysctl.2
@@ -37,11 +37,8 @@ sysctl \- read/write system parameters
 .PP
 .BI "int _sysctl(struct __sysctl_args *" args );
 .fi
-.PP
-.IR Note :
-There is no glibc wrapper for this system call; see NOTES.
 .SH DESCRIPTION
-.B Do not use this system call!
+.B This system call no longer exists on current kernels!
 See NOTES.
 .PP
 The
@@ -96,12 +93,12 @@ non-NULL, but allowed zero room in
 .B ENOTDIR
 .I name
 was not found.
+.SH VERSIONS
+This system call first appeared in Linux 1.3.57.
+It was removed in Linux 5.5.
 .SH CONFORMING TO
 This call is Linux-specific, and should not be used in programs
 intended to be portable.
-A
-.BR sysctl ()
-call has been present in Linux since version 1.3.57.
 It originated in
 4.4BSD.
 Only Linux has the
@@ -111,26 +108,23 @@ but the declaration of the
 .BR sysctl ()
 function is the same in both.
 .SH NOTES
-Glibc does not provide a wrapper for this system call; call it using
-.BR syscall (2).
-Or rather...
-.I don't
-call it:
-use of this system call has long been discouraged,
-and it is so unloved that
-\fBit is likely to disappear in a future kernel version\fP.
-.\" See http://lwn.net/Articles/247243/
-Since Linux 2.6.24,
-uses of this system call result in warnings in the kernel log.
-.\" Though comments in suggest that it is needed by old glibc binaries,
-.\" so maybe it's not going away.
-Remove it from your programs now; use the
+Use of this system call was long discouraged:
+since Linux 2.6.24,
+uses of this system call result in warnings in the kernel log,
+and in Linux 5.5, the system call was finally removed.
+Use the
 .I /proc/sys
 interface instead.
 .PP
-This system call is available only if the kernel was configured with the
+Note that on older kernels where this system call still exists,
+it is available only if the kernel was configured with the
 .B CONFIG_SYSCTL_SYSCALL
 option.
+Furthermore,
+glibc does not provide a wrapper for this system call,
+necessitating the use of
+.BR syscall (2).
+.PP
 .SH BUGS
 The object names vary between kernel versions,
 making this system call worthless for applications.