MODPROBE(8) modprobe MODPROBE(8) NAZWA modprobe - dodaje i usuwa moduly z jadra Linux SKLADNIA modprobe [-v] [-V] [-C plik-konfiguracyjny] [-n] [-i] [-q] [-b] [nazwa-modulu] [modul parametry...] modprobe [-r] [-v] [-n] [-i] [nazwa-modulu...] modprobe [-c] modprobe [--dump-modversions] [nazwa-pliku] OPIS modprobe dodaje i usuwa moduly z jadra Linux w sposob inteligentny: prosze zauwazyc, ze dla wygody nie rozroznia sie _ i - w nazwach modulow (przeprowadzana jest automatyczna konwersja znakow podkreslenia). modprobe szuka wszystkich modulow i innych plikow w katalogu modulow /lib/modules/`uname -r`. Wyjatkami sa opcjonalne pliki konfiguracyjne w katalogu /etc/modprobe.d (patrz modprobe.conf(5)). modprobe uzyje rowniez opcji modulu podanych w wierszu polecenia jadra w postaci . i czarnych list w postaci modprobe.blacklist=. Prosze zauwazyc, ze w przeciwienstwie do jader Linux z galezi 2.4 (ktore nie sa obslugiwane przez to narzedzie) ta wersja modprobe nic nie wykonuje na samych modulach: interpretowanie symboli i obsluga parametrow jest wykonywana wewnatrz jadra. W zwiazku z tym, bledom modulow towarzysza niekiedy komunikaty jadra: patrz dmesg(8). modprobe oczekuje obecnosci zaktualizowanego pliku modules.dep.bin utworzonego przez powiazane narzedzie depmod, dystrybuowane razem z modprobe (patrz depmod(8)). Dla kazdego modulu plik ten posiada spis innych modulow jakich (jesli jest taka potrzeba) wymaga dany modul, a modprobe uzywa jej do automatycznego dodawania lub usuwania tych zaleznosci. Jesli po nazwie-modulu podano argumenty, sa one przekazywane jadru (oprocz ewentualnych opcji umieszczonych w pliku konfiguracyjnym). Przy ladowaniu modulow, nazwa-modulu moze byc rowniez sciezka do modulu. Jesli sciezka jest wzgledna, musi sie zaczynac od "./". Prosze zauwazyc, ze ten sposob moze nie zadzialac, gdy sciezka prowadzi do modulu z zaleznosciami niewystepujacymi w zainstalowanej bazie danych depmod. OPCJE -a, --all Laduje wszystkie moduly podane w wierszu polecenia. -b, --use-blacklist Opcja powoduje zastosowanie przez modprobe polecen blacklist z plikow konfiguracyjnych (jesli wystepuja) takze do nazw modulow. Jest ona uzywana z reguly przez udev(7). -C, --config Opcja przeslania domyslny katalog konfiguracyjny (/etc/modprobe.d). Poprzez opcje install i remove, opcja jest podawana innym poleceniom modprobe w zmiennej srodowiskowej MODPROBE_OPTIONS. -c, --showconfig Zrzuca efektywna konfiguracje z katalogu konfiguracyjnego i wychodzi. --dump-modversions Wypisuje liste informacji o wersjach modulow wymaganych przez modul. Opcja jest uzywana przewaznie przez dystrybucje, aby spakietowac modul jadra Linux, uzywajac zaleznosci uwzgledniajacych wersje modulu. -d, --dirname Glowny katalog dla modulow, domyslnie "/". --first-time modprobe zwykle konczy prace pomyslnie (nic nie robiac) jesli poleci sie mu zaladowac modul, ktory jest juz obecny lub usunac modul, ktory nie jest obecny. To dobre rozwiazanie do prostych skryptow, jednak bardziej skomplikowane chca sie czesto dowiedziec, czy modprobe tak naprawde cos zrobil: ta opcja powoduje, ze modprobe konczy prace z niepowodzeniem, jesli program faktycznie nic nie wykonuje. --force-vermagic Kazdy modul zawiera niewielki lancuch z waznymi informacjami obejmujacymi np. wersje jadra i kompilatora. Jesli nie uda sie zaladowac modulu, a jadro poinformuje ze "version magic" nie pasuje, mozna uzyc tej opcji do usuniecia go. Oczywiscie to sprawdzenie odbywa sie dla ochrony uzytkownika, wiec uzycie niniejszej opcji jest niebezpieczne, chyba ze jest sie pewnym tego, co sie robi. Opcja odnosi sie do wszystkich zaladowanych modulow: zarowno modulu (lub aliasu) z wiersza polecenia, jak i do modulow od ktorych jest on zalezny. --force-modversion Jesli moduly sa skompilowane z ustawieniem CONFIG_MODVERSIONS, tworzona jest sekcja nt. szczegolow wersji kazdego modulu uzytego przez (lub udostepnianego) przez dany modul. Jesli nie powiedzie sie zaladowanie modulu, a jadro poinformuje ze nie zgadza sie wersja ktoregos z modulu bedacego interfejsem, mozna uzyc "--force-modversion" aby usunac rowniez informacje o wersji. Oczywiscie to sprawdzenie odbywa sie dla ochrony uzytkownika, wiec uzycie niniejszej opcji jest niebezpieczne, chyba ze jest sie pewnym tego, co sie robi. Opcja odnosi sie do wszystkich zaladowanych modulow: zarowno modulu (lub aliasu) z wiersza polecenia, jak i do modulow od ktorych jest on zalezny. -f, --force Probuje wyciac z modulu wszystkie informacje o wersji, ktore moga spowodowac jego niepomyslne zaladowanie: jest to odpowiednik uzycia obu opcji --force-vermagic i --force-modversion. Oczywiscie to sprawdzenie odbywa sie dla ochrony uzytkownika, wiec uzycie niniejszej opcji jest niebezpieczne, chyba ze jest sie pewnym tego, co sie robi. Opcja odnosi sie do wszystkich zaladowanych modulow: zarowno modulu (lub aliasu) z wiersza polecenia, jak i do modulow od ktorych jest on zalezny. -i, --ignore-install, --ignore-remove Opcja powoduje ignorowanie przez modprobe polecen install i remove w pliku konfiguracyjnym (jesli istnieje), do modulu podanego w wierszu polecenia (wszystkie zalezne moduly beda wciaz mialy ustawiane polecenia je dotyczace z pliku konfiguracyjnego). Oba polecenia install i remove beda obecnie ignorowane gdy uzyta jest ta opcja, niezaleznie czy zadanie dotyczylo tylko jednego (a nie obu) z --ignore-install i --ignore-remove. Patrz modprobe.d(5). -n, --dry-run, --show Opcja wykonuje wszystko poza rzeczywistym zaladowaniem lub usunieciem modulu (lub wykonaniu polecen install lub remove). W polaczeniu z -v jest przydatna do debugowania problemow. Z powodow historycznych zarowno --dry-run i --show oznaczaja to samo i moga byc stosowane wymiennie. -q, --quiet Z ta opcja modprobe nie bedzie wypisywalo informacji o bledzie, gdy bedzie sie probowalo zaladowac modul, ktorego nie mozna znalezc (i nie jest aliasem lub poleceniem install/remove). Program bedzie mogl wciaz zwracac niezerowy kod zakonczenia. Jadro uzywa tej opcji do wyprobowania modulow, ktore moga potencjalnie istniec, przy uzyciu request_module. -R, --resolve-alias Wypisuje wszystkie nazwy modulow pasujace do aliasu. Moze byc przydatne do debugowania problemow z aliasem modulu. -r, --remove Opcja powoduje usuniecie modulu przez modprobe, zamiast zaladowania go. Jesli moduly, od ktorych on zalezy sa rowniez nieuzywane, modprobe takze sprobuje je usunac. W przeciwienstwie do ladowania modulow, mozna podac kilka modulow w wierszu polecenia (nie ma sensu podawac parametrow modulu podczas usuwania go). Z reguly nie ma powodu aby usuwac moduly, ale czesc blednych modulow moze tego wymagac. Jadro dystrybucyjne moze w ogole nie byc zbudowane z obsluga usuwania modulow. -w, --wait=czas-w-milisekundach Opcja powoduje, ze modprobe -r bedzie ponawial proby usuniecia modulu, ktore zawodza ze wzgledu na zajetosc modulu (tzn. jesli jego refcount nie wynosi 0 w momencie wywolania). Proby podejmowane przez modprobe beda sie powtarzac z coraz dluzsza przerwa, az do maksymalnego czasu oczekiwania w milisekundach, okreslonego niniejsza opcja. -S, --set-version Ustawia wersje jadra, zamiast uzywania uname(2) do decydowania o niej (decyduje o miejscu szukania modulow). --show-depends Wypisuje zaleznosci modulu (lub aliasu) wlacznie z samym modulem. Wynikiem jest (byc moze pusty) zestaw nazw plikow modulow, po jednym w wierszu, zaczynajacych sie "insmod", ktory jest z reguly uzywany przez dystrybucje do okreslenia ktore moduly wlaczyc do generowanych obrazow initrd/initramfs. Stosowane polecenie install jest poprzedzone przez "install". Opcja nie wykonuje zadnego z polecen instalacji. Prosze zauwazyc, ze modinfo(8) moze zostac uzyte do pozyskania zaleznosci modulu z samego modulu, ale nie wie nic o aliasach ani poleceniach instalacji. -s, --syslog Opcja powoduje, ze wszystkie komunikaty o bledach przesylane sa przez mechanizm syslog (jak LOG_DAEMON z poziomem LOG_NOTICE), zamiast na standardowe wyjscie bledow. Wlacza sie rowniez automatycznie, gdy stderr jest niedostepne. Poprzez opcje install i remove, opcja jest podawana innym poleceniom modprobe w zmiennej srodowiskowej MODPROBE_OPTIONS. -V, --version Wyswietla informacje o wersji i konczy dzialanie. -v, --verbose Wypisuje informacje o czynnosciach wykonywanych przez program. modprobe wypisuje zwykle komunikaty jedynie, gdy wystepuja jakies problemy. Poprzez opcje install i remove, opcja jest podawana innym poleceniom modprobe w zmiennej srodowiskowej MODPROBE_OPTIONS. SRODOWISKO Do przekazania argumentow do modprobe mozna uzyc rowniez zmiennej srodowiskowej MODPROBE_OPTIONS. PRAWA AUTORSKIE Pierwotnie: Copyright 2002, Rusty Russell, IBM Corporation. Strona podrecznika jest obecnie zarzadzana przez Jona Mastersa i innych. ZOBACZ TAKZE modprobe.d(5), insmod(8), rmmod(8), lsmod(8), modinfo(8) depmod(8) AUTORZY Jon Masters Deweloper Robby Workman Deweloper Lucas De Marchi Deweloper TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Andrzej Krzysztofowicz i Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . kmod 09.02.2023 r. MODPROBE(8)