NÉV¶
query_module - különböző modulokra vonatkozó
paramétereket kérdez a kerneltől.
ÁTTEKINTÉS¶
#include <linux/module.h>
int query_module(const char *name, int which,
void *buf, size_t bufsize, size_t *ret);
LEÍRÁS¶
A
query_module betölthető modulokra vonatkozó
információkat kér a kerneltől. Az információ
pontos természete és formátuma a
which
alfunkciótól függ. Néhány funkciónak
szüksége van a
name paraméterre, hogy megnevezzen egy
jelenleg betöltött modult, néhány másik megengedi
hogy a
name értéke
NULL legyen, jelezve a magát a
kernelt.
A WHICH ÉRTÉKEI¶
- 0
- Mindig sikerrel tér vissza. A rendszerhívás
tesztelésére használható.
- 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 ret
értéke a modulok száma.
- 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 ret értéke a modulok száma.
- QM_REFS
- Visszaadja az összes modul nevét, amelyik a
megadott modult használja. Ez a QM_DEPS fordítottja. A
kimenő puffer formátuma egymás után sorakozó
nullára végződő stringek; a ret
értéke a modulok száma.
- 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:
struct module_symbol
{
unsigned long value;
unsigned long name;
};
nullára végződő stringekkel folytatva. A
name
értéke a
buf kezdetéhez képest relatív
karakter offszet; a
ret értéke a szimbólumok
száma.
- QM_INFO
- Egyéb információt ad a megadott
modulról. A kimenő puffer formátuma:
struct module_info
{
unsigned long address;
unsigned long size;
unsigned long flags;
};
ahol a
address a kernel memória cím, ahol a modul helyet
foglal,
size a modul mérete bájtban, és
flags egy
maszkolt érték a következőkből:
MOD_RUNNING,
MOD_AUTOCLEAN, stb., ami a modul jelenlegi állapotát jelzi. A
ret értéke a
module_info struktúra
méretét adja meg.
VISSZATÉRÉSI ÉRTÉK¶
Siker esetén zéró. Hiba esetén az érték -1,
és az
errno értéke megfelelően lesz
beállítva.
HIBÁK¶
- ENOENT
- Nincs name nevű modul.
- EINVAL
- Hibás which, vagy name a kernelt jelenti
egy olyan alfunkciónál, ahol ez nem értelmes.
- ENOSPC
- A megadott buffer méret túl kicsi. ret a
minimálisan szükséges méretet tartalmazza.
- EFAULT
- A name, buf, vagy ret közül
legalább az egyik kívül volt a program által
elérhető címtartományon.
LÁSD MÉG¶
create_module(2),
init_module(2),
delete_module(2).
MAGYAR FORDÍTÁS¶
Böszörményi Zoltán <zboszor@mail.externet.hu>