Strengthened the warning against using this system call

and note that it may disappear in a future kernel version.
This commit is contained in:
Michael Kerrisk 2007-09-13 17:41:38 +00:00
parent f631e6d3ad
commit 3efbc18c81
1 changed files with 11 additions and 5 deletions

View File

@ -25,7 +25,7 @@
.\" Modified Tue Oct 22 22:28:41 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified Mon Jan 5 20:31:04 1998 by aeb.
.\"
.TH SYSCTL 2 2007-06-01 "Linux" "Linux Programmer's Manual"
.TH SYSCTL 2 2007-09-22 "Linux" "Linux Programmer's Manual"
.SH NAME
sysctl \- read/write system parameters
.SH SYNOPSIS
@ -106,12 +106,18 @@ function is the same in both.
.SH NOTES
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.SH BUGS
The object names vary between kernel versions.
.B This makes this system call worthless for applications.
Use the
Or rather... 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/
Remove it from your programs now; use the
.I /proc/sys
interface instead.
.SH BUGS
The object names vary between kernel versions,
making this system call worthless for applications.
.PP
Not all available objects are properly documented.
.PP