.\" Copyright (c) 1996 Free Software Foundation, Inc.
.\" This program is distributed according to the Gnu General Public License.
.\" See the file COPYING in the kernel source directory.
.\" $Id: insmod.8 1.7 Thu, 20 Apr 2000 14:31:49 +1000 kaos $
.\"
.TH INSMOD 8 "October 12 1999" Linux "Linux Module Support"
.SH NV
insmod \- betlthet kernel modult tlt be
.SH TTEKINTS
.B insmod
[\-fkmpqrsxXvyY] [\-P\ prefix] [\-o\ modul_nv]
objektum_fjl [\ symbol=value\ ...\ ]
.SH LERS
.B Insmod
Betlt egy betlthet kernelmodult a fut kernelbe.
.PP
Az
.B insmod
parancs megprbl hozzfzni egy modult a fut kernelhez gy, hogy
feloldja annak minden szimblumt a kernel exportlt szimblum-tblzatbl.
.PP
Ha az objektum fjl neve kiterjeszts nlkl adott, akkor az
.B insmod
parancs alaprtelmezett alknyvtrakban fogja keresni a modult.
A MODPATH krnyezeti vltoz hasznlhat ennek fellbrlsra.
Ha egy modul konfigurcis fjl (pl. /etc/modules.conf) ltezik,
akkor annak tartalma fogja fellbrlni a MODPATH-ban definilt
elrsi utakat.
.PP
A MODULECONF krnyezeti vltoz is hasznlhat arra, hogy
az alaprtelmezett /etc/modules.conf -tl (vagy /etc/conf.modules,
ez utbbi hasznlata nem javasolt) eltr konfigurcis fjlt
vlasszunk.
Ez a krnyezeti vltoz az sszes fenti defincit fellbrlja.
.SS OPCIK
.TP
.I \-f
Megprblja betlteni a modult akkor is, ha a fut kernel s
a modul kernelverzija nem egyezik meg.
.TP
.I \-k
Az automatikus trls kapcsolt lltja be a modulban. Ezt a
\fBkerneld\fP(8) hasznlja, hogy eltvoltsa az egy ideje nem
hasznlt modulokat \(em rendszerint egy perc eltelte utn.
.TP
.I \-m
Egy betltsi trkpet r ki, megknnytve a modul hibakeresst
egy kernelpnik esetn.
.TP
.I "\-o \fRmodule_name"
Expliciten megnevezi a modult ahelyett, hogy az objektum fjl
nevbl szrmaztatn.
.TP
.I \-p
Teszteli a modult, hogy sikeresen be lehetne-e tlteni. Ebbe
belertend az objektum megkeresse a modul-tvonalon, a
verziszm ellenrzse s a szimblumok feloldsa.
.TP
.I \-q
Nem rja ki a feloldhatatlan szimblumok listjt.
Nem panaszkodik verzieltrsrl.
A problmt csak az insmod visszatrsi rtke jelzi.
.TP
.I \-r
Egyes felhasznlk nem root azonostval fordtjk a modulokat,
majd root-knt installljk azokat. Ezen mvelet utn a modulok
tulajdonosa egy nem root felhasznl lesz, mg ha a modulokat
tartalmaz knyvtr root tulajdon is. Ha ezt a nem root azonostt
feltrik, a behatol fellrhatja az ltala tulajdonolt ltez
modulokat, s ezt felhasznlhatja root jog szerzsre.
.TP
.I ""
Alaprtelmezs szerint a modutils programok visszautastjk olyan
modulok hasznlatt, amelyeknek nem root a tulajdonosa. A -r
megadsa ezt a hibt elnyomja, s megengedi a root-nak, hogy nem
root tulajdonos modulokat tltsn be.
.TP
.I ""
.B A
.I -r
.B hasznlata komoly biztonsgi problma, s nem ajnlott.
.TP
.I \-s
A terminl helyett mindent a \fBsyslog\fP(3)-ba r.
.TP
.I \-v
Bbeszdbb lesz.
.TP
.I "\-X, -x"
Exportld (-X), illetve ne exportld a modul kls szimblumait.
Alaprtelmezs szerint a szimblumokat exportlja. Ez az opci
csak akkor hatsos, ha maga a modul nem exportlja explicite a
sajt szimblumtbljt, gy ez egy ritkbban hasznlt opci.
.TP
.I "\-Y, -y"
Hozzadja, illetve nem adja hozz a ksymoops szimblumokat a ksyms-hez.
Ezeket a szimblomukat a ksymoops program hasznlja, jobb hibakeresst
lehetv tve, ha egy Oops trtnik a modulban. Alaprtelmezs szerint
a ksymoops szimblumok definildnak. Ez az opci fggetlen a -X/-x
opciktl.
.TP
.I ""
A ksymoops szimblumok kb. 260 byte-al nvelik a betlttt modult.
Hasznld inkbb az alaprtelmezst s a pontosabb Oops hibakeress
lehetsgt, kivve ha tnyleg kevs a kernelmemria s a ksyms-t
prblod a minimlis mretre sszehzni.
.TP
.I "\-P prefix"
Ez az opcit hasznlhat verzival elltott modulokhoz SMP vagy
bigmem kernelek mell, mivel az ilyen modulok egy extra prefixet
tartalmaznak a szimblumaik nevben.
Ha a kernel szimblum verzival volt fordtva, akkor az insmod
automatikusan felderti ezt a prefixet a "get_module_symbol"
defincijbl, ami minden olyan kernelben ltezik, amelyik
modulokat tmogat. Ha a kernelben nincs modul verzi, de a
modul szimblum verzival volt fordtva, akkor a felhasznlnak
meg kell adnia a \-P opcit.
.SS "MODUL PARAMTEREK"
Nhny modul elfogad betltskor paramtereket, melyekkel testreszabhat
a mkdsk. Ezek a paramterek gyakran I/O cmek s IRQ szmok, amelyek
gprl-gpre vltoznak, s nem lehet a hardverbl megllaptani.
.PP
A 2.0-s sorozat kernelekhez fordtott moduloknl brmilyen egsz
vagy karakteres mutat szimblum kezelhet paramterknt s mdosthat.
A 2.1-es kernelektl kezdve a paramter szimblumok expliciten meg vannak
jellve. Tovbb tpusinformcit is tartalmaznak az rtk ellenrzshez
betltskor.
.PP
Egsz tpus esetn minden rtk lehet decimlis, oktlis vagy
hexadecimlis, pl.: 17, 021 vagy 0x11. A tmbelemeket vesszvel
elvlasztott sorozattal adhatjuk meg; egyes elemek kihagyhatk
az rtk meg nem adsval.
.PP
A 2.0-s sorozat modulokban azok az rtkek, amelyek nem szmjeggyel
kezddnek, karakterlncnak tekintendek. 2.1-tl kezdve a paramter
tpusa hatrozza meg azt, hogy az rtket karakterlncknt rtelmezze-e.
Ha az rtk macskakrmmel (\fI"\fP) kezddik, akkor az rtk a C nyelv
szerint lesz rtelmezve, escape-szekvencikkal, stb. Figyelembe
kell venni, hogy hj (shell prompt) rtelmezi a macskakrmt, ezrt
"meg kell vdeni".
.SS "KSYMOOPS TMOGATS"
Modulok hasznlata esetn a kernel Oops hibakeressnek megknnytsre
az insmod alaprtelmezsknt hozzad nhny szimblumot a ksyms-hez,
lsd a \fB-Y\fP opcit. Ezek a szimblumok
"\fB__insmod_\fP\fImodulename\fP\fB_\fP"-el kezddnek. A \fImodulename\fP
szksges ahhoz, hogy egyedileg azonostsuk a szimblumokat, s
lehetsges ugyanazt az objektumfjlt tbbszr ms nven betlteni.
A jelenleg definilt szimblumok
.PP
__insmod_\fImodulename\fP_O\fIobjectfile\fP_M\fImtime\fP_V\fIversion\fP
.PP
Az \fIobjectfile\fP a fjl neve, amelybl az objektum betltdtt.
Ez biztostja, hogy a ksymoops egyeztetni tudja a kdot a megfelel
objektummal. \fImtime\fP annak a fjlnak az utols mdosts ideje
hexadecimlis rtkben, 0 ha a stat() hibt jelzett.
\fIversion\fP a kernel verzija, amelyhez a modult fordtottk, -1
ha nem nincs verziszm. A _O szimblumnak ugyanaz a kezdcme,
mint a modul fejlcnek.
.PP
__insmod_\fImodulename\fP_S\fIsectionname\fP_L\fIlength\fP
.PP
Ez a szimblum a kivlasztott ELF szekcik elejn jelenik meg,
amelyek jelenleg .text, .rodata, .data s .bss. Csak akkor
jelenik meg, ha az adott szekcinak nullnl nagyobb a mrete.
\fIsectionname\fP az ELF szekci neve, \fIlength\fP a szekci
hossza decimlisan. Ezek a szimblumok segtik a ksymoops-ot
olyan szekcik feltrkpezsben, ahol nincsenek hozzfrhet
szimblumok.
.PP
A kernel Oops hibakeress msik problmja, hogy a /proc/ksyms s
a /proc/modules tartalma vltozhat az Oops s a hiba logjnak
feldolgozsa kztt. Ennek thidalsra, ha ltezik a /var/log/ksymoops
knyvtr, akkor insmod s rmmod automatikusan tmsolja a /proc/ksyms
s /proc/modules fljokat a /var/log/ksymoops knyvtrba a
`date\ +%Y%m%d%H%M%S` prefix-szel.
A rendszer adminisztrtor megmondhatja a ksymoops-nak, hogy melyik
"pillanatfelvtelt" hasznlja amikor egy Oops-t debuggol. Nincs olyan
opci, ami letiltan ezt az automatikus tmsolst, ha nem akarjuk,
hogy megtrtnjen, akkor ne hozzuk ltre a /var/log/ksymoops knyvtrat.
Ha a knyvtr ltezik, akkor a tulajdonosa root, s a joga 644 vagy 600
kell hogy legyen, s az albbi script naponta futtatand. A script
insmod_clean_ksymoops nven tallhat meg.
.PP
.ne 8
.nf
  #!/bin/sh
  # Trli a 2 napnl rgebbi ksyms s modules mentseket.
  if [ -d /var/log/ksymoops ]
  then
	  set -e
	  # Biztostjuk, hogy mindig van legalbb egy verzi
	  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
.SH LSD MG
\fBrmmod\fP(8), \fBmodprobe\fP(8), \fBdepmod\fP(8), \fBlsmod\fP(8),
\fBksyms\fP(8), \fBmodules\fP(2), \fBgenksyms\fP(8), \fBkerneld\fP(8),
\fBksymoops\fP(kernel).
.SH TRTNELEM
A modul tmogatst elszr Anonymous ksztette el.
.br
A kezdeti Linux vltozat: Bas Laarhoven <bas@vimec.nl>
.br
A 0.99.14-es verzi: Jon Tombs <jon@gtex02.us.es>
.br
Kibvtette: Bjorn Ekwall <bj0rn@blox.se>
.br
Az eredeti ELF tmogats: Eric Youngdale <eric@aib.com>
.br
jrarta a 2.1.17-es kernelhez Richard Henderson <rth@tamu.edu>
.br
Bvts a modutils-2.2.*-hez: Bjorn Ekwall <bj0rn@blox.se>, 1999 mrciusa
.br
Ksymoops tmogats: Keith Owens <kaos@ocs.com.au>, 1999 mjusa
.SH MAGYAR FORDTS
Bszrmnyi Zoltn <zboszor@mail.externet.hu>
.br
Narancs v1 <narancs1@externet.hu>