Scroll to navigation

QUERY_MODULE(2) Руководство программиста Linux QUERY_MODULE(2)

ИМЯ

query_module - запросить ядро о различных параметрах, касающихся модулей

ОБЗОР

#include <linux/module.h>

int query_module(const char *name, int which, void *buf,
                 size_t bufsize, size_t *ret);

ОПИСАНИЕ

query_module() запрашивает информацию у ядра о загружаемых модулях. Возвращаемая информация помещается в буфер, указанный в buf. Вызывающий должен указать размер buf в bufsize. Смысл и формат возвращаемой информации зависит от операции, задаваемой в which. Для некоторых операций требуется заполнить name для указания на уже загруженный модуль, для некоторых в name можно указать NULL, что указывает на получения свойства ядра.

В which можно указать следующие значения:

0
Завершается успешно, если ядро поддерживает query_module(). Используется для проверки доступности системного вызова.
Возвращает имена всех загруженных модулей. Возвращаемый буфер содержит последовательность строк, оканчивающихся null; в ret указано количество модулей.
Возвращает имена всех модулей, используемых указанным модулем. Возвращаемый буфер содержит последовательность строк, оканчивающихся null; в ret указано количество модулей.
Возвращает имена всех модулей, использующих указанный модуль. Это обратная по отношению к QM_DEPS операция. Возвращаемый буфер содержит последовательность строк, оканчивающихся null; в ret указано количество модулей.
Возвращает символы и значения, экспортируемые ядром или указанным модулем. Возвращаемый буфер содержит массив структур следующего формата:
struct module_symbol {

unsigned long value;
unsigned long name; };

завершаемого строками, оканчивающимися null. Значение name содержит смещение строки в знаках относительно начала buf; в ret указано количество символов.
Возвращает различную информацию об указанном модуле. Формат результата в буфере:
struct module_info {

unsigned long address;
unsigned long size;
unsigned long flags; };

где address — это адрес ядра, где располагается модуль, size — размер модуля в байтах, flags — маска MOD_RUNNING, MOD_AUTOCLEAN и т. д., показывающая текущее состояние модуля (смотрите файл исходного кода ядра include/linux/module.h). В ret указан размер структуры module_info.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении возвращается ноль. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.

ОШИБКИ

Одно из значений в name, buf или ret находится вне доступного программного адресного пространства.
Неправильное значение which; name равно NULL (указывающее "параметры ядра"), но оно не разрешено для указанного значения which.
Модуль с именем, указанным в name, не существует.
Указанный размер буфера слишком мал. В ret возвращается минимальный необходимый размер.
query_module() не поддерживается в этой версии ядра.

СООТВЕТСТВИЕ СТАНДАРТАМ

query_module() есть только в Linux.

ЗАМЕЧАНИЯ

Данный системный вызов есть только в Linux до версии 2.4; он был удалён в Linux 2.6. Некоторую информацию, которая была доступна через query_module(), можно получить из /proc/modules, /proc/kallsyms, и /sys/modules.

СМОТРИТЕ ТАКЖЕ

create_module(2), delete_module(2), get_kernel_syms(2), init_module(2)

2007-06-03 Linux