'\" t
.\"     Title: modprobe
.\"    Author: Jon Masters <jcm@jonmasters.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 01/29/2021
.\"    Manual: modprobe
.\"    Source: kmod
.\"  Language: English
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\"
.\" Japanese Version Copyright (C) 2005 Suzuki Takashi,
.\"         and 2022 ribbon,
.\"         and 2022 Chonan Yoichi,
.\"         all rights reserved.
.\" Translated (module-init-tools) Sun Jul 10 00:42:36 JST 2005
.\"         by Suzuki Takashi <JM@linux.or.jp>.
.\" New Translation (kmod version 29) Tue May 31 2022
.\"         by ribbon <ribbon@users.osdn.me>
.\" Modified Tue Oct 25 09:28:07 JST 2022
.\"         by Chonan Yoichi <cyoichi@maple.ocn.ne.jp>
.\"
.\" This program is free software: you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation, either version 2 of the License, or
.\" (at your option) any later version.
.\" 
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\" 
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.\"
.TH MODPROBE 8 2021/01/29 kmod modprobe
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH 名前
modprobe \- Linux カーネルに対してモジュールの着脱を行う
.SH 書式
.HP \w'\fBmodprobe\fR\ 'u
\fBmodprobe\fP [\fB\-v\fP] [\fB\-V\fP] [\fB\-C\ \fP\fIconfig\-file\fP] [\fB\-n\fP] [\fB\-i\fP] [\fB\-q\fP]
[\fB\-b\fP] [\fImodulename\fP] [\fImodule\ parameters\fP...]
.HP \w'\fBmodprobe\fR\ 'u
\fBmodprobe\fP [\-r] [\fB\-v\fP] [\fB\-n\fP] [\fB\-i\fP] [\fImodulename\fP...]
.HP \w'\fBmodprobe\fR\ 'u
\fBmodprobe\fP [\-c]
.HP \w'\fBmodprobe\fR\ 'u
\fBmodprobe\fP [\-\-dump\-modversions] [\fIfilename\fP]
.SH 説明
.PP
\fBmodprobe\fP は、Linux
カーネルに対して頭のよいやり方でモジュールの追加や取り外しを行います。
なお、ユーザの便宜を考慮して、モジュール名に含まれる _ と \- とを区別しません
(アンダースコアへの変換が自動的に行われます)。
\fBmodprobe\fP は、モジュールディレクトリ /lib/modules/`uname \-r`
を見て、すべてのモジュールやそのほかのファイルをそれ以下に捜します。
ただし、作成が任意の設定ファイルについては、/etc/modprobe\&.d
ディレクトリを調べます (\fBmodprobe.d\fP(5) 参照)。
\fBmodprobe\fP はまた、カーネルコマンドラインで指定された、
モジュールオプションやブラックリストも使用します。前者の書式は
<module>\&.<option>
であり、後者の書式は modprobe\&.blacklist=<module> です。
.PP
なお、2\&.4 系列の Linux カーネル (このツールはサポートしていません)
の場合とは違って、当バージョンの \fBmodprobe\fP
は、モジュールそのものに対しては何の操作も行いません。
シンボルの解決やパラメータの解釈といった作業は、
カーネルの内部で行われます。そこで、モジュールの処理に失敗すると、
カーネルメッセージが出ることがあります。\fBdmesg\fP(8) を参照してください。
.PP
\fBmodprobe\fP は、modules\&.dep\&.bin
ファイルが最新であることを当てにしています。このファイルは、\fBmodprobe\fP
と一緒に配布され、現在の \fBmodprobe\fP に対応している
\fBdepmod\fP(8) ユーティリティによって生成されます
(\fBdepmod\fP(8) 参照)。 modules\&.dep\&.bin
は、各モジュールが、ほかのどんなモジュールを必要としているかを
(そういったものがあれば) リストしており、\fBmodprobe\fP は、このファイルを使用して、
そうした依存するモジュールを自動的に追加したり、取り外したりします。
.PP
\fImodulename\fP の後ろに引数を付けると、そうした引数はカーネルに渡されます
(設定ファイルで指定しているモジュールオプション
[訳注: モジュールパラメータとも言います] があれば、そこに追加されるわけです)。
.SH オプション
.PP
\fB\-a\fP, \fB\-\-all\fP
.RS 4
コマンドラインで指定されたモジュール名をすべて組み込みます。
.RE
.PP
\fB\-b\fP, \fB\-\-use\-blacklist\fP
.RS 4
このオプションを指定すると、\fBmodprobe\fP は、設定ファイルに \fBblacklist\fP
コマンドがあれば、それもモジュール名に対して適用します。
このオプションは通常、\fBudev\fP(7) によって使用されます。
.RE
.PP
\fB\-C\fP, \fB\-\-config\fP
.RS 4
このオプションは、設定ディレクトリをデフォルトの /etc/modprobe\&.d
から変更します。
.sp
このオプションは、環境変数 MODPROBE_OPTIONS に入れられて、\fBinstall\fP や
\fBremove\fP コマンド経由で、ほかの \fBmodprobe\fP コマンドにも渡されます。
.RE
.PP
\fB\-c\fP, \fB\-\-showconfig\fP
.RS 4
設定ディレクトリを読み込み、有効な設定を標準出力に書き出して、終了します。
.RE
.PP
\fB\-\-dump\-modversions\fP
.RS 4
あるモジュールが要求している、そのモジュールのバージョン管理情報のリストを表示します。
このオプションは通常、モジュールのバージョン管理の依存情報を利用して Linux
のカーネルモジュールをパッケージにまとめるために、
ディストリビューションによって使用されます。
.RE
.PP
\fB\-d\fP, \fB\-\-dirname\fP
.RS 4
モジュール群にとってのルートディレクトリ。デフォルトでは / です。
.RE
.PP
\fB\-\-first\-time\fP
.RS 4
通常、\fBmodprobe\fP は、すでに存在するモジュールの組み込みや、
存在しないモジュールの取り外しを命じられても、処理に成功したものとして
(何もせずに) 終了します。これは単純なスクリプトではまったく問題がありません。
でも、より複雑なスクリプトでは、\fBmodprobe\fP
が実際に何らかの処理を行ったかどうかを知りたいことがよくあります。
このオプションを使うと、\fBmodprobe\fP は、実際には何もしなかった場合、
実行に失敗したことになります。
.RE
.PP
\fB\-\-force\-vermagic\fP
.RS 4
どのモジュールの中にも、
カーネルやコンパイラのバージョンといった重要な情報を含む短い文字列が存在します。
モジュールのロードに失敗して、
カーネルが「バージョンマジックが一致しない」と苦情を言って来る場合、
このオプションを使えば、そのバージョンマジックを除去することができます。
言うまでもありませんが、こうしたチェックは、
ユーザを守るためにあるのですから、自分のやっていることがよくわかっていないかぎり、
このオプションを使うのは危険です。
.sp
このオプションは、組み込まれるどんなモジュールにも適用されます。
すなわち、コマンドラインで指定されたモジュール (やエイリアス) だけでなく、
それが依存するモジュールがあれば、それにも適用されます。
.RE
.PP
\fB\-\-force\-modversion\fP
.RS 4
CONFIG_MODVERSIONS を有効にして、モジュールをコンパイルすると、
そのモジュールが利用する (あるいは、提供する)
すべてのインターフェースのバージョンを記録したセクションが、モジュール内に作られます。
モジュールのロードに失敗して、カーネルが「モジュールのインターフェースに、
バージョンがカーネル側と一致しないものがある」と苦情を言って来る場合、
"\-\-force\-modversion" を使えば、そうしたバージョン情報をそっくり除去することができます。
言うまでもありませんが、こうしたチェックは、ユーザを守るためにあるのですから、
自分のやっていることがよくわかっていないかぎり、このオプションを使うのは危険です。
.sp
このオプションは、組み込まれるどんなモジュールにも適用されます。
すなわち、コマンドラインで指定されたモジュール (やエイリアス) だけでなく、
それが依存するモジュールがあれば、それにも適用されます。
.RE
.PP
\fB\-f\fP, \fB\-\-force\fP
.RS 4
バージョン管理に関する情報がモジュールにあると、ロードが中断しかねない場合に、
モジュールからそうした情報をすべて取り除こうとします。
これは \fB\-\-force\-vermagic\fP と \fB\-\-force\-modversion\fP
の両方を使用するのと同じことです。
言うまでもありませんが、こうしたチェックはユーザを守るためにあるのですから、
自分のやっていることがよくわかっていないかぎり、このオプションを使うのは危険です。
.sp
このオプションは、組み込まれるどんなモジュールにも適用されます。
すなわち、コマンドラインで指定されたモジュール (やエイリアス) だけでなく、
それが依存するモジュールがあれば、それにも適用されます
.RE
.PP
\fB\-i\fP, \fB\-\-ignore\-install\fP, \fB\-\-ignore\-remove\fP
.RS 4
このオプションを使うと、\fBmodprobe\fP
は、コマンドラインで指定されたモジュールに対して設定ファイル中に
install や remove コマンドが存在しても、それを無視します
(依存するモジュールについては、このオプションを指定した場合でも、
設定ファイル中でそのモジュールに対して設定されているコマンドの対象になります)。
現状では、このオプションを使用した場合、\fBinstall\fP と \fBremove\fP
の両方のコマンドが無視されることになります。
\fB\-\-ignore\-install\fP や \fB\-\-ignore\-remove\fP の片方のみを使って
(そして、両方を使うことなく) より具体的に指定しても、動作は変わりません。
\fBmodprobe.d(5)\fP を参照してください。
.RE
.PP
\fB\-n\fP, \fB\-\-dry\-run\fP, \fB\-\-show\fP
.RS 4
このオプションを指定すると、実際にモジュールを組み込んだり、取り外したり
(それに、install や remove コマンドを実行したり) する以外のあらゆることを行います。
\fB\-v\fP オプションと組み合わせると、問題が起きたときのデバッグに便利です。
歴史的な理由から  \fB\-\-dry\-run\fP と \fB\-\-show\fP は事実上同じ意味なので、
どちらを使っても構いません。
.RE
.PP
\fB\-q\fP, \fB\-\-quiet\fP
.RS 4
このフラグを使用すると、\fBmodprobe\fP は、モジュールを取り外したり、
組み込んだりしようとして、それが見つからなかった場合に
(しかも、それがエイリアスの名前でも、\fBinstall\fP や \fBremove\fP
コマンドの対象でもなかった場合に)、エラーメッセージを出さなくなります。それでも、
ゼロ以外のステータスで終了することに変わりはありません。なお、カーネルは、
存在するかどうかが不確かなモジュールの探索を request_module
関数を使って便宜主義的に行うために、このフラグを使用します。
.RE
.PP
\fB\-R\fP, \fB\-\-resolve\-alias\fP
.RS 4
あるエイリアスに対応するモジュール名をすべて表示します。
モジュールのエイリアスに問題がある場合、デバッグの役に立つかもしれません。
.RE
.PP
\fB\-r\fP, \fB\-\-remove\fP
.RS 4
このオプションを指定すると、\fBmodprobe\fP は、モジュールを組み込む代わりに、
それを取り外します。そのモジュールが依存しているモジュールも使用されていない場合は、
それもまた取り外そうとします。組み込みを行う場合とは違って、
複数のモジュールをコマンドラインで指定することができます
(モジュールを取り外す場合には、モジュールパラメータを指定しても意味がありません)。
.sp
通常は、モジュールを取り外す理由などありませんが、
モジュールにバグのある場合には、それが必要になることもあります。
もっとも、ご使用のディストリビューションのカーネルは、
モジュール取り外しのサポートを有効にしてビルドされていないかもしれません。
.RE
.PP
\fB\-S\fP, \fB\-\-set\-version\fP
.RS 4
カーネルのバージョンを設定します。すなわち、カーネルのバージョン
(それによって、モジュールを探しに行く場所が決まります)
を判断するのに、\fBuname\fP(2) を使用しません。
.RE
.PP
\fB\-\-show\-depends\fP
.RS 4
あるモジュール (または、エイリアス) の依存関係を、そのモジュール自体も含めて、
一覧表示します。モジュールファイル名の集合 (空集合のこともあります) が、1 行に
1 ファイルずつ、各行の先頭に "insmod" を付けて、出力されます。
このオプションの代表的な使い道は、ディストリビューションが initrd/initramfs
イメージを作成するとき、どのモジュールを収録するかを決めるのに使うことです。
\fBInstall\fP コマンドが適用されている場合は、"install"
という文字列を行頭に置くことで、それを示しますが、そうした install
コマンドが実行されるわけではありません。なお、\fBmodinfo\fP(8) を使えば、
モジュールの依存関係をそのモジュール自体から取り出すことができますが、
\fBmodinfo\fP は、設定ファイルの alias や install といったコマンドについては、
何も知らないことに注意してください。
.RE
.PP
\fB\-s\fP, \fB\-\-syslog\fP
.RS 4
このオプションを指定すると、エラーメッセージがある場合に、
それを標準エラーに送るのではなく、syslog の仕組みを通して出力します
(LOG_NOTICE レベルの LOG_DAEMON として扱われます)。
このオプションは、標準エラーが使えない場合にも、自動的に有効になります。
.sp
このオプションは、環境変数 MODPROBE_OPTIONS に入れられて、\fBinstall\fP や
\fBremove\fP コマンド経由で、ほかの \fBmodprobe\fP コマンドにも渡されます。
.RE
.PP
\fB\-V\fP, \fB\-\-version\fP
.RS 4
プログラムのバージョンを表示して終了します。
.RE
.PP
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
プログラムが何をやっているかについてメッセージを表示します。通常
modprobe がメッセージを出すのは、何かがうまく行かなかったときだけです。
.sp
このオプションは、環境変数 MODPROBE_OPTIONS に入れられて、\fBinstall\fP や
\fBremove\fP コマンド経由で、ほかの \fBmodprobe\fP コマンドにも渡されます。
.RE
.SH 環境変数
.PP
環境変数 MODPROBE_OPTIONS は、\fBmodprobe\fP
コマンドに引数を渡すためにユーザが使用することもできます。
.SH 著作権
.PP
このマニュアルページの最初の版は、"Copyright 2002, Rusty Russell, IBM Corporation"
でした。現在では、Jon Masters ほか数名によって保守されています。
.SH 関連項目
.PP
\fBmodprobe.d\fP(5), \fBinsmod\fP(8), \fBrmmod\fP(8), \fBlsmod\fP(8), \fBmodinfo\fP(8)
\fBdepmod\fP(8)
.SH 著者
.PP
\fBJon Masters\fP <\&jcm@jonmasters\&.org\&>
.RS 4
開発者
.RE
.PP
\fBRobby Workman\fP <\&rworkman@slackware\&.com\&>
.RS 4
開発者
.RE
.PP
\fBLucas De Marchi\fP <\&lucas\&.de\&.marchi@gmail\&.com\&>
.RS 4
開発者
.RE