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
|
.\" Copyright (C) 1996 Free Software Foundation, Inc.
.\" This file is distributed accroding to the GNU General Public License.
.\" See the file COPYING in the top level source directory for details.
.\" Translated into Spanish Wed Feb 18 16:35:53 CET 1998 by Gerardo
.\" Aburruzaga Garca <gerardo.aburruzaga@uca.es>
.\"
.TH QUERY_MODULE 2 "26 Dic 1996" "Linux 2.1.17" "Soporte de Mdulos de Linux"
.SH NOMBRE
query_module \- interroga al kernel sobre varias cosas relacionadas
con los mdulos
.SH SINOPSIS
.nf
.B #include <linux/module.h>
.sp
\fBint query_module(const char *\fInombre\fB, int \fIque\fB,
void *\fIbuf\fB, size_t \fItambuf\fB, size_t *\fIret\fB);
.fi
.SH DESCRIPCIN
.B query_module
pide informacin al kernel relativa a mdulos cargables. La naturaleza
precisa de la informacin y su formato depende de la subfuncin
\fIque\fP. Algunas funciones requieren que \fInombre\fP se refiera a
un mdulo cargado actualmente, otras permiten que \fInombre\fP sea
\fBNULL\fP, indicando el propio kernel.
.SS "VALORES DE `QUE'"
.TP
.B 0
Siempre devuelve `xito'. Se emplea para probar la llamada al sistema.
.TP
.B QM_MODULES
Devuelve los nombres de todos los mdulos cargados. El formato del
bfer de salida consiste en cadenas de caracteres adyacentes
terminadas en cero; \fIret\fP contendr el nmero de mdulos.
.TP
.B QM_DEPS
Devuelve los nombres de todos los mdulos utilizados por el mdulo
indicado. El formato del bfer de salida consiste en cadenas de
caracteres adyacentes terminadas en cero; \fIret\fP contendr el
nmero de mdulos.
.TP
.B QM_REFS
Devuelve los nombres de todos los mdulos que utilizan al
indicado. Esto es lo inverso de \fBQM_DEPS\fP.
El formato del bfer de salida consiste en cadenas de
caracteres adyacentes terminadas en cero; \fIret\fP contendr el
nmero de mdulos.
.TP
.B QM_SYMBOLS
Devuelve los smbolos y valores exportados por el kernel o el mdulo
indicado. El formato del bfer consiste en un vector de:
.RS
.PP
.nf
struct module_symbol
{
unsigned long value;
unsigned long name;
};
.fi
.PP
seguido por cadenas de caracteres terminadas en cero. El valor de
\fInombre\fP es el desplazamiento de la cadena relativo al comienzo de
\fIbuf\fP; \fIret\fP contendr el nmero de smbolos.
.RE
.TP
.B QM_INFO
Devuelve informacin variada sobre el mdulo indicado. El formato del
bfer de salida es:
.RS
.PP
.nf
struct module_info
{
unsigned long address;
unsigned long size;
unsigned long flags;
};
.fi
.PP
donde \fIaddress\fP es la direccin del kernel en la que reside el mdulo,
\fIsize\fP es el tamao del modulo en bytes, y \fIflags\fP es
una mscara de \fBMOD_RUNNING\fP, \fBMOD_AUTOCLEAN\fP, etctera, que
indica el estado actual del mdulo. \fIret\fP contendr el tamao de la
struct \fBmodule_info\fP.
.RE
.SH "VALOR DEVUELTO"
En caso de xito, se devuelve cero. En caso de error, se devuelve \-1
y se pone un valor apropiado en \fIerrno\fP.
.SH ERRORES
.TP
.B ENOENT
No existe ningn mdulo con ese \fInombre\fP.
.TP
.B EINVAL
Invlido \fIque\fP, o \fInombre\fP le indica al kernel una subfuncin
inapropiada.
.TP
.B ENOSPC
El tamao del bfer proporcionado era demasiado pequeo. \fIret\fP
contendr el mnimo tamao que se necesita.
.TP
.B EFAULT
Al menos uno de \fInombre\fP, \fIbuf\fP o \fIret\fP estaban afuera del
espacio de direcciones accesible al programa.
.SH "VASE TAMBIN"
.BR create_module "(2), " init_module "(2), " delete_module "(2).
|
