Linux Certif

Toute la documentation sur la certification Linux LPI

Rechercher une page de manuel

query_module

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>