NAZWA

delete_module - usuwa (odłącza) moduł jądra

BIBLIOTEKA

Standardowa biblioteka C (libc, -lc)

SKŁADNIA

#include <fcntl.h>            /* Definicja stałych O_* */
#include <sys/syscall.h>      /* Definicja stałych SYS_* */
#include <unistd.h>

int syscall(SYS_delete_module, const char *name, unsigned int flags);

Uwaga: glibc nie udostępnia opakowania dla delete_module(), co wymusza użycie syscall(2).

OPIS

Wywołanie systemowe delete_module() próbuje usunąć nieużywany, ładowalny wpis modułu określony nazwą name. Jeśli moduł posiada funkcję exit, to jest ona wykonywana przed usunięciem modułu. Argument flags służy do modyfikacji zachowania wywołania systemowego, zgodnie z opisem poniżej. To wywołanie systemowe wymaga uprzywilejowania.

Próba usunięcia modułu zachodzi zgodnie z poniższymi regułami:

(1)

Jeśli występują inne załadowane moduły zależące od tego modułu (tzn. odniesienia do symboli w nim zdefiniowanych), to wywołanie zawodzi.

(2)

W przeciwnym razie, jeśli licznik odniesień do modułu (tzn. liczba procesów używających go aktualnie) wynosi zero, to moduł jest natychmiast usuwany.

(3)

Jeśli moduł ma niezerowy licznik odniesień, to zachowanie zależy od bitów ustawionych w flags. Przy zwykłym użyciu (zob. UWAGI), podany jest zawsze znacznik O_NONBLOCK, dodatkowo można też podać znacznik O_TRUNC.

Różne zestawienia flags dają następujący rezultat:

Znacznik O_TRUNC ma jeden dodatkowy skutek wobec powyższych reguł. Domyślnie, jeśli moduł ma funkcję init, lecz nie posiada funkcji exit, to próba usunięcia modułu zawodzi. Jeśli jednak podano O_TRUNC to ten warunek jest pomijany.

Używanie znacznika O_TRUNC jest niebezpieczne! Jeśli jądro nie zostało zbudowane z CONFIG_MODULE_FORCE_UNLOAD, znacznik jest po cichu ignorowany (zwykle CONFIG_MODULE_FORCE_UNLOAD jest włączony). Używanie tego znacznika prowadzi do skażenia jądra (TAINT_FORCED_RMMOD).

WARTOŚĆ ZWRACANA

Po pomyślnym zakończeniu zwracane jest zero. Po błędzie zwracane jest -1 i ustawiane jest errno wskazując błąd.

BŁĘDY

EBUSY

Moduł nie jest „żywy” (tzn. wciąż jest inicjowany lub został już oznaczony do usunięcia) lub moduł posiada funkcję init, ale nie ma funkcji exit a we flags nie podano O_TRUNC.

EFAULT

name odnosi się do położenia, które jest poza dostępną dla procesu przestrzenią adresową.

ENOENT

Nie istnieje moduł o tej nazwie.

EPERM

Wywołujący nie był uprzywilejowany (nie posiadał przywileju (ang. capability) CAP_SYS_MODULE) lub usuwanie modułów jest wyłączone (zob. /proc/sys/kernel/modules_disabled w proc(5)).

EWOULDBLOCK

Od tego modułu zależą inne moduły; albo we flags podano O_NONBLOCK, lecz licznik odniesień tego modułu jest niezerowy i we flags nie podano O_TRUNC.

STANDARDY

Linux.

HISTORIA

Wywołanie systemowe delete_module() nie jest obsługiwane przez glibc. W nagłówkach glibc nie ma jego deklaracji, ale z powodów pewnych zaszłości historycznych wersje przed glibc 2.23 eksportowały ABI dla tego wywołania systemowego. Z tego powodu, aby go użyć wystarczy (przed glibc 2.23) manualnie zadeklarować interfejs w swoim kodzie; alternatywnie można wywołać to wywołanie systemowe za pomocą syscall(2).

UWAGI

Nieprzerywalny stan snu, który może się zdarzyć, gdy pominie się O_NONBLOCK z flags jest uważany za niepożądany, ponieważ śpiący proces pozostawiany jest w stanie nieśmiertelności. Według stanu na Linux 3.7, podawanie O_NONBLOCK jest opcjonalne, ale w przyszłych jądrach prawdopodobnie stanie się to obowiązkowe.

ZOBACZ TAKŻE

create_module(2), init_module(2), query_module(2), lsmod(8), modprobe(8), rmmod(8)

TŁUMACZENIE

Tłumaczenie niniejszej strony podręcznika: Przemek Borys <pborys@dione.ids.pl> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.