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
|
.\" 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.
.\"
.\" Traduction 21/07/1997 par Christophe Blaess (ccb@club-internet.fr)
.\"
.TH QUERY_MODULE 2 "21 Juillet 1997" Linux "Manuel du programmeur Linux"
.SH NOM
query_module \- Demander au noyau des informations concernant les modules.
.SH SYNOPSIS
.nf
.B #include <linux/module.h>
.sp
\fBint query_module(const char *\fInom\fB, int \fIwhich\fB,
void *\fIbuf\fB, size_t \fItaille_buf\fB, size_t *\fIret\fB);
.fi
.SH DESCRIPTION
.B query_module
interroge le noyau pour obtenir des informations concernant les modules
chargeables. La nature prcise des informations, et leurs formats dpendent
de l'argument \fIwhich\fP, qui joue le rle de slecteur de fonction.
Certaines fonctions ncessitent le \fInom\fP d'un module effectivement
charg, certaines permettent \fInom\fP d'tre \fBNULL\fP, afin
d'obtenir les informations propres au noyau.
.SS "VALEURS POSSIBLES DE WHICH"
.TP
.B 0
Russit toujours. Permet de vrifier l'appel-systme.
.TP
.B QM_MODULES
Renvoie le nom de tous les modules chargs.
Le buffer de sortie est rempli avec des chanes de caractres
termines par des caractres nuls.
\fIret\fP contient le nombre de modules.
.TP
.B QM_DEPS
Renvoie le nom de tous les modules utiliss par le module indiqu.
Le buffer de sortie est rempli avec des chanes de caractres
termines par des caractres nuls.
\fIret\fP contient le nombre de modules.
.TP
.B QM_REFS
Renvoie le nom de tous les modules utilisant le module indiqu.
C'est la fonction inverse de \fBQM_DEPS\fP.
Le buffer de sortie est rempli avec des chanes de caractres
termines par des caractres nuls.
\fIret\fP contient le nombre de modules.
.TP
.B QM_SYMBOLS
Renvoie les symboles et les valeurs exports par le noyau, ou par
le module indiqu. Le buffer de sortie est un tableau de structures :
.RS
.PP
.nf
struct module_symbol
{
unsigned long value;
unsigned long name;
};
.fi
.PP
suivi de chanes termines par des caractres nuls.
La valeur de \fIname\fP correspond au dcalage entre le nom du symbole
et le dbut du buffer \fIbuf\fP.
\fIret\fP contient le nombre de symboles.
.RE
.TP
.B QM_INFO
Renvoie des informations diverses concernant le module indiqu. Le buffer
de sortie est une structure :
.RS
.PP
.nf
struct module_info
{
unsigned long address;
unsigned long size;
unsigned long flags;
};
.fi
.PP
ou \fIaddress\fP correspond l'adresse laquelle le module rside dans
le noyau, \fIsize\fP est la taille, en octets, du module, et \fIflags\fP
est un masque de \fBMOD_RUNNING\fP, \fBMOD_AUTOCLEAN\fP, etc. qui
indiquent l'tat actuel du module.
\fIret\fP correspond la taille de la structure \fBmodule_info\fP.
.RE
.SH "VALEUR RENVOYE"
.B query_modules
renvoie zro s'il russit, ou \-1 s'il choue, auquel cas
\fIerrno\fP contient le code d'erreur.
.SH ERREURS
.TP
.B ENOENT
Il n'y a pas de module de ce \fInom\fP.
.TP
.B EINVAL
La valeur de \fIwhich\fP est invalide, ou le \fInom\fP est NULL et
la sous-fonction n'est pas approprie pour le noyau.
.TP
.B ENOSPC
Le buffer fourni est trop petit. \fIret\fP contient la taille minimum
ncessaire.
.TP
.B EFAULT
\fInom\fP, \fIbuf\fP, ou \fIret\fP pointe en dehors de l'espace d'adressage
accessible.
.SH "VOIR AUSSI"
.BR create_module "(2), " init_module "(2), " delete_module "(2).
.SH TRADUCTION
Christophe Blaess, 1997.
|
