.\" -*- 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.D 5 "25 kwietnia 2025 r." kmod modprobe.d
.PP
.SH NAZWA
.PP
modprobe.\&d \- katalog konfiguracji modprobe
.PP
.SH SKŁADNIA
.PP
/etc/modprobe.\&d/*.\&conf
.PP
/run/modprobe.\&d/*.\&conf
.PP
/usr/local/lib/modprobe.\&d/*.\&conf
.PP
/usr/lib/modprobe.\&d/*.\&conf
.PP
/lib/modprobe.\&d/*.\&conf
.PP
.SH OPIS
.PP
Ze względu na zależności między modułami, polecenie \fBmodprobe\fP może dodawać
lub usuwać więcej niż pojedynczy moduł, zatem potrzebna jest metoda
podawania opcji, jakie mają być używane z tymi modułami.\& Można w ten
sposób także tworzyć wygodne aliasy:  czyli alternatywne nazwy dla modułów
lub zupełnie przesłaniać zwykłe zachowanie \fBmodprobe\fP w przypadku
specjalnych wymagań (np. dodawania więcej niż jednego modułu).\&
.PP
Proszę zwrócić uwagę, że nazwy aliasów i modułów (podobnie jak inne nazwy
modułów) mogą zawierać znaki \- lub _: oba można stosować zamiennie we
wszystkich poleceniach związanych z modułami, ponieważ konwersja znaków
podkreślenia następuje automatycznie.\&
.PP
.SH "FORMAT KONFIGURACJI"
.PP
Pliki konfiguracyjne zawierają po jednym poleceniu na wiersz, przy czym
puste wiersze oraz wiersze zaczynające się od \[Bq]#\[rq] są ignorowane
(przydatne do dodawania komentarzy).\& Znak \[Bq]\[rs]\[rq] na końcu wiersza
powoduje, że następny wiersz staje się kontynuacją poprzedniego, co czyni
pliki nieco czytelniejszymi.\&
.PP
Więcej informacji w poniższym rozdziale POLECENIA.\&
.PP
.SH "KATALOGI KONFIGURACJI I PIERWSZEŃSTWO"
.PP
Pliki konfiguracyjne są odczytywane z katalogów wyszczególnionych w SKŁADNI,
w tej kolejności.\& Po załadowaniu pliku o danej nazwie, pliki o tej samej
nazwie z kolejnych katalogów są ignorowane.\&
.PP
Wszystkie pliki konfiguracyjne są sortowane w kolejności leksykograficznej,
niezależnie od katalogu, z jakiego pochodzą.\& Pliki konfiguracyjne mogą być
albo zupełnie zastąpione (przez nowy plik konfiguracyjny, o tej samej
nazwie, w katalogu o wyższym priorytecie) albo częściowo zastąpione (przez
plik konfiguracyjny dalszy w kolejności).\&
.PP
UWAGA: Katalogi konfiguracyjne można zmienić zmienną środowiskową
MODPROBE_OPTIONS.\& Więcej informacji w rozdziale ŚRODOWISKO w podręczniku
\fBmodprobe\fP(8).\&
.PP
.SH POLECENIA
.PP
alias \fIwieloznacznik\fP \fInazwa\-modułu\fP
.RS 4
Pozwala nadać modułowi alternatywną nazwę.\& Przykładowo \[Bq]alias moj\-mod
naprawde\-dluga\-nazwa\-modulu\[rq] oznacza, że można używać \[Bq]modprobe
moj\-mod\[rq] zamiast \[Bq]modprobe naprawde\-dluga\-nazwa\-modulu\[rq].\& Można
też korzystać z wieloznaczników powłoki, zatem \[Bq]alias moj\-mod*
naprawde\-dluga\-nazwa\-modulu\[rq] oznacza, że \[Bq]modprobe
moj\-mod\-costam\[rq] również zadziała. Nie można tworzyć aliasów do innych
aliasów (to prowadziłoby do szaleństwa), ale aliasy mogą posiadać opcje,
które zostaną dodane do wszelkich innych opcji.\&
.PP
Moduły mogą zawierać swoje własne aliasy, które można poznać poleceniem
\fBmodinfo\fP.\& Aliasy te są używane w ostatniej kolejności (tj.\& jeśli nie
ma rzeczywistego modułu o takiej nazwie, ani w konfiguracji nie ma polecenia
\fBinstall\fP, \fBremove\fP lub \fBalias\fP).\&
.PP
.RE
blacklist \fInazwa\-modułu\fP
.RS 4
Moduły mogą zawierać swoje własne aliasy: zwykle są to aliasy opisujące
obsługiwane urządzenia, np. \[Bq]pci:123.\&.\&.\&\[rq].\& Te
\[Bq]wewnętrzne\[rq] aliasy można przesłonić zwykłymi słowami kluczowymi
\[Bq]alias\[rq], ale niekiedy zdarza się, że dwa lub więcej modułów
obsługuje te same urządzenia albo moduł nieprawidłowo zgłasza obsługę
urządzenia, którego nie obsługuje: słowo kluczowe \fBblacklist\fP wskazuje, że
wszystkie wewnętrzne aliasy danego modułu należy zignorować.\&
.PP
.RE
install \fInazwa\-modułu\fP \fIpolecenie.\&.\&.\&\fP
.RS 4
Polecenie instruuje \fBmodprobe\fP, aby uruchomiło podane polecenie zamiast
umieszczać moduł w jądrze w zwykły sposób.\& Polecenie to może być dowolnym
poleceniem powłoki: w ten sposób można dokonać dowolnie skomplikowanego
przetwarzania.\& Przykładowo, jeśli moduł \[Bq]fred\[rq] działa lepiej z już
zainstalowanym modułem \[Bq]barney\[rq] (ale nie jest od niego zależny, więc
\fBmodprobe\fP nie załaduje go automatycznie), można podać \[Bq]install fred
/sbin/modprobe barney; /sbin/modprobe \-\-ignore\-install fred\[rq], co da
oczekiwany efekt.\& Proszę odnotować \fB\-\-ignore\-install\fP, które powstrzymuje
drugi przebieg \fBmodprobe\fP od ponownego uruchomienia tego samego polecenia
\fBinstall\fP.\& Zob. też \fBremove\fP poniżej.\&
.PP
Długoterminowa przyszłość tego polecenia jako rozwiązania problemów z
zapewnianiem dodatkowych zależności modułom nie jest pewna; planuje się jego
zastąpienie ostrzeżeniem o przyszłym usunięciu lub uznaniu za przestarzałe w
którymś z przyszłych wydań.\& Obecność polecenia komplikuje automatyczne
określanie zależności modułów przez narzędzia dystrybucji takie jak mkinitrd
(ponieważ wymaga jakiejś interpretacji tego, co może robić polecenie
\fBinstall\fP).\& W idealnym świecie moduły zapewniałyby wszelkie informacje o
zależnościach bez niniejszego polecenia i trwają prace nad implementacją
obsługi miękkich zależności w jądrze Linux.\&
.PP
Jeśli w poleceniu użyje się łańcucha \[Bq]$CMDLINE_OPTS\[rq], zostanie on
zastąpiony opcjami podanymi w wierszu polecenia modprobe.\& Może być to
przydatne, ponieważ użytkownicy oczekują, że \[Bq]modprobe fred opt=1\[rq]
przekaże argument \[Bq]opt=1\[rq] do modułu nawet, jeśli w pliku
konfiguracyjnym występuje polecenie install.\& Tak więc powyższy przykład
przyjmie w ten sposób postać: \[Bq]install fred /sbin/modprobe barney;
/sbin/modprobe \-\-ignore\-install fred $CMDLINE_OPTS\[rq].
.PP
.RE
options \fInazwa\-modułu\fP \fIopcja.\&.\&.\&\fP
.RS 4
Polecenie to pozwala dodawać opcje do modułu \fInazwa\-modułu\fP (które może być
aliasem) za każdym razem, gdy zostanie on dodany do jądra: bezpośrednio (za
pomocą \fBmodprobe\fP \fInazwa\-modułu\fP) lub ze względu na zależność innego
dodawanego modułu.\&
.PP
Wszystkie opcje są dodawane razem: mogą pochodzić z opcji \fBoption\fP samego
modułu, jego aliasu oraz z wiersza polecenia.\&
.PP
.RE
remove \fInazwa\-modułu\fP \fIpolecenie.\&.\&.\&\fP
.RS 4
Podobne do powyższego polecenia \fBinstall\fP, tyle że wywoływane przy
uruchomieniu polecenia \[Bq]modprobe \-r\[rq].\&
.PP
.RE
softdep \fInazwa\-modułu\fP pre: \fImoduły.\&.\&.\&\fP post: \fImoduły.\&.\&.\&\fP
.RS 4
Polecenie \fBsoftdep\fP pozwala zdefiniować zależności miękkie (opcjonalne).\&
Moduł \fInazwa\-modułu\fP może być używany bez instalacji tych opcjonalnych
modułów, ale zwykle nie będzie wówczas w pełni funkcjonalny.\& Na przykład
sterownik adaptera HBA może wymagać załadowania innego modułu, aby korzystać
z funkcji zarządzania przestrzenią dyskową.\&
.PP
Po pre i post następują listy nazw i/lub aliasów innych modułów, które
modprobe spróbuje zainstalować (lub usunąć), w zadanej kolejności, przed
(pre) i po (post) głównym module podanym w argumencie \fInazwa\-modułu\fP.\&
.PP
Przykład: W konfiguracji zapisano polecenie \[Bq]softdep c pre: a b post: d
e\[rq].\& Uruchomienie \[Bq]modprobe c\[rq] staje się teraz równoważne
\[Bq]modprobe a b c d e\[rq] bez softdep.\& Opcje takie jak \-\-use\-blacklist
są stosowane do wszystkich podanych modułów, natomiast parametry modułów \-
tylko do modułu c.\&
.PP
Uwaga: jeśli z tym samym argumentem \fInazwa\-modułu\fP występują też polecenia
\fBinstall\fP lub \fBremove\fP, \fBsoftdep\fP ma pierwszeństwo.\&
.PP
.RE
weakdep \fInazwa\-modułu\fP \fImoduły.\&.\&.\&\fP
.RS 4
Polecenie \fBweakdep\fP pozwala na zdefiniowanie słabych zależności modułów.\&
Są podobne do zależności miękkich typu pre z tą różnicą, że przestrzeń
użytkownika nie próbuje załadować tej zależności przed podanym modułem.\&
Jądro może zażądać jednego lub kilku z nich w trakcie sondowania modułu, w
zależności od przypisań sprzętowych.\& Przeznaczeniem zależności słabych
jest możliwość zdefiniowania przez sterownik, że określona zależność może
być potrzebna, zatem powinna być obecna w systemie plików (np.\& w
initramfs) gdy moduł jest sondowany.\&
.PP
Przykład: Zdefiniowano \[Bq]weakdep c a b\[rq].\& Program tworzący initramfs
wie o tym, że powinien dodać a, b i c do systemu plików, ponieważ a i b mogą
być wymagane/oczekiwane w trakcie rozruchu.\& Gdy c jest ładowany i
sondowany, może wywołać request_module(), powodując załadowanie również a
lub b.\&
.PP
.RE
.SH ZGODNOŚĆ
.PP
Przyszła wersja kmod będzie zawierała wyraźne ostrzeżenie o konieczności
unikania korzystania z \fBinstall\fP, jak wyjaśniono powyżej.\& Stanie się tak
po ukończeniu pełnej obsługi zależności miękkich w jądrze.\& W ramach tego,
istniejąca obsługa za pośrednictwem niniejszego narzędzia zostanie
uzupełniona przez zapewnianie takich zależności bezpośrednio z modułów.\&
.PP
.SH PRAWA AUTORSKIE
.PP
Pierwotne autorstwo niniejszego podręcznika systemowego: Copyright 2004,
Rusty Russell, IBM Corporation.\&
.PP
.SH "ZOBACZ TAKŻE"
.PP
\fBmodprobe\fP(8), \fBmodules.\&dep\fP(5)
.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
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
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 .
