Provided by:
manpages-pl_20051117-1_all 
NAZWA
modprobe - wysokopoziomowa obsługa modułów
SKŁADNIA
modprobe [ -adnqv ] [ -C konfiguracja ] moduł [ symbol=wartość ... ]
modprobe [ -adnqv ] [ -C konfiguracja ] [ -t typ ] wzorzec
modprobe -l [ -C konfiguracja ] [ -t typ ] wzorzec
modprobe -c [ -C konfiguracja ]
modprobe -r [ -dnv ] [ -C konfiguracja ] [ moduł ...]
modprobe -V
OPCJE
-a, --all
Ładuje all wszystkie moduły pasujące do wzorca, zamiast
zatrzymać się po pierwszym pomyślnym załadowaniu.
-c, --showconfig
Pokazuje akrualnie używaną konfigurację.
-d, --debug
Pokazuje informacje o wewnęrznej reprezentacji stosu modułów.
-k, --autoclean
Ustawia 'autoczyszczenie' dla załadowanych modułów. Używane
przez jądro podczas wywoływania modprobe aby zapewnić brakujące
właściwości (dostępne jako moduły). Opcja -k włącza też -q.
Opcje te są automatycznie przekazywane do insmoda.
-l, --list
Wypisuje pasujące moduły.
-n, --show
Pokazuje, co by się działo, nie podejmując żadnej akcji.
-q, --quiet
Nie narzeka na niepomyślną instalację modułu przez insmoda.
Kontymuuje jak zwykle, lecz po cichu, umożliwiając modprobe
testowanie innych możliwości. Opcja ta jest automatycznie
przekazywana do insmoda.
-r, --remove
Usuwa moduł (stos modułów) lub wykonuj autoczyszczenie, w
zależności od tego, czy podano jakieś moduły w linii poleceń,
czy nie.
-s, --syslog
Wyprowadza wszystko do syslog zamiast na standardową
diagnostykę. Opcja ta jest automatycznie przekazywana do
insmoda.
-t, --type typmoduu
Bierze pod uwagę jedynie moduły danego typu. modprobe będzie
szukać jadynie takich modułów, których katalog w ścieżce zawiera
"/typmoduu/". typmoduu może zawierać więcej niż jedną nazwę
katalogu, np. -t drivers/net wypisze moduły z xxx/drivers/net/
i jego podkatalogów.
-v, --verbose
Wupisuje wszystkie uruchamiane polecenia.
-V, --version
Wypisuje wersję modprobe.
-C, --config plikkonf
Korzysta z pliku plikkonf zamiast z (opcjonalnego)
/etc/modules.conf dla określenia konfiguracji. Do wybrania (i
narzucenia) innego pliku konfiguracyjnego niż domyślny
/etc/modules.conf (lub (przestarzały) /etc/conf.modules) można
również użyć zmiennej środowiska MODULECONF.
Uwaga: Zawy modułów nie mogą zawierać ścieżek (bez '/') ani kończących
nazwę '.o'. Na przykład, slip jest dla modprobe poprawną nazwą,
a /lib/modules/2.2.19/net/slip i slip.o są niepoprawne. Dotyczy
to linii poleceń i całego pliku konfiguracyjnego.
OPIS
Programy narzędziowe modprobe i depmod służą do zarządzania
zmodularyzowanym jądrem Linuksa przez zwykłych użytkowników,
administratorów i twórców dystrybucji.
modprobe w celu automatycznego ładowania właściwych, spośród zbioru
modułów dostępnych w predefiniowanych drzewach katalogów, korzysta z
pliku podobnego do "Makefile", tworzonego przez depmod. modprobe jest
używany do załadowania: pojedynczego modułu, zbioru powiązanych
modułów, lub wszystkich modułów oznaczonych podanym znacznikiem.
modprobe automatycznie załaduje wszystkie moduły podstawowe, wymagane
przez zbiór modułów, zgodnie z opisem w pliku powiązań modules.dep.
Jeśli ładowanie jednego z tych modułów się nie powiedzie, cały zbiór
modułów załadowanych w bieżącej sesji zostanie automatycznie
rozładowany.
modprobe może ładować moduły na dwa różne sposoby. Jeden to taki, że
modprobe spróbuje załadować moduł z podanej listy (zdefiniowany przez
wzorzec ). modprobe zatrzyma się jeśli uda mu się załadować jeden z
modułów. W ten sposób można automatycznie ładować sterownik karty
Ethernet jako jeden z listy.
Inny sposób użycia modprobe to załadowanie wszystkich modułów z listy.
Zobzcz PRZYKŁADY poniżej.
Gdy poda się opcję -r, modprobe automatycznie usunie zbiór modułów,
podobnie jak by to zostało wykonane przez rmmod -r. Należy zauważyć,
że wydanie polecenia modprobe -r spowoduje wyczyszczenie nieużywanych,
automatycznie załadowanych modułów a także wykonanie poleceń pre- i
post-remove z pliku konfiguracyjnego /etc/modules.conf.
Jeżeli opcja -l zostanie połączona z opcją -t, wypisana zostanie lista
wszystkich dostępnych modułów określonego typu.
Opcja -c wypisuje całą bieżącą konfigurację (ustawienia domyślne + plik
konfiguracyjny).
KONFIGURACJA
Zachowanie się depmod i modprobe może być dostosowane przez
(opcjonalny) plik konfiguracyjny /etc/conf.modules.
Po bardziej szczegółowy opis możliwej zawartości tego pliku, jak i
konfigurację domyślną używaną przez depmod i modprobe, zajrzyj do
modules.conf(5).
Należy zwrócić uwagę, że polecenia pre- i post-remove nie będą
wykonywane jeśli moduł jest usuwany automatycznie przez kerneld!
Zamiast zastanawiać się, jak to obejść, należy poczekać, aż zostanie
wprowadzona obsługa trwałego przechowywania danych dla modułów.
Jeśli funkcjonalność pre- i post-install jest potrzebna, należy
wyłączyć automatyczne usuwanie modułów przez kerneld i zamiast tego
wpisać linię podobną do poniższej w crontab (ma to również zastosowanie
w systemach korzystających z kmod), aby automatyczne usuwać moduły co 2
minuty:
*/2 * * * * test -f /proc/modules && /sbin/modprobe -r
STRATEGIA
Idea polega na tym, by modprobe najpierw sprawdził katalog zawierający
moduły skompilowane dla bieżącej wersji jądra. Jeśli właściwy moduł nie
zostanie tam znaleziony, modprobe sprawdzi inne katalogi, wspólne dla
głównego numery wersji jądra (np. 2.0, 2.2). Jeśli tam też nie znajdzie
modułu, modprobe będzie szukać w katalogu zawierającym moduły dla
domyślnego jądra, itd.
Podczas instalacji nowego Linuksa, moduły powinny być przeniesione do
katalogu nazwanego od numeru jądra które jest instalowane. Wówczas
należy zrobić dowiązanie symboliczne z tego katalogu do katalogu
"default".
Podczas każdej kompilacji nowego jądra, polecenie make modules_install
utworzy nowy katalog, ale nie zmieni dowiązania do katalogu default.
Kiedy otrzyma się moduł nie związany z konkretnym jądrem należy go
umieścić w jednym z katalogów nie zależnych od wersji jądra w katalogu
/lib/modules.
Takie jest standardowe zachowanie, które może być zmienione poprzez
odpowiednie wpisy do /etc/modules.conf.
PRZYKŁADY
modprobe -t net
Załaduj jeden z modułów, który znajduje się w katalogu
oznaczonym "net". Każdy moduł jest wyprubowywany aż do momentu
kiedy któryś z nich zostanie załadowany (standardowo:
/lib/modules/net).
modprobe -t net
Ładuje jeden z modułów znajdujących się w katalogu "net".
Próbuje wszystkich modułów po kolei, aż z jednym się uda.
modprobe -a -t boot
Wszystkie moduły znajdujące się w katalogach oznaczonych przez
boot będą załadowane.
modprobe slip
Polecenie to spowoduje próbę załadowania modułu slhc.o o ile nie
został uprzednio załadowany, ponieważ moduł slip wymaga
funkcjonalności modułu slhc. Ta zależność będzie opisana w
pliku "modules.dep" utworzonym wcześniej automatycznie przez
polecenie depmod.
modprobe -r slip
usunie moduł slip. Usunie również automatycznie moduł slhc, o
ile nie jest on również używany przez jakiś inny moduł (np.
ppp).
PLIKI
/etc/modules.conf (alternatywnie, przestarzały /etc/conf.modules)
/lib/modules/*/modules.dep,
/lib/modules/*
ZOBACZ TAKŻE
depmod(8), lsmod(8), kerneld(8), ksyms(8), rmmod(8)
TRYB BEZPIECZNY
Jeśli efektywny uid jest różny od rzeczywistego uid, modprobe analizuje
podane parametry szczególnie podejrzliwie. Ostatni parametr jest zawsze
traktowany jak nazwa modułu, nawet gdy zaczyna się od '-'. Może być
podana nazwa tylko jednego modułu a opcje postaci "zmienna=wartość" są
zabronione. Nazwa modułu jest zawsze traktowana jak łańcuch znakowy, w
trybie bezpiecznym nie są przeprowadzane rozwinięcia. Jednakże,
rozwinięcia nadal są wykonywane odnośnie danych zawartych w pliku
konfiguracyjnym.
euid może być różny od uid podczas wywoływania modprobe przez jądro;
dzieje się tak dla jąder >= 2.4.0-test11. W świecie idealnym modprobe
mógłby ufać jądru, że przekazuje tylko prawidłowe parametry. Jednakże,
pojawiła się co najmniej jedna metoda wykorzystania tego lokalnie dla
uzyskania uprawnień roota, gdyż wysokopoziomowy kod kernela przekazywał
bezpośrednio parametry od użytkownika do modprobe, bez kontroli.
modprobe automatycznie ustawia tryb bezpieczny, gdy środowisko składa
się jedynie z następujących zmiennych:
HOME=/
TERM=linux
PATH=/sbin:/usr/sbin:/bin:/usr/bin
Jest to wykrywanie uruchamiania modprobe przez jądro dla jąder 2.2 do
2.4.0-test11, nawet gdy uid == euid, jak się dzieje dla wcześniejszych
jąder.
LOGOWANIE POLECEŃ
Jeśli istnieje katalog /var/log/ksymoops, a modprobe zostanie
uruchomiany z opcją powodującą załadowanie lub usunięcie modułu,
modprobe zaloguje swoje polecenie i kod powrotu w
/var/log/ksymoops/`date +%Y%m%d.log`. Nie ma przełącznika
wyłączającego automatyczne logowanie. Jeśli nie ma ono występować, nie
należy tworzyć katalogu /var/log/ksymoops. Jeśli ten katalog istnieje,
powinien być on własnością roota i mieć prawa dostępu 644 lub 600 oraz
należy uruchamiać codziennie, lub w podobnych odstępach czasu, skrypt
insmod_ksymoops_clean.
NIEZBĘDNE NARZĘDZIA
depmod(8), insmod(8)
UWAGI
Wzorce podane programowi modprobe często wymagają cytowania, aby mieć
pewność, że są interpretowany we właściwy sposób.
AUTOR
Jacques Gelinas (jack@solucorp.qc.ca)
Bjorn Ekwall (bj0rn@blox.se)