dpkg-deb(1)

名前
dpkg-deb - Debian パッケージアーカイブ (.deb) 操作ツール

書式
dpkg-deb [option...] command

説明
dpkg-deb は、Debian アーカイブの作成、展開、情報の表示を行う。

パッケージをシステムにインストールしたり削除したりするには dpkg を使うこと。

また、dpkg-deb に引き渡したいオプションを指定して dpkg を実行することで、dpkg-deb を実行することもできる。dpkg は、dpkg-deb 用のオプションであると判断すると、 dpkg-deb を起動する。

コマンド

-b, --build directory [archive|directory]
    directory 以下のファイルシステムツリーから debian アーカイブを作成する。 directory には、control ファイルなどの制御情報ファイルのある DEBIAN サブディレクトリが必ず存在しなければならない。 DEBIAN ディレクトリはバイナリパッケージのファイルシステム・アーカイブには含まれない。代わりに DEBIAN ディレクトリ以下にあったファイルはバイナリパッケージの制御情報エリアに置かれる。 --nocheck を指定しないかぎり、 dpkg-deb は DEBIAN/control を読み込んで解析する。 dpkg-deb は、文法エラーなどの問題のチェックを行い、ビルド中のバイナリパッケージ名を表示する。 dpkg-deb は、 DEBIAN 制御情報ディレクトリにある、メンテナスクリプトなどのファイルのパーミッションもチェックする。 archive が指定されない場合、 dpkg-deb はパッケージを directory.deb という名前で作成する。 作成するアーカイブが既に存在している場合は、上書きする。 2 番目の引数がディレクトリの場合、 dpkg-deb は package_version_arch.deb または package_version.deb (パッケージ制御ファイルに Architecture フィールドがない場合) というファイルを作成する。ファイル名の代わりにディレクトリを指定するときには、--nocheck オプションを使用してはいけない (dpkg-deb は、使用するファイル名を確認するために、パッケージ制御ファイルを読み込んで解析する必要があるため)。

-I, --info archive [control-file-name...]
    バイナリパッケージアーカイブの情報を表示する。 control-file-name が指定されていない場合は、制御ファイルの一覧と、パッケージの概要を表示する。 control-file-name が指定された場合、 dpkg-deb は指定された順でファイルの内容を表示する。指定したファイルの一部が存在しない場合、存在しないファイル各々について、標準エラー出力にエラーメッセージを表示し、そして終了ステータス 2 で終了する。

-W, --show archive
    バイナリパッケージアーカイブの情報を --showformat 引数で指定した形式で表示する。デフォルトの形式では、パッケージ名とバージョンがタブで区切られて 1 行に表示される。

-f, --field archive [control-field-name...]
    バイナリパッケージアーカイブから制御ファイル情報を取り出す。 control-file-field が指定されていない場合、control ファイルのすべての内容が表示される。 control-file-field が指定されている場合、dpkg-deb は指定されたフィールドの内容を制御ファイルに記載されている順に表示する。control-file-field が複数指定された場合、 dpkg-deb は、各々の前にフィールド名 (およびコロンとスペース) を表示する。 指定したフィールドがみつからない場合でもエラーにはならない。

-c, --contents archive
    パッケージアーカイブに含まれるファイルシステムツリーの内容を表示する。現在は、tar の冗長表示 (-v オプション) の形式で表示する。

-x, --extract archive directory
    パッケージアーカイブから、ファイルシステムツリーを指定したディレクトリに展開する。 ルートディレクトリにパッケージを展開しても、正しいインストールにはならないことに注意 ! パッケージのインストールには dpkg を使うこと。 directory (親ディレクトリは含まない) は必要に応じて作成される。

-X, --vextract archive directory
    --extract (-x) に --verbose (-v) を付加したオプションと同様だが、実際にファイルを展開して一覧を表示する。

-R, --raw-extract archive directory
    パッケージアーカイブから、ファイルシステムツリーを指定したディレクトリに展開し、制御情報ファイルを、DEBIAN サブディレクトリに展開する。 指定したディレクトリ (親ディレクトリは含まない) は必要に応じて作成される。

--ctrl-tarfile archive
    Extracts the control data from a binary package and sends it to standard output in tar format (since dpkg 1.17.14). Together with tar(1) this can be used to extract a particular control file from a package archive. The input archive will always be processed sequentially.

--fsys-tarfile archive
    バイナリパッケージからファイルシステムツリーを展開し、標準出力に tar 形式で出力する。 tar(1) と組み合わせて使用することで、特定のファイルをパッケージアーカイブから取り出すことができる。入力のアーカイブは、常に 1 つずつ処理される。

-e, --control archive [directory]
    パッケージアーカイブから制御情報ファイルを指定したディレクトリに展開する。 ディレクトリが指定されない場合、カレントディレクトリの DEBIAN サブディレクトリに展開する。 指定したディレクトリ (親ディレクトリは含まない) は必要に応じて作成される。

-?, --help
    利用方法を表示して終了する。

--version
    バージョン情報を表示して終了する。

オプション

--showformat=format
    このオプションは、--show の出力の書式を指定するものである。書式は、一覧表示される各パッケージの出力を制御する文字列である。 文字列は "${field-name}" 形式であらゆる status フィールドを参照することができる。有効なフィールドの一覧は、対象のパッケージに -I を使用することで簡単に確認できる。書式オプションの網羅的な解説 (エスケープシーケンスやフィールドでのタブの使い方を含む) は、dpkg-query(1)の --showformat オプションの解説を参照のこと。 このフィールドのデフォルトの書式は "${Package}\t${Version}\n" である。

-zcompress-level
    パッケージのビルドの際に、圧縮を行うバックエンドのプログラムに引き渡す圧縮レベルを指定する (デフォルトは、gzip および bzip2 の場合 9、xz および lzma の場合 6)。指定可能な値は 0-9 であり、gzip の場合 0 は非圧縮に対応するが、bzip2 の場合 0 は 1 とみなされる。dpkg 1.16.2 より前では、すべての圧縮プログラムにおいて、レベル 0 は非圧縮と等価となる。

-Scompress-strategy
    Specify which compression strategy to use on the compressor backend, when building a package (since dpkg 1.16.2). Allowed values are none (since dpkg 1.16.4), filtered, huffman, rle and fixed for gzip (since dpkg 1.17.0) and extreme for xz.

-Zcompress-type
    Specify which compression type to use when building a package. Allowed values are gzip, xz, bzip2 (deprecated), lzma (deprecated), and none (default is xz).

--uniform-compression
    Specify that the same compression parameters should be used for all archive members (i.e. control.tar and data.tar). Otherwise only the data.tar member will use those parameters. The only supported compression types allowed to be uniformly used are none, gzip and xz.

--deb-format=format
    Set the archive format version used when building (since dpkg 1.17.0). Allowed values are 2.0 for the new format, and 0.939000 for the old one (default is 2.0). The old archive format is less easily parsed by non-Debian tools and is now obsolete; its only use is when building packages to be parsed by versions of dpkg older than 0.93.76 (September 1995), which was released as i386 a.out only.

--new
    This is a legacy alias for --deb-format=2.0.

--old
    This is a legacy alias for --deb-format=0.939000.

--nocheck
    dpkg-deb --build の際に通常実施される、アーカイブの内容のチェックを実施しない。これにより、アーカイブの内容に問題があっても、アーカイブをビルドすることができる。

-v, --verbose
    詳細な出力を有効にする。現在のところ、これは --extract に --vextract と同様の挙動をさせる場合のみ有効である。

-D, --debug
    デバッグ出力を有効にする。これはあまり面白いものではない。

環境変数

TMPDIR
    TMPDIR が設定されている場合、dpkg-deb は、一時的なファイルやディレクトリを作成するディレクトリとして使用する。

参考
dpkg-deb でソフトウェアをインストールしようとしてはいけない!すべてのファイルの適切なパスへインストール、パッケージのスクリプトの実行、ステータスや内容の記録を確実に実行するために、必ず dpkg を使うこと。

バグ
dpkg-deb -I package1.deb package2.deb は適切に動作しない。 .deb ファイルには認証という概念がなく、単純なチェックサムすらもない (APT のような高レイヤのツールは、指定されたリポジトリから情報を収集することで .deb パッケージの認証をサポートしている。また大半のパッケージは近年debian/rules によって生成される md5sum 制御ファイルを提供している。しかし、これらは低レイヤのツールが直接的にサポートしているものではない。

関連項目
deb(5), deb-control(5), dpkg(1), dselect(1).

翻訳者
高橋 基信 <monyo@monyo.com>. 喜瀬 浩 <kise@fuyuneko.jp>. 関戸 幸一 <sekido@mbox.kyoto-inet.or.jp>. 鍋谷 栄展 <nabe@debian.or.jp>. 倉澤 望 <nabetaro@debian.or.jp>. 石川 睦 <ishikawa@linux.or.jp>. 鵜飼 文敏 <ukai@debian.or.jp>. 中野 武雄 <nakano@apm.seikei.ac.jp>.

翻訳校正
Debian JP Documentation ML <debian-doc@debian.or.jp>.