Compile kernel module (Bosanski)

Related articles
Kernel (Bosanski)
Kernel modules
Nekad možda poželiš kompajlirati Linux
kernel modul
bez da rekompajliras cijeli kernel.
Note
Možeš zamijeniti postojeći modul samo ukoliko je kompajliran kao modul(M) i nije builtin (y) u kernel.
Build okruženje
Prvo moraš instalirati potrebne build dependency-e poput kompajlera(
base-devel
) i
linux-headers
.
Sljedeće moraš preuzeti source code kernela kojeg koristiš. Možeš pokušati noviji kernel nego što koristiš ali su velike šanse da se module neće loadati.
Pronađi kernel verziju sa
$ uname -r
Onda preuzmi potrebne source codove, vidi
Kernels/Traditional compilation#Download the kernel source
. Ukoliko skineš zadnji source koristeći
Git
, potrebno je checkout potrebnu verziju koristeći tag (npr. v4.1).
Source konfiguracija
Kada imaš source code, uđi u taj folder i clean ga sa (pobrisat će .config.old i promijeniti naziv .config u .config.old)
$ make mrproper
Zatim je potrebno kopirati .config trenutnog kernel u ovaj folder koristeći
$ cp /usr/lib/modules/$(uname -r)/build/.config ./
$ cp /usr/lib/modules/$(uname -r)/build/Module.symvers ./
Zatim, pobrini se da je konfiguracija podešena za kernel source-ove (ako koristiš kernel source za tačnu verziju, onda ne bi trebalo ništa da pita, ali noviji source-ovi nego trenutni kernel mogu pitati za nove opcije)
Također, ukoliko modul koji želiš da kompajliraš ima neke kompilacijske opcije poput debug build možeš ih podesiti sa bilo kojim alatom od make config/menuconfig/xconfig (vidi README)
$ make oldconfig
Kompajliranje module
Da bi se modul učitao propisno, morate naći tačnu verziju EXTRAVERSION komponente trenutne verzije kernela da biste mogli matchati tačne verzije u kernel source-u. EXTRAVERSION je variabla koja je smještena na vrhu Makefile, ali Makefile u vanilla kernelu će EXTRAVERSION biti prazna; podešena je u dijelu Arch kernel build procesa. Vrijednost EXTRAVERSION trenutnog kernela (obično
-1
) može se naći na jedan od dva načina:
Na vrhu
/usr/lib/modules/$(uname -r)/build/Makefile
fajla
Ukucaj
uname -r
i pogledaj između trećeg broja verzije i
-ARCH
(Arch specifično podešenje LOCALVERSION podešeno u .config fajlu). Npr, sa kernel verzijom
4.9.65-1-ARCH
, EXTRAVERSION je
-1
.
Nakon što je EXTRAVERSION poznat, pripremimo source za kompajlirano modula:
$ make EXTRAVERSION=<TVOJA EXTRAVERSION OVDJE> modules_prepare
Primjer:
$ make EXTRAVERSION=-1 modules_prepare
Alternativno, ako sretni da učitate module sa modprobe koristeći
--force-vermagic
opciju da se ignoriše nepoklapanje u verziji kernela, možete jednostavno pokrenuti:
$make modules_prepare
Note
Iako Makefile na
/usr/lib/modules/$(uname -r)/build/Makefile
se može kopirati preko Makefile u kernel source da se izbjegne manuelna specifikacija EXTRAVERSION na cli, to može prouzrokovati da se dogodi nepoklapanje kernel verzije. Ako je kernel source dobijen koristeći version control alat, poput git-a, jednostavno kopiranje Makefile-a bi učinilo da working kopija bude dirty, koji će kernel build proces prepoznati, te će appendati
+
u LOCALVERSION konfiguracijsku varijablue. Npr.
4.9.65-1-ARCH+
.
Na kraju, kompajlirajte željeni module time što navedete njegov folder. (Možete pronaći lokaciju modula koristeći modinfo ili find)
$ make M=fs/btrfs
out-of-tree kompajliranje module
preuzmi oficijalni source code trenutnog linux kernela kao što je opisano u
Kernel/Arch build system
:
$ cd && mkdir build
$ pkgctl repo clone linux
zatim usmjeri na checkirani source prilikom kompajliranja modula:
$ cd build/mymod
$ make -C ~/build/linux/src/archlinux-linux M=$PWD modules
Instaliranje module
Sada, nakon uspješnog kompajliranja module samo morate gzip i kopirati u svoj trenutni kernel.
Ukoliko zamjenjujete neki već postojeći module, morate ga prepisati (zapamtite da reinstaliranje
linux
će ga zamijeniti sa defaultnim modulom)
$ xz fs/btrfs/btrfs.ko
# cp -f fs/btrfs/btrfs.ko.xz /usr/lib/modules/$(uname -r)/kernel/fs/btrfs/
Alternativno, možete staviti update-ovani module u updates folder (kreirajte ga ukoliko ne postoji).
$ cp fs/btrfs/btrfs.ko.xz /usr/lib/modules/$(uname -r)/updates
Ako dodajete novi modul, možete ga samo kopirati u extramodules (note, ovo je samo primjer jer se btrfs neće loadati odavde)
# cp fs/btrfs/btrfs.ko.xz /usr/lib/modules/$(uname -r)/extramodules/
Ako kompajlirate module za rani boot (npr. updated modul) koji je kopirati u
Initramfs
onda morate regenerisati sa njim (u suprotnom, module se neće loadati). Dalje, ukoliko koristite "updates" folder metodu, možda ćete morati rebuildati modul dependency tree sa "depmod" prije regenerisanja
Initramfs
.
# mkinitcpio -p linux
mogući errori
Ako EXTRAVERSION nije ispravno podešena, sljedeći error se mogu pojaviti
# insmod mymod.ko
insmod: ERROR: could not insert module mymod.ko: Invalid module format
# modprobe mymod
modprobe: ERROR: could not insert 'mymod': Exec format error
dodavanje force-vermagic ignoriše mismatch verzije
modprobe mymod --force-vermagic
Vidi i
Linux Kernel Newbies
The Linux Kernel Module Programming Guide