Installation¶

Die Programme zum Umgang mit den Modulen sind grundsätzlich in der Standardinstallation enthalten, können aber ansonsten über die Pakete

• kmod

mit apturl

sudo apt-get install kmod 

sudo aptitude install kmod 

bzw. bis einschließlich Precise:

• module-init-tools

mit apturl

sudo apt-get install module-init-tools 

sudo aptitude install module-init-tools 

installiert werden ^[1].

Installiert man in neueren Ubuntu Versionen module-init-tools, so wird kmod als Abhängigkeit vorausgesetzt. Daraus folgt, kmod ist zwar das neuere Werkzeug, arbeitet aber auch unter module-init-tools. Grundsätzlich kann aber das Werkzeug module-init-tools bei Nutzung von kmod entfernt werden.

Befehle für Module¶

Im Folgenden werden einige wichtige Befehle für den Umgang mit Modulen kurz vorgestellt. Alle Befehle werden im Terminal ^[2] aufgerufen. Das Laden, Entladen sowie Erstellen von Abhängigkeiten erfordert Root-Rechte!

kmod list 

lsmod 

Module                  Size  Used by
btrfs                 835954  0 
raid6_pq               97812  1 btrfs
xor                    21411  1 btrfs
ufs                    74890  0 
qnx4                   13317  0 
hfsplus               107516  0 
hfs                    54677  0 
minix                  36140  0 
ntfs                   97369  0 
msdos                  17332  0 
jfs                   181348  0 
xfs                   912173  0 
libcrc32c              12644  2 xfs,btrfs
nls_iso8859_1          12713  0 
usb_storage            62209  0 
pci_stub               12622  1 
vboxpci                23194  0 
vboxnetadp             25670  0 
vboxnetflt             27613  0 
vboxdrv               409768  3 vboxnetadp,vboxnetflt,vboxpci
bnep                   19624  2 
rfcomm                 69160  0 
bluetooth             391196  10 bnep,rfcomm
joydev                 17381  0 
fglrx                8085343  587 
kvm_amd                59987  0 
snd_hda_codec_hdmi     46254  1 
kvm                   451511  1 kvm_amd
snd_hda_codec_realtek    61438  1 
snd_hda_intel          52355  9 
edac_core              62291  0 
snd_hda_codec         192906  3 snd_hda_codec_realtek,snd_hda_codec_hdmi,snd_hda_intel
snd_seq_midi           13324  0 
k10temp                13126  0 
serio_raw              13462  0 
snd_seq_midi_event     14899  1 snd_seq_midi
snd_hwdep              13602  1 snd_hda_codec
snd_rawmidi            30144  1 snd_seq_midi
edac_mce_amd           22617  0 
snd_pcm               102099  3 snd_hda_codec_hdmi,snd_hda_codec,snd_hda_intel
snd_page_alloc         18710  2 snd_pcm,snd_hda_intel
sp5100_tco             13979  0 
snd_seq                61560  2 snd_seq_midi_event,snd_seq_midi
i2c_piix4              22155  0 
snd_seq_device         14497  3 snd_seq,snd_rawmidi,snd_seq_midi
snd_timer              29482  2 snd_pcm,snd_seq
amd_iommu_v2           19054  1 fglrx
wmi                    19177  0 
snd                    69238  29 snd_hda_codec_realtek,snd_hwdep,snd_timer,snd_hda_codec_hdmi,snd_pcm,snd_seq,snd_rawmidi,snd_hda_codec,snd_hda_intel,snd_seq_device,snd_seq_midi
mac_hid                13205  0 
soundcore              12680  1 snd
parport_pc             32701  0 
ppdev                  17671  0 
it87                   43113  0 
hwmon_vid              12783  1 it87
lp                     17759  0 
parport                42348  3 lp,ppdev,parport_pc
pata_acpi              13038  0 
hid_generic            12548  0 
usbhid                 52570  0 
hid                   106148  2 hid_generic,usbhid
psmouse               106678  0 
pata_atiixp            13271  0 
r8169                  67581  0 
ahci                   25819  6 
mii                    13934  1 r8169
libahci                32560  1 ahci

modinfo MODULNAME 

modinfo snd 

filename:       /lib/modules/2.6.20-15-generic/kernel/sound/core/snd.ko
alias:          char-major-116-*
license:        GPL
description:    Advanced Linux Sound Architecture driver for soundcards.
author:         Jaroslav Kysela <perex@suse.cz>
srcversion:     3BE4E61EB0303AD5846B8A6
depends:        soundcore
vermagic:       2.6.20-15-generic SMP mod_unload 586
parm:           major:Major # for sound driver. (int)
parm:           cards_limit:Count of auto-loadable soundcards. (int)

sudo modprobe OPTIONEN MODULNAME(N) 

sudo insmod MODULNAME 

sudo rmmod OPTIONEN MODULNAME 

sudo depmod OPTIONEN 

Module automatisch laden¶

Möchte man ein Modul, welches der Kernel nicht automatisch mit lädt, beim Systemstart automatisch laden, so trägt man den Modulnamen einfach in die Datei /etc/modules ein. Dazu öffnet man diese Datei mit einem Editor mit Root-Rechten ^[3] und macht die entsprechenden Einträge, wobei pro Zeile nur ein Modulname eingetragen werden darf. Ab dem nächsten Systemstart werden alle Module (zusätzlich) geladen, die dort eingetragen sind.

Module mit Optionen laden¶

Mögliche Optionen eines bestimmten Moduls abfragen:

modinfo -p MODULNAME
modinfo MODULNAME -F parm
modinfo MODULNAME | grep parm 

Siehe auch grep

Beispielausgabe beim Modul iwlwifi:

swcrypto:using crypto in software (default 0 [hardware]) (int)
11n_disable:disable 11n functionality, bitmap: 1: full, 2: disable agg TX, 4: disable agg RX, 8 enable agg TX (uint)
amsdu_size:amsdu size 0: 12K for multi Rx queue devices, 4K for other devices 1:4K 2:8K 3:12K (default 0) (int)
fw_restart:restart firmware in case of error (default true) (bool)
antenna_coupling:specify antenna coupling in dB (default: 0 dB) (int)
nvm_file:NVM file name (charp)
d0i3_disable:disable d0i3 functionality (default: Y) (bool)
lar_disable:disable LAR functionality (default: N) (bool)
uapsd_disable:disable U-APSD functionality bitmap 1: BSS 2: P2P Client (default: 3) (uint)
bt_coex_active:enable wifi/bt co-exist (default: enable) (bool)
led_mode:0=system default, 1=On(RF On)/Off(RF Off), 2=blinking, 3=Off (default: 0) (int)
power_save:enable WiFi power management (default: disable) (bool)
power_level:default power save level (range from 1 - 5, default: 1) (int)
fw_monitor:firmware monitor - to debug FW (default: false - needs lots of memory) (bool)
d0i3_timeout:Timeout to D0i3 entry when idle (ms) (uint)
disable_11ac:Disable VHT capabilities (default: false) (bool)

Mögliche Werte und Konstanten:

Oft werden die erlaubten Werte mit angegeben. Entsprechende Optionen können vorab getestet werden. Beim Laden des Moduls werden entsprechende Hinweise oder auch Fehler ausgegeben.

Beispiel:

# richtig
sudo modprobe -v iwlwifi bt_coex_active=1
# fehlerhafter Vorgabewert
sudo modprobe -v iwlwifi bt_coex_active=2 

Die dazu passenden Ausgaben lautet:

# richtig
insmod /lib/modules/4.10.0-42-generic/kernel/drivers/net/wireless/intel/iwlwifi/iwlwifi.ko bt_coex_active=1
# fehlerhaft
modprobe: ERROR: could not insert 'iwlwifi': Invalid argument

Soll ein Modul immer mit einer bestimmten Option geladen werden, kann dies über eine entsprechenden Konfigurationsdatei in /etc/modprobe.d festgelegt werden. Diese Datei existiert nicht standardmäßig - wenn sie gebraucht wird, muss sie mit Root-Rechten ^[3] angelegt werden. Es gibt nur einen Eintrag pro Zeile. Um eine Option zu setzen, beginnt man mit einem options:

options modulname_1 option1=XX
options modulname_2 option2=YY

Mehrere Moduloptionen setzen:

options modulname option1=XX option2=XX option3=XX

Beispiel:

options iwlwifi 11n_disable=1 fw_restart=1

Die benötigte Datei /etc/modprobe.d/MODULNAME_options.conf einschließlich der Optionseinträge für ein bestimmtes Kernelmodul kann sehr einfach durch eine einzige Befehlszeile im Terminal ^[2] angelegt werden.

Über einen kombinierten Shell-Befehl wird die Datei mit entsprechendem Inhalt erzeugt:

echo "options MODULNAME option1=XX option2=XX" | sudo tee /etc/modprobe.d/MODULNAME_options.conf 

Siehe auch Shell/Umleitungen

Beispiel:

echo "options iwlwifi 11n_disable=1 fw_restart=1" | sudo tee /etc/modprobe.d/iwlwifi_options.conf 

Die Optionen werden nach einem Systemneustart oder manuellem entladen und erneutem laden des Moduls übernommen.

Automatisches Laden verhindern - Blacklisting¶

Unter bestimmten Umständen kann es sinnvoll sein, das Laden von bestimmten Modulen explizit zu verbieten. Dies geschieht durch den Eintrag des entsprechenden Moduls in eine so genannte Blacklist-Datei. Diese Dateien befinden sich im Verzeichnis /etc/modprobe.d. In der Regel sind schon einige Einträge in der /etc/modprobe.d/blacklist.conf zu finden.

Die Datei legt man mit einem Editor mit Root-Rechten an ^[3] (bzw. öffnet eine vorhandene Datei) und fügt einen Dateieintrag nach folgendem Schema hinzu, je ein Eintrag pro Zeile:

blacklist modulname_1
blacklist modulname_2

Die Sperrlisten haben üblicherweise den Namen blacklist-Modulname.conf, d.h. der Dateiname kann frei gewählt werden, sollte aber mit dem Präfix blacklist- beginnen um direkt über die Funktion zu informieren. Darüber hinaus existiert auch eine "allgemeine" Datei, die nur den Namen blacklist.conf trägt. Diese Datei sollte man allerdings nicht komplett überschreiben, sondern bei Bedarf weitere Einträge anhängen.

Auch hier kann dies über einen kombinierten Shell-Befehl in einem Zug durchgeführt werden:

Eintrag an bestehende Sperrliste /etc/modprobe.d/blacklist.conf anhängen:

echo "blacklist prism54" | sudo tee -a /etc/modprobe.d/blacklist.conf 

Neue Sperrliste anlegen bzw. bestehende überschreiben:

echo "blacklist prism54" | sudo tee /etc/modprobe.d/blacklist_prism54.conf 

Siehe auch Shell/Umleitungen

Sollte ein benötigtes Modul nicht automatisch bei Systemstart geladen werden, so kann dies an einem entsprechenden Sperreintrag liegen. Bestehende Sperrlisten nach einem Eintrag mittels grep durchsuchen:

grep -i MODULNAME /etc/modprobe.d/* 

Beispiel:

grep -i prism54 /etc/modprobe.d/* 

Entsprechende Einträge wie oben gezeigt mittels grep suchen und über sed auskommentieren, Modul also wieder entsperren:

sudo sed -i "s/blacklist MODULNAME/#blacklist MODULNAME/g" $(egrep -lo 'blacklist MODULNAME' /etc/modprobe.d/*) 

Beispiel:

sudo sed -i "s/blacklist prism54/#blacklist prism54/g" $(egrep -lo 'blacklist prism54' /etc/modprobe.d/*) 

Übersicht über alle Module¶

Wer wissen möchte, welche Module auf dem eigenen Rechner verfügbar (nicht geladen!) sind, der kann sich mit dem Befehl ^[2]

basename -s ".ko" $(find /lib/modules/$(uname -r) -type f -name "*.ko") 

eine komplette Liste anzeigen lassen. Allerdings ist die Liste extrem lang (der Kernel bringt mehrere hundert Module mit...), daher ist es eventuell günstiger, die Modulverzeichnisse mit einem Dateimanager zu durchforsten. Die Module liegen alle in den Unterverzeichnissen von /lib/modules/KERNELVERSION/kernel/

Links¶

• Module-Assistant - Module nachträglich erstellen und installieren

• DKMS - Module automatisch aktualisieren