.\" 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.
.\" $Id: query_module.2 1.2 Thu, 13 Apr 2000 18:17:59 +1000 kaos $
.\"
.TH QUERY_MODULE 2 "1996. december 26" "Linux 2.1.17" "Linux Modul Támogatás"
.SH NÉV
query_module \- különböző modulokra vonatkozó paramétereket kérdez a kerneltől.
.SH ÁTTEKINTÉS
.nf
.B #include <linux/module.h>
.sp
\fBint query_module(const char *\fIname\fB, int \fIwhich\fB,
void *\fIbuf\fB, size_t \fIbufsize\fB, size_t *\fIret\fB);
.fi
.SH LEÍRÁS
A
.B query_module
betölthető modulokra vonatkozó információkat kér a kerneltől.
Az információ pontos természete és formátuma a \fIwhich\fP alfunkciótól
függ. Néhány funkciónak szüksége van a \fIname\fP paraméterre, hogy
megnevezzen egy jelenleg betöltött modult, néhány másik megengedi
hogy a \fIname\fP értéke \fBNULL\fP legyen, jelezve a magát a kernelt.

.SS "A WHICH ÉRTÉKEI"
.TP
.B 0
Mindig sikerrel tér vissza. A rendszerhívás tesztelésére használható.
.TP
.B QM_MODULES
A betöltött modulok nevét adja vissza. A kimenő puffer formátuma
egymás után sorakozó nullára végződő stringek; a \fIret\fP értéke
a modulok száma.
.TP
.B QM_DEPS
Visszaadja a megadott modul által használt összes modul nevét.
A kimenő puffer formátuma egymás után sorakozó nullára végződő stringek;
a \fIret\fP értéke a modulok száma.
.TP
.B QM_REFS
Visszaadja az összes modul nevét, amelyik a megadott modult használja.
Ez a \fBQM_DEPS\fP fordítottja. A kimenő puffer formátuma egymás után
sorakozó nullára végződő stringek; a \fIret\fP értéke a modulok száma.
.TP
.B QM_SYMBOLS
Visszaadja a kernel vagy a megadott modul által exportált szimbólumok
nevét és értékét. A puffer formátuma egy ilyen struktúrákból álló tömb:
.RS
.PP
.nf
struct module_symbol
{
  unsigned long value;
  unsigned long name;
};
.fi
.PP
nullára végződő stringekkel folytatva. A \fIname\fP értéke a \fIbuf\fP
kezdetéhez képest relatív karakter offszet; a \fIret\fP értéke a
szimbólumok száma.
.RE
.TP
.B QM_INFO
Egyéb információt ad a megadott modulról. A kimenő puffer formátuma:
.RS
.PP
.nf
struct module_info
{
  unsigned long address;
  unsigned long size;
  unsigned long flags;
};
.fi
.PP
ahol a \fIaddress\fP a kernel memória cím, ahol a modul helyet foglal,
\fIsize\fP a modul mérete bájtban, és \fIflags\fP egy maszkolt érték
a következőkből: \fBMOD_RUNNING\fP, \fBMOD_AUTOCLEAN\fP, stb., ami
a modul jelenlegi állapotát jelzi. A \fIret\fP értéke a \fBmodule_info\fP
struktúra méretét adja meg.
.RE
.SH "VISSZATÉRÉSI ÉRTÉK"
Siker esetén zéró. Hiba esetén az érték \-1, és az \fIerrno\fP értéke
megfelelően lesz beállítva.
.SH HIBÁK
.TP
.B ENOENT
Nincs \fIname\fP nevű modul.
.TP
.B EINVAL
Hibás \fIwhich\fP, vagy \fIname\fP a kernelt jelenti egy olyan
alfunkciónál, ahol ez nem értelmes.
.TP
.B ENOSPC
A megadott buffer méret túl kicsi. \fIret\fP a minimálisan szükséges
méretet tartalmazza.
.TP
.B EFAULT
A \fIname\fP, \fIbuf\fP, vagy \fIret\fP közül legalább az egyik
kívül volt a program által elérhető címtartományon.
.SH "LÁSD MÉG"
.BR create_module "(2), " init_module "(2), " delete_module "(2)."
.SH MAGYAR FORDÍTÁS
Böszörményi Zoltán <zboszor@mail.externet.hu>