Главная » 2017 » Ноябрь » 21 » man 2 query_module
01:27
man 2 query_module

SEO sprint - Всё для максимальной раскрутки!





ИМЯ


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



ОБЗОР


#include <linux/module.h>

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

Замечание: В заголовочных файлах glibc этой системный вызов отсутствует; смотрите
ЗАМЕЧАНИЯ.



ОПИСАНИЕ


Замечание: Данный системный вызов доступен только в ядрах до Linux 2.6.

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

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

0 Завершается успешно, если ядро поддерживает query_module(). Используется
для проверки доступности системного вызова.

QM_MODULES
Возвращает имена всех загруженных модулей. Возвращаемый буфер содержит
последовательность строк, оканчивающихся null; в ret указано количество
модулей.

QM_DEPS
Возвращает имена всех модулей, используемых указанным модулем. Возвращаемый
буфер содержит последовательность строк, оканчивающихся null; в ret указано
количество модулей.

QM_REFS
Возвращает имена всех модулей, использующих указанный модуль. Это обратная
по отношению к QM_DEPS операция. Возвращаемый буфер содержит
последовательность строк, оканчивающихся null; в ret указано количество
модулей.

QM_SYMBOLS
Возвращает символы и значения, экспортируемые ядром или указанным модулем.
Возвращаемый буфер содержит массив структур следующего формата:

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

завершаемого строками, оканчивающимися null. Значение name содержит
смещение строки в знаках относительно начала buf; в ret указано количество
символов.

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



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


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



ОШИБКИ


EFAULT Одно из значений в name, buf или ret находится вне доступного программного
адресного пространства.

EINVAL Неправильное значение which; name равно NULL (указывающее "параметры
ядра"), но оно не разрешено для указанного значения which.

ENOENT Модуль с именем, указанным в name, не существует.

ENOSPC Указанный размер буфера слишком мал. В ret возвращается минимальный
необходимый размер.

ENOSYS query_module() не поддерживается в этой версии ядра (например, в 2.6 или
более поздних).



ВЕРСИИ


Данный системный вызов есть только в Linux до версии 2.4; он был удалён в Linux
2.6.



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


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



ЗАМЕЧАНИЯ


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

Системный вызов query_module() не поддерживается glibc. В заголовочных файлах
glibc он не объявлен, но в недавнем прошлом glibc экспортировал ABI для этого
системного вызова. Поэтому чтобы получить данный системный вызов достаточно
вручную объявить интерфейс в своём коде; или же вы можете вызвать его через
syscall(2).



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


create_module(2), delete_module(2), get_kernel_syms(2), init_module(2), lsmod(8),
modinfo(8)



Категория: (2) Системные вызовы ядра (функции языка Си) | Просмотров: 360 | Добавил: Администратор | Рейтинг: 0.0/0
Всего комментариев: 0
avatar