Provided by:
manpages-hu_20010119-5_all 
N'EV
insmod - betolthet kernel modult tolt be
'ATTEKINT'ES
insmod [-fkmpqrsxXvyY] [-P prefix] [-o modul_nev] objektum_fajl
[ symbol=value ... ]
LE'IR'AS
Insmod Betolt egy betolthet kernelmodult a futo kernelbe.
Az insmod parancs megprobal hozzafzni egy modult a futo kernelhez ugy,
hogy feloldja annak minden szimbolumat a kernel exportalt szimbolum-
tablazatabol.
Ha az objektum fajl neve kiterjesztes nelkul adott, akkor az insmod
parancs alapertelmezett alkonyvtarakban fogja keresni a modult. A
MODPATH kornyezeti valtozo hasznalhato ennek felulbiralasara. Ha egy
modul konfiguracios fajl (pl. /etc/modules.conf) letezik, akkor annak
tartalma fogja felulbiralni a MODPATH-ban definialt eleresi utakat.
A MODULECONF kornyezeti valtozo is hasznalhato arra, hogy az
alapertelmezett /etc/modules.conf -tol (vagy /etc/conf.modules, ez
utobbi hasznalata nem javasolt) elter konfiguracios fajlt valasszunk.
Ez a kornyezeti valtozo az osszes fenti definiciot felulbiralja.
OPCI'OK
-f Megprobalja betolteni a modult akkor is, ha a futo kernel es a
modul kernelverzioja nem egyezik meg.
-k Az automatikus torles kapcsolot allitja be a modulban. Ezt a
kerneld(8) hasznalja, hogy eltavolitsa az egy ideje nem hasznalt
modulokat -- rendszerint egy perc eltelte utan.
-m Egy betoltesi terkepet ir ki, megkonnyitve a modul hibakereseset
egy kernelpanik eseten.
-o module_name
Expliciten megnevezi a modult ahelyett, hogy az objektum fajl
nevebl szarmaztatna.
-p Teszteli a modult, hogy sikeresen be lehetne-e tolteni. Ebbe
beleertend az objektum megkeresese a modul-utvonalon, a
verzioszam ellenrzese es a szimbolumok feloldasa.
-q Nem irja ki a feloldhatatlan szimbolumok listajat. Nem
panaszkodik verzioelteresrl. A problemat csak az insmod
visszateresi erteke jelzi.
-r Egyes felhasznalok nem root azonositoval forditjak a modulokat,
majd root-kent installaljak azokat. Ezen mvelet utan a modulok
tulajdonosa egy nem root felhasznalo lesz, meg ha a modulokat
tartalmazo konyvtar root tulajdonu is. Ha ezt a nem root
azonositot feltorik, a behatolo felulirhatja az altala
tulajdonolt letez modulokat, es ezt felhasznalhatja root jog
szerzesere.
Alapertelmezes szerint a modutils programok visszautasitjak
olyan modulok hasznalatat, amelyeknek nem root a tulajdonosa. A
-r megadasa ezt a hibat elnyomja, es megengedi a root-nak, hogy
nem root tulajdonosu modulokat toltson be.
A -r haszn'alata komoly biztons'agi probl'ema, 'es nem aj'anlott.
-s A terminal helyett mindent a syslog(3)-ba ir.
-v Bbeszedbb lesz.
-X, -x Exportald (-X), illetve ne exportald a modul kuls szimbolumait.
Alapertelmezes szerint a szimbolumokat exportalja. Ez az opcio
csak akkor hatasos, ha maga a modul nem exportalja explicite a
sajat szimbolumtablajat, igy ez egy ritkabban hasznalt opcio.
-Y, -y Hozzaadja, illetve nem adja hozza a ksymoops szimbolumokat a
ksyms-hez. Ezeket a szimbolomukat a ksymoops program hasznalja,
jobb hibakeresest lehetve teve, ha egy Oops tortenik a modulban.
Alapertelmezes szerint a ksymoops szimbolumok definialodnak. Ez
az opcio fuggetlen a -X/-x opcioktol.
A ksymoops szimbolumok kb. 260 byte-al novelik a betoltott
modult. Hasznald inkabb az alapertelmezest es a pontosabb Oops
hibakereses lehetseget, kiveve ha tenyleg keves a kernelmemoria
es a ksyms-t probalod a minimalis meretere osszehuzni.
-P prefix
Ez az opciot hasznalhato verzioval ellatott modulokhoz SMP vagy
bigmem kernelek melle, mivel az ilyen modulok egy extra prefixet
tartalmaznak a szimbolumaik neveben. Ha a kernel szimbolum
verzioval volt forditva, akkor az insmod automatikusan felderiti
ezt a prefixet a "get_module_symbol" definiciojabol, ami minden
olyan kernelben letezik, amelyik modulokat tamogat. Ha a
kernelben nincs modul verzio, de a modul szimbolum verzioval
volt forditva, akkor a felhasznalonak meg kell adnia a -P
opciot.
MODUL PARAM'ETEREK
Nehany modul elfogad betolteskor parametereket, melyekkel
testreszabhato a mkodesuk. Ezek a parameterek gyakran I/O cimek es IRQ
szamok, amelyek geprol-gepre valtoznak, es nem lehet a hardverbl
megallapitani.
A 2.0-as sorozatu kernelekhez forditott moduloknal barmilyen egesz vagy
karakteres mutato szimbolum kezelhet parameterkent es modosithato. A
2.1-es kernelektol kezdve a parameter szimbolumok expliciten meg vannak
jelolve. Tovabba tipusinformaciot is tartalmaznak az ertek
ellenrzesehez betolteskor.
Egesz tipus eseten minden ertek lehet decimalis, oktalis vagy
hexadecimalis, pl.: 17, 021 vagy 0x11. A tombelemeket vesszvel
elvalasztott sorozattal adhatjuk meg; egyes elemek kihagyhatok az ertek
meg nem adasaval.
A 2.0-as sorozatu modulokban azok az ertekek, amelyek nem szamjeggyel
kezddnek, karakterlancnak tekintendek. 2.1-tl kezdve a parameter tipusa
hatarozza meg azt, hogy az erteket karakterlanckent ertelmezze-e. Ha
az ertek macskakorommel (") kezddik, akkor az ertek a C nyelv szerint
lesz ertelmezve, escape-szekvenciakkal, stb. Figyelembe kell venni,
hogy hej (shell prompt) ertelmezi a macskakormot, ezert "meg kell
vedeni".
KSYMOOPS T'AMOGAT'AS
Modulok hasznalata eseten a kernel Oops hibakeresesenek megkonnyitesere
az insmod alapertelmezeskent hozzaad nehany szimbolumot a ksyms-hez,
lasd a -Y opciot. Ezek a szimbolumok "__insmod_modulename_"-el
kezddnek. A modulename szukseges ahhoz, hogy egyedileg azonositsuk a
szimbolumokat, es lehetseges ugyanazt az objektumfajlt tobbszor mas
neven betolteni. A jelenleg definialt szimbolumok
__insmod_modulename_Oobjectfile_Mmtime_Vversion
Az objectfile a fajl neve, amelybl az objektum betoltdott. Ez
biztositja, hogy a ksymoops egyeztetni tudja a kodot a megfelel
objektummal. mtime annak a fajlnak az utolso modositas ideje
hexadecimalis ertekben, 0 ha a stat() hibat jelzett. version a kernel
verzioja, amelyhez a modult forditottak, -1 ha nem nincs verzioszam. A
_O szimbolumnak ugyanaz a kezdcime, mint a modul fejlecenek.
__insmod_modulename_Ssectionname_Llength
Ez a szimbolum a kivalasztott ELF szekciok elejen jelenik meg, amelyek
jelenleg .text, .rodata, .data es .bss. Csak akkor jelenik meg, ha az
adott szekcionak nullanal nagyobb a merete. sectionname az ELF szekcio
neve, length a szekcio hossza decimalisan. Ezek a szimbolumok segitik a
ksymoops-ot olyan szekciok felterkepezeseben, ahol nincsenek
hozzaferhet szimbolumok.
A kernel Oops hibakereses masik problemaja, hogy a /proc/ksyms es a
/proc/modules tartalma valtozhat az Oops es a hiba logjanak
feldolgozasa kozott. Ennek athidalasara, ha letezik a /var/log/ksymoops
konyvtar, akkor insmod es rmmod automatikusan atmasolja a /proc/ksyms
es /proc/modules faljokat a /var/log/ksymoops konyvtarba a
`date +%Y%m%d%H%M%S` prefix-szel. A rendszer adminisztrator
megmondhatja a ksymoops-nak, hogy melyik "pillanatfelvetelt" hasznalja
amikor egy Oops-t debuggol. Nincs olyan opcio, ami letiltana ezt az
automatikus atmasolast, ha nem akarjuk, hogy megtortenjen, akkor ne
hozzuk letre a /var/log/ksymoops konyvtarat. Ha a konyvtar letezik,
akkor a tulajdonosa root, es a joga 644 vagy 600 kell hogy legyen, es
az alabbi script naponta futtatando. A script insmod_clean_ksymoops
neven talalhato meg.
#!/bin/sh
# Torli a 2 napnal regebbi ksyms es modules menteseket.
if [ -d /var/log/ksymoops ]
then
set -e
# Biztositjuk, hogy mindig van legalabb egy verzio
d=`date +%Y%m%d%H%M%S`
cp -a /proc/ksyms /var/log/ksymoops/${d}.ksyms
cp -a /proc/modules /var/log/ksymoops/${d}.modules
find /var/log/ksymoops -type f -atime +2 -exec rm {} \;
fi
L'ASD M'EG
rmmod(8), modprobe(8), depmod(8), lsmod(8), ksyms(8), modules(2),
genksyms(8), kerneld(8), ksymoops(kernel).
T"ORT'ENELEM
A modul tamogatast elszor Anonymous keszitette el.
A kezdeti Linux valtozat: Bas Laarhoven <bas@vimec.nl>
A 0.99.14-es verzio: Jon Tombs <jon@gtex02.us.es>
Kibvitette: Bjorn Ekwall <bj0rn@blox.se>
Az eredeti ELF tamogatas: Eric Youngdale <eric@aib.com>
Ujrairta a 2.1.17-es kernelhez Richard Henderson <rth@tamu.edu>
Bvites a modutils-2.2.*-hez: Bjorn Ekwall <bj0rn@blox.se>, 1999
marciusa
Ksymoops tamogatas: Keith Owens <kaos@ocs.com.au>, 1999 majusa
MAGYAR FORD'IT'AS
Boszormenyi Zoltan <zboszor@mail.externet.hu>
Narancs v1 <narancs1@externet.hu>