名前¶

apt-ftparchive - インデックスファイル生成ユーティリティ

概要¶

apt-ftparchive [-dsq] [--md5] [--delink] [--readonly] [--contents] [--arch architecture] [-o=設定文字列] [-c=設定ファイル] {packages パス [override-file [pathprefix]] | sources パス [override-file [pathprefix]] | contents パス | release パス | generate 設定ファイル セクション... | clean 設定ファイル | {-v | --version} | {-h | --help}}

説明¶

apt-ftparchive は、APT が取得元にアクセスするのに必要な、インデックスファイルを生成するコマンドラインツールです。インデックスファイルは、元のサイトの内容に基づき生成されるべきです。

apt-ftparchive は、dpkg-scanpackages(1) プログラムのスーパーセットで、packages コマンド経由で機能全体を取り込んでいます。また、contents ファイルジェネレータ contents と完全なアーカイブの生成プロセス「スクリプト」である綿密な手段を含んでいます。

本質的に apt-ftparchive は、.deb ファイルの内容をキャッシュするのにバイナリデータベースを使用できます。また、gzip(1) 以外のいかなる外部プログラムにも依存しません。すべて生成する際には、ファイル変更点の検出と希望した圧縮出力ファイルの作成を自動的に実行します。

-h オプションや --help オプションを除き、以下に挙げるコマンドが必要です。

packages

sources

contents

release

generate

clean

GENERATE 設定¶

generate コマンドは、生成するアーカイブに関する記述をした設定ファイルを使用します。設定ファイルは、bind 8 や dhcpd といった ISC ツールに見られるような、ISC 設定フォーマットに従います。apt.conf(5) に、構文の説明があります。Generate 設定はセクション法で解析しますが、apt.conf(5) はツリー法で解析するのに注意してください。これはスコープタグの扱い方に違いがあるだけです。

generate 設定には 4 個の独立したセクションがあります。以下それぞれ説明します。

for i in Sections do 


   for j in Architectures do


      Generate for DIST=scope SECTION=i ARCH=j


     

バイナリオーバーライドファイル¶

バイナリオーバーライドファイルは、dpkg-scanpackages(1) と完全に互換性があります。ここには、空白区切りでフィールドが 4 個あります。先頭のフィールドはパッケージ名、2 番目のフィールドはパッケージに強制する優先度、3 番目のフィールドはパッケージに強制するセクション、最後のフィールドはメンテナ順列フィールドです。

メンテナフィールドの一般的な形は以下のようになります。

old [// oldn]* => new

また単純に以下のようにもなります。

new

最初の形式は、// で区切られた古い email アドレスのリストを許可します。この形式がある場合は、メンテナフィールドになるよう new に置換してください。2 番目の形式は無条件にメンテナフィールドに置換します。

ソースオーバーライドファイル¶

ソースオーバーライドファイルは、dpkg-scansources(1) と完全に互換性があります。ここには、空白区切りでフィールドが 2 個あります。先頭のフィールドはソースパッケージ名、2 番目のフィールドは割り当てるセクションです。

特別オーバーライドファイル¶

特別オーバーライドファイルは、出力中に任意のタグを追加・置換できるようにします。3 列からなり、先頭はパッケージ、2番目はタグ、残りは新しい値です。

オプション¶

ここで設定オプションとして説明したコマンドラインオプションは、 すべて設定ファイルを使用して設定できます。 設定ファイルに書いた真偽値をとるオプションは -f-,--no-f, -f=no などのようにして上書きできます。

--md5, --sha1, --sha256, --sha512

-d, --db

-q, --quiet

--delink

--contents

-s, --source-override

--readonly

-a, --arch

APT::FTPArchive::AlwaysStat

APT::FTPArchive::LongDescription

-h, --help

-v, --version

-c, --config-file

-o, --option

サンプル¶

バイナリパッケージ (.deb) があるディレクトリの Packages ファイルを生成するには、以下のようにします。

apt-ftparchive packages directory | gzip > Packages.gz

関連項目¶

apt.conf(5)

診断メッセージ¶

apt-ftparchive は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

バグ¶

APT バグページ[1] をご覧ください。 APT のバグを報告する場合は、 /usr/share/doc/debian/bug-reporting.txt や reportbug(1) コマンドをご覧ください。

翻訳¶

倉澤 望 <nabetaro@debian.or.jp> (2003-2006,2009-2012), Takuma Yamada <tyamada@takumayamada.com> (2016), Debian JP Documentation ML <debian-doc@debian.or.jp>

この翻訳文書には未訳部分が含まれている可能性があることに 注意してください。 翻訳がオリジナルに追従できていない場合、 内容を失わないようにこのようにしています。

著者¶

Gunthorpe Jason[FAMILY Given]

[FAMILY Given]

注記¶

1.

APT バグページ