Man page - modprobe(8)

Packages contains this manual

Package:  kmod
apt-get install kmod

Manuals in package:
• kmod(8)
• modprobe.conf(5)
• depmod.d(5)
• modules.dep.bin(5)
• lsmod(8)
• modprobe(8)
• modules.dep(5)
• insmod(8)
• modprobe.d(5)
• rmmod(8)
• modinfo(8)
• depmod(8)
Documentations in package:
• libkmod2

Available languages:

en fr pl tr ja ro

Manual

MODPROBE

名 前
書 式
説 明
オ プ シ ョ ン
環 境 変 数
著 作 権
関 連 項 目
著 者

---

名 前

modprobe - Linux カ ー ネ ル に 対 し て モ ジ ュ ー ル の 着 脱 を 行 う

書 式

	modprobe [ -v ] [ -V ] [ -C config-file ] [ -n ] [ -i ] [ -q ] [ -b ] [ modulename ] [ module parameters ...]
	modprobe [-r] [ -v ] [ -n ] [ -i ] [ modulename ...]
	modprobe [-c]
	modprobe [--dump-modversions] [ filename ]

説 明

modprobe は 、 Linux カ ー ネ ル に 対 し て 頭 の よ い や り 方 で モ ジ ュ ー ル の 追 加 や 取 り 外 し を 行 い ま す 。 な お 、 ユ ー ザ の 便 宜 を 考 慮 し て 、 モ ジ ュ ー ル 名 に 含 ま れ る _ と - と を 区 別 し ま せ ん (ア ン ダ ー ス コ ア へ の 変 換 が 自 動 的 に 行 わ れ ま す )。 modprobe は 、 モ ジ ュ ー ル デ ィ レ ク ト リ /lib/modules/‘uname -r‘ を 見 て 、 す べ て の モ ジ ュ ー ル や そ の ほ か の フ ァ イ ル を そ れ 以 下 に 捜 し ま す 。 た だ し 、 作 成 が 任 意 の 設 定 フ ァ イ ル に つ い て は 、 /etc/modprobe.d デ ィ レ ク ト リ を 調 べ ま す ( modprobe.d (5) 参 照 )。 modprobe は ま た 、 カ ー ネ ル コ マ ン ド ラ イ ン で 指 定 さ れ た 、 モ ジ ュ ー ル オ プ シ ョ ン や ブ ラ ッ ク リ ス ト も 使 用 し ま す 。 前 者 の 書 式 は <module>.<option> で あ り 、 後 者 の 書 式 は modprobe.blacklist=<module> で す 。

な お 、 2.4 系 列 の Linux カ ー ネ ル (こ の ツ ー ル は サ ポ ー ト し て い ま せ ん ) の 場 合 と は 違 っ て 、 当 バ ー ジ ョ ン の modprobe は 、 モ ジ ュ ー ル そ の も の に 対 し て は 何 の 操 作 も 行 い ま せ ん 。 シ ン ボ ル の 解 決 や パ ラ メ ー タ の 解 釈 と い っ た 作 業 は 、 カ ー ネ ル の 内 部 で 行 わ れ ま す 。 そ こ で 、 モ ジ ュ ー ル の 処 理 に 失 敗 す る と 、 カ ー ネ ル メ ッ セ ー ジ が 出 る こ と が あ り ま す 。 dmesg (8) を 参 照 し て く だ さ い 。

modprobe は 、 modules.dep.bin フ ァ イ ル が 最 新 で あ る こ と を 当 て に し て い ま す 。 こ の フ ァ イ ル は 、 modprobe と 一 緒 に 配 布 さ れ 、 現 在 の modprobe に 対 応 し て い る depmod (8) ユ ー テ ィ リ テ ィ に よ っ て 生 成 さ れ ま す ( depmod (8) 参 照 )。 modules.dep.bin は 、 各 モ ジ ュ ー ル が 、 ほ か の ど ん な モ ジ ュ ー ル を 必 要 と し て い る か を (そ う い っ た も の が あ れ ば ) リ ス ト し て お り 、 modprobe は 、 こ の フ ァ イ ル を 使 用 し て 、 そ う し た 依 存 す る モ ジ ュ ー ル を 自 動 的 に 追 加 し た り 、 取 り 外 し た り し ま す 。

modulename の 後 ろ に 引 数 を 付 け る と 、 そ う し た 引 数 は カ ー ネ ル に 渡 さ れ ま す (設 定 フ ァ イ ル で 指 定 し て い る モ ジ ュ ー ル オ プ シ ョ ン [訳 注 : モ ジ ュ ー ル パ ラ メ ー タ と も 言 い ま す ] が あ れ ば 、 そ こ に 追 加 さ れ る わ け で す )。

オ プ シ ョ ン

-a , --all

コ マ ン ド ラ イ ン で 指 定 さ れ た モ ジ ュ ー ル 名 を す べ て 組 み 込 み ま す 。

-b , --use-blacklist

こ の オ プ シ ョ ン を 指 定 す る と 、 modprobe は 、 設 定 フ ァ イ ル に blacklist コ マ ン ド が あ れ ば 、 そ れ も モ ジ ュ ー ル 名 に 対 し て 適 用 し ま す 。 こ の オ プ シ ョ ン は 通 常 、 udev (7) に よ っ て 使 用 さ れ ま す 。

-C , --config

こ の オ プ シ ョ ン は 、 設 定 デ ィ レ ク ト リ を デ フ ォ ル ト の /etc/modprobe.d か ら 変 更 し ま す 。

こ の オ プ シ ョ ン は 、 環 境 変 数 MODPROBE_OPTIONS に 入 れ ら れ て 、 install や remove コ マ ン ド 経 由 で 、 ほ か の modprobe コ マ ン ド に も 渡 さ れ ま す 。

-c , --showconfig

設 定 デ ィ レ ク ト リ を 読 み 込 み 、 有 効 な 設 定 を 標 準 出 力 に 書 き 出 し て 、 終 了 し ま す 。

--dump-modversions

あ る モ ジ ュ ー ル が 要 求 し て い る 、 そ の モ ジ ュ ー ル の バ ー ジ ョ ン 管 理 情 報 の リ ス ト を 表 示 し ま す 。 こ の オ プ シ ョ ン は 通 常 、 モ ジ ュ ー ル の バ ー ジ ョ ン 管 理 の 依 存 情 報 を 利 用 し て Linux の カ ー ネ ル モ ジ ュ ー ル を パ ッ ケ ー ジ に ま と め る た め に 、 デ ィ ス ト リ ビ ュ ー シ ョ ン に よ っ て 使 用 さ れ ま す 。

-d , --dirname

モ ジ ュ ー ル 群 に と っ て の ル ー ト デ ィ レ ク ト リ 。 デ フ ォ ル ト で は / で す 。

--first-time

通 常 、 modprobe は 、 す で に 存 在 す る モ ジ ュ ー ル の 組 み 込 み や 、 存 在 し な い モ ジ ュ ー ル の 取 り 外 し を 命 じ ら れ て も 、 処 理 に 成 功 し た も の と し て (何 も せ ず に ) 終 了 し ま す 。 こ れ は 単 純 な ス ク リ プ ト で は ま っ た く 問 題 が あ り ま せ ん 。 で も 、 よ り 複 雑 な ス ク リ プ ト で は 、 modprobe が 実 際 に 何 ら か の 処 理 を 行 っ た か ど う か を 知 り た い こ と が よ く あ り ま す 。 こ の オ プ シ ョ ン を 使 う と 、 modprobe は 、 実 際 に は 何 も し な か っ た 場 合 、 実 行 に 失 敗 し た こ と に な り ま す 。

--force-vermagic

ど の モ ジ ュ ー ル の 中 に も 、 カ ー ネ ル や コ ン パ イ ラ の バ ー ジ ョ ン と い っ た 重 要 な 情 報 を 含 む 短 い 文 字 列 が 存 在 し ま す 。 モ ジ ュ ー ル の ロ ー ド に 失 敗 し て 、 カ ー ネ ル が 「 バ ー ジ ョ ン マ ジ ッ ク が 一 致 し な い 」 と 苦 情 を 言 っ て 来 る 場 合 、 こ の オ プ シ ョ ン を 使 え ば 、 そ の バ ー ジ ョ ン マ ジ ッ ク を 除 去 す る こ と が で き ま す 。 言 う ま で も あ り ま せ ん が 、 こ う し た チ ェ ッ ク は 、 ユ ー ザ を 守 る た め に あ る の で す か ら 、 自 分 の や っ て い る こ と が よ く わ か っ て い な い か ぎ り 、 こ の オ プ シ ョ ン を 使 う の は 危 険 で す 。

こ の オ プ シ ョ ン は 、 組 み 込 ま れ る ど ん な モ ジ ュ ー ル に も 適 用 さ れ ま す 。 す な わ ち 、 コ マ ン ド ラ イ ン で 指 定 さ れ た モ ジ ュ ー ル (や エ イ リ ア ス ) だ け で な く 、 そ れ が 依 存 す る モ ジ ュ ー ル が あ れ ば 、 そ れ に も 適 用 さ れ ま す 。

--force-modversion

CONFIG_MODVERSIONS を 有 効 に し て 、 モ ジ ュ ー ル を コ ン パ イ ル す る と 、 そ の モ ジ ュ ー ル が 利 用 す る (あ る い は 、 提 供 す る ) す べ て の イ ン タ ー フ ェ ー ス の バ ー ジ ョ ン を 記 録 し た セ ク シ ョ ン が 、 モ ジ ュ ー ル 内 に 作 ら れ ま す 。 モ ジ ュ ー ル の ロ ー ド に 失 敗 し て 、 カ ー ネ ル が 「 モ ジ ュ ー ル の イ ン タ ー フ ェ ー ス に 、 バ ー ジ ョ ン が カ ー ネ ル 側 と 一 致 し な い も の が あ る 」 と 苦 情 を 言 っ て 来 る 場 合 、 "--force-modversion" を 使 え ば 、 そ う し た バ ー ジ ョ ン 情 報 を そ っ く り 除 去 す る こ と が で き ま す 。 言 う ま で も あ り ま せ ん が 、 こ う し た チ ェ ッ ク は 、 ユ ー ザ を 守 る た め に あ る の で す か ら 、 自 分 の や っ て い る こ と が よ く わ か っ て い な い か ぎ り 、 こ の オ プ シ ョ ン を 使 う の は 危 険 で す 。

こ の オ プ シ ョ ン は 、 組 み 込 ま れ る ど ん な モ ジ ュ ー ル に も 適 用 さ れ ま す 。 す な わ ち 、 コ マ ン ド ラ イ ン で 指 定 さ れ た モ ジ ュ ー ル (や エ イ リ ア ス ) だ け で な く 、 そ れ が 依 存 す る モ ジ ュ ー ル が あ れ ば 、 そ れ に も 適 用 さ れ ま す 。

-f , --force

バ ー ジ ョ ン 管 理 に 関 す る 情 報 が モ ジ ュ ー ル に あ る と 、 ロ ー ド が 中 断 し か ね な い 場 合 に 、 モ ジ ュ ー ル か ら そ う し た 情 報 を す べ て 取 り 除 こ う と し ま す 。 こ れ は --force-vermagic と --force-modversion の 両 方 を 使 用 す る の と 同 じ こ と で す 。 言 う ま で も あ り ま せ ん が 、 こ う し た チ ェ ッ ク は ユ ー ザ を 守 る た め に あ る の で す か ら 、 自 分 の や っ て い る こ と が よ く わ か っ て い な い か ぎ り 、 こ の オ プ シ ョ ン を 使 う の は 危 険 で す 。

こ の オ プ シ ョ ン は 、 組 み 込 ま れ る ど ん な モ ジ ュ ー ル に も 適 用 さ れ ま す 。 す な わ ち 、 コ マ ン ド ラ イ ン で 指 定 さ れ た モ ジ ュ ー ル (や エ イ リ ア ス ) だ け で な く 、 そ れ が 依 存 す る モ ジ ュ ー ル が あ れ ば 、 そ れ に も 適 用 さ れ ま す

-i , --ignore-install , --ignore-remove

こ の オ プ シ ョ ン を 使 う と 、 modprobe は 、 コ マ ン ド ラ イ ン で 指 定 さ れ た モ ジ ュ ー ル に 対 し て 設 定 フ ァ イ ル 中 に install や remove コ マ ン ド が 存 在 し て も 、 そ れ を 無 視 し ま す (依 存 す る モ ジ ュ ー ル に つ い て は 、 こ の オ プ シ ョ ン を 指 定 し た 場 合 で も 、 設 定 フ ァ イ ル 中 で そ の モ ジ ュ ー ル に 対 し て 設 定 さ れ て い る コ マ ン ド の 対 象 に な り ま す )。 現 状 で は 、 こ の オ プ シ ョ ン を 使 用 し た 場 合 、 install と remove の 両 方 の コ マ ン ド が 無 視 さ れ る こ と に な り ま す 。 --ignore-install や --ignore-remove の 片 方 の み を 使 っ て (そ し て 、 両 方 を 使 う こ と な く ) よ り 具 体 的 に 指 定 し て も 、 動 作 は 変 わ り ま せ ん 。 modprobe.d(5) を 参 照 し て く だ さ い 。

-n , --dry-run , --show

こ の オ プ シ ョ ン を 指 定 す る と 、 実 際 に モ ジ ュ ー ル を 組 み 込 ん だ り 、 取 り 外 し た り (そ れ に 、 install や remove コ マ ン ド を 実 行 し た り ) す る 以 外 の あ ら ゆ る こ と を 行 い ま す 。 -v オ プ シ ョ ン と 組 み 合 わ せ る と 、 問 題 が 起 き た と き の デ バ ッ グ に 便 利 で す 。 歴 史 的 な 理 由 か ら --dry-run と --show は 事 実 上 同 じ 意 味 な の で 、 ど ち ら を 使 っ て も 構 い ま せ ん 。

-q , --quiet

こ の フ ラ グ を 使 用 す る と 、 modprobe は 、 モ ジ ュ ー ル を 取 り 外 し た り 、 組 み 込 ん だ り し よ う と し て 、 そ れ が 見 つ か ら な か っ た 場 合 に (し か も 、 そ れ が エ イ リ ア ス の 名 前 で も 、 install や remove コ マ ン ド の 対 象 で も な か っ た 場 合 に )、 エ ラ ー メ ッ セ ー ジ を 出 さ な く な り ま す 。 そ れ で も 、 ゼ ロ 以 外 の ス テ ー タ ス で 終 了 す る こ と に 変 わ り は あ り ま せ ん 。 な お 、 カ ー ネ ル は 、 存 在 す る か ど う か が 不 確 か な モ ジ ュ ー ル の 探 索 を request_module 関 数 を 使 っ て 便 宜 主 義 的 に 行 う た め に 、 こ の フ ラ グ を 使 用 し ま す 。

-R , --resolve-alias

あ る エ イ リ ア ス に 対 応 す る モ ジ ュ ー ル 名 を す べ て 表 示 し ま す 。 モ ジ ュ ー ル の エ イ リ ア ス に 問 題 が あ る 場 合 、 デ バ ッ グ の 役 に 立 つ か も し れ ま せ ん 。

-r , --remove

こ の オ プ シ ョ ン を 指 定 す る と 、 modprobe は 、 モ ジ ュ ー ル を 組 み 込 む 代 わ り に 、 そ れ を 取 り 外 し ま す 。 そ の モ ジ ュ ー ル が 依 存 し て い る モ ジ ュ ー ル も 使 用 さ れ て い な い 場 合 は 、 そ れ も ま た 取 り 外 そ う と し ま す 。 組 み 込 み を 行 う 場 合 と は 違 っ て 、 複 数 の モ ジ ュ ー ル を コ マ ン ド ラ イ ン で 指 定 す る こ と が で き ま す (モ ジ ュ ー ル を 取 り 外 す 場 合 に は 、 モ ジ ュ ー ル パ ラ メ ー タ を 指 定 し て も 意 味 が あ り ま せ ん )。

通 常 は 、 モ ジ ュ ー ル を 取 り 外 す 理 由 な ど あ り ま せ ん が 、 モ ジ ュ ー ル に バ グ の あ る 場 合 に は 、 そ れ が 必 要 に な る こ と も あ り ま す 。 も っ と も 、 ご 使 用 の デ ィ ス ト リ ビ ュ ー シ ョ ン の カ ー ネ ル は 、 モ ジ ュ ー ル 取 り 外 し の サ ポ ー ト を 有 効 に し て ビ ル ド さ れ て い な い か も し れ ま せ ん 。

-S , --set-version

カ ー ネ ル の バ ー ジ ョ ン を 設 定 し ま す 。 す な わ ち 、 カ ー ネ ル の バ ー ジ ョ ン (そ れ に よ っ て 、 モ ジ ュ ー ル を 探 し に 行 く 場 所 が 決 ま り ま す ) を 判 断 す る の に 、 uname (2) を 使 用 し ま せ ん 。

--show-depends

あ る モ ジ ュ ー ル (ま た は 、 エ イ リ ア ス ) の 依 存 関 係 を 、 そ の モ ジ ュ ー ル 自 体 も 含 め て 、 一 覧 表 示 し ま す 。 モ ジ ュ ー ル フ ァ イ ル 名 の 集 合 (空 集 合 の こ と も あ り ま す ) が 、 1 行 に 1 フ ァ イ ル ず つ 、 各 行 の 先 頭 に "insmod" を 付 け て 、 出 力 さ れ ま す 。 こ の オ プ シ ョ ン の 代 表 的 な 使 い 道 は 、 デ ィ ス ト リ ビ ュ ー シ ョ ン が initrd/initramfs イ メ ー ジ を 作 成 す る と き 、 ど の モ ジ ュ ー ル を 収 録 す る か を 決 め る の に 使 う こ と で す 。 Install コ マ ン ド が 適 用 さ れ て い る 場 合 は 、 "install" と い う 文 字 列 を 行 頭 に 置 く こ と で 、 そ れ を 示 し ま す が 、 そ う し た install コ マ ン ド が 実 行 さ れ る わ け で は あ り ま せ ん 。 な お 、 modinfo (8) を 使 え ば 、 モ ジ ュ ー ル の 依 存 関 係 を そ の モ ジ ュ ー ル 自 体 か ら 取 り 出 す こ と が で き ま す が 、 modinfo は 、 設 定 フ ァ イ ル の alias や install と い っ た コ マ ン ド に つ い て は 、 何 も 知 ら な い こ と に 注 意 し て く だ さ い 。

-s , --syslog

こ の オ プ シ ョ ン を 指 定 す る と 、 エ ラ ー メ ッ セ ー ジ が あ る 場 合 に 、 そ れ を 標 準 エ ラ ー に 送 る の で は な く 、 syslog の 仕 組 み を 通 し て 出 力 し ま す (LOG_NOTICE レ ベ ル の LOG_DAEMON と し て 扱 わ れ ま す )。 こ の オ プ シ ョ ン は 、 標 準 エ ラ ー が 使 え な い 場 合 に も 、 自 動 的 に 有 効 に な り ま す 。

こ の オ プ シ ョ ン は 、 環 境 変 数 MODPROBE_OPTIONS に 入 れ ら れ て 、 install や remove コ マ ン ド 経 由 で 、 ほ か の modprobe コ マ ン ド に も 渡 さ れ ま す 。

-V , --version

プ ロ グ ラ ム の バ ー ジ ョ ン を 表 示 し て 終 了 し ま す 。

-v , --verbose

プ ロ グ ラ ム が 何 を や っ て い る か に つ い て メ ッ セ ー ジ を 表 示 し ま す 。 通 常 modprobe が メ ッ セ ー ジ を 出 す の は 、 何 か が う ま く 行 か な か っ た と き だ け で す 。

こ の オ プ シ ョ ン は 、 環 境 変 数 MODPROBE_OPTIONS に 入 れ ら れ て 、 install や remove コ マ ン ド 経 由 で 、 ほ か の modprobe コ マ ン ド に も 渡 さ れ ま す 。

環 境 変 数

環 境 変 数 MODPROBE_OPTIONS は 、 modprobe コ マ ン ド に 引 数 を 渡 す た め に ユ ー ザ が 使 用 す る こ と も で き ま す 。

著 作 権

こ の マ ニ ュ ア ル ペ ー ジ の 最 初 の 版 は 、 "Copyright 2002, Rusty Russell, IBM Corporation" で し た 。 現 在 で は 、 Jon Masters ほ か 数 名 に よ っ て 保 守 さ れ て い ま す 。

関 連 項 目

modprobe.d (5), insmod (8), rmmod (8), lsmod (8), modinfo (8) depmod (8)

著 者

Jon Masters <jcm@jonmasters.org>

開 発 者

Robby Workman <rworkman@slackware.com>

開 発 者

Lucas De Marchi <lucas.de.marchi@gmail.com>

開 発 者

---