manual/module-init-tools/draft/man5/modprobe.conf.5

   1 .\" This manpage has been automatically generated by docbook2man
   2 .\" from a DocBook document.  This tool can be found at:
   3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
   4 .\" Please send any bug reports, improvements, comments, patches,
   5 .\" etc. to Steve Cheng <steve@ggi-project.org>.
   6 .\"
   7 .\" Japanese Version Copyright (C) 2005 Suzuki Takashi
   8 .\"         all rights reserved.
   9 .\" Translated Sun Jul 10 22:56:20 JST 2005
  10 .\"         by Suzuki Takashi <JM@linux.or.jp>.
  11 .\"
  12 .\"WORD:        insert          登録する
  13 .\"
  14 .TH "MODPROBE.CONF" "5" "1 June 2005" "" ""
  15
  16 .\"O .SH NAME
  17 .SH "名前"
  18 .\"O modprobe.conf, modprobe.d \- Configuration file/directory for modprobe
  19 modprobe.conf, modprobe.d \- modprobe の設定ファイル・ディレクトリ
  20 .\"O .SH "DESCRIPTION"
  21 .SH "説明"
  22 .PP
  23 .\"O Because the \fBmodprobe\fR command can add or
  24 .\"O remove extra more than one module, due to module dependencies,
  25 .\"O we need a method of specifying what options are to be used with
  26 .\"O those modules.  \fI/etc/modprobe.conf\fR (or, if that does not exist, all files under the \fI/etc/modprobe.d\fR directory) specifies
  27 .\"O those options, as required.  It can also be used to create
  28 .\"O convenient aliases: alternate names for a module.  Finally, it
  29 .\"O can override the normal \fBmodprobe\fR behavior
  30 .\"O altogether, for those with very special requirements (such as
  31 .\"O inserting more than one module).
  32 \fBmodprobe\fR コマンドはモジュールの依存関係に応じて
  33 複数のモジュールを追加したり削除したりできるため、
  34 これらのモジュールにどのオプションを使うかを指定する手段が必要である。
  35 \fI/etc/modprobe.conf\fR (または \fI/etc/modprobe.conf\fR が存在しない場合、
  36 \fI/etc/modprobe.d\fR ディレクトリ以下のすべてのファイル) は
  37 必要に応じてこれらのオプションを指定する。
  38 また、便利なようにエイリアス (モジュールの別名) を作成するためにも用いられる。
  39 最後に、
  40 (複数のモジュールを登録するなどの) 特別な要求に応えるために、
  41 \fBmodprobe\fR の通常の振る舞いを完全に無効にして乗っ取ることができる。
  42 .PP
  43 .\"O Note that module and alias names (like other module names) can
  44 .\"O have - or _ in them: both are interchangable throughout all the
  45 .\"O module commands.
  46 モジュール名やエイリアス名には (他のモジュール名と同様に)
  47 \- や _ を含めることができる。
  48 ここで、 \- と _ はすべてのモジュールコマンドにおいて、
  49 互いに入れ替え可能である (区別されない) ことに注意。
  50 .PP
  51 .\"O The format of \fImodprobe.conf\fR and files under \fImodprobe.d\fR is simple: one
  52 .\"O command per line, with blank lines and lines starting with #
  53 .\"O ignored (useful for adding comments).  A \\ at the end of a line
  54 .\"O causes it to continue on the next line, which makes the file a
  55 .\"O bit neater.
  56 \fImodprobe.conf\fR や \fImodprobe.d\fR 以下のファイルの形式は単純である。
  57 1 行に 1 コマンドで、
  58 空行と # で始まる行は無視される (コメントを追加するのに使える) 。
  59 行末の \\ は次の行に続くことを意味し、これを使えばファイルが少し見やすくなる。
  60 .PP
  61 .\"O The syntax is a simplification of \fImodules.conf\fR, used in 2.4 kernels and earlier.
  62 書式は 2.4 以前のカーネルで使われていた \fImodules.conf\fR を
  63 簡単にしたものである。
  64 .\"O .SH "COMMANDS"
  65 .SH "コマンド"
  66 .TP
  67 \fBalias \fIwildcard\fB \fImodulename\fB \fR
  68 .\"O This allows you to give alternate names for a module.  For
  69 .\"O example: "alias my-mod really_long_modulename"
  70 .\"O means you can use "modprobe my-mod" instead of "modprobe
  71 .\"O really_long_modulename".  You can also use shell-style
  72 .\"O wildcards, so "alias my-mod* really_long_modulename"
  73 .\"O means that "modprobe my-mod-something" has the same
  74 .\"O effect.  You can't have aliases to other aliases (that
  75 .\"O way lies madness), but aliases can have options, which
  76 .\"O will be added to any other options.
  77 モジュールの別名を付ける。
  78 例えば、 "alias my-mod really_long_modulename" とすると、
  79 "modprobe really_long_modulename" の代わりに
  80 "modprobe my-mod" を使うことができる。
  81 シェル形式のワイルドカードも使うことができ、
  82 "alias my-mod* really_long_modulename" とすると
  83 "modprobe my-mod-something" も同じ効果となる。
  84 他のエイリアスに対するエイリアスを設定することはできない
  85 (正しく動作しない) が、
  86 エイリアスにオプションを設定することができ、
  87 それらは他のオプションに追加される。
  88 .\"O Note that modules can also contain their own aliases,
  89 .\"O which you can see using \fBmodinfo\fR.  These
  90 .\"O aliases are used as a last resort (ie. if there is no real
  91 .\"O module, \fBinstall\fR,
  92 .\"O \fBremove\fR, or \fBalias\fR
  93 .\"O command in the configuration).
  94 モジュールはそれ自身にエイリアスを持つことができる点に注意。
  95 それらは \fBmodinfo\fR で見ることができる。
  96 これらのエイリアスは最後の望みとして使われる
  97 (つまり、その名前の実モジュールもなく、設定ファイル中に
  98 その名前の \fBinstall\fR, \fBremove\fR, \fBalias\fR コマンドが
  99 存在しない場合に使われる) 。
 100 .TP
 101 \fBoptions \fImodulename\fB \fIoption...\fB \fR
 102 .\"O This command allows you to add options to the module
 103 .\"O \fImodulename\fR (which might be an
 104 .\"O alias) every time it is inserted into the kernel: whether
 105 .\"O directly (using \fBmodprobe\fR
 106 .\"O \fImodulename\fR, or because the
 107 .\"O module being inserted depends on this module.
 108 このコマンドで
 109 モジュール \fImodulename\fR (エイリアスも可) に
 110 オプションを追加することができる。
 111 ここで設定されたオプションは
 112 カーネルに登録される際に毎回使われ、
 113 (\fBmodprobe\fR \fImodulename\fR で) 直接登録される場合にも
 114 そのモジュールに依存するモジュールと一緒に登録される場合にも
 115 使われる。
 116
 117 .\"O All options are added together: they can come from an
 118 .\"O \fBoption\fR for the module itself, for an
 119 .\"O alias, and on the command line.
 120 モジュール自身に対する \fBoption\fR 、
 121 エイリアスに対する \fBoption\fR 、
 122 コマンドラインのオプションは、
 123 全てのオプションがいっしょに渡される。
 124 .TP
 125 \fBinstall \fImodulename\fB \fIcommand...\fB \fR
 126 .\"O This is the most powerful primitive in
 127 .\"O \fImodprobe.conf\fR: it tells
 128 .\"O \fBmodprobe\fR to run your command instead of
 129 .\"O inserting the module in the kernel as normal.  The command
 130 .\"O can be any shell command: this allows you to do any kind
 131 .\"O of complex processing you might wish.  For example, if the
 132 .\"O module "fred" worked better with the module "barney"
 133 .\"O already installed (but it didn't depend on it, so
 134 .\"O \fBmodprobe\fR won't automatically load it),
 135 .\"O you could say "install fred /sbin/modprobe barney;
 136 .\"O /sbin/modprobe --ignore-install fred", which would do what
 137 .\"O you wanted.  Note the \fB--ignore-install\fR,
 138 .\"O which stops the second \fBmodprobe\fR from
 139 .\"O re-running the same \fBinstall\fR command.
 140 .\"O See also \fBremove\fR below
 141 \fImodprobe.conf\fR の中でもっとも強力なコマンドである。
 142 \fBmodprobe\fR は、
 143 通常はカーネルにモジュールを登録するが、
 144 install コマンドを記述すると、
 145 代わりにここで指定された command を実行する。
 146 command はどんなシェルコマンドでもよい。
 147 そのため、どんな複雑な処理でも思いどおりに指定できる。
 148 例えば、モジュール "fred" が、
 149 "barney" がインストールされている状態のほうが
 150 うまく動作する (が依存関係にないので
 151 \fBmodprobe\fR が自動的にロードしない) 場合、
 152 "install fred /sbin/modprobe barney;
 153 /sbin/modprobe --ignore-install fred" と書けば、
 154 望みどおりのことをさせることができる。
 155 ここで、 \fB--ignore-install\fR は
 156 2 番目の \fBmodprobe\fR が同じ \fBinstall\fR コマンドを
 157 再び実行しないようにするためのものである。
 158 \fBremove\fR も参照。
 159
 160 .\"O You can also use \fBinstall\fR to make up
 161 .\"O modules which don't otherwise exist.  For example:
 162 .\"O "install probe-ethernet /sbin/modprobe e100 ||
 163 .\"O /sbin/modprobe eepro100", which will try first the e100
 164 .\"O driver, then the eepro100 driver, when you do "modprobe
 165 .\"O probe-ethernet".
 166 \fBinstall\fR を使って、
 167 実際には存在しないモジュールを作ることもできる。
 168 例えば、
 169 "install probe-ethernet /sbin/modprobe e100 ||
 170 /sbin/modprobe eepro100" と書けば、
 171 "modprobe probe-ethernet" としたときに、
 172 まず e100 ドライバを試し、次に eepro100 を試す。
 173
 174 .\"O If you use the string "$CMDLINE_OPTS" in the command, it
 175 .\"O will be replaced by any options specified on the modprobe
 176 .\"O command line.  This can be useful because users expect
 177 .\"O "modprobe fred opt=1" to pass the "opt=1" arg to the
 178 .\"O module, even if there's an install command in the
 179 .\"O configuration file.  So our above example becomes "install
 180 .\"O fred /sbin/modprobe barney; /sbin/modprobe
 181 .\"O --ignore-install fred $CMDLINE_OPTS"
 182 コマンドの中で "$CMDLINE_OPTS" という文字列を使うと、
 183 modprobe のコマンドラインで指定したオプションに置き換えられる。
 184 これを使うと、
 185 設定ファイルに install コマンドが存在していても、
 186 ユーザは "modprobe fred opt=1" というコマンドラインで
 187 モジュールに "opt=1" というオプションを渡すことができ、便利である。
 188 つまり、上の例では設定ファイルに
 189 "install
 190 fred /sbin/modprobe barney; /sbin/modprobe
 191 --ignore-install fred $CMDLINE_OPTS" のように書けばよい。
 192 .TP
 193 \fBremove \fImodulename\fB \fIcommand...\fB \fR
 194 .\"O This is similar to the \fBinstall\fR command
 195 .\"O above, except it is invoked when "modprobe -r" is run.
 196 .\"O The removal counterparts to the two examples above would
 197 .\"O be: "remove fred /sbin/modprobe -r --ignore-remove fred &&
 198 .\"O /sbin/modprobe -r barney", and "remove probe-ethernet
 199 .\"O /sbin/modprobe -r eepro100 || /sbin/modprobe -r e100".
 200 上の \fBinstall\fR コマンドと同様であるが、
 201 "modprobe -r" が呼び出されたときに実行される。
 202 上の 2 つの例を削除にあてはめると、
 203 "remove fred /sbin/modprobe -r --ignore-remove fred &&
 204 /sbin/modprobe -r barney" および
 205 "remove probe-ethernet
 206 /sbin/modprobe -r eepro100 || /sbin/modprobe -r e100" のようになる。
 207 .TP
 208 \fBinclude \fIfilename\fB \fR
 209 .\"O Using this command, you can include other configuration
 210 .\"O files, or whole directories, which is occasionally useful.  Note that aliases in
 211 .\"O the included file will override aliases previously
 212 .\"O declared in the current file.
 213 このコマンドを使うと、
 214 他の設定ファイルまたはディレクトリ全体を読み込むことができ、
 215 これが便利なこともある。
 216 読み込まれたファイル中のエイリアスは
 217 現在のファイルで定義されたエイリアスを上書きすることに注意。
 218 .TP
 219 \fBblacklist \fImodulename\fB \fR
 220 .\"O Modules can contain their own aliases: usually these are
 221 .\"O aliases describing the devices they support, such as
 222 .\"O "pci:123...".  These "internal" aliases can be overridden
 223 .\"O by normal "alias" keywords, but there are cases where two
 224 .\"O or more modules both support the same devices, or a module
 225 .\"O invalidly claims to support a device: the
 226 .\"O \fBblacklist\fR keyword indicates that all of
 227 .\"O a particular module's internal aliases are to be ignored.
 228 モジュールはそれ自身にエイリアスを持つことができる。
 229 通常、これらは "pci:123..." といったように、
 230 サポートするデバイスを表すエイリアスである。
 231 これらの「内部」エイリアスは
 232 通常の "alias" キーワードで上書きすることができる。
 233 しかし、 2 つ以上のモジュールが同じデバイスをサポートする場合や、
 234 モジュールがサポートしないデバイスをサポートするとしている場合もある。
 235 このような場合、 \fBblacklist\fR キーワードを使って、
 236 あるモジュールのすべての内部エイリアスを無視させることができる。
 237 .\"O .SH "BACKWARDS COMPATIBILITY"
 238 .SH "下位互換性"
 239 .PP
 240 .\"O There is a \fBgenerate_modprobe.conf\fR program
 241 .\"O which should do a reasonable job of generating
 242 .\"O \fImodprobe.conf\fR from your current (2.4 or
 243 .\"O 2.2) modules setup.
 244 現在の (2.4 または 2.2 の) モジュール設定から
 245 \fImodprobe.conf\fR を生成してくれる
 246 \fBgenerate_modprobe.conf\fR というプログラムがある。
 247 .PP
 248 .\"O Although the syntax is similar to the older
 249 .\"O \fI/etc/modules.conf\fR, there are many features
 250 .\"O missing.  There are two reasons for this: firstly, install and
 251 .\"O remove commands can do just about anything, and secondly, the
 252 .\"O module-init-tools modprobe is designed to be simple enough that
 253 .\"O it can be easily replaced.
 254 書式は以前の \fI/etc/modules.conf\fR と似ているが、
 255 多くの機能が削除されている。
 256 これには 2 つの理由がある:
 257 まず、 install および remove コマンドでほとんど何でもできる。
 258 二つ目に、 module-init-tools の modprobe は
 259 他のツールで簡単に置き換えることができるよう、
 260 十分単純になるように設計されている。
 261 .PP
 262 .\"O With the complexity of actual module insertion reduced to three
 263 .\"O system calls (open, read, init_module), and the
 264 .\"O \fImodules.dep\fR file being simple and open,
 265 .\"O producing a more powerful modprobe variant can be done
 266 .\"O independently if there is a need.
 267 実際のモジュールの登録の複雑さが
 268 3 つのシステムコール (open, read, init_module) で軽減され、
 269 \fImodules.dep\fR ファイルが単純でオープンであるおかげで、
 270 もし必要があればもっと強力な改良版の modprobe を作ることも可能である。
 271 .\"O .SH "COPYRIGHT"
 272 .SH "著作権"
 273 .PP
 274 .\"O This manual page Copyright 2004, Rusty Russell, IBM Corporation.
 275 このマニュアルページの著作権表示は Copyright 2004, Rusty Russell, IBM Corporation.
 276 .\"O .SH "SEE ALSO"
 277 .SH "関連項目"
 278 .PP
 279 \fBmodprobe\fR(8),
 280 \fBmodules.dep\fR(5)