Differences between version 2 and previous revision of sysctl(2).
Other diffs: Previous Major Revision, Previous Author, or view the Annotated Edit History
| Newer page: | version 2 | Last edited on Monday, January 3, 2005 1:08:31 pm | by DashedDot | Revert |
| Older page: | version 1 | Last edited on Tuesday, June 4, 2002 12:23:48 am | by perry | Revert |
@@ -25,62 +25,57 @@
__#include __
-___syscall1(int, _sysctl, struct __sysctl_args *,
-
+___syscall1(int, _sysctl, struct __sysctl_args *, args);__
-__int _sysctl(struct __sysctl_args
-
-
+__int _sysctl(struct __sysctl_args *__''args''__);
+
+
__!!DESCRIPTION
The ___sysctl__ call reads and/or writes kernel
parameters. For example, the hostname, or the maximum number
of open files. The argument has the form
-struct __sysctl_args {
-int *name; /* integer vector describing variable */
-int nlen; /* length of this vector */
-void *oldval; /* 0 or address where to store old value */
-size_t *oldlenp; /* available room for old value,
-
-void *newval; /* 0 or address of new value */
-size_t newlen; /* size of new value */
-};
-This call does a search in a tree structure, possibly resembling a directory tree under __/proc/sys__, and if the requested item is found calls some appropriate routine to read or modify the value.
+
struct __sysctl_args {
+
int *name; /* integer vector describing variable */
+
int nlen; /* length of this vector */
+
void *oldval; /* 0 or address where to store old value */
+
size_t *oldlenp; /* available room for old value, overwritten by actual size of old value */
+
void *newval; /* 0 or address of new value */
+
size_t newlen; /* size of new value */
+
};
+
+This call does a search in a tree structure, possibly resembling a directory tree under __/proc/sys__,
+
and if the requested item is found calls some appropriate routine to read or modify the value.
+
!!EXAMPLE
+#include
-#include
!!RETURN VALUE
-
Upon successful completion, ___sysctl__ returns 0.
Otherwise, a value of -1 is returned and ''errno'' is set
to indicate the error.
+
!!ERRORS
-
__ENOTDIR__
-
''name'' was not found.
-
__EPERM__
-
No search permission for one of the encountered
`directories', or no read permission where ''oldval'' was
nonzero, or no write permission where ''newval'' was
nonzero.
-
__EFAULT__
-
The invocation asked for the previous value by setting
''oldval'' non-NULL, but allowed zero room in
''oldlenp''.
@@ -104,7 +99,8 @@
It is not yet possible to change operating system by writing
to ''/proc/sys/kernel/ostype''.
!!SEE ALSO
+[Sysctl | http://man-wiki.net/index.php/2:sysctl]
proc(5)
----
