> Linux Reviews > man >

depmod

, modprobe programy do "automatycznej" obs�ugi modu��w

depmod.1.man
depmod.8.man

1. depmod.1.man

Manpage of DEPMOD

DEPMOD

Section: Linux Module Support (1)
Updated: March 17, 1996
Index Return to Main Contents

NAZWA

depmod, modprobe - programy do "automatycznej" obs�ugi modu��w

SK�ADNIA

depmod [ -a ]
depmod [ -a wersja ]
depmod modu�1.o modu�2.o ...

modprobe modu�.o [symbol=warto�� ...]
modprobe -t tag wzorzec
modprobe -a -t tag wzorzec
modprobe -l [ -t tag ] wzorzec
modprobe -r modu�
modprobe -c

OPIS

Narz�dzia te maj� pom�c u�ytkownikom w pos�ugiwaniu si� modu�ami Linuksa.

Depmod tworzy plik podobny do "Makefile" z zale�no�ciami, bazuj�cy na symbolach, kt�re znalaz� w zbiorze modu��w podanych w linii komend (lub w standardowym miejscu). Plik zale�no�ci mo�e by� potem u�yty przez modprobe , aby automatycznie za�adowa� odpowiednie modu�y.

Modprobe jest u�ywany aby za�adowa� zbi�r modu��w, pojedynczy modu�, zbi�r zale�nych od siebie modu��w lub wszystkie modu�y oznaczone okre�lonym tagiem.

Modprobe �aduje automatycznie wszystkie modu�y zale�ne od siebie w zbiorze modu��w, jak zosta�o to opisane w pliku zale�no�ci modules.dep. Je�li za�adowanie jednego z tych modu��w si� nie powiedzie, ca�y zbi�r modu��w zostanie usuni�ty automatycznie z j�dra (przez rmmod).

Modprobe mo�e �adowa� modu�y na dwa r�ne sposoby. Jeden to taki, �e modprobe spr�buje za�adowa� modu� z podanej listy lub zdefiniowany przez wzorzec (pattern). Zatrzymuje si� je�li uda mu si� za�adowa� jeden z modu��w. Ten tryb mo�e by� u�yty np. do automatycznego za�adowania modu�u z driverem dla naszej karty sieciowej, wybranego z listy. Inny spos�b u�ycia modprobe, to za�adowanie wszystkich modu��w z listy. Ta opcja mo�e by� u�yta do za�adowania wszystkich modu��w w trakcie uruchamiania systemu.

Podaj�c opcj� -r, modprobe automatycznie usunie zbi�r modu��w, podobnie jak by to zosta�o wykonane przez rmmod -r

Opcja -l podana z opcj� -t wypisze wszystkie dost�pne modu�y okre�lonego typu. Polecenie mount mog�o by np. wykorzysta� komend�

modprobe -l -t fs

aby otrzyma� list� wszystkich dost�pnych system�w plik�w w postaci modu��w, aby nast�pnie za�adowa� odpowiedni. Polecenie, mount mog�oby si� wtedy sta� bardziej elastyczne... (ale tym zajmuje si� kerneld bez potrzeby zmian w poleceniu mount).

Opcja -c wy�wietla ca�� konfiguracj� (ustawienia standardowe + plik konfiguracyjny).

Najcz�stsze u�ycie depmod to wstawienie polecenia "/sbin/depmod -a" w jednym z plik�w startowych w /etc/rc.d, aby odpowiednie powi�zania modu��w by�y dost�pne zaraz po uruchomieniu si� systemu.
Istnieje tak�e mo�liwo�� utworzenia pliku zale�no�ci zaraz po skompilowaniu nowego j�dra. Po wykonaniu "depmod -a 1.3.99" je�li wcze�niej skompilowa�e� j�dro 1.3.99 i jego modu�y po raz pierwszy, u�ywaj�c wci�� j�dra 1.3.98, plik zostanie utworzony w odpowiednim miejscu.
Zauwa�, �e mimo wszystko, zale�no�ci wygenerowane mog� nie by� poprawne.

Opcja -d uruchomi depmod w trybie debugowania. Wy�wietla wszystkie polecenia, kt�re wydaje.

Opcja -e podaje list� wszystkich nierozwi�zanych symboli dla ka�dego modu�u, Normalnie depmod wy�wietli jedynie list� modu��w, kt�re nie mo�e za�adowa�.

Opcja -v wy�wietla list� wszystkich modu��w kt�rymi si� zajmuje.

Modu�y mog� by� po�o�one w innym miejscu systemu plik�w, ale zawsze b�dzie istnia�a potrzeba aby to zmieni�, szczeg�lnie dla ludzi zajmuj�cych si� rozwijaniem modu��w. Oczekuje si�, �e pojawi� si� oficjalne standardy zdefiniowane przez FSSTND. Do tego czasu mo�esz u�ywa� r�wnie dobrze struktury katalog�w tu zaproponowanej.

KONFIGURACJA

Zachowanie si� depmod i modprobe mo�e by� dostosowane przez (opcjonalny) plik konfiguracyjny /etc/conf.modules

Plik ten sk�ada si� ze zbioru linii.
Wszystkie puste linie i linie zaczynaj�ce si� od znaku '#', zostan� zignorowane.
Linie mog� by� kontynuowane poprzez zako�czenie ich znakami '\'.
Pozosta�e linie powinny by� dostosowane do jednego z podanych poni�ej format�w:

  keep
  parameter=warto��
  options module symbol=warto�� ...
  alias modu� prawdziwa_nazwa
  pre-install modu� polecenie ...
  install modu� polecenie ...
  post-install modu� polecenie ...
  pre-remove modu� polecenie ...
  remove modu� polecenie ...
  post-remove modu� polecenie ...

Wszystkie warto�ci w liniach "parameter" b�d� uruchamiane poprzez pow�ok�, co oznacza, �e dozwolone s� wszystkie triki pow�okowe, jak znaki specjalne "*", "?" i komendy podawane w odwr�conych apostrofach:

path[misc]=/lib/modules/1.1.5?
path[net]=/lib/modules/`uname -r`

Parametry mog� by� powtarzane wiele razy.

Poni�ej podane s� dozwolone parametry:

keep: Je�li to s�owo zostanie znalezione w lini przed jak�kolwiek inn� lini�, kt�ra zawiera opis �cie�ek (path) , standardowy zbi�r �cie�ek zostanie zachowany, a nast�pne zostan� dodane do niego. W przeciwnym wypadku standardowe �cie�ki zostan� usuni�te przez sciezki podane w pliku konfiguracyjnym.
depfile=DEPFILE_PATH: Jest to �cie�ka do pliku zawieraj�cego plik zale�no�ci, kt�ry zostanie utworzony przez depmod , a u�ywany przez modprobe.
path=SOME_PATH: Parametr path podaje katalog w kt�rym powinny by� szukane modu�y.
path[tag]=SOME_PATH: Parametr path mo�e mie� dodatkowy, opcjonalny tag. W ten spos�b mo�emy troch� dok�adniej opisa� znacznie modu��w w tym katalogu, pozwala nam to na zautomatyzowanie operacji wykonywanych przez modprobe. Tag jest dodawany do s�owa "path" i zawarty jest w nawiasach kwadratowych. Je�li przy 'path" nie ma podanego taga, standardowo do��czany jest tag "misc".
Jednym z bardziej u�ytecznych tag�w jest tag boot, kt�rym mo�emy oznaczy� wszystkie modu�y kt�re maj� by� za�adowane podczas startu systemu.

Je�li brakuje pliku '/etc/conf.modules', lub je�li �aden z parametr�w nie zosta� u�yty, nast�puj�ce ustawienia standardowe s� zak�adane:

depfile=/lib/modules/`uname -r`/modules.dep
path[boot]=/lib/modules

  path[fs]=/lib/modules/`uname -r`
  path[misc]=/lib/modules/`uname -r`
  path[net]=/lib/modules/`uname -r`
  path[scsi]=/lib/modules/`uname -r`
  path[cdrom]=/lib/modules/`uname -r`
  path[ipv4]=/lib/modules/`uname -r`
  path[ipv6]=/lib/modules/`uname -r`
  path[sound]=/lib/modules/`uname -r`

  path[fs]=/lib/modules/default
  path[misc]=/lib/modules/default
  path[net]=/lib/modules/default
  path[scsi]=/lib/modules/default
  path[cdrom]=/lib/modules/default
  path[ipv4]=/lib/modules/default
  path[ipv6]=/lib/modules/default
  path[sound]=/lib/modules/default

  path[fs]=/lib/modules
  path[misc]=/lib/modules
  path[net]=/lib/modules
  path[scsi]=/lib/modules
  path[cdrom]=/lib/modules
  path[ipv4]=/lib/modules
  path[ipv6]=/lib/modules
  path[sound]=/lib/modules

Wszystkie linie opcji ("option" lines) podaj� standardowe opcje kt�re s� wymagane przez modu�, np.:

modprobe de620 bnc=1

Opcje te mog� by� zmienione przez podanie tych opcji do programu modprobe z lini komend.

Mo�liwe jest u�ycie lini opcji tak�e dla aliasu modu�u r�wnie dobrze jak i dla jego prawdziwej nazwy. Przyk�ad u�ytecznego u�ycia poni�ej:

alias dummy0 dummy
options dummy0 -o dummy0

Linie zaczynaj�ce si� od s�owa "alias" mog� by� u�yte dla podania alias�w dla pewnych modu��w. Linia w /etc/conf.modules kt�ra wygl�da jak poni�ej:

alias iso9660 isofs

sprawia �e mo�na wpisa� modprobe iso9660 mimo i� tak naprawd� nie ma takiego modu�u.
Zauwa� �e linia:

alias nazwa_modu�u off

sprawi, �e modprobe zignoruje ��dania za�adownia tego modu�u. Jest to zazwyczaj u�ywane w po��czeniu z kerneld.

Komendy: Linie konfiguruj�ce
  pre-install modu� polecenie ...
  install modu� polecenie ...
  post-install modu� polecenie ...
  pre-remove modu� polecenie ...
  remove modu� polecenie ...
  post-remove modu� polecenie ...
mog� by� u�yte kiedy chcemy aby pewne specyficzne polecenia zosta�y wykonane kiedy modu� jest �adowany lub usuwany. Ca�y tekst podany za nazw� modu�u b�dzie zinterpretowany jak komenda do wykonania.
Zauwa�, �e komendy pre- i post-remove nie b�d� wykonywane je�li modu� jest usuwany automatycznie przez kerneld! Zamiast zastanawia� si�, jak to obej��, poczekaj, a� zostanie wprowadzona obs�uga uporczywych modu�om.

STRATEGIA

Istnieje pomys� aby modprobe najpierw sprawdzi� katalog zawieraj�cy modu�y skompilowane dla bie��cej wersji j�dra. Je�li nie zostanie tam znaleziony, modprobe sprawdzi inne katalogi.

Kiedy zainstalujesz nowego Linuksa, modu�y powinny by� przesuni�te do katalogu nazwanego od numeru j�dra kt�re instalujemy. Nast�pnie powiniene� zrobi� link z tego katalogu do katalogu "default".

Za ka�dym razem kiedy kompilujesz nowe j�dro, polecenie make modules_install stworzy nowy katalog, ale nie zmieni katalogu default.

Kiedy otrzymasz modu� nie zwi�zany z konkretnym j�drem powiniene� go umie�ci� w katalogu nie zale�nym od wersji j�dra w katalogu /lib/modules.

Takie jest standardowe zachowanie, kt�re jednak�e mo�e by� zmienione poprzez odpowiednie wpisy do /etc/conf.modules.

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 -a -t boot: Wszystkie modu�y, kt�re znajduj� si� w katalogu oznaczony przez "boot" b�d� za�adowane (standardowo: /lib/modules/boot).
modprobe slip.o: Polecenie to spowoduje pr�b� za�adowania modu�u slhc.o o ile nie zosta� uprzednio za�adowany, poniewa� modu� slip potrzebuje wcze�niejszego za�adowania modu�u slhc.o. Ta zale�no�� b�dzie opisana w pliku "modules.dep", kt�ry zosta� wygenerowany automatycznie przez depmod
modprobe -r slip.o: usunie slip.o, a tak�e automatycznie slhc.o, chyba �e jest on u�ywany przez jaki� inny modu� (np. ppp.o).

PLIKI

/etc/conf.modules, (and /etc/modules.conf)
/lib/modules/*/modules.dep,
/lib/modules/*

ZOBACZ TAK�E

lsmod(1), kerneld(8), ksyms(1), modules(2),

NIEZB�DNE NARZ�DZIA

insmod(1), nm(1) rmmod(1),

NOTES

Wzorzec podany programowi modprobe cz�sto jest escapowany, aby mie� pewno��, �e jest interpretowany we w�a�ciwy spos�b.

AUTOR

Jacques Gelinas (jack@solucorp.qc.ca)
Bjorn Ekwall (bj0rn@blox.se)

B��DY

Naah...

This document was created by man2html using the manual pages.
Time: 17:40:19 GMT, May 11, 2012

2. depmod.8.man

Manpage of DEPMOD

DEPMOD

Section: Wsparcie dla modu��w (8)
Updated: 2 pa�dziernika 2001
Index Return to Main Contents

NAZWA

depmod - obs�uga opisu zale�no�ci pomi�dzy modu�ami j�dra

SK�ADNIA

depmod -[aA] [-enqsvVru] [-C plikkofiguracyjny] [-F symbolej�dra] [-b katalogbazowy] [wymuszona_wersja]
depmod [-enqsvru] [-F symbolej�dra] modu�1.o modu�2.o ...

OPCJE

-a: Poszukuje modu��w we wszystkich katalogach wymienionych w (opcjonalnym) pliku kofiguracyjnym /etc/modules.conf.
-A: Por�wnuje znaczniki czasowe plik�w i, je�li trzeba, dzia�a jak depmod -a. Ta opcja aktualizuje zale�no�ci jedynie, gdy co� si� zmieni�o.
-e: Pokazuje wszystkie nierozwi�zane symbole dla poszczeg�lnych modu��w.
-n: Wypisuje plik zale�no�ci na standardowe wyj�cie, zamiast do drzewa /lib/modules.
-s: Wypisuje komunikaty o b��dach za po�rednictwem demona syslog, zamiast na standardow� diagnostyk�.
-v: Wypisuje nazwy poszczeg�lnych modu��w podczas ich przetwarzania.
-q: Ka�e depmodowi zamilkn�� i nie narzeka� na brakuj�ce symbole.
-V: Wypisuje numer wersji programu depmod
-r: Niekt�rzy u�ytkownicy kompiluj� modu�y jako u�ytkownik inny ni� root, a nast�pnie instaluj� je jako root. W wyniku tego w�a�cicielem modu��w nie b�dzie root, nawet je�li jest on w�a�cicielem katalogu modu��w. Je�li dopu�ci si� innego u�ytkownika ni� root jako w�a�ciciela modu��w, umo�liwi si� nieproszonemu go�ciowi nadpisanie istniej�cych modu��w b�d�cych w�asno�ci� tego u�ytkownika i wykorzystanie za�adowania go do uzyskania uprawnie� roota.
: Domy�lnie, modutils odrzuc� pr�b� za�adowania modu�u nie nale��cego do root-a. Podanie -r zniesie b��d i pozwoli root-owi za�adowa� modu�y, kt�re nie s� jego w�asno�ci�.
: U�ywanie -r jest powa�nym naruszeniem bezpiecze�stwa i nie jest zalecane.
-u: depmod 2.4 nie ustawia kodu powrotu, gdy wyst�puj� nierozwi�zane symbole. Nast�pna g��wna wersja modutils (2.5) b�dzie to robi�. Niekt�re dystrybucje wymagaj� niezerowego kodu powrotu przy nierozwi�zanych symbolach, ale taka zmiana mog�aby spowodowa� problemy u u�ytkownik�w oczekuj�cych starego zachowania. Je�li niezerowy kodu powrotu jest potrzebny w depmod 2.4, nale�y poda� -u. depmod 2.5 b�dzie milcz�co ignorowa� flag� -u i b�dzie zawsze zwraca� niezerowy kodu powrotu przy nierozwi�zanych symbolach.

Nast�puj�ce opcje s� przydatne dla os�b zarz�dzaj�cych dystrybucjami:

-b katalogbazowy: Je�li drzewo katalog�w /lib/modules zawieraj�ce poddrzewa modu��w zostanie przeniesione gdzie indziej, aby obs�ugiwa� modu�y w innym �rodowisku, opcja katalogbazowy m�wi depmodowi, gdzie szuka� przeniesionego obrazu drzewa /lib/modules. Odwo�ania do plik�w w pliku wynikowym depmoda, modules.dep, kt�ry zostanie utworzony nie b�d� zawiera� �cie�ki katalogbazowy. Oznacza to, �e gdy drzewo plik�w zostanie przeniesione z powrotem z katalogbazowy/lib/modules do /lib/modules w ostatecznej dystrybucji, wszystkie odwo�ania b�d� poprawne.
-C plikkofiguracyjny: Ka�e korzysta� z pliku plikkofiguracyjny zamiast /etc/modules.conf.
Do wybrania innego pliku konfiguracyjnego ni� domy�lny /etc/modules.conf (lub /etc/conf.modules (przestarza�e)) mo�na r�wnie� wykorzysta� zmienn� �rodowiska MODULECONF.
-F symbolej�dra: Podczas budowania pliku zale�no�ci dla innego j�dra ni� aktualnie dzia��j�ce wa�ne jest, aby depmod korzysta� z w�a�ciwego zbioru symboli j�draa przy rozwi�zywaniu odwo�a� do j�dra z poszczeg�lnych modu��w. Symbole te mog� by� kopi� albo kopi� pliku System.map z w�a�ciwego j�dra, albo kopi� zawarto�ci /proc/ksyms. Je�li j�dro u�ywa a wersjonowanych symboli, najlepiej korzysta� z kopii zawarto�ci /proc/ksyms, gdy� plik ten zawiera wersje symboli j�dra. Jednak�e, nawet z wersjonowanymi symbolami, mo�na u�ywa� System.map.

OPIS

Programy narz�dziowe depmod i modprobe s�u�� do zarz�dzania zmodularyzowanym j�drem Linuksa przez zwyk�ych u�ytkownik�w, administrator�w i tw�rc�w dystrybucji.

depmod tworzy podobny do "Makefile" plik z zale�no�ciami, oparty na symbolach, kt�re znajdzie w zbiorze modu��w podanych w linii polece� lub w katalogach wymienionych w pliku konfiguracyjnym. Plik zale�no�ci mo�e by� potem wykorzystany przez modprobe w celu automatycznego �adowania odpowiednich modu��w lub zestaw�w modu��w.

Typowe u�ycie depmod polega na umieszczeniu linii /sbin/depmod -a gdzie� w skryptach startowych w /etc/rc.d tak, aby odpowiednie powi�zania modu��w by�y dost�pne zaraz po uruchomieniu si� systemu. Nale�y zauwa�y�, �e parametr -a jest obecnie opcjonalny. Dla stosowania podczas startu systemu opcja -q mo�e by� bardziej w�a�ciwa, gdy� wycisza ona depmoda w kwestii nierozwi�zanych symboli.

Istnieje tak�e mo�liwo�� utworzenia pliku zale�no�ci zaraz po skompilowaniu nowego j�dra. Wydanie polecenia "depmod -a 2.2.99" po wcze�niejszej kompilacji j�dra 2.2.99 i jego modu��w po raz pierwszy, u�ywaj�c wci�� j�dra 2.2.98, spowoduje utworzenie pliku we w�a�ciwym miejscu. Jednak�e w tym przypadku, wygenerowane zale�no�ci mog� nie by� poprawne. Zobacz opis opcji -F, -C i -b powy�ej aby uzyska� wi�cej informacji na temat obs�ugi tej sytuacji.

Podczas tworzenia zwi�zk�w pomi�dzy modu�ami i symbolami udost�pnionymi przez inne modu�y depmod nie bierze pod uwag� stosunku modu�u lub udost�pnionych syboli do licencji GPL. To znaczy, depmod nie zg�osi b��du je�li modu� na licencji niezgodnej z GPL b�dzie si� odwo�ywa� to symboli zastrze�onych dla GPL (EXPORT_SYMBOL_GPL w j�drze). Jednak�e, insmod odm�wi rozwi�zania symboli zastrze�onych dla GPL dla modu��w nie-GPL, wi�c modu�u nie uda si� za�adowa�.

KONFIGURACJA

Zachowanie si� depmod i modprobe mo�e by� dostosowane przez (opcjonalny) plik konfiguracyjny /etc/modules.conf.
Zajrzyj do modprobe(8) i modules.conf(5) po pe�ny opis.

STRATEGIA

Za ka�dym razem podczas kompilacji nowego j�dra, polecenie make modules_install stworzy nowy katalog, ale nie zmieni katalogu domy�lnego.

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 /lib/modules.

Takie jest standardowe zachowanie, kt�re jednak�e mo�e by� zmienione poprzez odpowiednie wpisy do /etc/modules.conf.