1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
.\" Copyright (C) 1996 Andries Brouwer (aeb@cwi.nl)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Written 11 April 1996 by Andries Brouwer <aeb@cwi.nl>
.\" 960412: Added comments from Stephen Tweedie
.\" Modified Tue Oct 22 22:28:41 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Translated into Spanish Wed Feb 18 17:01:53 CET 1998 by Gerardo
.\" Aburruzaga Garca <gerardo.aburruzaga@uca.es>
.\"
.TH SYSCTL 2 "18 Febrero 1998" "Linux 1.3.85" "Manual del Programador Linux"
.SH NOMBRE
sysctl \- lee/escribe parmetros del sistema
.SH SINOPSIS
.B #include <unistd.h>
.sp
.B #include <linux/unistd.h>
.sp
.B #include <linux/sysctl.h>
.sp
.B _syscall1(int, _sysctl, struct __sysctl_args *, args);
.sp
.BI "int _sysctl(struct __sysctl_args *" args );
.SH DESCRIPCIN
La llamada
.B _sysctl
lee o escribe parmetros del kernel. Por ejemplo, el nombre del
computador, o el nmero mximo de ficheros abiertos. El argumento
tiene la forma
.PP
.nf
struct __sysctl_args {
int *name; /* vector describiendo la variable */
int nlen; /* longitud de este vector */
void *oldval; /* 0 dir. donde guardar valor antiguo */
size_t *oldlenp; /* sitio disponible para el valor antiguo,
sobrescrito por el tamao real de dicho valor */
void *newval; /* 0 direccin del nuevo valor */
size_t newlen; /* tamao del nuevo valor */
};
.fi
.PP
Esta llamada efecta una bsqueda en una estructura de rbol,
posiblemente parecido a un rbol de directorios bajo
.BR /proc/sys ,
y si lo pedido se encuentra, llama a alguna rutina apropiada para leer
o modificar el valor.
.SH "EJEMPLO"
.nf
#include <linux/unistd.h>
#include <linux/types.h>
#include <linux/sysctl.h>
_syscall1(int, _sysctl, struct __sysctl_args *, args);
int sysctl(int *name, int nlen, void *oldval, size_t *oldlenp,
void *newval, size_t newlen)
{
struct __sysctl_args args={name,nlen,oldval,oldlenp,newval,newlen};
return _sysctl(&args);
}
#define SIZE(x) sizeof(x)/sizeof(x[0])
#define OSNAMESZ 100
char osname[OSNAMESZ];
int osnamelth;
int name[] = { CTL_KERN, KERN_OSTYPE };
main(){
osnamelth = SIZE(osname);
if (sysctl(name, SIZE(name), osname, &osnamelth, 0, 0))
perror("sysctl");
else
printf("Esta mquina ejecuta %*s\en", osnamelth, osname);
return 0;
}
.fi
.SH "VALORES DEVUELTOS"
Tras una terminacin exitosa,
.B _sysctl
devuelve 0. En otro caso, se devuelve el valor \-1 y se pone en
.I errno
un valor que indica el error.
.SH ERRORES
.TP
.B ENOTDIR
.I name
no se ha encontrado.
.TP
.B EPERM
No haba permiso de paso para uno de los `directorios' encontrados, o
no haba permiso de lectura donde
.I oldval
era no-cero, o no haba permiso de escritura donde
.I newval
era no-cero.
.TP
.B EFAULT
La llamada pidi el valor anterior poniendo
.I oldval
como no NULL, pero se permiti un espacio cero en
.IR oldlenp .
.SH "CONFORME CON"
Esta llamada es especfica de Linux, y no debera emplearse en
programas pretendidamente transportables.
Una llamada
.B sysctl
ha estado presente en Linux desde la versin 1.3.57. Se origin en
4.4BSD. Slo Linux tiene el espejo
.IR /proc/sys ,
y los esquemas de nomenclatura de objetos difieren entre Linux y BSD
4.4, pero la declaracin de la funcin
.BR sysctl (2)
es la misma en ambos.
.SH BUGS
No todos los objetos disponibles estn correctamente documentados.
.br
An no es posible cambiar el sistema operativo escribiendo en
.IR /proc/sys/kernel/ostype .
:-)
.SH "VASE TAMBIN"
.BR proc (5).
|
