Ubuntu Manpage: modprobe - dodaje i usuwa moduły z jądra Linux

NAZWA

       modprobe - dodaje i usuwa moduły z jądra Linux

SKŁADNIA


       modprobe [-v] [-V] [-C plik-konfiguracyjny] [-n] [-i] [-q] [-b] [nazwa-modułu] [moduł parametry...]

       modprobe [-r] [-v] [-n] [-i] [nazwa-modułu...]

       modprobe [-c]

       modprobe [--dump-modversions] [nazwa-pliku]

OPIS

modprobe dodaje i usuwa moduły z jądra Linux w sposób inteligentny: proszę zauważyć, że dla wygody nie
rozróżnia się _ i - w nazwach modułów (przeprowadzana jest automatyczna konwersja znaków podkreślenia).
modprobe szuka wszystkich modułów i innych plików w katalogu modułów /lib/modules/`uname -r`. Wyjątkami
są opcjonalne pliki konfiguracyjne w katalogu /etc/modprobe.d (patrz modprobe.conf(5)). modprobe użyje
również opcji modułu podanych w wierszu polecenia jądra w postaci <moduł>.<opcja> i czarnych list w
postaci modprobe.blacklist=<moduł>.

Proszę zauważyć, że w przeciwieństwie do jąder Linux z gałęzi 2.4 (które nie są obsługiwane przez to
narzędzie) ta wersja modprobe nic nie wykonuje na samych modułach: interpretowanie symboli i obsługa
parametrów jest wykonywana wewnątrz jądra. W związku z tym, błędom modułów towarzyszą niekiedy komunikaty
jądra: patrz dmesg(8).

modprobe oczekuje obecności zaktualizowanego pliku modules.dep.bin utworzonego przez powiązane narzędzie
depmod, dystrybuowane razem z modprobe (patrz depmod(8)). Dla każdego modułu plik ten posiada spis innych
modułów jakich (jeśli jest taka potrzeba) wymaga dany moduł, a modprobe używa jej do automatycznego
dodawania lub usuwania tych zależności.

Jeśli po nazwie-modułu podano argumenty, są one przekazywane jądru (oprócz ewentualnych opcji
umieszczonych w pliku konfiguracyjnym).

When loading modules, modulename can also be a path to the module. If the path is relative, it must
explicitly start with "./". Note that this may fail when using a path to a module with dependencies not
matching the installed depmod database.

OPCJE

-a, --all
Ładuje wszystkie moduły podane w wierszu polecenia.

-b, --use-blacklist
Opcja powoduje zastosowanie przez modprobe poleceń blacklist z plików konfiguracyjnych (jeśli
występują) także do nazw modułów. Jest ona używana z reguły przez udev(7).

-C, --config
Opcja przesłania domyślny katalog konfiguracyjny (/etc/modprobe.d).

Poprzez opcje install i remove, opcja jest podawana innym poleceniom modprobe w zmiennej
środowiskowej MODPROBE_OPTIONS.

-c, --showconfig
Zrzuca efektywną konfigurację z katalogu konfiguracyjnego i wychodzi.

--dump-modversions
Wypisuje listę informacji o wersjach modułów wymaganych przez moduł. Opcja jest używana przeważnie
przez dystrybucje, aby spakietować moduł jądra Linux, używając zależności uwzględniających wersje
modułu.

-d, --dirname
Główny katalog dla modułów, domyślnie "/".

--first-time
modprobe zwykle kończy pracę pomyślnie (nic nie robiąc) jeśli poleci się mu załadować moduł, który
jest już obecny lub usunąć moduł, który nie jest obecny. To dobre rozwiązanie do prostych skryptów,
jednak bardziej skomplikowane chcą się często dowiedzieć, czy modprobe tak naprawdę coś zrobił: ta
opcja powoduje, że modprobe kończy pracę z niepowodzeniem, jeśli program faktycznie nic nie wykonuje.

--force-vermagic
Każdy moduł zawiera niewielki łańcuch z ważnymi informacjami obejmującymi np. wersje jądra i
kompilatora. Jeśli nie uda się załadować modułu, a jądro poinformuje że "version magic" nie pasuje,
można użyć tej opcji do usunięcia go. Oczywiście to sprawdzenie odbywa się dla ochrony użytkownika,
więc użycie niniejszej opcji jest niebezpieczne, chyba że jest się pewnym tego, co się robi.

Opcja odnosi się do wszystkich załadowanych modułów: zarówno modułu (lub aliasu) z wiersza polecenia,
jak i do modułów od których jest on zależny.

--force-modversion
Jeśli moduły są skompilowane z ustawieniem CONFIG_MODVERSIONS, tworzona jest sekcja nt. szczegółów
wersji każdego modułu użytego przez (lub udostępnianego) przez dany moduł. Jeśli nie powiedzie się
załadowanie modułu, a jądro poinformuje że nie zgadza się wersja któregoś z modułu będącego
interfejsem, można użyć "--force-modversion" aby usunąć również informację o wersji. Oczywiście to
sprawdzenie odbywa się dla ochrony użytkownika, więc użycie niniejszej opcji jest niebezpieczne,
chyba że jest się pewnym tego, co się robi.

Opcja odnosi się do wszystkich załadowanych modułów: zarówno modułu (lub aliasu) z wiersza polecenia,
jak i do modułów od których jest on zależny.

-f, --force
Próbuje wyciąć z modułu wszystkie informacje o wersji, które mogą spowodować jego niepomyślne
załadowanie: jest to odpowiednik użycia obu opcji --force-vermagic i --force-modversion. Oczywiście
to sprawdzenie odbywa się dla ochrony użytkownika, więc użycie niniejszej opcji jest niebezpieczne,
chyba że jest się pewnym tego, co się robi.

Opcja odnosi się do wszystkich załadowanych modułów: zarówno modułu (lub aliasu) z wiersza polecenia,
jak i do modułów od których jest on zależny.

-i, --ignore-install, --ignore-remove
Opcja powoduje ignorowanie przez modprobe poleceń install i remove w pliku konfiguracyjnym (jeśli
istnieje), do modułu podanego w wierszu polecenia (wszystkie zależne moduły będą wciąż miały
ustawiane polecenia je dotyczące z pliku konfiguracyjnego). Oba polecenia install i remove będą
obecnie ignorowane gdy użyta jest ta opcja, niezależnie czy żądanie dotyczyło tylko jednego (a nie
obu) z --ignore-install i --ignore-remove. Patrz modprobe.d(5).

-n, --dry-run, --show
Opcja wykonuje wszystko poza rzeczywistym załadowaniem lub usunięciem modułu (lub wykonaniu poleceń
install lub remove). W połączeniu z -v jest przydatna do debugowania problemów. Z powodów
historycznych zarówno --dry-run i --show oznaczają to samo i mogą być stosowane wymiennie.

-q, --quiet
Z tą opcją modprobe nie będzie wypisywało informacji o błędzie, gdy będzie się próbowało załadować
moduł, którego nie można znaleźć (i nie jest aliasem lub poleceniem install/remove). Program będzie
mógł wciąż zwracać niezerowy kod zakończenia. Jądro używa tej opcji do wypróbowania modułów, które
mogą potencjalnie istnieć, przy użyciu request_module.

-R, --resolve-alias
Wypisuje wszystkie nazwy modułów pasujące do aliasu. Może być przydatne do debugowania problemów z
aliasem modułu.

-r, --remove
Opcja powoduje usunięcie modułu przez modprobe, zamiast załadowania go. Jeśli moduły, od których on
zależy są również nieużywane, modprobe także spróbuje je usunąć. W przeciwieństwie do ładowania
modułów, można podać kilka modułów w wierszu polecenia (nie ma sensu podawać parametrów modułu
podczas usuwania go).

Z reguły nie ma powodu aby usuwać moduły, ale część błędnych modułów może tego wymagać. Jądro
dystrybucyjne może w ogóle nie być zbudowane z obsługą usuwania modułów.

-w, --wait=TIMEOUT_MSEC
This option causes modprobe -r to continue trying to remove a module if it fails due to the module
being busy, i.e. its refcount is not 0 at the time the call is made. Modprobe tries to remove the
module with an incremental sleep time between each tentative up until the maximum wait time in
milliseconds passed in this option.

-S, --set-version
Ustawia wersję jądra, zamiast używania uname(2) do decydowania o niej (decyduje o miejscu szukania
modułów).

--show-depends
Wypisuje zależności modułu (lub aliasu) włącznie z samym modułem. Wynikiem jest (być może pusty)
zestaw nazw plików modułów, po jednym w wierszu, zaczynających się "insmod", który jest z reguły
używany przez dystrybucje do określenia które moduły włączyć do generowanych obrazów
initrd/initramfs. Stosowane polecenie install jest poprzedzone przez "install". Opcja nie wykonuje
żadnego z poleceń instalacji. Proszę zauważyć, że modinfo(8) może zostać użyte do pozyskania
zależności modułu z samego modułu, ale nie wie nic o aliasach ani poleceniach instalacji.

-s, --syslog
Opcja powoduje, że wszystkie komunikaty o błędach przesyłane są przez mechanizm syslog (jak
LOG_DAEMON z poziomem LOG_NOTICE), zamiast na standardowe wyjście błędów. Włącza się również
automatycznie, gdy stderr jest niedostępne.

Poprzez opcje install i remove, opcja jest podawana innym poleceniom modprobe w zmiennej
środowiskowej MODPROBE_OPTIONS.

-V, --version
Wyświetla informacje o wersji i kończy działanie.

-v, --verbose
Wypisuje informacje o czynnościach wykonywanych przez program. modprobe wypisuje zwykle komunikaty
jedynie, gdy występują jakieś problemy.

Poprzez opcje install i remove, opcja jest podawana innym poleceniom modprobe w zmiennej
środowiskowej MODPROBE_OPTIONS.

ŚRODOWISKO

       Do przekazania argumentów do modprobe można użyć również zmiennej środowiskowej MODPROBE_OPTIONS.

PRAWA AUTORSKIE

       Pierwotnie: Copyright 2002, Rusty Russell, IBM Corporation. Strona podręcznika jest obecnie zarządzana
       przez Jona Mastersa i innych.

ZOBACZ TAKŻE

       modprobe.d(5), insmod(8), rmmod(8), lsmod(8), modinfo(8) depmod(8)

AUTORZY

       Jon Masters <jcm@jonmasters.org>
           Deweloper

       Robby Workman <rworkman@slackware.com>
           Deweloper

       Lucas De Marchi <lucas.de.marchi@gmail.com>
           Deweloper

TŁUMACZENIE

       Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz
       <ankry@green.mf.pg.gda.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.

kmod                                              22.09.2023 r.                                      MODPROBE(8)