ИМЯ

delete_module - выгружает модуль ядра

ОБЗОР

int delete_module(const char *name, int flags);

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

ОПИСАНИЕ

Вызов delete_module() пытается удалить неиспользуемый загруженный модуль с именем name. Если у модуля есть функция exit, то она выполняется перед выгрузкой. Аргумент flags используется для изменения поведения системного вызова — это описано далее. Данный системный вызов требует особых прав.

Удаление модуля выполняется по следующим правилам:

1.: Если какой-то другой модуль зависит от выгружаемого (т.е., использует его символы), то вызов завершается с ошибкой.
2.: В противном случае, если счётчик ссылок на модуль (т.е. количество процессов, использующих модуль в данный момент) равно нулю, то модуль немедленно выгружается.
3.: Если у модуля ненулевой счётчик ссылок, то поведение зависит от битов, установленных в flags. Обычно (смотрите ЗАМЕЧАНИЯ) всегда указывается флаг O_NONBLOCK, а иногда добавляется O_TRUNC.
: Различные комбинации значений в flags дают разный эффект:

flags == O_NONBLOCK: Вызов сразу завершается с ошибкой.
flags == (O_NONBLOCK | O_TRUNC): Модуль немедленно выгружается, независимо от того, равен счётчик ссылок 0 или нет.
(flags & O_NONBLOCK) == 0: Если в flags не указан O_NONBLOCK, то выполняются следующие шаги:

Модуль помечается, что больше ссылаться на него запрещается.
Если счётчик ссылок модуля не равен нулю, то вызывающий переходит в непрерываемое состояние сна (TASK_UNINTERRUPTIBLE) до тех пор, пока счётчик ссылок не станет равным 0 — в этот момент вызов разблокируется.
Модуль выгружается как обычно.

Флаг O_TRUNC имеет ещё один эффект на правила, описанные выше. По умолчанию, если модуль имеет функцию init, но не имеет функции exit, то попытка удаления модуля завершается с ошибкой. Однако, если указан O_TRUNC, то это требование не учитывается.

Использовать флаг O_TRUNC опасно! Если ядро не собрано с параметром CONFIG_MODULE_FORCE_UNLOAD, то этот флаг просто игнорируется (обычно параметр CONFIG_MODULE_FORCE_UNLOAD включают). Использование этого флага приводит к примешиванию (taints) в ядре (TAINT_FORCED_RMMOD).

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

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

ОШИБКИ

EBUSY: Модуль не «живой» (т.е., он всё ещё инициализируется или уже помечен для удаления); или модуль имеет функцию init, но не имеет функции exit и в flags не указан флаг O_TRUNC.
EFAULT: Значение name указывает на расположение вне доступного адресного пространства процесса.
ENOENT: Модуль с таким именем не существует.
EPERM: Вызывающий не имеет прав (не имеет мандата CAP_SYS_MODULE), или отключена выгрузка модулей (смотрите /proc/sys/kernel/modules_disabled в proc(5)).
EWOULDBLOCK: Другие модули зависят от этого модуля; или в flags указан флаг O_NONBLOCK, но счётчик ссылок модуля не равен 0 и в flags не указан флаг O_TRUNC.

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

Вызов delete_module() есть только в Linux.

ЗАМЕЧАНИЯ

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

Непрерываемый сон, который может начаться, если в flags не указан флаг O_NONBLOCK, считается нежелательным, так как спящий процесс находится в неубиваемом состоянии. В Linux 3.7 указание O_NONBLOCK необязательно, но в будущих ядрах, он, вероятно, станет обязательным.

Linux версии 2.4 и более ранние

В Linux версии 2.4 и более ранних системный вызов принимал один аргумент:

int delete_module(const char *name);

Если значение name равно NULL, то все неиспользуемые модули, помеченные для автоматической вычистки, удаляются.

Есть и некоторые другие отличия в поведении delete_module() в Linux 2.4 и более ранних, но они пока не описаны в этой справочной странице.

ИМЯ