LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

sysctl.2: This system call was removed in Linux 5.5; adjust the page accordingly 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2019-12-09 22:20:29 +01:00
parent 5afb9373df
commit 5dc3d7b78f
1 changed files with 16 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
man2/sysctl.2
View File

@ -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.