.\"/* Copyright 1999 Bjorn Ekwall <bj0rn@blox.se>
.\" This program is distributed according to the Gnu General Public License.
.\" See the file COPYING in the base distribution directory
.\"
.TH MODULES.CONF 5 "1999. december 7"
.UC 4
.SH NV
modules.conf \- konfigurcis fjl a kernelmodulok betltshez
.SH LERS
A
.B modprobe(8)
(s a
.B depmod(8)
)
viselkedse mdosthat az (opcionlis)
.B /etc/modules.conf.
konfigurcis fjllal.
.PP
A konfigurcis fjl sorokbl ll.
.br
Minden res sort, s a sorban lev '#' utni szveget figyelmen
kvl hagyja.
.br
A sorok folytatdhatnak, ha egy sort a '\\' karakterekkel zrunk.
.br
A maradk sorok meg kell hogy feleljenek a kvetkez formtumoknak:
.nf

  [add] above modul modul_lista
  alias alias_nv eredmny
  [add] below modul modul_lista
  define VLTOZ SZ
  depfile=EGY_ELRSI_T
  else
  elseif KIFEJEZS
  endif
  if KIFEJEZS
  include KONFIGURCIS_FJL_ELRSI_T
  insmod_opt=ALAP_OPCIK_AZ_INSMODNAK
  install modul parancs ...
  keep
  [add] options modul MODUL_SPECIFIKUS_OPCIK
  path=EGY_ELRSI_T
  path[JELZS]=EGY_ELRSI_T
  [add] probe name modul_lista
  [add] probeall name modul_lista
  post-install modul parancs ...
  post-remove modul parancs ...
  pre-install modul parancs ...
  pre-remove modul parancs ...
  remove modul parancs ...
.fi
.PP
Minden direktva argumentumai feldolgozsra kerlnek, hogy
a shell meta-karaktereket kezelhesse, ami azt jelenti, hogy
a "shell trkkk", mint pl. a jokerkarakterek s `` kz
zrt parancsok hasznlhatk:
.nf

  path[misc]=/lib/moduls/1.1.5?/local
  path[net]=/lib/moduls/`uname \-r`/net

.fi
A direktvk tbbszr is megismtelhetek. Figyeljk meg, hogy
nhny direktva eltt szerepelhet az
.I add
opcionlis prefix. Amikor ez a prefix szerepel, az j
modul_lista
.B hozzaddik
az elz modul_listhoz, ahelyett, hogy fellrn.
.SH SZEMANTIKA
.B EGY_ELRSI_T
teljesen megadott elrsi t.
Lehetsges, hogy shell meta-karaktereket hasznljunk az
.B EGY_ELRSI_T
-ban, belertve egy parancs kimenett is, mint pl. a
.I \`uname \-r\`
s
.I \`kernelversion\`.
.br
Ezt a kt parancsot ezek a programok belsleg is rtik, az
aktulis kernel verziszmt, illetve a jelenlegi kernelverzit
jelentve (pl. 2.2.3 s 2.2).
.PP
A
.B SZ
nem white-space (szkz, tabultor, stb.) karakterek sorozata.
Ha ' " vagy ` van a stringben, akkor a kvetkez illeszked
' " vagy ` -ig minden karakter szintn a string rsze, mg az
elbb megadott kivtelek is. Minden
.B SZ
ki lesz fejtve a meta-karakterek szablyai szerint. Ha a kifejts
tbb szt is eredmnyez, akkor az els szt hasznlja.
.PP
A KIFEJEZS lehet:
.TP
.I "SZ sszehasonlt_opertor SZ"
ahol az sszehasonlt_opertor az ==, !=, <, <=, >= vagy > egyike.
A kt SZ string rtke lesz sszehasonltva.
.TP
.I "\-n SZ sszehasonlt_opertor SZ"
ahol sszehasonlt_opertor az ==, !=, <, <=, >= vagy > egyike.
A kt SZ numerikus rtke lesz sszehasonltva.
.TP
.I SZ
Ha a SZ kifejtse sikertelen, vagy a kifejts eredmnye "0" (zr)
vagy "" (res), akkor a kifejezs rtke FALSE. Klnben a kifejezs
rtke TRUE.
.TP
.I "\-f FJLNV"
Teszteli, hogy FJLNV ltezik-e.
.TP
.I \-k
Teszteli, hogy az "automatikus eltvolts" engedlyezve van-e.
(Pl. a kernelbl lett meghva.)
.TP
.I "! KIFEJEZS"
Egy kifejezs negltja szintn kifejezs.
.SH SZINTAXIS
Ez a leglis direktvk lersa.
.TP
.I "define VLTOZ SZ"
Egy
.I putenv("VLTOZ=SZ")
utastst hajt vgre. Vltozk hozhatk ltre s mdosthatk
ezzel a direktvval. A vltozk hozzfrhetv vlnak a shell
krnyezetben, ami az aktulis menetben vgrehajtott parancsok szmra
hasznlhatv teszi ezeket.
.TP
.I "depfile=EGY_ELRSI_T"
Ez a fggsgi fjl elrsi tja, amit a
.B depmod
hoz ltre s a
.B modprobe
hasznlja, hogy megtallja a modulokat s a tle fgg egyb modulokat.
Normlisan az alaprtelmezett rtk hasznland, lsd lejjebb.
.TP
.I "if KIFEJEZS"
Ha a kifejezs rtke
.B TRUE
akkor az illeszked
.I "else, elseif"
vagy
.I endif
-ig minden direktva feldolgozsra kerl. Klnben figyelmen kvl
lesznek hagyva.
A
.I if
direktvk maximum 20 mlysgig egymsba gyazhatk.
.br
Megjegyzs: kerljk a
.B path
direktvk feltteles vgrehajtst. Mivel a
.B modprobe
elegenden "okos", egy felttelesen vgrehajtott
.B path
direktvval nem nyersz semmit, csak sszezavar. Tnyleg.
.TP
.I "else"
Ha a korbbi illeszked
.I if
vagy
.I elseif
direktva kirtkelse utn annak kifejezse
.B FALSE
rtket kapott, akkor az (opcionlis)
.I else
s az illeszked
.I endif
direktva kz zrt direktvk lesznek kirtkelve.
.TP
.I "elseif KIFEJEZS"
Ha a korbbi illeszked
.I if
vagy
.I elseif
direktva kirtkelse utn annak kifejezse
.B FALSE
s ennek a direktva kifejezsnek rtke
.B TRUE
akkor a kvetkez illeszked
.I "elseif, else"
vagy
.I endif
-ig minden direktva feldolgozsra kerl. Klnben figyelmen kvl
lesznek hagyva.
.TP
.I "endif"
Ez a direktva fejezi be az illeszked
.I "if, elseif"
vagy
.I else
direktva lncot amely a konfigurcis fjl feltteles
feldolgozst kontrolllja.
.nf

  if KIFEJEZS
      konfigurci sorok
  elseif KIFEJEZS
      konfigurci sorok
  else
      konfigurci sorok
  endif

.fi
Az
.I else
s
.I elseif
direktvk opcionlisak.
.TP
.I "include KONFIGURACIOS_FAJL_ELRSI_UT"
Klnbz platformok s konfigurcik kezelse egy
fjllal meglehetsen komplex lehet. Az
.I include
direktva hasznlatval, felttelesen feldolgozva az
.I if
direktvk segtsgvel, ez knnyebben kezelhet.
.TP
.I "insmod_opt=ALAP_OPCIOK_AZ_INSMODNAK"
Ha az insmod nhny specilis opcit ignyel, amelyet nem adhatunk
meg mshol, ez a direktva lehetv teszi hogy az insmod minden
meghvsakor megkapja ezt az opcit. Az insmod standard alaprtelmezett
opciit nem szksges msdostani, kivve ha specilis eseteket
kell kezelni.
.TP
.I "keep"
Ha ez a sz megjelenik egy sorban brmilyen sor
.B eltt,
amelyik
.B path
lerst tartalmaz, akkor az alaprtelmezett elrsi utak megrzdnek,
s a tovbbi lersok ehhez hozzaddnak. Klnben a normlis viselkeds
szerint az alaprtelmezett elrsi utakat
.B fellrjk
a konfigurcis fjlban megadottak.
.TP
.I "path=EGY_ELRSI_T"
.TP
.I "path[JELZS]=EGY_ELRSI_T"
Az
.B EGY_ELRSI_T
megad egy jabb knyvtrat, ahol modulok tallhatk.
A
.B path
direktva egy opcionlis jelzst hordozhat.
gy ez egy kicsit tbbet mond az adott knyvtrban tallhat modulok
cljrl s a
.B modprobe
szmra lehetv tesz automatikus mveleteket.
A jelzs a "path" kulcssz utn szgletes zrjelben tallhat.
Ha a jelzs hinyzik, akkor az a "misc" (egyb) jelzst felttelezi.
.br
Egy nagyon hasznos jelzs a
.B boot,
amivel megadhat az sszes olyan knyvtr, ami bootolskor
betltend modulokat tartalmaz.
.TP
.I "alias alias_nv eredmny"
Az "alias" direktva arra hasznlhat, hogy modulok szmra
"lneveket" adjunk. Egy /etc/modules.conf sor ami gy nz ki:
.nf

  alias iso9660 isofs

.fi
lehetv teszi, hogy lerjuk a
.B "modprobe iso9660"
parancsot, habr nincs iso9660 nev modul szmra objektumfjl.
.br
Jegyezzk meg, hogy a
.nf

  alias valamilyen_modul off

.fi
sor azt eredmnyezi, hogy a modprobe figyelmen kvl hagyja
annak a modulnak a betltsre irnyul krseket.
Egy msik specilis lnv a
.nf

  alias valamilyen_modul null

.fi
ami azt eredmnyezi, hogy a valamilyen_modul betltsre szolgl
krs mindig sikeres lesz, de tnylegesen nem lesz betltve.
Ezt egy kiindulsi alapnak lehet hasznlni modulcsoportok
ltrehozsra az
.I above
s
.I below
direktvkkal.
.br
.nf

.fi
.ne 7
Lehetsges nagy mennyisg
.I alias
direktvk hasznlata, mivel minden lnv rekurzvan lesz kifejtve,
hogy a tnylegesen hivatkozott modult megtallja. Egy 1000-es fels
korlt van az lnevek rekurzis mlysgre, hogy az ehhez hasonl
krket feldertse:
.nf

  alias a b
  alias b a

.fi
.br
Ha az
.I alias
vgs eredmnye nem ad tnyleges modul nevet, akkor a modprobe
"probe" s "probeall" hozzrendelseket alkalmaz az eredmnyre.
Ha azok nem sikeresek, akkor a modult nem tallta meg. Ez eredmnyezi,
hogy az ilyen (devfs-bl szrmaz) konstrukcik rtelmes eredmnyre
vezetnek:
.br
.nf

  alias           /dev/sg*        /dev/sg
  probeall        /dev/sg         scsi-hosts sg

.fi
.ne 7
Leglis megolds, hogy egy alias az A modul nevet a B modul nvre
kpezze le s az A modul ugyanakkor ltezzen is, de ez a konstrukci
nem egyrtelm s
.B nem
ajnlott. Trtneti okokbl, a kernel hangrendszere tartalmaz egy
sound.o nev modult de a fejlesztk egy lnevet is akartak a "sound"-rl
a felhasznl hangkrtya drivernek moduljra, pl. "alias\ sound\ sb".
Ennek a kvetelmnynek tmogatsra, de a definilt viselkeds
fenntartsra, ahol lnevek is kaphatnak opcikat, a modprobe nem
vgez lnv feloldst, ha a nevet a modules.dep fjlbl kapta,
klnben igen. Ez nem garantlja minden esetben az elvrt
viselkedst az lnevek s valdi modulok minden kombincijval,
s kerlni kell az olyan lneveket, ami egy igazi modul neve is.
.TP
.I "[add] probe name modul_lista"
.TP
.I "[add] probeall name modul_lista"
Ezek a direktvk csak akkor hasznlhatk, ha a
.I name
egy modul neve, ami a
.B modprobe
paramtereknt adott.
Ennek az a hatsa, hogy amikor egy krs rkezik a
.I name
-re, akkor a modul_listban lev modulok lesznek vgigprblva
a megadott sorrendben. A klnbsg a direktvk kztt az, hogy a
.I probe
az els sikeres betltsig prblkozik, mg a
.I probeall
a lista vgig.
A kilpsi sttusz azt mutatja, hogy volt-e sikeresen betlttt
modul, vagy sem.
Az opcionlis
.I add
prefix hozzadja az j listt a rgihez ahelyett, hogy fellrn.
.TP
.I "[add] options modul MODUL_SPECIFIKUS_OPCIK"
Minden modul nv, belertve az lneveket is, kaphat sajt
.I options
direktvt.
Az lnevek szmra megadott opciknak nagyobb prioritsa van, mint
az "alacsonyabb szint" neveknek. Ez a szably segt az ellentmond
.I options
direktvk feloldsban.
A parancssorban megadott opciknak van a legnagyobb prioritsa.
Az opcionlis
.I add
prefix az j listt hozzadja a rgihez ahelyett, hogy fellrn.
Ha egy
.I alias
eredmnye nem egy igazi modul, akkor az
.I options
direktva ami az
.I alias
lncbl volt konstrulva figyelmen kvl lesz hagyva a probe[all]
meghvsa eltt.
.TP
.I "[add] above modul modul_lista"
Ez a direktva lehetv teszi, hogy egy modul "behzzon"
egy msik modult (vagy modulcsoportot) maga fl, ahogy az
.B lsmod(8)
parancs kimenetbl ltszik.
Az
.I above
direktva hasznos olyan krlmnyek esetn, amikor a fggsgek
komplexebbek, mint amit a
.B modules.dep
fggsgi fjl lerhatna.
Ez egy optimalizlt esete a
.I post-install
s
.I pre-remove
direktvknak.
Jegyezzk meg, hogy a modul betltse nem befolysolja a
.B modprobe.
kilpsi sttuszt.
Az opcionlis
.I add
prefix az j listt hozzadja a rgihez ahelyett, hogy fellrn.
.TP
.I "[add] below modul modul_list"
Ez a direktva lehetv teszi, hogy egy modul "betoljon"
egy msik modult (vagy modulcsoportot) maga al, ahogy az
.B lsmod(8)
parancs kimenetbl ltszik.
A
.I below
direktva hasznos olyan krlmnyek esetn, amikor a fggsgek
komplexebbek, mint amit a
.B modules.dep
fggsgi fjl lerhatna.
Ez egy optimalizlt esete a
.I pre-install
s
.I post-remove
direktvknak.
Jegyezzk meg, hogy a modul betltse nem befolysolja a
.B modprobe.
kilpsi sttuszt.
Az opcionlis
.I add
prefix az j listt hozzadja a rgihez ahelyett, hogy fellrn.
.PP
A kvetkez direktvk hasznosak hogy (opcionlisan) vgrehajtsunk
parancsokat, amikor modult betltnk vagy eltvoltunk. Jegyezzk meg,
hogy lnevek is megadhatk ezekben a direktvkban, amelyek helyes
sorrendben hajtdnak vgre az olyan direktvkkal, ahol nem lnevet
adtunk meg.
.TP
.I "pre-install modul parancs"
Vgrehajtja a
.I parancs
-ot mieltt betlten a megadott modult.
Lsd mg a
.I below
direktvt.
.TP
.I "install modul parancs"
A
.I parancs
-ot hajtja vgre az  alaprtelmezett
.B insmod
helyett, amikor betlti a megadott modult.
.TP
.I "post-install modul parancs"
Vgrehajtja a
.I parancs
-ot miutn betlttte a megadott modult.
Lsd mg az
.I above
direktvt.
.TP
.I "pre-remove modul parancs"
Vgrehajtja a
.I parancs
-ot, mieltt eltvoltan a megadott modult.
Lsd mg az
.I above
direktvt.
.TP
.I "remove modul parancs"
A
.I parancs
-ot hajtja vgre az alaprtelmezett (beptett)
.B rmmod
helyett, amikor eltvoltja a megadott modult.
.TP
.I "post-remove modul parancs"
Vgrehajtja a
.I parancs
-ot miutn eltvoltotta a megadott modult.
Lsd mg az
.I below
direktvt.
.PP
.SH ALAPRTELMEZETT KONFIGURCI
Ha az '/etc/modules.conf' konfigurcis fjl hinyzik, vagy
nincs fellbrlt direktva, akkor a kvetkez alaprtelmezsek
rvnyesek:
.PP
  depfile=/lib/modules/`uname \-r`/modules.dep

  path[boot]=/lib/modules/boot
  path[fs]=/lib/modules/`uname \-r`/fs
  path[net]=/lib/modules/`uname \-r`/net
  path[scsi]=/lib/modules/`uname \-r`/scsi
  path[block]=/lib/modules/`uname \-r`/block
  path[cdrom]=/lib/modules/`uname \-r`/cdrom
  path[ipv4]=/lib/modules/`uname \-r`/ipv4
  path[ipv6]=/lib/modules/`uname \-r`/ipv6
  path[sound]=/lib/modules/`uname \-r`/sound
  path[fc4]=/lib/modules/`uname \-r`/fc4
  path[video]=/lib/modules/`uname \-r`/video
  path[misc]=/lib/modules/`uname \-r`/misc
  path[pcmcia]=/lib/modules/`uname \-r`/pcmcia
  path[atm]=/lib/modules/`uname \-r`/atm
  path[usb]=/lib/modules/`uname \-r`/usb
  path[ide]=/lib/modules/`uname \-r`/ide
  path[ieee1394]=/lib/modules/`uname \-r`/ieee1394

  path[fs]=/lib/modules/`kernelversion`/fs
  path[net]=/lib/modules/`kernelversion`/net
  path[scsi]=/lib/modules/`kernelversion`/scsi
  path[block]=/lib/modules/`kernelversion`/block
  path[cdrom]=/lib/modules/`kernelversion`/cdrom
  path[ipv4]=/lib/modules/`kernelversion`/ipv4
  path[ipv6]=/lib/modules/`kernelversion`/ipv6
  path[sound]=/lib/modules/`kernelversion`/sound
  path[fc4]=/lib/modules/`kernelversion`/fc4
  path[video]=/lib/modules/`kernelversion`/video
  path[misc]=/lib/modules/`kernelversion`/misc
  path[pcmcia]=/lib/modules/`kernelversion`/pcmcia
  path[atm]=/lib/modules/`kernelversion`/atm
  path[usb]=/lib/modules/`kernelversion`/usb
  path[ide]=/lib/modules/`kernelversion`/ide
  path[ieee1394]=/lib/modules/`kernelversion`/ieee1394

  path[fs]=/lib/modules/default/fs
  path[net]=/lib/modules/default/net
  path[scsi]=/lib/modules/default/scsi
  path[block]=/lib/modules/default/block
  path[cdrom]=/lib/modules/default/cdrom
  path[ipv4]=/lib/modules/default/ipv4
  path[ipv6]=/lib/modules/default/ipv6
  path[sound]=/lib/modules/default/sound
  path[fc4]=/lib/modules/default/fc4
  path[video]=/lib/modules/default/video
  path[misc]=/lib/modules/default/misc
  path[pcmcia]=/lib/modules/default/pcmcia
  path[atm]=/lib/modules/default/atm
  path[usb]=/lib/modules/default/usb
  path[ide]=/lib/modules/default/ide
  path[ieee1394]=/lib/modules/default/ieee1394

  path[fs]=/lib/modules/fs
  path[net]=/lib/modules/net
  path[scsi]=/lib/modules/scsi
  path[block]=/lib/modules/block
  path[cdrom]=/lib/modules/cdrom
  path[ipv4]=/lib/modules/ipv4
  path[ipv6]=/lib/modules/ipv6
  path[sound]=/lib/modules/sound
  path[fc4]=/lib/modules/fc4
  path[video]=/lib/modules/video
  path[misc]=/lib/modules/misc
  path[pcmcia]=/lib/modules/pcmcia
  path[atm]=/lib/modules/atm
  path[usb]=/lib/modules/usb
  path[ide]=/lib/modules/ide
  path[ieee1394]=/lib/modules/ieee1394
.PP
Van egy halom alaprtelmezett
.I alias
s
.I options
direktva is.
Mivel ezek kre folyamatosan bvl, ezt nem adjuk meg ezen a helyen.
A (jelenlegi) alaprtelmezsek a
.B "modprobe \-c"
paranccsal nzhetk meg egy res
.B /etc/modules.conf
fjl hasznlatval.
.PP
Minden
.I options
direktva megadja a modul szmra szksges opcikat, pl:
.nf

  modprobe de620 bnc=1

.fi
Ezek az opcik fellbrlhatk az
.B /etc/modules.conf
fjlban s a
.B modprobe
parancssorban.
.PP
Emlkezz, hogy lehetsges
.I options
direktvt megadni lnevek s valdi modulok szmra is.
Ez hasznos pl. a dummy modul esetben:
.nf

  alias dummy0 dummy
  options dummy0 \-o dummy0

.fi
.PP
.SH ALTERNATV KONFIGURCIS FJL
Trtneti okokbl, ha az /etc/modules.conf nem ltezik, akkor
a modutils a /etc/conf.modules -t hasznlja helyette.
Ennek a nvnek a hasznlata nem javasolt, a /etc/modules.conf -al
kell helyettesteni.
Ez a modutils verzi egy figyelmeztet zenetet r ki, ha /etc/conf.modules
ltezik, ksbbi verzik hibazenetet fognak kirni, s visszautastjk
a modulok betltst.
.SH LSD MG
depmod(8), modprobe(8), insmod(8)
.SH SZERZ
.nf
Bjorn Ekwall <bj0rn@blox.se>
Keith Owens <kaos@ocs.com.au>
.SH MAGYAR FORDTS
Bszrmnyi Zoltn <zboszor@mail.externet.hu>