NOMBRE

       query_module - interroga al núcleo sobre varias cosas relacionadas con los módulos

SINOPSIS

       #include <linux/module.h>

       int query_module(const char *nombre, int que,
       void *buf, size_t tambuf, size_t *ret);

DESCRIPCIÓN

       query_module  pide  información  al  núcleo  relativa  a  módulos cargables. La naturaleza
       precisa de la información y su formato depende de la  subfunción  que.  Algunas  funciones
       requieren que nombre se refiera a un módulo cargado actualmente, otras permiten que nombre
       sea NULL, indicando el propio núcleo.

   VALORES DE `QUE'
       0      Siempre devuelve `éxito'. Se emplea para probar la llamada al sistema.

       QM_MODULES
              Devuelve los nombres de todos los módulos cargados. El formato del búfer de  salida
              consiste  en  cadenas de caracteres adyacentes terminadas en cero; ret contendrá el
              número de módulos.

       QM_DEPS
              Devuelve los nombres de todos los módulos utilizados por  el  módulo  indicado.  El
              formato del búfer de salida consiste en cadenas de caracteres adyacentes terminadas
              en cero; ret contendrá el número de módulos.

       QM_REFS
              Devuelve los nombres de todos los módulos que utilizan  al  indicado.  Esto  es  lo
              inverso  de  QM_DEPS.   El  formato  del  búfer  de  salida  consiste en cadenas de
              caracteres adyacentes terminadas en cero; ret contendrá el número de módulos.

       QM_SYMBOLS
              Devuelve los símbolos y valores exportados por el núcleo o el módulo  indicado.  El
              formato del búfer consiste en un vector de:

              struct module_symbol
              {
                unsigned long value;
                unsigned long name;
              };

              seguido  por  cadenas  de  caracteres  terminadas en cero. El valor de nombre es el
              desplazamiento de la cadena relativo al comienzo de buf; ret contendrá el número de
              símbolos.

       QM_INFO
              Devuelve  información  variada  sobre  el  módulo indicado. El formato del búfer de
              salida es:

              struct module_info
              {
                unsigned long address;
                unsigned long size;
                unsigned long flags;
              };

              donde address es la dirección del núcleo en la que reside el  módulo,  size  es  el
              tamaño  del  modulo en bytes, y flags es una máscara de MOD_RUNNING, MOD_AUTOCLEAN,
              etcétera, que indica el estado actual del módulo. ret contendrá  el  tamaño  de  la
              struct module_info.

VALOR DEVUELTO

       En  caso  de  éxito, se devuelve cero. En caso de error, se devuelve -1 y se pone un valor
       apropiado en errno.

ERRORES

       ENOENT No existe ningún módulo con ese nombre.

       EINVAL Inválido que, o nombre le indica al núcleo una subfunción inapropiada.

       ENOSPC El tamaño del búfer proporcionado era demasiado pequeño. ret  contendrá  el  mínimo
              tamaño que se necesita.

       EFAULT Al  menos  uno  de  nombre,  buf  o  ret  estaban afuera del espacio de direcciones
              accesible al programa.

VÉASE TAMBIÉN

       create_module(2), init_module(2), delete_module(2).