manual/kmod/draft/man8/depmod.8

   1 '\" t
   2 .\"     Title: depmod
   3 .\"    Author: Jon Masters <jcm@jonmasters.org>
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
   5 .\"      Date: 01/29/2021
   6 .\"    Manual: depmod
   7 .\"    Source: kmod
   8 .\"  Language: English
   9 .\"
  10 .\"*******************************************************************
  11 .\"
  12 .\" This file was generated with po4a. Translate the source file.
  13 .\"
  14 .\"*******************************************************************
  15 .\"
  16 .\" translated for 29, 2022-05-31 ribbon <ribbon@users.osdn.me>
  17 .\"
  18 .TH DEPMOD 8 2021/01/29 kmod depmod
  19 .ie  \n(.g .ds Aq \(aq
  20 .el       .ds Aq '
  21 .\" -----------------------------------------------------------------
  22 .\" * Define some portability stuff
  23 .\" -----------------------------------------------------------------
  24 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  25 .\" http://bugs.debian.org/507673
  26 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  27 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  28 .\" -----------------------------------------------------------------
  29 .\" * set default formatting
  30 .\" -----------------------------------------------------------------
  31 .\" disable hyphenation
  32 .nh
  33 .\" disable justification (adjust text to left margin only)
  34 .ad l
  35 .\" -----------------------------------------------------------------
  36 .\" * MAIN CONTENT STARTS HERE *
  37 .\" -----------------------------------------------------------------
  38 .SH 名前
  39 depmod \- modules\&.dep とマップファイルを生成する
  40 .SH 書式
  41 .HP \w'\fBdepmod\fR\ 'u
  42 \fBdepmod\fP [\fB\-b\ \fP\fIbasedir\fP] [\fB\-e\fP] [\fB\-E\ \fP\fIModule\&.symvers\fP] [\fB\-F\ \fP\fISystem\&.map\fP] [\fB\-n\fP] [\fB\-v\fP] [\fB\-A\fP] [\fB\-P\ \fP\fIprefix\fP] [\fB\-w\fP]
  43 [\fIversion\fP]
  44 .HP \w'\fBdepmod\fR\ 'u
  45 \fBdepmod\fP [\fB\-e\fP] [\fB\-E\ \fP\fIModule\&.symvers\fP] [\fB\-F\ \fP\fISystem\&.map\fP]
  46 [\fB\-n\fP] [\fB\-v\fP] [\fB\-P\ \fP\fIprefix\fP] [\fB\-w\fP] [\fIversion\fP] [\fIfilename\fP...]
  47 .SH 説明
  48 .PP
  49 Linux カーネルモジュールは、 他のモジュールが利用できるようなサービス ("シンボル" と呼ばれる) を提供することができます (コード内において
  50 EXPORT_SYMBOL バリアントを用いて行われます)。 2 つめのモジュールがこのシンボルを利用していたら、 2 つめのモジュールは、 明らかに
  51 1 つめのモジュールに依存していることになります。 このような依存関係は、 非常に複雑になることがあります。
  52 .PP
  53 \fBdepmod\fP は /lib/modules/\fIversion\fP 以下にあるモジュールを読み込んで、 何というシンボルをエクスポートしているか、
  54 何というシンボルを必要としているかを確認した上で、 モジュールの依存関係の一覧を生成します。 デフォルトでは、 その一覧を modules\&.dep
  55 に書き込みます。 またバイナリハッシュ形式として modules\&.dep\&.bin を同一ディレクトリ内に書き込みます。
  56 コマンドラインからファイル名が指定された場合は、 そのモジュールのみが検査されます (モジュールがすべて一覧表示されていなければ、
  57 この機能はほぼ役に立ちません)。 \fBdepmod\fP はまた、 modules\&.symbols という名のファイル内に、
  58 モジュールによって提供されるシンボルの一覧を生成します。 そのバイナリハッシュ形式は、 modules\&.symbols\&.bin に生成します。
  59 モジュールが特別なデバイス名 (devname) を提供するものであって、 (systemd\-tmpfiles などのユーティリティーによって)
  60 システム起動時に /dev を有効化する必要がある場合、 \fBdepmod\fP は modules\&.devname というファイルを出力します。
  61 .PP
  62 \fIversion\fP が指定された場合は、 現在のカーネルバージョン (\fBuname \-r\fP によって返される) ではなく、
  63 指定されたカーネルバージョンのディレクトリを用います。
  64 .SH オプション
  65 .PP
  66 \fB\-a\fP, \fB\-\-all\fP
  67 .RS 4
  68 すべてのモジュールを調査します。 このオプションはデフォルトでは、 コマンドラインからファイル名を何も指定しなかった場合に利用できます。
  69 .RE
  70 .PP
  71 \fB\-A\fP, \fB\-\-quick\fP
  72 .RS 4
  73 このオプションを指定すると、 処理を行う前に、 modules\&.dep ファイルよりも、 モジュールが新しいかどうかがチェックされます。
  74 新しくなければ、 ファイルを再生成することなく、 すぐに終了します。
  75 .RE
  76 .PP
  77 \fB\-b \fP\fIbasedir\fP, \fB\-\-basedir \fP\fIbasedir\fP
  78 .RS 4
  79 指定するモジュールが、 その時点で (通常の) ディレクトリ /lib/modules/\fIversion\fP にないが、ステージング領域にある場合に、
  80 ディレクトリ名の先頭につく \fIbasedir\fP を指定することができます。 この \fIbasedir\fP は、 出力先である modules\&.dep
  81 ファイルでは取り除かれます。 したがって、 すぐに通常のディレクトリに移動させることができます。 このオプションを用いるのは、
  82 ディストリビューションベンダーであり、 depmod を後で実行することなく、 メタデータファイルを事前生成したい場合です。
  83 .RE
  84 .PP
  85 \fB\-C\fP, \fB\-\-config \fP\fIfile or directory\fP
  86 .RS 4
  87 このオプションは、 デフォルトの設定ディレクトリ /etc/depmod\&.d/ を上書きします。
  88 .RE
  89 .PP
  90 \fB\-e\fP, \fB\-\-errsyms\fP
  91 .RS 4
  92 \fB\-F\fP と合わせて用いた場合に、 このオプションは、 モジュールが必要としているシンボルの中で、
  93 他のモジュールやカーネルからは提供されていないものを表示します。 モジュールによってシンボルが提供されていない場合には、
  94 カーネルから提供されているものとして扱うのが普通です (理想的には、 そうであるべきです)。 ただし、
  95 追加してアップデートしたサードパーティー製のドライバーが、 正しくインストールされていなかったり、 適切にビルドされていなかったりした場合に、
  96 この仮定は成り立たなくなります。
  97 .RE
  98 .PP
  99 \fB\-E\fP, \fB\-\-symvers\fP
 100 .RS 4
 101 \fB\-e\fP と合わせて用いた場合に、 このオプションは、 モジュールが提供するシンボルバージョンの中で、 Module\&.symvers
 102 を通じてカーネルが提供するシンボルバージョンに一致しないものを表示します。 このオプションは \fB\-F\fP とともに用いることはできません。
 103 .RE
 104 .PP
 105 \fB\-F\fP, \fB\-\-filesyms \fP\fISystem\&.map\fP
 106 .RS 4
 107 カーネルのビルド時に System\&.map が提供されるので、 この \fB\-e\fP オプションを使えば、 未解決のシンボルを表示できます。
 108 このオプションは \fB\-E\fP とともに用いることはできません。
 109 .RE
 110 .PP
 111 \fB\-h\fP, \fB\-\-help\fP
 112 .RS 4
 113 ヘルプメッセージを表示して終了します。
 114 .RE
 115 .PP
 116 \fB\-n\fP, \fB\-\-show\fP, \fB\-\-dry\-run\fP
 117 .RS 4
 118 これを指定すると、 生成結果である modules\&.dep やその他のマップファイルを、 モジュールディレクトリに書き込まずに、
 119 標準出力へ書き出します。
 120 .RE
 121 .PP
 122 \fB\-P\fP
 123 .RS 4
 124 アーキテクチャーによっては、 シンボルの先頭に無関係なプレフィックスがつけられる場合があります。 このオプションは、 無視したいプレフィックス
 125 (たとえば \*(Aq_\*(Aq) を指定します。
 126 .RE
 127 .PP
 128 \fB\-v\fP, \fB\-\-verbose\fP
 129 .RS 4
 130 \fBdepmod\fP の詳細 (verbose) モードでは、 各モジュールが依存するシンボルすべてと、 そのシンボルを提供するモジュールのファイル名を
 131 (stdout に) 出力します。
 132 .RE
 133 .PP
 134 \fB\-V\fP, \fB\-\-version\fP
 135 .RS 4
 136 プログラムのバージョンを表示して終了します。 古いカーネル上において実行する場合には、 以降の注意事項を参照してください。
 137 .RE
 138 .PP
 139 \fB\-w\fP
 140 .RS 4
 141 依存関係、エイリアス、シンボルバージョンなどに重複があった場合に警告します。
 142 .RE
 143 .SH 著作権
 144 .PP
 145 この man ページの元々の著作権表記は Copyright 2002, Rusty Russell, IBM Corporation です。 一部は
 146 Copyright Jon Masters, and others です。
 147 .SH 関連項目
 148 .PP
 149 \fBdepmod.d\fP(5), \fBmodprobe\fP(8), \fBmodules.dep\fP(5)
 150 .SH 著者
 151 .PP
 152 \fBJon Masters\fP <\&jcm@jonmasters\&.org\&>
 153 .RS 4
 154 開発者
 155 .RE
 156 .PP
 157 \fBRobby Workman\fP <\&rworkman@slackware\&.com\&>
 158 .RS 4
 159 開発者
 160 .RE
 161 .PP
 162 \fBLucas De Marchi\fP <\&lucas\&.de\&.marchi@gmail\&.com\&>
 163 .RS 4
 164 開発者
 165 .RE