Manpages

名 前

modprobe − Linux カ ー ネ ル に モ ジ ュ ー ル を 追 加 し た り 削 除 し た り す る プ ロ グ ラ ム

書 式

modprobe [ −v ] [ −V ] [ −C config−file ] [ −n ] [ −i ] [ −q ] [ −o modulename ] [ modulename ] [ module parameters ... ]

modprobe [ −r ] [ −v ] [ −n ] [ −i ] [ modulename ... ]

modprobe [ −l ] [ −t dirname ] [ wildcard ]

modprobe [ −c ]

説 明

modprobe は Linux カ ー ネ ル に 賢 く モ ジ ュ ー ル を 追 加 し た り 削 除 し た り す る 。 利 便 性 の た め 、 モ ジ ュ ー ル 名 に お い て _ と − の 違 い は な い こ と に 注 意 。 modprobe は 、 全 て の モ ジ ュ ー ル と 他 の フ ァ イ ル を モ ジ ュ ー ル デ ィ レ ク ト リ /lib/modules/’uname −r’ か ら 参 照 す る 。 こ の ほ か に 、 も し あ れ ば /etc/modprobe.conf 設 定 フ ァ イ ル と /etc/modprobe.d デ ィ レ ク ト リ を 参 照 す る (modprobe.conf(5) を 参 照 ) 。 こ の バ ー ジ ョ ン の modprobe は 、 自 身 で は モ ジ ュ ー ル に 対 し て 何 も し な い こ と に 注 意 。 シ ン ボ ル の 解 決 や パ ラ メ ー タ の 解 釈 と い っ た 処 理 は カ ー ネ ル の 中 で 行 な わ れ る 。 そ の た め 、 モ ジ ュ ー ル の 不 具 合 は カ ー ネ ル の メ ッ セ ー ジ と し て 報 告 さ れ る こ と も あ る 。 dmesg(8) を 参 照 。

modprobe を 実 行 す る と き は 、 depmod (depmod(8) を 参 照 ) で 生 成 さ れ た modules.dep が 最 新 の 状 態 に な っ て い な け れ ば な ら な い 。 こ の フ ァ イ ル に は 、 そ れ ぞ れ の モ ジ ュ ー ル が (も し あ れ ば ) 他 の ど の モ ジ ュ ー ル を 必 要 と し て い る か が 列 挙 さ れ て い て 、 modprobe は こ れ を 使 っ て 依 存 す る モ ジ ュ ー ル を 自 動 的 に 追 加 し た り 削 除 し た り す る 。 (modules.dep(5) を 参 照 ) 。

modulename の 後 ろ に 指 定 さ れ た 引 数 は 、 カ ー ネ ル に 渡 さ れ る (設 定 フ ァ イ ル に 列 挙 さ れ た オ プ シ ョ ン に 追 加 さ れ る ) 。

オ プ シ ョ ン

−v −−verbose プ ロ グ ラ ム が 何 を し て い る か に 関 す る メ ッ セ ー ジ を 表 示 す る 。 通 常 、 modprobe は 何 か ま ず い こ と が 起 こ っ た 場 合 に 限 っ て メ ッ セ ー ジ を 表 示 す る 。 こ の オ プ シ ョ ン は install お よ び remove コ マ ン ド を 通 じ て 、 MODPROBE_OPTIONS 環 境 変 数 に あ る modprobe の 他 の コ マ ン ド に 渡 さ れ る 。
−C −−config
こ の オ プ シ ョ ン は デ フ ォ ル ト の 設 定 フ ァ イ ル (/etc/modprobe.conf/etc/modprobe.d/) を 無 視 す る 。 こ の オ プ シ ョ ン は install お よ び remove コ マ ン ド を 通 じ て 、 MODPROBE_OPTIONS 環 境 変 数 に あ る modprobe の 他 の コ マ ン ド に 渡 さ れ る 。
−c −−showconfig
設 定 フ ァ イ ル の 内 容 を 表 示 し 、 終 了 す る 。
−n −−dry−run
こ の オ プ シ ョ ン は 実 際 に モ ジ ュ ー ル を 登 録 し た り 削 除 し た り す る (あ る い は install や remove コ マ ン ド を 実 行 す る ) 以 外 の 、 全 て の 処 理 を 行 な う 。 −v と 組 み 合 わ せ て 使 う と 、 不 具 合 を デ バ ッ グ す る の に 便 利 で あ る 。
−i −−ignore−install −−ignore−remove
こ の オ プ シ ョ ン を 使 う と 、 modprobe は コ マ ン ド ラ イ ン で 指 定 さ れ た モ ジ ュ ー ル に 対 す る 設 定 フ ァ イ ル 中 の install お よ び remove コ マ ン ド を (も し あ れ ば ) 無 視 す る (た だ し 、 依 存 す る モ ジ ュ ー ル は 設 定 フ ァ イ ル 中 の コ マ ン ド に 従 う ) 。 modprobe.conf(5) を 参 照 。
−q −−quiet
通 常 、 modprobe は 見 つ か ら な い (か つ エ イ リ ア ス で も な い か install/remove コ マ ン ド で も な い ) モ ジ ュ ー ル を 削 除 し た り 登 録 し た り し よ う と す る と 、 エ ラ ー を 通 知 す る 。 こ の フ ラ グ を 使 う と 、 modprobe は で た ら め な 名 前 は 単 に 無 視 す る (カ ー ネ ル は こ の 名 前 を 使 っ て 存 在 す る か も し れ な い モ ジ ュ ー ル を 日 和 見 的 に プ ロ ー ブ す る ) 。
−r −−remove
こ の オ プ シ ョ ン で modprobe は モ ジ ュ ー ル を 削 除 す る 。 こ の オ プ シ ョ ン が な い 場 合 は 登 録 す る 。 依 存 す る モ ジ ュ ー ル も 使 わ れ て い な い 場 合 、 modprobe は そ れ ら も 削 除 し よ う と す る 。 登 録 と は 異 な り 、 複 数 の モ ジ ュ ー ル を コ マ ン ド ラ イ ン で 指 定 す る こ と が で き る (モ ジ ュ ー ル を 削 除 す る と き に モ ジ ュ ー ル パ ラ メ ー タ を 指 定 す る の は 意 味 が な い ) 。 通 常 は 、 モ ジ ュ ー ル を 削 除 す る 理 由 な ど な い が 、 不 具 合 の あ る モ ジ ュ ー ル に は 必 要 で あ る 。 使 っ て い る カ ー ネ ル が モ ジ ュ ー ル の 削 除 に 対 応 し て い な い か も し れ な い 。
−V −−version
プ ロ グ ラ ム の バ ー ジ ョ ン を 表 示 し 、 終 了 す る 。 古 い カ ー ネ ル で 実 行 す る 場 合 の 注 意 に つ い て は 下 を 参 照 。
−f −−force
モ ジ ュ ー ル か ら バ ー ジ ョ ン に 関 す る 情 報 を 取 り 除 こ う と す る (そ う し な い と ロ ー ド で き な い モ ジ ュ ー ル に 対 し て ) 。 こ の オ プ シ ョ ン は −−force−vermagic−−force−modversion オ プ シ ョ ン の 両 方 を 使 っ た の と 同 じ で あ る 。 当 然 の こ と な が ら 、 こ れ ら の チ ェ ッ ク は あ な た を 守 る た め に 存 在 す る の で あ っ て 、 こ の オ プ シ ョ ン を 使 う の は 危 険 で あ る 。 こ の オ プ シ ョ ン は 登 録 さ れ る す べ て の モ ジ ュ ー ル に 適 用 さ れ る 。 つ ま り 、 コ マ ン ド ラ イ ン で 指 定 し た モ ジ ュ ー ル (ま た は エ イ リ ア ス ) だ け で な く 、 依 存 す る モ ジ ュ ー ル に も 有 効 で あ る 。
−−force−vermagic
ど の モ ジ ュ ー ル に も 、 カ ー ネ ル や コ ン パ イ ラ の バ ー ジ ョ ン と い っ た 、 重 要 な 情 報 を 持 つ 短 い 文 字 列 が あ る 。 モ ジ ュ ー ル が ロ ー ド に 失 敗 し 、 カ ー ネ ル が "version magic" が 一 致 し な い と 文 句 を 言 う 場 合 、 こ の オ プ シ ョ ン を 使 っ て "version magic" を 削 除 す る こ と が で き る 。 当 然 の こ と な が ら 、 こ れ ら の チ ェ ッ ク は あ な た を 守 る た め に 存 在 す る の で あ っ て 、 こ の オ プ シ ョ ン を 使 う の は 危 険 で あ る 。 こ の オ プ シ ョ ン は 登 録 さ れ る す べ て の モ ジ ュ ー ル に 適 用 さ れ る 。 つ ま り 、 コ マ ン ド ラ イ ン で 指 定 し た モ ジ ュ ー ル (ま た は エ イ リ ア ス ) だ け で な く 、 依 存 す る モ ジ ュ ー ル に も 有 効 で あ る 。
−−force−modversion
モ ジ ュ ー ル が CONFIG_MODVERSIONS を セ ッ ト し て コ ン パ イ ル さ れ て い る 場 合 、 モ ジ ュ ー ル が 使 っ て い る (ま た は 提 供 す る ) ひ と つ ひ と つ の イ ン タ フ ェ ー ス の バ ー ジ ョ ン を 記 し た セ ク シ ョ ン が 生 成 さ れ る 。 モ ジ ュ ー ル が ロ ー ド に 失 敗 し 、 カ ー ネ ル が イ ン タ フ ェ ー ス の バ ー ジ ョ ン の 一 致 し な い も の が あ る と 文 句 を 言 う 場 合 、 "−−force−modversion" を 使 っ て バ ー ジ ョ ン 情 報 を ば っ さ り 削 除 す る こ と が で き る 。 当 然 の こ と な が ら 、 こ れ ら の チ ェ ッ ク は あ な た を 守 る た め に 存 在 す る の で あ っ て 、 こ の オ プ シ ョ ン を 使 う の は 危 険 で あ る 。 こ の オ プ シ ョ ン は 登 録 さ れ る す べ て の モ ジ ュ ー ル に 適 用 さ れ る 。 つ ま り 、 コ マ ン ド ラ イ ン で 指 定 し た モ ジ ュ ー ル (ま た は エ イ リ ア ス ) だ け で な く 、 依 存 す る モ ジ ュ ー ル に も 有 効 で あ る 。
−l −−list
指 定 さ れ た ワ イ ル ド カ ー ド (あ る い は ワ イ ル ド カ ー ド が 指 定 さ れ な い 場 合 "*") に 一 致 す る す べ て の モ ジ ュ ー ル を 列 挙 す る 。 こ の オ プ シ ョ ン は 下 位 互 換 性 の た め に 用 意 さ れ て い る 。 も っ と 柔 軟 性 の あ る 代 替 品 と し て 、 find(1)basename(1) を 参 照 。
−a −−all
指 定 さ れ た ワ イ ル ド カ ー ド に 一 致 す る 全 て の モ ジ ュ ー ル を 登 録 す る 。 こ の オ プ シ ョ ン は 下 位 互 換 性 の た め に 用 意 さ れ て い る 。 も っ と 柔 軟 性 の あ る 代 替 品 と し て 、 find(1)basename(1) を 参 照 。
−t −−type

−l を 指 定 さ れ た dirname に 一 致 す る デ ィ レ ク ト リ に あ る モ ジ ュ ー ル に 限 定 す る 。 こ の オ プ シ ョ ン は 下 位 互 換 性 の た め に 用 意 さ れ て い る 。 も っ と 柔 軟 性 の あ る 代 替 品 と し て 、 find(1)basename(1) を 参 照 。

−s −−syslog こ の オ プ シ ョ ン を 使 う と 、 す べ て の エ ラ ー メ ッ セ ー ジ が syslog の 仕 組 み で (LOG_NOTICE と い う レ ベ ル の LOG_DAEMON と し て ) 通 知 さ れ る よ う に な る 。 こ の オ プ シ ョ ン が な い 場 合 は 標 準 エ ラ ー に 出 力 さ れ る 。 こ の オ プ シ ョ ン は 標 準 エ ラ ー が 使 え な い 場 合 、 自 動 的 に 有 効 に な る 。 こ の オ プ シ ョ ン は install お よ び remove コ マ ン ド を 通 じ て 、 MODPROBE_OPTIONS 環 境 変 数 に あ る modprobe の 他 の コ マ ン ド に 渡 さ れ る 。
−−set−version
カ ー ネ ル バ ー ジ ョ ン を 設 定 す る 。 こ の オ プ シ ョ ン が な い 場 合 、 カ ー ネ ル バ ー ジ ョ ン (モ ジ ュ ー ル を 検 索 す る 場 所 を 表 す ) を 決 定 す る た め に uname(2) が 使 わ れ る 。 こ の オ プ シ ョ ン は 下 位 互 換 性 の チ ェ ッ ク も 無 効 に す る (そ の た め modprobe.old(8) は 一 切 実 行 さ れ な い ) 。
−−show−depends
モ ジ ュ ー ル (ま た は エ イ リ ア ス ) の 依 存 関 係 を 列 挙 す る 。 モ ジ ュ ー ル 自 身 も 含 ま れ る 。 こ の オ プ シ ョ ン は モ ジ ュ ー ル の フ ァ イ ル 名 の 集 合 (空 の 場 合 も あ る ) を 生 成 す る 。 1 行 に 1 個 の モ ジ ュ ー ル が 表 示 さ れ 、 先 頭 に "insmod" が 付 く 。 install コ マ ン ド が 適 用 さ れ る 場 合 、 先 頭 に "install" が 付 く 。 install コ マ ン ド は 一 切 実 行 し な い 。 modinfo(8) を 使 え ば モ ジ ュ ー ル 自 身 か ら モ ジ ュ ー ル の 依 存 関 係 を 取 り 出 す こ と が で き る が 、 エ イ リ ア ス や install コ マ ン ド に つ い て は 全 く 分 か ら な い こ と に 注 意 。
−o −−name
こ の オ プ シ ョ ン は カ ー ネ ル に 登 録 さ れ る モ ジ ュ ー ル の 名 前 を 変 更 し よ う と す る 。 テ ス ト 用 の モ ジ ュ ー ル に は 複 数 回 登 録 す る こ と の で き る も の が あ り 便 利 だ が 、 カ ー ネ ル は 同 じ 名 前 の モ ジ ュ ー ル が 2 個 あ る と 拒 否 す る 。 通 常 、 モ ジ ュ ー ル を 複 数 回 登 録 す る 必 要 は な い は ず で あ る 。 な ぜ な ら モ ジ ュ ー ル に 対 応 し て い な い 場 合 に 役 に 立 た な い か ら で あ る 。
−−first−time
通 常 、 modprobe は す で に 存 在 す る モ ジ ュ ー ル を 登 録 し よ う と し た 場 合 や 存 在 し な い モ ジ ュ ー ル を 削 除 し よ う と し た 場 合 に も 成 功 す る (そ し て 何 も し な い ) 。 こ の 振 る 舞 い は modutils と 下 位 互 換 性 が あ り 、 単 純 な ス ク リ プ ト に と っ て は 望 ま し い 。 し か し 、 も っ と 複 雑 な ス ク リ プ ト で は modprobe が 実 際 に 何 か を し た か ど う か を 知 り た く な る こ と も 多 い 。 こ の オ プ シ ョ ン は 上 の よ う な 場 合 、 modprobe が 失 敗 す る よ う に す る 。

下 位 互 換 性

こ の バ ー ジ ョ ン の modprobe は 、 カ ー ネ ル 2.5.48 お よ び そ れ 以 降 の た め の も の で あ る 。 古 い 形 式 の モ ジ ュ ー ル に 対 応 し た カ ー ネ ル を 検 出 す る と (そ の た め の ほ と ん ど の 処 理 は ユ ー ザ 空 間 で 行 な わ れ る ) 、 そ の 場 で modprobe.old を 実 行 し よ う と す る 。 そ の た め 、 ユ ー ザ は 全 く 意 識 し な く て よ い 。

環 境 変 数

MODPROBE_OPTIONS 環 境 変 数 も modprobe に 引 数 を 渡 す の に 使 う こ と が で き る 。

著 作 権

こ の マ ニ ュ ア ル ペ ー ジ の 著 作 権 表 示 は Copyright 2002, Rusty Russell, IBM Corporation.

関 連 項 目

modprobe.conf(5), lsmod(8), modprobe.old(8)