.\" Copyright (c) 1994, 1995 Jacques Gelinas (jacques@solucorp.qc.ca)
.\" Copyright (c) 1995 Bjorn Ekwall (bj0rn@blox.se)
.\" This program is distributed according to the Gnu General Public License.
.\" See the file COPYING in the kernel source directory /linux
.\" $Id: depmod.1,v 1.5 2000/09/30 17:08:37 wojtek2 Exp $
.\"
.\" {PTM/MM/0.1/18-11-1998/"depmod.1, modprobe.1 - automatyczna obsuga moduw"}
.TH DEPMOD 1 "March 17, 1996" Linux "Linux Module Support"
.SH NAZWA
depmod, modprobe \- programy do "automatycznej" obsugi moduw
.SH SKADNIA
.B depmod
[ \-a ]
.br
.B depmod
[ \-a wersja ]
.br
.B depmod
modu1.o modu2.o ...
.PP
.B modprobe
modu.o [symbol=warto ...]
.br
.B modprobe
\-t tag wzorzec
.br
.B modprobe
\-a \-t tag wzorzec
.br
.B modprobe
\-l [ \-t tag ] wzorzec
.br
.B modprobe
\-r modu
.br
.B modprobe
\-c
.br
.SH OPIS
Narzdzia te maj pomc uytkownikom w posugiwaniu si moduami
Linuksa.
.PP
.B Depmod
tworzy plik podobny do "Makefile" z zalenociami, bazujcy na symbolach,
ktre znalaz w zbiorze moduw podanych w linii komend (lub w standardowym
miejscu).
Plik zalenoci moe by potem uyty przez
.B modprobe 
, aby automatycznie  zaadowa odpowiednie moduy.
.PP
.B Modprobe
jest uywany aby zaadowa zbir moduw, pojedynczy modu, zbir
zalenych od siebie moduw lub wszystkie moduy oznaczone okrelonym
tagiem.
.PP
.B Modprobe
aduje automatycznie wszystkie moduy zalene od siebie w zbiorze moduw,
jak zostao to opisane w pliku zalenoci modules.dep.
Jeli zaadowanie jednego z tych moduw si nie powiedzie, cay zbir
moduw zostanie usunity automatycznie z jdra (przez rmmod).
.PP
.B Modprobe
moe adowa moduy na dwa rne sposoby. Jeden to taki, e modprobe sprbuje
zaadowa modu z podanej listy lub zdefiniowany przez  
.B wzorzec (pattern).
Zatrzymuje si jeli uda mu si zaadowa jeden z moduw.
Ten tryb moe by uyty np. do automatycznego zaadowania moduu z driverem
dla naszej karty sieciowej, wybranego z listy.
Inny sposb uycia modprobe, to zaadowanie wszystkich moduw z listy.
Ta opcja moe by uyta do zaadowania wszystkich moduw w trakcie
uruchamiania systemu.
.PP
Podajc opcj
.B -r,
modprobe automatycznie usunie zbir moduw, podobnie jak by to zostao wykonane przez
.B rmmod -r
.
.PP
Opcja -l podana z opcj -t wypisze wszystkie dostpne moduy
okrelonego typu.
Polecenie
.B mount
mogo by np. wykorzysta komend

	modprobe -l -t fs

aby otrzyma list wszystkich dostpnych systemw plikw w postaci moduw,
aby nastpnie zaadowa odpowiedni.
Polecenie, mount mogoby si wtedy sta bardziej elastyczne...
(ale tym zajmuje si kerneld bez potrzeby zmian w poleceniu mount).
.PP
Opcja -c wywietla ca konfiguracj (ustawienia standardowe + plik
konfiguracyjny).
.PP
Najczstsze uycie
.B depmod
to wstawienie polecenia "/sbin/depmod -a" w jednym z plikw startowych w
/etc/rc.d, aby odpowiednie powizania moduw byy dostpne zaraz po
uruchomieniu si systemu.
.br
Istnieje take moliwo utworzenia pliku zalenoci zaraz po skompilowaniu
nowego jdra. Po wykonaniu "depmod -a 1.3.99" jeli wczeniej skompilowae
jdro 1.3.99 i jego moduy po raz pierwszy, uywajc wci jdra 1.3.98,
plik zostanie utworzony w odpowiednim miejscu.
.br
Zauwa, e mimo wszystko, zalenoci wygenerowane mog nie by poprawne.
.PP
Opcja
.B -d
uruchomi depmod w trybie debugowania. Wywietla wszystkie polecenia, ktre
wydaje.
.Pp
Opcja
.B -e
podaje list wszystkich nierozwizanych symboli dla kadego moduu,
Normalnie depmod wywietli jedynie list moduw, ktre nie moe zaadowa.
.Pp
Opcja
.B -v
wywietla list wszystkich moduw ktrymi si zajmuje.
.Pp
Moduy mog by pooone w innym miejscu systemu plikw, ale zawsze bdzie
istniaa potrzeba aby to zmieni, szczeglnie dla ludzi zajmujcych si
rozwijaniem moduw.
Oczekuje si, e pojawi si oficjalne standardy zdefiniowane przez FSSTND.
Do tego czasu moesz uywa rwnie dobrze struktury katalogw tu
zaproponowanej.
.SH KONFIGURACJA
Zachowanie si
.B depmod
i
.B modprobe
moe by dostosowane przez (opcjonalny) plik konfiguracyjny
.B /etc/conf.modules
.PP
Plik ten skada si ze zbioru linii.
.br
Wszystkie puste linie i linie zaczynajce si od znaku '#', zostan
zignorowane.
.br
Linie mog by kontynuowane poprzez zakoczenie ich znakami '\\'.
.br
Pozostae linie powinny by dostosowane do jednego z podanych poniej
formatw:

  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 wartoci w liniach "parameter"  bd uruchamiane poprzez powok,
co oznacza, e dozwolone s wszystkie triki powokowe, jak znaki specjalne "*", "?"
i komendy podawane w odwrconych apostrofach:

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

Parametry mog by powtarzane wiele razy.
.PP
Poniej podane s dozwolone parametry:
.TP
keep
Jeli to sowo zostanie znalezione w lini
.B przed
jakkolwiek inn lini, ktra zawiera opis
.B cieek (path)
, standardowy zbir cieek zostanie zachowany, a nastpne zostan dodane do niego.
W przeciwnym wypadku standardowe cieki zostan
.B usunite
przez sciezki podane w pliku konfiguracyjnym.
.TP
depfile=DEPFILE_PATH
Jest to cieka do pliku zawierajcego plik zalenoci, ktry zostanie
utworzony przez
.B depmod
, a uywany przez
.B modprobe.
.TP
path=SOME_PATH
Parametr
.B path
podaje katalog w ktrym powinny by szukane moduy.
.TP
path[tag]=SOME_PATH
Parametr path moe mie dodatkowy, opcjonalny tag.
W ten sposb moemy troch dokadniej opisa znacznie moduw w tym
katalogu, pozwala nam to na zautomatyzowanie operacji wykonywanych przez
.B modprobe.
Tag jest dodawany do sowa "path" i zawarty jest w nawiasach kwadratowych.
Jeli przy 'path" nie ma podanego taga, standardowo doczany jest tag
"misc".
.br
Jednym z bardziej uytecznych tagw jest tag
.B boot,
ktrym moemy oznaczy wszystkie moduy ktre maj by zaadowane podczas
startu systemu.
.PP
Jeli brakuje pliku '/etc/conf.modules',
lub jeli aden z parametrw nie zosta uyty,
nastpujce ustawienia standardowe s zakadane:
.PP
  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
.PP
Wszystkie linie opcji ("option" lines) podaj standardowe opcje ktre s
wymagane przez modu, np.:

  modprobe de620 bnc=1

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

Moliwe jest uycie lini opcji take dla aliasu moduu rwnie dobrze jak i
dla jego prawdziwej nazwy.
Przykad uytecznego uycia poniej:

  alias dummy0 dummy
  options dummy0 -o dummy0

.PP
Linie zaczynajce si od sowa "alias" mog by uyte dla podania aliasw
dla pewnych moduw.
Linia w /etc/conf.modules ktra wyglda jak poniej:

  alias iso9660 isofs

sprawia e mona wpisa
.B "modprobe iso9660"
mimo i tak naprawd nie ma takiego moduu.
.br
Zauwa e linia:

  alias nazwa_moduu off

sprawi, e modprobe zignoruje dania zaadownia tego moduu.
Jest to zazwyczaj uywane w poczeniu z
.B kerneld.
.TP
Komendy
Linie konfigurujce
  pre-install modu polecenie ...
  install modu polecenie ...
  post-install modu polecenie ...
  pre-remove modu polecenie ...
  remove modu polecenie ...
  post-remove modu polecenie ...
.br
mog by uyte kiedy chcemy aby pewne specyficzne polecenia zostay wykonane 
kiedy modu jest adowany lub usuwany.
Cay tekst podany za nazw moduu bdzie zinterpretowany jak komenda do
wykonania.
.br
Zauwa, e komendy pre- i post-remove \fBnie\fR bd wykonywane jeli modu
jest usuwany automatycznie przez kerneld!
Zamiast zastanawia si, jak to obej, poczekaj, a zostanie wprowadzona obsuga 
uporczywych moduom.

.SH STRATEGIA
Istnieje pomys aby
.B modprobe
najpierw sprawdzi katalog zawierajcy moduy skompilowane dla biecej wersji
jdra. Jeli nie zostanie tam znaleziony,
.B modprobe
sprawdzi inne katalogi.
.PP
Kiedy zainstalujesz nowego Linuksa, moduy powinny by przesunite do
katalogu nazwanego od numeru jdra ktre instalujemy.
Nastpnie powiniene zrobi link z tego katalogu do katalogu "default".
.PP
Za kadym razem kiedy kompilujesz nowe jdro, polecenie
.B "make modules_install"
stworzy nowy katalog, ale nie zmieni katalogu default.
.PP
Kiedy otrzymasz modu nie zwizany z konkretnym jdrem powiniene go umieci
w katalogu nie zalenym od wersji jdra w katalogu /lib/modules.
.PP
Takie jest standardowe zachowanie, ktre jednake moe by zmienione poprzez
odpowiednie wpisy do /etc/conf.modules.
.SH PRZYKADY
.TP
modprobe -t net
Zaaduj jeden z moduw, ktry znajduje si w katalogu oznaczonym "net".
Kady modu jest wyprubowywany a do momentu kiedy ktry z nich zostanie
zaadowany (standardowo: /lib/modules/net).
.TP
modprobe -a -t boot
Wszystkie moduy, ktre znajduj si w katalogu oznaczony przez "boot" bd
zaadowane (standardowo: /lib/modules/boot).
.TP
modprobe slip.o
Polecenie to spowoduje prb zaadowania moduu slhc.o o ile nie zosta
uprzednio zaadowany, poniewa modu slip potrzebuje wczeniejszego
zaadowania moduu slhc.o.
Ta zaleno bdzie opisana w pliku "modules.dep", ktry zosta wygenerowany
automatycznie przez
.B depmod
.TP
modprobe -r slip.o
usunie slip.o, a take automatycznie slhc.o, chyba e jest on uywany przez
jaki inny modu (np. ppp.o).
.SH PLIKI
.nf
/etc/conf.modules, (and /etc/modules.conf)
/lib/modules/*/modules.dep,
/lib/modules/*
.fi
.SH ZOBACZ TAKE
lsmod(1),
kerneld(8),
ksyms(1),
modules(2),
.SH NIEZBDNE NARZDZIA
insmod(1),
nm(1)
rmmod(1),
.SH NOTES
Wzorzec podany programowi modprobe czsto jest escapowany, aby
mie pewno, e jest interpretowany we waciwy sposb.

.SH AUTOR
Jacques Gelinas (jack@solucorp.qc.ca)
.br
Bjorn Ekwall (bj0rn@blox.se)
.SH BDY
Naah...