dpkg-split(1) dpkg suite dpkg-split(1)
名前
dpkg-split - Debian パッケージアーカイブの分割/統合ツール
書式
dpkg-split [option...] command
説明
dpkg-split は Debian バイナリパッケージのファイルを小さいパートに分割したり、それらを再度統合したりするツールであり、フロッ
ピーディスクのような容量の小さい媒体上に、サイズの大きいパッケージファイルを保管できるようにする。
これは、--split, --join, --info オプションを手動で指定することにより行われる。
dpkg-split には --auto オプションにより実行される自動モードも備わっている。自動モードでは、存在しているがまだ統合されていな
いパートのキューを管理することで、すべてのパートが確認できた時点でそれらを統合する。キューの管理は、--listq および --discard
オプションで行うことができる。
分割、統合、キューイング処理のいずれも、標準出力に有用なメッセージを出力する。これらは無視しても問題ない。
コマンド
-s, --split complete-archive [prefix]
単一の Debian バイナリパッケージを幾つかのパートに分割する。
各パートは、prefix.NofM.deb のように名づけられる。ここで、N は 1 から始まるパート番号であり、M はパートの総数で
ある (いずれも 10 進数である)。
prefix が指定されていない場合は、complete-archive ファイル名が、ディレクトリ部分も含めて用いられるが、末尾の
.deb 部分は削除される。
-j, --join part...
パッケージファイルのパート群を集約して、分割前のオリジナルファイルに統合する。
引数として指定された各パートのファイルは、オリジナルのバイナリファイルのすべてのパートを含んでいること。パートを順番に並べて指定する必
要はないが、同じパートのファイルを複数回指定することはできない。
各パートは分割時に指定されたサイズが同一である必要がある。これは、通常各パートが単一の dpkg-split --split の実行か
ら生成されることを意味する。
パートのファイル名は、統合処理において重要ではない。
生成されたファイルは、デフォルトで package_version_arch.deb というファイル名になる。
-I, --info part...
パートのファイルに関する情報を人が読みやすい形式で表示する。バイナリパッケージのパート以外のファイルが引数で指定された場合は、それを指
摘するメッセージを (標準出力に) 代わりに表示する。
-a, --auto -o complete-output part
自動的にパートをキューイングして、可能であればパッケージを再統合する。
part で指定されたパートが検査され、同じパッケージファイルのパートのキューにあるパッケージの別のパート (もしあれば) と比較され
る。
part が属するパッケージファイルのすべてのパートが利用可能な場合、パッケージは統合され、complete-output に書き出さ
れる (ファイルが既存の場合もエラーとはならないが、通常は推奨されない)。
それ以外の場合、part がキューにコピーされ、complete-output は作成されない。
part が分割されたバイナリパッケージのパート以外の場合、dpkg-split は戻り値 1 で終了する。何らかのトラブルが発生した
場合、戻り値 2 で終了する。
--auto を使用する場合、--output もしくは -o オプションも指定すること (これを必須にしないと、呼び出したプログラム
が出力ファイル名を知る術がなくなってしまう)。
-l, --listq
統合されるパッケージのキューの内容を一覧表示する。
キューにパートが存在している各パッケージファイルについて、パッケージ名とキューにあるパート、キューに格納されているバイト数が出力され
る。
-d, --discard [package...]
パッケージの残りのパートが揃うまでキューに格納されているパートをキューから削除する。
package が指定されなかった場合、キューは完全に消去される。何らかのパッケージが指定された場合、そのパッケージのパートのみが削除
される。
-?, --help
利用方法を表示して終了する。
--version
バージョン情報を表示して終了する。
オプション
--depotdir directory
Specifies an alternative directory for the queue of parts awaiting
automatic reassembly. The default is /var/lib/dpkg/parts.
--admindir directory
Set the administrative directory to directory (since dpkg 1.21.10).
This is where the statoverride file is stored. Defaults to
«/var/lib/dpkg» if DPKG_ADMINDIR has not been set.
--root directory
Set the root directory to directory (since dpkg 1.21.10), which
sets the installation directory to «directory» and the
administrative directory to «directory/var/lib/dpkg» if DPKG_ROOT
has not been set.
-S, --partsize kibibytes
ファイル分割の際のパートの最大サイズを kibibyte (1024 byte) 単位で指定する。デフォルトは 450 KiB であ
る。
-o, --output complete-output
統合の際の出力ファイル名を指定する。
これは、(--join による) 手動統合の際のデフォルトのファイル名に優先する。また、(--auto による) 自動でのキューイング
および統合の際には必須である。
-Q, --npquiet
自動でのキューイングおよび統合が行われる際、dpkg-split は通常バイナリパッケージのパートでない part が指定されるとメッ
セージを出力するが、このオプションによりメッセージが抑止され、dpkg のようなプログラムがパッケージの分割や統合を扱う際に、余計な
メッセージを出力することが避けられる。
--msdos
Forces the output filenames generated by --split to be MSDOS-
compatible.
これにより、入力ファイル名から生成されたデフォルト値の prefix、引数として指定された prefix いずれもが切り詰められる。英
数字は小文字にされ、プラス記号は x に置き換えられ、その他の文字は破棄される。
必要な切り詰めが行われた結果として、prefixNofM.deb 形式のファイル名が生成される。
終了ステータス
0 要求された分割、統合、その他のコマンドは成功した。--info コマンドはファイルがバイナリパッケージのパートでなかった場合も含め、成
功としてカウントする。
1 --auto の場合のみ発生し、part ファイルがバイナリパッケージのパートではなかったことを示す。
2 Fatal or unrecoverable error due to invalid command-line usage, a
file that looked like a package part file but was corrupted, or
interactions with the system, such as accesses to the database,
memory allocations, etc.
環境変数
DPKG_ROOT
If set and --root option has not been specified, it will be used as
the filesystem root directory (since dpkg 1.21.10).
DPKG_ADMINDIR
If set and the --admindir or --root options have not been
specified, it will be used as the dpkg data directory (since dpkg
1.21.10).
DPKG_DEBUG
Sets the debug mask (since dpkg 1.21.10) from an octal value. The
currently accepted flags are described in the dpkg --debug option,
but not all these flags might have an effect on this program.
DPKG_COLORS
Sets the color mode (since dpkg 1.18.5). The currently accepted
values are: auto (default), always and never.
SOURCE_DATE_EPOCH
If set, it will be used as the timestamp (as seconds since the
epoch) in the deb-split(5)'s ar(5) container.
ファイル
/var/lib/dpkg/parts
パートを構成するファイルが自動統合を待機するデフォルトのキューディレクトリ。
このディレクトリ内のファイル名は dpkg-split の内部形式となっており、その他のプログラムから参照されることを想定していな
い。いかなる場合もファイル名の形式に依存すべきではない。
バグ
キューにあるパッケージの詳細は、キューディレクトリを自分で調べない限り確認することができない。
ファイルがバイナリパッケージのパートかどうかを簡単に確認する手段が存在しない。
関連項目
deb(5), deb-control(5), dpkg-deb(1), dpkg(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>.
1.21.22 2023-05-11 dpkg-split(1)
Generated by dwww version 1.15 on Mon Jul 1 05:14:36 CEST 2024.