'\" t .\" Title: apt-ftparchive .\" Author: Gunthorpe Jason[FAMILY Given] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 10\ \&5 月\ \&2019 .\" Manual: APT .\" Source: APT 2.2.4 .\" Language: Japanese .\" .TH "APT\-FTPARCHIVE" "1" "10\ \&5 月\ \&2019" "APT 2.2.4" "APT" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "名前" apt-ftparchive \- インデックスファイル生成ユーティリティ .SH "概要" .HP \w'\fBapt\-ftparchive\fR\ 'u \fBapt\-ftparchive\fR [\fB\-dsq\fR] [\fB\-\-md5\fR] [\fB\-\-delink\fR] [\fB\-\-readonly\fR] [\fB\-\-contents\fR] [\fB\-\-arch\ \fR\fB\fIarchitecture\fR\fR] [\fB\-o=\fR\fB\fI設定文字列\fR\fR] [\fB\-c=\fR\fB\fI設定ファイル\fR\fR] {packages\ \fIパス\fR...\ [\fIoverride\-file\fR\ [\fIpathprefix\fR]] | sources\ \fIパス\fR...\ [\fIoverride\-file\fR\ [\fIpathprefix\fR]] | contents\ \fIパス\fR | release\ \fIパス\fR | generate\ \fI設定ファイル\fR\ \fIセクション\fR... | clean\ \fI設定ファイル\fR | {\-v\ |\ \-\-version} | {\-h\ |\ \-\-help}} .SH "説明" .PP \fBapt\-ftparchive\fR は、APT が取得元にアクセスするのに必要な、インデックスファイルを生成するコマンドラインツールです。インデックスファイルは、元のサイトの内容に基づき生成されるべきです。 .PP \fBapt\-ftparchive\fR は、\fBdpkg-scanpackages\fR(1) プログラムのスーパーセットで、packages コマンド経由で機能全体を取り込んでいます。また、contents ファイルジェネレータ contents と完全なアーカイブの生成プロセス「スクリプト」である綿密な手段を含んでいます。 .PP 本質的に \fBapt\-ftparchive\fR は、\&.deb ファイルの内容をキャッシュするのにバイナリデータベースを使用できます。また、\fBgzip\fR(1) 以外のいかなる外部プログラムにも依存しません。すべて生成する際には、ファイル変更点の検出と希望した圧縮出力ファイルの作成を自動的に実行します。 .PP \fB\-h\fR オプションや \fB\-\-help\fR オプションを除き、以下に挙げるコマンドが必要です。 .PP \fBpackages\fR .RS 4 packages コマンドは、ディレクトリツリーからパッケージファイルを生成します。与えられたディレクトリから再帰検索し、\&.deb ファイルを取得します。またパッケージレコードを標準出力にそれぞれ出力します。このコマンドは、\fBdpkg-scanpackages\fR(1) とほぼ同じです。 .sp \fB\-\-db\fR オプションで、キャッシュ DB を指定できます。 .RE .PP \fBsources\fR .RS 4 sources コマンドは、ディレクトリツリーからソースインデックスファイルを生成します。与えられたディレクトリから再帰検索し、\&.dsc ファイルを取得します。またソースレコードを標準出力にそれぞれ出力します。このコマンドは、\fBdpkg-scansources\fR(1) とほぼ同じです。 .sp override ファイルを指定した場合、src 拡張子がついたソースオーバーライドファイルを探します。使用するソースオーバーライドファイルを変更するのには、\-\-source\-override オプションを使用します。 .RE .PP \fBcontents\fR .RS 4 contents コマンドは、ディレクトリツリーからコンテンツファイルを生成します。与えられたディレクトリから再帰検索し、\&.deb ファイルを取得します。またファイルごとにファイル一覧を読み取ります。その後、パッケージに対応するファイル一覧を標準出力にソートして出力します。ディレクトリは出力に含まれません。複数のパッケージが同じファイルを持つ場合、パッケージ名をカンマ区切りで出力します。 .sp \fB\-\-db\fR オプションで、キャッシュ DB を指定できます。 .RE .PP \fBrelease\fR .RS 4 release コマンドは、ディレクトリツリーから Release ファイルを生成します。与えたディレクトリを再帰的に検索し、未圧縮の Packages, Sources, Contents, Components, icons 各ファイル、それに Release, Index, md5sum\&.txt ファイルをデフォルト (APT::FTPArchive::Release::Default\-Patterns) で探します。また APT::FTPArchive::Release::Patterns に列挙して、さらにファイル名のパターンを追加できます。その後、(デフォルトで) MD5, SHA1, SHA256 と SHA512 の各ダイジェストをファイルごとに格納した Release ファイルを標準出力に書き出します。 .sp Release ファイルの追加メタデータフィールドの値は、APT::FTPArchive::Release 以下の相当する値 (例: APT::FTPArchive::Release::Origin) をとります。サポートするフィールドは、Origin, Label, Suite, Version, Codename, Date, NotAutomatic, ButAutomaticUpgrades, Acquire\-By\-Hash, Valid\-Until, Signed\-By, Architectures, Components, Description です。 .RE .PP \fBgenerate\fR .RS 4 generate コマンドは、cron スクリプトから実行できるよう設計されており、与えられた設定ファイルに従ってインデックスを生成します。設定言語は、必要な設定を維持する簡単な方法を提供すると共に、インデックスファイルをどのディレクトリから作成するかを指定する、柔軟な方法を提供します。 .RE .PP \fBclean\fR .RS 4 clean コマンドは、設定ファイルで与えられたデータベースを、もう必要ないレコードを削除して整理します。 .RE .SH "GENERATE 設定" .PP generate コマンドは、生成するアーカイブに関する記述をした設定ファイルを使用します。設定ファイルは、bind 8 や dhcpd といった ISC ツールに見られるような、ISC 設定フォーマットに従います。\fBapt.conf\fR(5) に、構文の説明があります。Generate 設定はセクション法で解析しますが、\fBapt.conf\fR(5) はツリー法で解析するのに注意してください。これはスコープタグの扱い方に違いがあるだけです。 .PP generate 設定には 4 個の独立したセクションがあります。以下それぞれ説明します。 .SS "Dir セクション" .PP Dir セクションは、生成プロセスで必要なファイルを配置するために必要な、標準ディレクトリを定義します。このディレクトリは、完全な絶対パスを生成するため、後のセクションで定義される相対パスの前に結合されます。 .PP \fBArchiveDir\fR .RS 4 FTP アーカイブのルートを指定します。標準的な Debian 設定では、このディレクトリには ls\-LR と dist ノードがあります。 .RE .PP \fBOverrideDir\fR .RS 4 オーバーライドファイルの場所を指定します。 .RE .PP \fBCacheDir\fR .RS 4 キャッシュファイルの場所を指定します。 .RE .PP \fBFileListDir\fR .RS 4 FileList 設定が以下で使用されている場合、ファイルリストファイルの場所を指定します。 .RE .SS "Default セクション" .PP Default セクションではデフォルト値を指定します。また、生成器の動作を制御する設定も行います。他のセクションでは、ここにあるデフォルト値を、セクションごとの設定で上書きします。 .PP \fBPackages::Compress\fR .RS 4 パッケージインデックスファイルのデフォルト圧縮方法を設定します。設定項目 \fBAPT::Compressor\fR によって設定した圧縮形式の最低1つが入る、空白区切りの文字列です。圧縮方法のデフォルトはすべて \*(Aq\&. gzip\*(Aq です。 .RE .PP \fBPackages::Extensions\fR .RS 4 パッケージファイル拡張子のデフォルト値を列挙します。このデフォルト値は \*(Aq\&.deb\*(Aq です。 .RE .PP \fBSources::Compress\fR .RS 4 Packages::Compress と同様に、Sources ファイルの圧縮方法を指定します。 .RE .PP \fBSources::Extensions\fR .RS 4 ソースファイル拡張子のデフォルト値を列挙します。このデフォルト値は \*(Aq\&.dsc\*(Aq です。 .RE .PP \fBContents::Compress\fR .RS 4 Packages::Compress と同様に、Contents ファイルの圧縮方法を指定します。 .RE .PP \fBTranslation::Compress\fR .RS 4 Packages::Compress と同様に、Translation\-en マスターファイルの圧縮を制御します。 .RE .PP \fBDeLinkLimit\fR .RS 4 実行するごとに delink (及びハードリンクの置き換え) する量を、キロバイト単位で指定します。セクションごとの External\-Links 設定と合わせて使います。 .RE .PP \fBFileMode\fR .RS 4 作成したインデックスファイルのモードを指定します。デフォルトは 0644 です。全インデックスファイルは、umask を無視してこのモードを使用します。 .RE .PP \fBLongDescription\fR .RS 4 長い説明文を Packages ファイルに含めるか、マスター Translation\-en ファイルに分割するかを指定します。 .RE .SS "TreeDefault セクション" .PP 特定の Tree セクションのデフォルトを設定します。これらの変数はすべて置換変数であり、文字列 $(DIST), $(SECTION), $(ARCH) をそれぞれの値に展開します。 .PP \fBMaxContentsChange\fR .RS 4 日毎に生成する contents ファイルをキロバイト単位で設定します。contents ファイルをラウンドロビンし、数日経つとすべて再生成します。 .RE .PP \fBContentsAge\fR .RS 4 変更がない contents ファイルをチェックする日数を指定します。この制限を越えた contents ファイルの mtime を、更新します。パッケージファイルが変更されても、[例えば上書き編集で] contents ファイルが更新されないような場合、こういったことが発生します。新しい \&.deb ファイルをインストールしたい場合、保留を解除でき、少なくとも新しいファイルが必要です。デフォルトは 10 で、単位は日です。 .RE .PP \fBDirectory\fR .RS 4 \&.deb ディレクトリツリーの先頭を設定します。デフォルトは $(DIST)/$(SECTION)/binary\-$(ARCH)/ です。 .RE .PP \fBSrcDirectory\fR .RS 4 ソースパッケージディレクトリツリーの先頭を設定します。デフォルトは $(DIST)/$(SECTION)/source/ です。 .RE .PP \fBPackages\fR .RS 4 Packages ファイルの出力先を設定します。デフォルトは $(DIST)/$(SECTION)/binary\-$(ARCH)/Packages です。 .RE .PP \fBSources\fR .RS 4 Sources ファイルの出力先を設定します。デフォルトは $(DIST)/$(SECTION)/source/Sources です。 .RE .PP \fBTranslation\fR .RS 4 万一 Packages ファイルに含まれていない場合、長い説明文がある Translation\-en マスターファイルの出力先を設定します。デフォルトは、$(DIST)/$(SECTION)/i18n/Translation\-en です。 .RE .PP \fBInternalPrefix\fR .RS 4 外部リンクではなく、内部リンクと見なす判断材料となる、パスのプレフィックスを設定します。デフォルトは、$(DIST)/$(SECTION)/ です。 .RE .PP \fBContents\fR .RS 4 Contents ファイルの出力先を設定します。デフォルトは、$(DIST)/$(SECTION)/Contents\-$(ARCH) です。複数の Packages ファイルをひとつの Contents ファイルにまとめられる設定 (デフォルト) の場合、\fBapt\-ftparchive\fR は自動でパッケージファイルをまとめます。 .RE .PP \fBContents::Header\fR .RS 4 contents の出力に付けるヘッダファイルを設定します。 .RE .PP \fBBinCacheDB\fR .RS 4 このセクションで使用するバイナリキャッシュデータベースを設定します。複数のセクションで同じデータベースを共有できます。 .RE .PP \fBFileList\fR .RS 4 ディレクトリツリーを走査する代わりに、\fBapt\-ftparchive\fR が読み込むファイル一覧ファイルを指定します。相対ファイル名は、アーカイブディレクトリが先頭につきます。 .RE .PP \fBSourceFileList\fR .RS 4 ディレクトリツリーを走査する代わりに、\fBapt\-ftparchive\fR が読み込むファイル一覧ファイルを指定します。相対ファイル名は、アーカイブディレクトリが先頭につきます。ソースインデックスを処理する際に使用します。 .RE .SS "Tree セクション" .PP Tree セクションでは、ベースディレクトリからの標準 Debian ファイルツリー、ベースディレクトリの複数のセクション、最終的にはセクションごとの複数のアーキテクチャを定義します。使用する正確なパスは、Directory 変数で定義されます。 .PP Tree セクションは、$(DIST) 変数で設定されているスコープタグをとり、ツリーのルート (ArchiveDirが先頭につくパス) を定義します。通常、この設定は dists/bullseye のようになります。 .PP TreeDefault セクションで定義される設定はすべて、3 個の新しい変数と同様に、Tree セクションで使用できます。 .PP Tree セクションを処理する際、\fBapt\-ftparchive\fR は以下のような操作を行います。 .sp .if n \{\ .RS 4 .\} .nf for i in Sections do for j in Architectures do Generate for DIST=scope SECTION=i ARCH=j .fi .if n \{\ .RE .\} .PP \fBSections\fR .RS 4 distribution 以下に現れるセクションを、空白区切りで指定したリストです。通常、main contrib non\-free のようになります。 .RE .PP \fBArchitectures\fR .RS 4 検索部の下に表示されるすべてのアーキテクチャの空白区切りリストです。特別なアーキテクチャ「source」は、このツリーがソースアーカイブを持っていることを示すために使用されます。アーキテクチャ「all」は、Packages のようなアーキテクチャ固有のファイルがすべてのファイル中のアーキテクチャ all パッケージに関する情報を含まず、専用のファイルで利用できることを示します。 .RE .PP \fBLongDescription\fR .RS 4 長い説明文を Packages ファイルに含めるか、マスター Translation\-en ファイルに分割するかを指定します。 .RE .PP \fBBinOverride\fR .RS 4 バイナリオーバーライドファイルを設定します。このオーバーライドファイルには、セクション、優先度、メンテナのアドレスといった情報が含まれています。 .RE .PP \fBSrcOverride\fR .RS 4 ソースオーバーライドファイルを設定します。このオーバーライドファイルには、セクションの情報が含まれています。 .RE .PP \fBExtraOverride\fR .RS 4 バイナリ特別オーバーライドファイルを設定します。 .RE .PP \fBSrcExtraOverride\fR .RS 4 ソース特別オーバーライドファイルを設定します。 .RE .SS "BinDirectory セクション" .PP bindirectory セクションでは、特殊な構造を持たないバイナリディレクトリツリーを定義します。スコープタグはバイナリディレクトリの場所を指定し、設定は変数展開のない Tree セクションや SectionArchitecture 設定に似ています。 .PP \fBPackages\fR .RS 4 Packages ファイルの出力先を設定します。 .RE .PP \fBSources\fR .RS 4 Sources ファイルの出力先を設定します。少なくとも Packages か Sources のうち、ひとつは必要です。 .RE .PP \fBContents\fR .RS 4 Contents ファイルの出力先を設定します (オプション)。 .RE .PP \fBBinOverride\fR .RS 4 バイナリオーバーライドファイルを設定します。 .RE .PP \fBSrcOverride\fR .RS 4 ソースオーバーライドファイルを設定します。 .RE .PP \fBExtraOverride\fR .RS 4 バイナリ特別オーバーライドファイルを設定します。 .RE .PP \fBSrcExtraOverride\fR .RS 4 ソース特別オーバーライドファイルを設定します。 .RE .PP \fBBinCacheDB\fR .RS 4 キャッシュ DB を設定します。 .RE .PP \fBPathPrefix\fR .RS 4 全出力パスに付加するパス。 .RE .PP \fBFileList\fR, \fBSourceFileList\fR .RS 4 ファイル一覧ファイルを指定します。 .RE .SH "バイナリオーバーライドファイル" .PP バイナリオーバーライドファイルは、\fBdpkg-scanpackages\fR(1) と完全に互換性があります。ここには、空白区切りでフィールドが 4 個あります。先頭のフィールドはパッケージ名、2 番目のフィールドはパッケージに強制する優先度、3 番目のフィールドはパッケージに強制するセクション、最後のフィールドはメンテナ順列フィールドです。 .PP メンテナフィールドの一般的な形は以下のようになります。 .sp .if n \{\ .RS 4 .\} .nf old [// oldn]* => new .fi .if n \{\ .RE .\} .sp また単純に以下のようにもなります。 .sp .if n \{\ .RS 4 .\} .nf new .fi .if n \{\ .RE .\} .sp 最初の形式は、// で区切られた古い email アドレスのリストを許可します。この形式がある場合は、メンテナフィールドになるよう new に置換してください。2 番目の形式は無条件にメンテナフィールドに置換します。 .SH "ソースオーバーライドファイル" .PP ソースオーバーライドファイルは、\fBdpkg-scansources\fR(1) と完全に互換性があります。ここには、空白区切りでフィールドが 2 個あります。先頭のフィールドはソースパッケージ名、2 番目のフィールドは割り当てるセクションです。 .SH "特別オーバーライドファイル" .PP 特別オーバーライドファイルは、出力中に任意のタグを追加・置換できるようにします。3 列からなり、先頭はパッケージ、2番目はタグ、残りは新しい値です。 .SH "オプション" .PP ここで設定オプションとして説明したコマンドラインオプションは、 すべて設定ファイルを使用して設定できます。 設定ファイルに書いた真偽値をとるオプションは \fB\-f\-\fR,\fB\-\-no\-f\fR, \fB\-f=no\fR などのようにして上書きできます。 .PP \fB\-\-md5\fR, \fB\-\-sha1\fR, \fB\-\-sha256\fR, \fB\-\-sha512\fR .RS 4 与えたチェックサムを生成します。このオプションはデフォルトで on です。off にすると生成したインデックスファイルには checksum フィールドが含まれません。設定項目: APT::FTPArchive::\fIChecksum\fR と APT::FTPArchive::\fIIndex\fR::\fIChecksum\fR。ここで \fIIndex\fR は Packages, Sources, Release になります。\fIChecksum\fR は MD5, SHA1, SHA256 または SHA512 になります。 .RE .PP \fB\-d\fR, \fB\-\-db\fR .RS 4 バイナリキャッシュ DB を使用します。generate コマンドには影響しません。設定項目: APT::FTPArchive::DB .RE .PP \fB\-q\fR, \fB\-\-quiet\fR .RS 4 静粛 \- 進捗表示を省略し、ログをとるのに便利な出力を行います。最大 2 つまで q を重ねることでより静粛にできます。また、\fB\-q=#\fR のように静粛レベルを指定して、設定ファイルを上書きすることもできます。設定項目: quiet .RE .PP \fB\-\-delink\fR .RS 4 Delink を実行します。External\-Links 設定を使用している場合、このオプションはファイルの delink を有効にします。デフォルトは on で、off にするには \fB\-\-no\-delink\fR としてください。設定項目: APT::FTPArchive::DeLinkAct .RE .PP \fB\-\-contents\fR .RS 4 contents の生成を行います。このオプションを指定し、パッケージインデックスをキャッシュ DB と共に生成する際、ファイルリストを後で使用するように、抽出し DB に格納します。generate コマンドを使用する際、このオプションでいずれの Contents ファイルも作成できます。デフォルトは on です。設定項目: APT::FTPArchive::Contents .RE .PP \fB\-s\fR, \fB\-\-source\-override\fR .RS 4 sources コマンドで使用する、ソースオーバーライドファイルを選択します。設定項目: APT::FTPArchive::SourceOverride .RE .PP \fB\-\-readonly\fR .RS 4 キャッシュデータベースを読み取り専用にします。設定項目: APT::FTPArchive::ReadOnlyDB .RE .PP \fB\-a\fR, \fB\-\-arch\fR .RS 4 packages コマンドや contents コマンドで、与えたパスにあるすべてのパッケージファイルではなく、*_arch\&.deb や *_all\&.deb に一致したパッケージファイルのみを受け付けます。設定項目: APT::FTPArchive::Architecture .RE .PP \fBAPT::FTPArchive::AlwaysStat\fR .RS 4 \fBapt-ftparchive\fR(1) は cachedb のメタデータに可能な限りキャッシュします。パッケージを再コンパイルし、また同じバージョンで再発行されると、古くなってしまったキャッシュのメタデータ (サイズやチェックサム) が使われ、これが問題になることがあります。このオプションを有効にすると、ファイルを更新するとチェックが行われるため、問題が起こらなくなります。デフォルトでは、このオプションは "false" にセットされていることに注意してください。バージョンや、同じバージョン番号のパッケージのビルドを、増やしてアップロードするのは推奨しないからです。そのため理論上、誰もその問題に行き会わず、すべての追加チェックには、意味がありません。 .RE .PP \fBAPT::FTPArchive::LongDescription\fR .RS 4 この設定オプションはデフォルトで "true" で、\fBapt-ftparchive\fR(1) が生成したアーカイブが Translation ファイルも提供する場合にのみ "false" に設定してください。Translation\-en マスターファイルは generate コマンドでのみ生成できることに注意してください。 .RE .PP \fB\-h\fR, \fB\-\-help\fR .RS 4 使い方の短い要約を表示します。 .RE .PP \fB\-v\fR, \fB\-\-version\fR .RS 4 プログラムのバージョンを表示します。 .RE .PP \fB\-c\fR, \fB\-\-config\-file\fR .RS 4 設定ファイル。 使用する設定ファイルを指定します。 このプログラムは、デフォルト設定ファイルを読んでから、この設定ファイルを読みます。 この設定をデフォルト設定ファイルよりも前に読む必要がある場合、 \fBAPT_CONFIG\fR 環境変数に指定してください。構文については \fBapt.conf\fR(5) をご覧ください。 .RE .PP \fB\-o\fR, \fB\-\-option\fR .RS 4 設定オプションのセット。任意の設定オプションをセットします。 構文 \fB\-o Foo::Bar=bar\fR となります。 異なるオプションを設定するため、\fB\-o\fR と \fB\-\-option\fR は、 複数回使用できます。 .RE .SH "サンプル" .PP バイナリパッケージ (\&.deb) があるディレクトリの Packages ファイルを生成するには、以下のようにします。 .sp .if n \{\ .RS 4 .\} .nf \fBapt\-ftparchive\fR packages \fIdirectory\fR | \fBgzip\fR > Packages\&.gz .fi .if n \{\ .RE .\} .SH "関連項目" .PP \fBapt.conf\fR(5) .SH "診断メッセージ" .PP \fBapt\-ftparchive\fR は正常終了時に 0 を返します。エラー時には十進の 100 を返します。 .SH "バグ" .PP \m[blue]\fBAPT バグページ\fR\m[]\&\s-2\u[1]\d\s+2 をご覧ください。 APT のバグを報告する場合は、 /usr/share/doc/debian/bug\-reporting\&.txt や \fBreportbug\fR(1) コマンドをご覧ください。 .SH "翻訳" .PP 倉澤 望 (2003\-2006,2009\-2012), Takuma Yamada (2016), Debian JP Documentation ML .PP この翻訳文書には未訳部分が含まれている可能性があることに 注意してください。 翻訳がオリジナルに追従できていない場合、 内容を失わないようにこのようにしています。 .SH "著者" .PP \fBGunthorpe Jason[FAMILY Given]\fR .RS 4 .RE .PP \fB[FAMILY Given]\fR .RS 4 .RE .SH "注記" .IP " 1." 4 APT バグページ .RS 4 \%http://bugs.debian.org/src:apt .RE