manual/kmod/draft/man5/modprobe.d.5

   1 '\" t
   2 .\"     Title: modprobe.d
   3 .\"    Author: Jon Masters <jcm@jonmasters.org>
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
   5 .\"      Date: 01/29/2021
   6 .\"    Manual: modprobe.d
   7 .\"    Source: kmod
   8 .\"  Language: English
   9 .\"
  10 .\"*******************************************************************
  11 .\"
  12 .\" This file was generated with po4a. Translate the source file.
  13 .\"
  14 .\"*******************************************************************
  15 .\"
  16 .\" Japanese Version Copyright (C) 2005 Suzuki Takashi,
  17 .\"         and 2022 ribbon,
  18 .\"         and 2022 Chonan Yoichi,
  19 .\"         all rights reserved.
  20 .\" Translated (modprobe.conf in module-init-tools) Sun Jul 10 22:56:20 JST 2005
  21 .\"         by Suzuki Takashi <JM@linux.or.jp>.
  22 .\" New Translation (kmod version 29) Tue May 31 2022
  23 .\"         by ribbon <ribbon@users.osdn.me>
  24 .\" Modified Tue Oct 25 09:28:07 JST 2022
  25 .\"         by Chonan Yoichi <cyoichi@maple.ocn.ne.ja>
  26 .\"
  27 .\" This program is free software: you can redistribute it and/or modify
  28 .\" it under the terms of the GNU General Public License as published by
  29 .\" the Free Software Foundation, either version 2 of the License, or
  30 .\" (at your option) any later version.
  31 .\"
  32 .\" This program is distributed in the hope that it will be useful,
  33 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  34 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  35 .\" GNU General Public License for more details.
  36 .\"
  37 .\" You should have received a copy of the GNU General Public License
  38 .\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
  39 .\"
  40 .TH MODPROBE\&.D 5 2021/01/29 kmod modprobe.d
  41 .ie  \n(.g .ds Aq \(aq
  42 .el       .ds Aq '
  43 .\" -----------------------------------------------------------------
  44 .\" * Define some portability stuff
  45 .\" -----------------------------------------------------------------
  46 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  47 .\" http://bugs.debian.org/507673
  48 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  49 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50 .\" -----------------------------------------------------------------
  51 .\" * set default formatting
  52 .\" -----------------------------------------------------------------
  53 .\" disable hyphenation
  54 .nh
  55 .\" disable justification (adjust text to left margin only)
  56 .ad l
  57 .\" -----------------------------------------------------------------
  58 .\" * MAIN CONTENT STARTS HERE *
  59 .\" -----------------------------------------------------------------
  60 .SH 名前
  61 modprobe.d \- modprobe 用の設定ディレクトリ
  62 .SH 概要
  63 .PP
  64 /lib/modprobe\&.d/*\&.conf
  65 .PP
  66 /usr/local/lib/modprobe\&.d/*\&.conf
  67 .PP
  68 /run/modprobe\&.d/*\&.conf
  69 .PP
  70 /etc/modprobe\&.d/*\&.conf
  71 .SH 説明
  72 .PP
  73 モジュールには依存関係があるので、\fBmodprobe\fP
  74 コマンドは、複数のモジュールを追加したり、取り外したりすることがありますが、そのため、
  75 そうした個々のモジュールにどんなオプションを使うべきかを指定する方法が必要になります。
  76 /etc/modprobe\&.d ディレクトリの直下にあるファイルで、.conf
  77 という拡張子で終わるもののすべてが、必要に応じて、そうしたオプションを指定しています。
  78 そうしたファイルは、使いやすいエイリアス、
  79 すなわちモジュールの別名を作るためにも使用することができます。
  80 また、そうしたファイルによって、(二つ以上のモジュールを組み込むといった)
  81 特別な要求を持つモジュールのために、標準の \fBmodprobe\fP
  82 の動作を全面的に変更することもできます。
  83 .PP
  84 モジュール名やエイリアス名では (後者の場合も、ほかのモジュール名と同様に)、\- や _
  85 を名前の一部に使うことができます。アンダースコアの変換が自動的に行われるので、
  86 モジュールコマンドのすべてにおいて、どちらを使っても同じであることに留意してください。
  87 .PP
  88 modprobe\&.d の下にあるファイルの書式は単純です。1 行 1 コマンドで、空行や
  89 \*(Aq#\*(Aq で始まる行は無視されます (後者はコメントを付けるのに使えます)。
  90 行末に 1 個の \*(Aq\e\*(Aq があると、その行は次の行に続くことになります。
  91 これを使うと、ファイルの見かけがちょっとよくなります。
  92 .SH コマンド
  93 .PP
  94 alias \fIwildcard\fP \fImodulename\fP
  95 .RS 4
  96 このコマンドを使えば、モジュールに別名を付けることができます。たとえば、"alias
  97 my\-mod really_long_modulename" と指定すると、"modprobe
  98 really_long_modulename" の代わりに "modprobe my\-mod"
  99 を使うことができます。シェル式のワイルドカードも使用できるので、
 100 "alias my\-mod* really_long_modulename" と指定すれば、
 101 "modprobe my\-mod\-something" でも同じ効果があります。
 102 ほかのエイリアスに対するエイリアスは作れませんが
 103 (そんなことをしたら、わけが分からなくなります)、
 104 エイリアスにもオプションを指定することはできます。その場合は、
 105 ほかにもオプションがあれば、そこに追加されることになるわけです
 106 (訳注: ここで言うオプションは、\fBmodprobe\fP(8) の「書式」で
 107 \fImodule\ parameter\fP と言われているもののこと)。
 108 .sp
 109 気をつけていただきたいのですが、
 110 モジュールは、自前のエイリアスを内蔵していることもあり、\fBmodinfo\fP
 111 を使えば、それを見ることができます。
 112 そうしたエイリアスは (訳注: モジュールを特定するとき) 最後の手段として利用されます
 113 (すなわち、指定された名前の実モジュールがなく、その名前に対応する
 114 \fBinstall\fP, \fBremove\fP, \fBalias\fP コマンドも設定ファイル中にない場合)。
 115 .RE
 116 .PP
 117 blacklist \fImodulename\fP
 118 .RS 4
 119 モジュールは、自前のエイリアスを内蔵していることがあります。たいていの場合、
 120 そうしたエイリアスは、そのモジュールがサポートしているデバイスを表していて、
 121 "pci:123\&.\&.\&." といったものです。こうした「内蔵」エイリアスも、通常の
 122 "alias" キーワードによって置き換えることができますが、
 123 二つ以上のモジュールが、どちらも同じデバイスをサポートしていたり
 124 (訳注: すなわち、同じ名前の内蔵エイリアスを持っていたり)、
 125 あるモジュールが、実際にはサポートしていないデバイスをサポートしていると、
 126 無効な主張をしていたりすることもあります。そうした場合に \fBblacklist\fP
 127 キーワードを使うと、そのモジュールの内蔵エイリアスをすべて無視せよと指示することになります。
 128 .RE
 129 .PP
 130 install \fImodulename\fP \fIcommand\&.\&.\&.\fP
 131 .RS 4
 132 このコマンドは、\fBmodprobe\fP
 133 に対して、いつもどおりカーネルにモジュールを組み込む代わりに、
 134 指定されたコマンドを実行するように指示します。
 135 指定するコマンドには任意のシェルコマンドが使えるので、
 136 どのような複雑な処理を望もうと、それを実行することができます。たとえば、
 137 モジュール "fred" は、モジュール "barney"
 138 がすでにインストールされているときの方が、うまく動作するとします
 139 (しかし、前者は後者に依存しているわけではないので、\fBmodprobe\fP
 140 は後者を自動的にロードしようとはしません)。そういう場合は、"install fred
 141 /sbin/modprobe barney; /sbin/modprobe \-\-ignore\-install fred"
 142 と、設定ファイルに書いておけばよいのです。そうすれば、
 143 希望する動作が行われることになります。
 144 \fB\-\-ignore\-install\fP に注意してください。これは、二番目の \fBmodprobe\fP
 145 が、ほかならぬこの \fBinstall\fP コマンドを繰り返し実行しないようにしているのです。
 146 以下の \fBremove\fP の項も参照してください。
 147 .sp
 148 このコマンドは、モジュールに補助的な依存モジュールを提供するという課題に対する一つの解決策ですが、
 149 長期的に見て、将来もそうである保証はありません。
 150 それどころか、このコマンドは、将来のリリースのある時点で、
 151 いずれ廃棄されるだろうとか、非推奨であるとかの警告に置き換えることが予定されています。
 152 このコマンドを使用すると、mkinitrd
 153 のようなディストリビューション固有のユーティリティが、
 154 依存するモジュールを自動的に判断しようとするとき、作業が複雑になるのです
 155 (なぜなら、現状では、そうしたユーティリティは、\fBinstall\fP
 156 コマンドがやっていそうなことを、何らかの方法で解読しなければならないからです)。
 157 完璧な世界でなら、このコマンドを使わないでも、モジュールは、
 158 依存関係の情報を漏れなく提供することでしょう。実際、ゆるやかな依存関係のサポートを
 159 Linux カーネルの内部で実装しようとする作業が、現在進行しています。
 160 .sp
 161 このコマンド中で、"$CMDLINE_OPTS" という文字列を使用すると、
 162 \fBmodprobe\fP のコマンドラインでオプションを指定した場合に、そのオプションが
 163 "$CMDLINE_OPTS" に置き換わります (訳注: このオプションは、上の \fBalias\fP
 164 コマンドの訳注でも述べましたが、\fBmodprobe\fP(8) の「書式」で \fImodule parameter\fP
 165 と言われているもののことです)。この動作は重宝なことがあります。
 166 なぜなら、ユーザとしては、"modprobe fred opt=1" とコマンドライン上で指定したら、
 167 設定ファイル中に \fBinstall\fP コマンドが存在する場合でも、モジュールに
 168 "opt=1" という引数が渡ってほしいと思うからです。そこで、上記の例でこれを使うと、
 169 "install fred /sbin/modprobe barney;
 170 /sbin/modprobe \-\-ignore\-install fred $CMDLINE_OPTS" になります。
 171 .RE
 172 .PP
 173 options \fImodulename\fP \fIoption\&.\&.\&.\fP
 174 .RS 4
 175 このコマンドを使えば、モジュール \fImodulename\fP (エイリアスであっても構いません)
 176 がカーネルに組み込まれるたびに、それにオプションを付け加えることができます。
 177 組み込みは、(\fBmodprobe \fP \fImodulename\fP を使って) 直接行われるか、
 178 組み込もうとするモジュールがこのモジュールに依存しているために行われるかを問いません。
 179 .sp
 180 すべてのオプションは、まとめて付け加えられます。そうしたオプションには、
 181 モジュールそのものやエイリアスに対して \fBoptions\fP
 182 コマンドで指定したものあれば、コマンドラインで指定したものもあるわけです。
 183 .RE
 184 .PP
 185 remove \fImodulename\fP \fIcommand\&.\&.\&.\fP
 186 .RS 4
 187 これは上記の \fBinstall\fP コマンドに似ていますが、"modprobe \-r"
 188 が実行されるときに、呼び出される点が異なっています。
 189 .RE
 190 .PP
 191 softdep \fImodulename\fP pre: \fImodules\&.\&.\&.\fP post: \fImodules\&.\&.\&.\fP
 192 .RS 4
 193 \fBsoftdep\fP コマンドを使えば、
 194 ゆるやかな、すなわち使用・不使用が任意なモジュールの依存関係を指定できます。
 195 \fImodulename\fP というモジュールは、
 196 そうした使用・不使用が任意なモジュールをインストールしないでも、使うことができます。
 197 でも、たいていの場合、何らかの機能が使えないことになります。
 198 たとえば、ある記憶装置の HBA (ホストバスアダプタ) 用のドライバは、
 199 管理機能を使うためには、別のモジュールをロードする必要があるかもしれません。
 200 .sp
 201 前依存モジュールや後依存モジュール (訳注: 上記 \fBsoftdep\fP の書式の pre: や
 202 post: に続く \fImodules\&.\&.\&.\fP) は、\fImodulename\fP
 203 という引数によって指定されたメインモジュールの前後に、\fBmodprobe\fP
 204 が 順番に組み込み (あるいは、取り外し)
 205 を試みるほかのモジュールの名前やエイリアスのリストです。
 206 .sp
 207 用例: "softdep c pre: a b post: d e"
 208 という設定がなされているとします。このとき、"modprobe c" を実行するのは、この
 209 softdep コマンドを設定せずに、"modprobe \-\-all a b c d e"
 210 を行うのと同じことです。なお、\-\-use\-blacklist
 211 のようなフラグは、指定されたすべてのモジュールに適用されますが、
 212 モジュールパラメータが適用されるのは、モジュール c だけです。
 213 .sp
 214 注意: 同じ \fImodulename\fP 引数を取る \fBinstall\fP や \fBremove\fP
 215 コマンドが設定ファイル中にあっても、\fBsoftdep\fP が優先されます。
 216 .RE
 217 .SH 互換性
 218 .PP
 219 kmod の将来のバージョンでは、上で述べたように、\fBinstall\fP
 220 の使用は避けるべきだとの強い警告が出ることになるでしょう。
 221 そうなるのは、カーネル中でのゆるやかな依存関係に対するサポートが完成したときのことです。
 222 そうしたサポートでは、ゆるやかな依存関係の情報をモジュール内で直接提供することによって、
 223 kmod ユーティリティ内での softdep
 224 による現在のサポートを補完することになるでしょう。
 225 .SH 著作権
 226 .PP
 227 このマニュアルページの最初の版は、"Copyright 2004, Rusty Russell,
 228 IBM Corporation" でした。現在では、Jon Masters ほか数名によって保守されています。
 229 .SH 関連項目
 230 .PP
 231 \fBmodprobe\fP(8), \fBmodules.dep\fP(5)
 232 .SH 著者
 233 .PP
 234 \fBJon Masters\fP <\&jcm@jonmasters\&.org\&>
 235 .RS 4
 236 開発者
 237 .RE
 238 .PP
 239 \fBRobby Workman\fP <\&rworkman@slackware\&.com\&>
 240 .RS 4
 241 開発者
 242 .RE
 243 .PP
 244 \fBLucas De Marchi\fP <\&lucas\&.de\&.marchi@gmail\&.com\&>
 245 .RS 4
 246 開発者
 247 .RE