NOM
modprobe - manipulació d'alt nivell de mòduls carregables
SINOPSI
modprobe [-adnqv] [-C configuració ] mòdul [symbol = value ...]
modprobe [-adnqv] [-C configuració ] [-t tipus ] patró
modprobe -l [-C config ] [-t tipus ] patró
modprobe -c [-C config ]
modprobe -r [-dnv] [-C config ] [mòdul ...]
modprobe- Vh
OPCIONS
-a , --all
Carregueu tots els mòduls coincidents en comptes de parar després de la primera càrrega reeixida.
-c , --showconfig
Mostra la configuració usada actualment.
-C , --config configuració
Utilitzeu la configuració de fitxers en comptes de (opcional) /etc/modules.conf per especificar la configuració. La variable d'entorn MODULECONF també es pot utilitzar per seleccionar (i anul·lar) un fitxer de configuració diferent del valor predeterminat /etc/modules.conf (o /etc/conf.modules (obsolet)).
Quan s'estableix la variable d'entorn UNAME_MACHINE , modutils utilitzarà el seu valor en lloc del camp de la màquina des de uname () syscall. Això s'utilitza principalment quan compileu mòduls de 64 bits en l'espai d'usuaris de 32 bits o viceversa, estableixi UNAME_MACHINE al tipus de mòduls. Modutils actual no suporta el mode de construcció creuada completa dels mòduls, es limita a triar entre versions de 32 i 64 bits de l'arquitectura host.
-d , --debug
Mostra informació sobre la representació interna de la pila de mòduls.
-h , - help
Mostra un resum d'opcions i surt immediatament.
-k , --autoclean
Estableix 'autoclear' en els mòduls carregats. Utilitzat pel nucli quan crida a modprobe per satisfer una característica que falta (subministrada com a mòdul). L'opció -q està implicada per -k . Aquestes opcions s'enviaran automàticament a insmod .
-l , --list
Mostra mòduls coincidents.
-n , --show
No realitzeu l'acció, simplement mostreu el que es farà.
-q , --quiet
No es queixi de insmod en no instal·lar un mòdul. Continueu com a normal, però silenciosament, amb altres possibilitats de provar modprobe. Aquesta opció s'enviarà automàticament a insmod .
-r , --remove
Elimineu el mòdul (pila) o feu autoclarar, depenent de si hi ha algun mòdul esmentat a la línia d'ordres.
-s , --syslog
Informeu mitjançant syslog en lloc de stderr. Aquestes opcions s'enviaran automàticament a insmod .
-t tipus de mòdul ; - Tipus de modulació tipus
Només consideri mòduls d'aquest tipus. modprobe només mirarà els mòduls la ruta del directori inclou exactament " / moduletype / ". El tipus de mòdul pot incloure més d'un nom de directori, per exemple, " -t drivers / net " llisteria els mòduls a xxx / drivers / net / i els seus subdirectoris.
-v , --verbose
Imprimiu tots els comandaments a mesura que s'executin.
-V, --versió
Mostra la versió de modprobe .
Nota:
Els noms dels mòduls no han de contenir camins (no '/'), ni poden contenir el final '.o'. Per exemple, slip és un nom de mòdul vàlid per a modprobe , /lib/modules/2.2.19/net/slip i slip.o no són vàlids. Això s'aplica a la línia d'ordres ia les entrades de la configuració.
DESCRIPCIÓ
Les utilitats modprobe i depmod estan dissenyades per fer que un nucli modular de Linux sigui més manejable per a tots els usuaris, administradors i mantenidors de la distribució.
Modprobe utilitza un fitxer de dependència com "Makefile", creat per depmod , per carregar automàticament els mòduls rellevants del conjunt de mòduls disponibles en arbres de directoris predefinits.
Modprobe s'utilitza per carregar un mòdul únic, una pila de mòduls dependents o tots els mòduls marcats amb una etiqueta especificada.
Modprobe carregarà automàticament tots els mòduls bàsics necessaris en una pila de mòduls, tal com es descriu en el fitxer de dependències modules.dep . Si la càrrega d'un d'aquests mòduls falla, es carregarà automàticament tota la pila actual de mòduls carregats a la sessió actual.
Modprobe té dues maneres de carregar mòduls. Una manera (el mode de sonda) intentarà carregar un mòdul d'una llista (definida per patró ). Modprobe deixa de carregar tan bon punt es carrega amb èxit un mòdul. Això podria ser utilitzat per autoliberar un controlador Ethernet d'una llista.
L'altra manera que es pot utilitzar modprobe és carregar tots els mòduls d'una llista. Consulteu EXEMPLES a continuació.
Amb l'opció -r , modprobe descarregarà automàticament una pila de mòduls, similar a la manera " rmmod -r ". Tingueu en compte que si s'utilitza només " modprobe -r " es netegen mòduls autònoms no utilitzats i també es faran les ordres pre-i post-remove al fitxer de configuració /etc/modules.conf .
La combinació de les opcions -l i -t conté tots els mòduls disponibles d'un determinat tipus.
L'opció -c imprimirà la configuració utilitzada actualment (fitxer de configuració predeterminat +).
CONFIGURACIÓ
El comportament de modprobe (i depmod ) pot ser modificat pel fitxer de configuració (opcional) /etc/modules.conf .
Per obtenir una descripció més detallada del que pot contenir aquest fitxer, així com la configuració predeterminada utilitzada per depmod i modprobe , consulteu mòduls.conf (5).
Tingueu en compte que les ordres pre i post-remove no s'executaran si un mòdul és "autocleaned" per kerneld! Busqueu el suport permanent per a l'emmagatzematge persistent del mòdul.
Si voleu utilitzar les funcions prèvies i posteriors a la instal·lació, haureu de desactivar l'autoclear per a kerneld i, en lloc d'això, situar-vos com la següent línia al vostre crontab (això s'utilitza també per als sistemes kmod) per fer autoclear cada 2 minuts :
* / 2 * * * * test -f / proc / modules && / sbin / modprobe -r
ESTRATÈGIA
La idea és que modprobe es veurà primer en el directori que conté mòduls compilats per a la versió actual del nucli. Si el mòdul no es troba allà, modprobe buscarà en el directori comú a la versió del kernel (p.ex. 2.0, 2.2). Si el mòdul encara es troba, modprobe buscarà al directori que conté mòduls per a una versió predeterminada, i així successivament.
Quan instal·leu un nou Linux, els mòduls s'han de moure a un directori relacionat amb l'alliberament (i versió) del nucli que esteu instal·lant. A continuació, haureu de fer un enllaç simbòlic d'aquest directori al directori "predeterminat".
Cada vegada que compileu un nou nucli, l'ordre " make modules_install " crearà un nou directori, però no canviarà l'enllaç "predeterminat".
Quan obtingueu un mòdul no relacionat amb la distribució del nucli, heu de col·locar-lo en un dels directoris independents de la versió a / lib / modules .
Aquesta és l'estratègia predeterminada, que es pot reemplaçar a /etc/modules.conf .
EXEMPLES
modprobe -t net
Carregueu un dels mòduls que estiguin emmagatzemats al directori etiquetat "net". Cada mòdul es prova fins que s'aconsegueixi un.
modprobe -a -t boot
Es carregaran tots els mòduls que es guarden als directoris etiquetats amb "arrencada".
modprobe slip
Això intentarà carregar el mòdul slhc.o si no s'ha carregat prèviament, ja que el mòdul slip necessita la funcionalitat del mòdul slhc. Aquesta dependència es descriu a l'arxiu modules.dep creat automàticament per depmod .
modprobe -r slip
Això descarregarà el mòdul de lliscament. També descarregarà el mòdul slhc de forma automàtica, tret que sigui utilitzat per algun altre mòdul (ppp, per exemple).
VEGEU TAMBÉ
depmod (8), lsmod (8), kerneld (8), ksyms (8), rmmod (8).
MODE SEGUR
Si l'efectiu uid no és igual a l'uid real, llavors el modprobe tracta la seva entrada amb extrema sospita. L'últim paràmetre sempre es tracta com a nom del mòdul, fins i tot si s'inicia amb '-'. Només hi pot haver un nom de mòdul i les opcions del formulari "variable = valor" estan prohibides. El nom del mòdul sempre es tracta com una cadena, no es realitza cap expansió meta en mode segur. Tanmateix, l'expansió meta encara s'aplica a les dades llegides des del fitxer de configuració.
euid pot no ser igual a uid quan s'invoca modprobe des del nucli, això és cert per kernels> = 2.4.0-test11. En un món ideal, modprobe podria confiar en el nucli per passar només paràmetres vàlids a modprobe. No obstant això, almenys s'ha produït un exploit arrel local perquè el codi del nucli d'alt nivell passava els paràmetres no verificats directament de l'usuari a modprobe. Així, modprobe ja no confia en l'entrada del nucli.
modprobe estableix automàticament el mode segur quan l'entorn només consisteix en aquestes cadenes
HOME = / TERM = linux PATH = / sbin: / usr / sbin: / bin: / usr / binAixò detecta l'execució de modprobe del nucli en kernels 2.2, encara que 2.4.0-test11, fins i tot si uid == euid, que fa en els kernels anteriors.
COMANDS DE LLOGGING
Si el directori / var / log / ksymoops existeix i modprobe s'executa amb una opció que podria carregar o esborrar un mòdul, llavors modprobe registrarà el seu ordre i retornarà l'estat a / var / log / ksymoops / `date +% Y% m% d .log " . No hi ha canvi per desactivar aquest registre automàtic, si no voleu que es produeixi, no creeu / var / log / ksymoops . Si aquest directori existeix, hauria de ser propietat de root i ser modes 644 o 600 i caldrà que executeu script insmod_ksymoops_clean cada dia més o menys.
SERVEIS REQUERITS
depmod (8), insmod (8).
Important: utilitzeu l'ordre man ( % home ) per veure com s'utilitza una comanda a l'ordinador en particular.