Provided by: manpages-hu_20010119-5_all bug

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>