.\" -*- coding: UTF-8 -*-
'\" t
.\"     Title: modprobe.d
.\"    Author: Jon Masters <jcm@jonmasters.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 12/10/2022
.\"    Manual: modprobe.d
.\"    Source: kmod
.\"  Language: English
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH MODPROBE\&.D 5 "10.12.2022 r." kmod modprobe.d
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH NAZWA
modprobe.d \- katalog konfiguracji modprobe
.SH SKŁADNIA
.PP
/lib/modprobe\&.d/*\&.conf
.PP
/usr/local/lib/modprobe\&.d/*\&.conf
.PP
/run/modprobe\&.d/*\&.conf
.PP
/etc/modprobe\&.d/*\&.conf
.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.\& Wszystkie pliki w
katalogu /etc/modprobe\&.d, które kończą się rozszerzeniem \&.conf określają
te opcje, zgodnie z wymaganiami\&. 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
Format plików konfiguracyjnym w katalogu modprobe\&.d jest prosty: 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\&.
.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\&.
.sp
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)\&.
.RE
.PP
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ć\&.
.RE
.PP
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\&.
.sp
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\&.
.sp
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].
.RE
.PP
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\&.
.sp
Wszystkie opcje są dodawane razem: mogą pochodzić z opcji \fBoption\fP samego
modułu, jego aliasu oraz z wiersza polecenia\&.
.RE
.PP
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]\&.
.RE
.PP
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ą\&.
.sp
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\&.
.sp
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\&.
.sp
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\&.
.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\&.
.SH PRAWA\ AUTORSKIE
.PP
Niniejsza strona podręcznika: pierwotnie Copyright 2004, Rusty Russell, IBM
Corporation\&. Obecnie utrzymywane przez Jona Mastersa i innych\&.
.SH "ZOBACZ TAKŻE"
.PP
\fBmodprobe\fP(8), \fBmodules.dep\fP(5)
.SH AUTORZY
.PP
\fBJon Masters\fP <\&jcm@jonmasters\&.org\&>
.RS 4
Deweloper
.RE
.PP
\fBRobby Workman\fP <\&rworkman@slackware\&.com\&>
.RS 4
Deweloper
.RE
.PP
\fBLucas De Marchi\fP <\&lucas\&.de\&.marchi@gmail\&.com\&>
.RS 4
Deweloper
.RE
.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 .
