.\" -*- coding: UTF-8 -*-
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.nh
.ad l
.\" Begin generated content:
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH MODPROBE 8 "25 kwietnia 2025 r." kmod modprobe
.PP
.SH NAZWA
.PP
modprobe \- dodaje i usuwa moduły z jądra Linux
.PP
.SH SKŁADNIA
.PP
\fBmodprobe\fP [\fB\-v\fP] [\fB\-V\fP] [\fB\-C\fP \fIplik\-konfiguracyjny\fP] [\fB\-n\fP] [\fB\-i\fP] [\fB\-q\fP] [\fB\-b\fP] [\fInazwa\-modułu\fP]
         [\fImoduł parametry\fP.\&.\&.\&]
.PP
\fBmodprobe\fP [\fB\-r\fP] [\fB\-v\fP] [\fB\-n\fP] [\fB\-i\fP] [\fInazwa\-modułu\fP.\&.\&.\&]
.PP
\fBmodprobe\fP [\fB\-c\fP]
.PP
\fBmodprobe\fP [\fB\-\-dump\-modversions\fP] [\fInazwa\-pliku\fP]
.PP
.SH OPIS
.PP
\fBmodprobe\fP 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).\&
\fBmodprobe\fP szuka wszystkich modułów i innych plików w katalogu modułów
/usr/lib/`uname \-r`, z wyjątkiem opcjonalnych plików konfiguracyjnych
(zob.\& \fBmodprobe.\&d\fP(5)).\& \fBmodprobe\fP 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ł>.\&
.PP
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 \fBmodprobe\fP 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 \fBdmesg\fP(8).\&
.PP
\fBmodprobe\fP oczekuje obecności zaktualizowanego pliku modules.\&dep.\&bin
utworzonego przez powiązane narzędzie \fBdepmod\fP, dystrybuowane razem z
\fBmodprobe\fP (patrz \fBdepmod\fP(8)).\& Dla każdego modułu plik ten posiada spis
innych modułów jakich (jeśli jest taka potrzeba) wymaga dany moduł, a
\fBmodprobe\fP używa jej do automatycznego dodawania lub usuwania tych
zależności.\&
.PP
Jeśli po \fInazwie\-modułu\fP podano argumenty, są one przekazywane jądru
(oprócz ewentualnych opcji umieszczonych w pliku konfiguracyjnym).\&
.PP
Przy ładowaniu modułów, \fInazwa\-modułu\fP może być również ścieżką do
modułu.\& Jeśli ścieżka jest względna, musi się zaczynać od ".\&/".\& Proszę
zauważyć, że ten sposób może nie zadziałać, gdy ścieżka prowadzi do modułu z
zależnościami niewystępującymi w zainstalowanej bazie danych depmod.\&
.PP
.SH OPCJE
.PP
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Ładuje wszystkie moduły podane w wierszu polecenia.\&
.PP
.RE
\fB\-b\fP, \fB\-\-use\-blacklist\fP
.RS 4
Opcja powoduje zastosowanie przez \fBmodprobe\fP poleceń \fBblacklist\fP z plików
konfiguracyjnych (jeśli występują) także do nazw modułów.\& Jest ona używana
z reguły przez \fBudev\fP(7).\&
.PP
.RE
\fB\-C\fP \fIkatalog\fP, \fB\-\-config\fP=\fIkatalog\fP
.RS 4
Opcja przesłania domyślny katalog konfiguracyjny.\& Zob.\&
\fBmodprobe.\&d\fP(5).\&
.PP
Poprzez opcje \fBinstall\fP i \fBremove\fP, opcja jest podawana innym poleceniom
\fBmodprobe\fP w zmiennej środowiskowej MODPROBE_OPTIONS.\&
.PP
.RE
\fB\-c\fP, \fB\-\-showconfig\fP
.RS 4
Zrzuca efektywną konfigurację z katalogu konfiguracyjnego i wychodzi.\&
.PP
.RE
\fB\-\-dump\-modversions\fP
.RS 4
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.\&
.PP
.RE
\fB\-d\fP, \fB\-\-dirname\fP
.RS 4
Główny katalog dla modułów, domyślnie "/".\&
.PP
.RE
\fB\-\-first\-time\fP
.RS 4
\fBmodprobe\fP 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 \fBmodprobe\fP tak naprawdę coś
zrobił: ta opcja powoduje, że modprobe kończy pracę z niepowodzeniem, jeśli
program faktycznie nic nie wykonuje.\&
.PP
.RE
\fB\-\-force\-vermagic\fP
.RS 4
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.\&
.PP
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.\&
.PP
.RE
\fB\-\-force\-modversion\fP
.RS 4
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ć \fB\-\-force\-modversion\fP, 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.\&
.PP
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.\&
.PP
.RE
\fB\-f\fP, \fB\-\-force\fP
.RS 4
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
\fB\-\-force\-vermagic\fP i \fB\-\-force\-modversion\fP.\& 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.\&
.PP
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.\&
.PP
.RE
\fB\-i\fP, \fB\-\-ignore\-install\fP, \fB\-\-ignore\-remove\fP
.RS 4
Opcja powoduje ignorowanie przez \fBmodprobe\fP poleceń \fBinstall\fP i \fBremove\fP
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 \fBinstall\fP i \fBremove\fP
będą obecnie ignorowane gdy użyta jest ta opcja, niezależnie czy żądanie
dotyczyło tylko jednego (a nie obu) z \fB\-\-ignore\-install\fP i
\fB\-\-ignore\-remove\fP.\& Patrz \fBmodprobe.d\fP(5).\&
.PP
.RE
\fB\-n\fP, \fB\-\-dry\-run\fP, \fB\-\-show\fP
.RS 4
Opcja wykonuje wszystko poza rzeczywistym załadowaniem lub usunięciem modułu
(lub wykonaniu poleceń install lub remove).\& W połączeniu z \fB\-v\fP jest
przydatna do debugowania problemów.\& Z powodów historycznych zarówno
\fB\-\-dry\-run\fP i \fB\-\-show\fP oznaczają to samo i mogą być stosowane wymiennie.\&
.PP
.RE
\fB\-q\fP, \fB\-\-quiet\fP
.RS 4
Z tą opcją \fBmodprobe\fP 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 \fBinstall\fP/\fBremove\fP).\& 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.\&
.PP
.RE
\fB\-R\fP, \fB\-\-resolve\-alias\fP
.RS 4
Wypisuje wszystkie nazwy modułów pasujące do aliasu.\& Może być przydatne do
debugowania problemów z aliasem modułu.\&
.PP
.RE
\fB\-r\fP, \fB\-\-remove\fP
.RS 4
Opcja powoduje usunięcie modułu przez \fBmodprobe\fP, zamiast załadowania go.\&
Jeśli moduły, od których on zależy są również nieużywane, \fBmodprobe\fP 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).\&
.PP
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.\&
.PP
.RE
\fB\-w\fP \fIczas\-w\-milisekundach\fP, \fB\-\-wait\fP=\fIczas\-w\-milisekundach\fP
.RS 4
Opcja powoduje, że \fBmodprobe \-r\fP będzie ponawiał próby usunięcia modułu,
które zawodzą ze względu na zajętość modułu (tzn. jeśli jego refcount nie
wynosi 0 w momencie wywołania).\& Próby podejmowane przez modprobe będą się
powtarzać z coraz dłuższą przerwą, aż do maksymalnego czasu oczekiwania w
milisekundach, określonego niniejszą opcją.\&
.PP
.RE
\fB\-S\fP \fIwersja\fP, \fB\-\-set\-version\fP=\fIwersja\fP
.RS 4
Ustawia wersję jądra, zamiast używania \fBuname\fP(2) do decydowania o niej
(decyduje o miejscu szukania modułów).\&
.PP
.RE
\fB\-\-show\-depends\fP
.RS 4
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 \fBinstall\fP jest poprzedzone przez "install".\& Opcja nie
wykonuje żadnego z poleceń instalacji.\& Proszę zauważyć, że \fBmodinfo\fP(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.\&
.PP
.RE
\fB\-s\fP, \fB\-\-syslog\fP
.RS 4
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.\&
.PP
Poprzez opcje \fBinstall\fP i \fBremove\fP, opcja jest podawana innym poleceniom
\fBmodprobe\fP w zmiennej środowiskowej MODPROBE_OPTIONS.\&
.PP
.RE
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Wyświetla informacje o wersji i kończy działanie.\&
.PP
.RE
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Wypisuje informacje o czynnościach wykonywanych przez program.\& \fBmodprobe\fP
wypisuje zwykle komunikaty jedynie, gdy występują jakieś problemy.\&
.PP
Poprzez opcje \fBinstall\fP i \fBremove\fP, opcja jest podawana innym poleceniom
\fBmodprobe\fP w zmiennej środowiskowej MODPROBE_OPTIONS.\&
.PP
.RE
.SH ŚRODOWISKO
.PP
Do przekazania argumentów do \fBmodprobe\fP można użyć również zmiennej
środowiskowej MODPROBE_OPTIONS.\& Jej format jest celowo nieudokumentowany,
ponieważ nie zaleca się korzystania z niej przez zewnętrzne narzędzia i
skrypty.
.PP
Zmienna środowiskowa wywodzi się od implementacji reguł instalacyjnych.\&
.PP
.SH PRAWA AUTORSKIE
.PP
Pierwotnie: Copyright 2002, Rusty Russell, IBM Corporation.\&
.PP
.SH "ZOBACZ TAKŻE"
.PP
\fBmodprobe.\&d\fP(5), \fBinsmod\fP(8), \fBrmmod\fP(8), \fBlsmod\fP(8), \fBmodinfo\fP(8),
\fBdepmod\fP(8)
.PP
.SH USTERKI
.PP
Zgłoszeń błędów prosimy dokonywać w systemie śledzenia błędów pod adresem
https://github.\&com/kmod\-project/kmod/issues/, wraz z informacją o wersji
programu, krokach potrzebnych do odtworzenia problemu oraz oczekiwanym
rezultacie.
.PP
.SH AUTORZY
.PP
Wielu współautorów pochodzi z listy dyskusyjnej linux\-modules pod adresem
<linux\-modules@vger.\&kernel.\&org> oraz z Githuba.\& Mając
sklonowane repozytorium kmod.\&git, wynik polecenia \fBgit\-shortlog\fP(1) i
\fBgit\-blame\fP(1) ukaże autorów danej części projektu.\&
.PP
Projektem opiekuje się aktualnie \fBLucas De Marchi\fP
<lucas.\&de.\&marchi@gmail.\&com>.\&
.PP
.SH TŁUMACZENIE
Tłumaczenie niniejszej strony podręcznika:
Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>
i
Michał Kułach <michal.kulach@gmail.com>
.
.PP
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach
licencji można uzyskać zapoznając się z
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License w wersji 3
.UE
lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
.PP
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy
dyskusyjnej
.MT manpages-pl-list@lists.sourceforge.net
.ME .
