Kernel module (Español)
Los módulos del núcleo (también conocido por su nombre inglés, kernel) son fragmentos de código que pueden ser cargados y eliminados del núcleo bajo demanda. Extienden la funcionalidad del núcleo sin necesidad de reiniciar el sistema.
Descripción
Para conocer cómo crear un módulo del núcleo, puede leer esta guía. Un módulo puede ser configurado para ser compilable (incluso en el núcleo) o cargable (se puede cargar bajo demanda). Para cargar o eliminar dinámicamente un módulo, tiene que estar configurado como un módulo cargable en la configuración del núcleo (la línea relacionada con el módulo, por lo tanto, se mostrará con la letra M).
Los módulos se almacenan en /lib/modules/nombre_del_kernel. Use la orden uname -r para obtener su versión actual del núcleo.
_) o guiones (-), sin embargo, esos símbolos son intercambiables, tanto cuando se utiliza la orden modprobe como en los archivos de configuración del directorio /etc/modprobe.d/.Obtener información
Para mostrar los módulos del núcleo cargados actualmente:
$ lsmod
Para mostrar información sobre un módulo:
$ modinfo nombre_del_módulo
Para listar las opciones que se establecen para un módulo cargado:
$ systool -v -m nombre_del_módulo
Para mostrar la configuración completa de todos los módulos:
$ modprobe -c | less
Para mostrar la configuración de un módulo en particular:
$ modprobe -c | grep nombre_del_módulo
Listar las dependencias de un módulo (o alias), incluido el propio módulo:
$ modprobe --show-depends nombre_del_módulo
Configuración
Hoy en día, todos los módulos que necesitan ser cargados, son manejados automáticamente por udev, por lo que si no quiere/necesita utilizar ningún módulo ajeno al núcleo, no hay necesidad de ponerlos en algún archivo de configuración para que se carguen en el arranque. Sin embargo, hay casos en que es posible que desee cargar un módulo específico adicional durante el proceso de arranque, o crear una lista negra de módulos (los cuales no se cargarán) para que el equipo funcione correctamente.
Cargar módulos
Los módulos adicionales del kernel pueden ser cargados durante el arranque configurándolos como una lista estática en los archivos residentes en /etc/modules-load.d/. Cada archivo de configuración es nombrado siguiendo el formato: /etc/modules-load.d/<programa>.conf. Los archivos de configuración contienen simplemente una lista de los nombres de los módulos del núcleo a cargar, separadas por saltos de líneas. Las líneas vacías y las líneas cuyo primer carácter sea # o ; serán ignoradas.
/etc/modules-load.d/virtio-net.conf
# Carga virtio-net.ko al arranque virtio-net
Consulte modules-load.d(5) para obtener más información.
Configurar opciones de los módulos
Para pasar un parámetro a un módulo puede usar un archivo de configuración en la carpeta modprobe o utilizar la línea de órdenes del núcleo.
Usar archivos en /etc/modprobe.d/
El directorio /etc/modprobe.d/ se puede utilizar para pasar la configuración de los módulos a udev, el cual utilizará modprobe para manejar la carga de los módulos durante el arranque del sistema. Puede crear un archivo de configuración con cualquier nombre en aquel directorio, siempre que acaben con la extensión .conf. La sintaxis es la siguiente:
/etc/modprobe.d/miarchivo.conf
options nombredelmódulo nombredelparámetro=valordelparámetro
Por ejemplo:
/etc/modprobe.d/thinkfan.conf
# Thinkpads on, ésto permite que el demonio thinkfan controle la velocidad del ventilador options thinkpad_acpi fan_control=1
.conf a FILES en mkinitcpio.conf, o usar el hook modconf, para que se incluya en el ramdisk.Usar la línea de órdenes de arranque del núcleo
Si el módulo está integrado en el núcleo también puede pasar opciones al módulo a través de la línea de órdenes. Para todos los cargadores de arranque (bootloader) más comunes la sintaxis correcta es:
nombredelmódulo.nombredelparámetro=valordelparámetro
por ejemplo:
thinkpad_acpi.fan_control=1
Simplemente añada esto a la línea de órdenes del núcleo de su gestor de arranque como se describe en parámetros del núcleo.
Alias
Los alias son nombres alternativos para un módulo. Por ejemplo: alias mi-mod nombre_de_módulo_muy_largo significa que puede utilizar modprobe mi-mod en lugar de modprobe nombre_de_módulo_muy_largo. También puede utilizar comodines del estilo shell, por lo que alias mi-mod* nombre_de_módulo_muy_largo significa que modprobe mi-mod-cualquier-cosa tiene el mismo efecto. Crear un alias:
/etc/modprobe.d/mialias.conf
alias mimod nombre_de_módulo_muy_largo
Algunos módulos tienen alias que se utilizan para su carga automática cuando son solicitados por una aplicación. La desactivación de estos alias evitará que se cargue automáticamente, pero permitirá que se puedan cargar manualmente. Ejemplo:
/etc/modprobe.d/modprobe.conf
# Evita cargar automáticamente el módulo necesario para bluetooth alias net-pf-31 off
Lista negra
Incluir en la lista negra («blacklisting»), en el contexto de los módulos del núcleo, es un mecanismo que evita que el núcleo cargue dicho módulo. Esto podría ser útil si, por ejemplo, el dispositivo de hardware asociado con el módulo no se utiliza y no desea que funcione, o porque la carga del módulo crea problemas: por ejemplo, puede darse la carga simultánea de dos módulos que intentan controlar el mismo dispositivo o componente del hardware, y cargándolos en conjunto se traduciría en un conflicto.
Algunos módulos se cargan como parte de initramfs. mkinitcpio -M mostrará todos los módulos detectados automáticamente: para evitar que initramfs cargue algunos de estos módulos, se utiliza la lista negra («blacklist») en /etc/modprobe.d/modprobe.conf. La ejecución de mkinitcpio -v mostrará una lista de todos los módulos insertados en initramfs por los distintos hooks (por ejemplo, hook filesystem, hook SCSI, etc.) Recuerde reconstruir el initramfs una vez haya hecho la lista negra de los módulos y reiniciar el sistema después.
Usar archivos en /etc/modprobe.d/
Crear un archivo .conf dentro de /etc/modprobe.d/ y añadir una línea para cada módulo que desee a la lista negra, usando la palabra clave blacklist. Por ejemplo, si desea evitar que el módulo pcspkr se cargue:
/etc/modprobe.d/nobeep.conf
# Esto evitará la carga del módulo pcspkr que controla el altavoz de la placa base blacklist pcspkr
blacklist respecto de un módulo hará que este no se cargue de forma automática, pero el módulo se puede cargar si otro módulo que no esté en la lista negra depende de él o si se carga de forma manual, con lo que iniciado este último se cargaría el primero, a pesar de estar incluido en la lista negra.
Sin embargo, hay una solución para este comportamiento, la orden install instruye a modprobe para ejecutar una orden personalizada, en lugar de insertar el módulo en la memoria, con lo que puede forzar que se impida la carga del módulo usando:
/etc/modprobe.d/blacklist.conf
... install MODULE_NAME /bin/false ...Esto hace efectivo la inclusión en la «lista negra» de ese módulo y de cualquier otro que dependa de él.
Usar la línea de órdenes del núcleo
También puede evitar la carga de módulos a través del gestor de arranque.
Agregue modprobe.blacklist=modname1,modname2,modname3 en la línea de órdenes del núcleo de su gestor de arranque como se describe en parámetros del núcleo.
Manejar módulos manualmente
Los módulos del núcleo pueden ser manejados con las herramientas proporcionadas por el paquete kmod. Estas herramientas pueden ser utilizadas manualmente.
Para cargar un módulo:
# modprobe nombre_del_módulo
Para quitar/retirar un módulo:
# modprobe -r nombre_del_módulo
O, alternativamente:
# rmmod nombre_del_módulo
Consejos y trucos
Función de bash para listar los parámetros del módulo
Esta es una función de bash que debe ser ejecutada como root, que mostrará una lista de todos los módulos actualmente cargados y todos sus parámetros, incluido el valor actual del parámetro. Utilice /proc/modules para obtener una lista actualizada de los módulos cargados, a continuación, acceder al archivo del módulo directamente con modinfo para tomar una descripción del módulo y las descripciones para cada parámetro (si está disponible), y finalmente acceda al sistema de archivos sysfs para tomar los nombres de los parámetros reales y los valores cargados en ese momento .
function aa_mod_parameters ()
{
N=/dev/null;
C=`tput op` O=$(echo -en "\n`tput setaf 2`>>> `tput op`");
for mod in $(cat /proc/modules|cut -d" " -f1);
do
md=/sys/module/$mod/parameters;
[[ ! -d $md ]] && continue;
m=$mod;
d=`modinfo -d $m 2>$N | tr "\n" "\t"`;
echo -en "$O$m$C";
[[ ${#d} -gt 0 ]] && echo -n " - $d";
echo;
for mc in $(cd $md; echo *);
do
de=`modinfo -p $mod 2>$N | grep ^$mc 2>$N|sed "s/^$mc=//" 2>$N`;
echo -en "\t$mc=`cat $md/$mc 2>$N`";
[[ ${#de} -gt 1 ]] && echo -en " - $de";
echo;
done;
done
}
Aquí está un ejemplo de salida.
# aa_mod_parameters
>>> ehci_hcd - USB 2.0 'Enhanced' Host Controller (EHCI) Driver
hird=0 - hird:host initiated resume duration, +1 for each 75us (int)
ignore_oc=N - ignore_oc:ignore bogus hardware overcurrent indications (bool)
log2_irq_thresh=0 - log2_irq_thresh:log2 IRQ latency, 1-64 microframes (int)
park=0 - park:park setting; 1-3 back-to-back async packets (uint)
>>> processor - ACPI Processor Driver
ignore_ppc=-1 - ignore_ppc:If the frequency of your machine gets wronglylimited by BIOS, this should help (int)
ignore_tpc=0 - ignore_tpc:Disable broken BIOS _TPC throttling support (int)
latency_factor=2 - latency_factor: (uint)
>>> usb_storage - USB Mass Storage driver for Linux
delay_use=1 - delay_use:seconds to delay before using a new device (uint)
option_zero_cd=1 - option_zero_cd:ZeroCD mode (1=Force Modem (default), 2=Allow CD-Rom (uint)
quirks= - quirks:supplemental list of device IDs and their quirks (string)
swi_tru_install=1 - swi_tru_install:TRU-Install mode (1=Full Logic (def), 2=Force CD-Rom, 3=Force Modem) (uint)
>>> video - ACPI Video Driver
allow_duplicates=N - allow_duplicates: (bool)
brightness_switch_enabled=Y - brightness_switch_enabled: (bool)
use_bios_initial_backlight=Y - use_bios_initial_backlight: (bool)
Lo que sigue es una variación de la función anterior, que incluye una descripción completa de cada parámetro. La salida tiene un formato ligeramente diferente y utiliza más colores.
function show_mod_parameter_info ()
{
if tty -s <&1
then
green="\e[1;32m"
yellow="\e[1;33m"
cyan="\e[1;36m"
reset="\e[0m"
else
green=
yellow=
cyan=
reset=
fi
newline="
"
while read mod
do
md=/sys/module/$mod/parameters
[[ ! -d $md ]] && continue
d="$(modinfo -d $mod 2>/dev/null | tr "\n" "\t")"
echo -en "$green$mod$reset"
[[ ${#d} -gt 0 ]] && echo -n " - $d"
echo
pnames=()
pdescs=()
pvals=()
pdesc=
add_desc=false
while IFS="$newline" read p
do
if [[ $p =~ ^[[:space:]] ]]
then
pdesc+="$newline $p"
else
$add_desc && pdescs+=("$pdesc")
pname="${p%%:*}"
pnames+=("$pname")
pdesc=(" ${p#*:}")
pvals+=("$(cat $md/$pname 2>/dev/null)")
fi
add_desc=true
done < <(modinfo -p $mod 2>/dev/null)
$add_desc && pdescs+=("$pdesc")
for ((i=0; i<${#pnames[@]}; i++))
do
printf " $cyan%s$reset = $yellow%s$reset\n%s\n" \
${pnames[i]} \
"${pvals[i]}" \
"${pdescs[i]}"
done
echo
done < <(cut -d' ' -f1 /proc/modules | sort)
}