名 前
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
packages コ マ ン ド は 、 デ ィ レ ク ト リ ツ リ ー か ら パ ッ ケ ー ジ フ ァ イ ル を 生 成 し ま す 。 与 え ら れ た デ ィ レ ク ト リ か ら 再 帰 検 索 し 、 .deb フ ァ イ ル を 取 得 し ま す 。 ま た パ ッ ケ ー ジ レ コ ー ド を 標 準 出 力 に そ れ ぞ れ 出 力 し ま す 。 こ の コ マ ン ド は 、 dpkg-scanpackages(1) と ほ ぼ 同 じ で す 。
--db オ プ シ ョ ン で 、 キ ャ ッ シ ュ DB を 指 定 で き ま す 。
sources
sources コ マ ン ド は 、 デ ィ レ ク ト リ ツ リ ー か ら ソ ー ス イ ン デ ッ ク ス フ ァ イ ル を 生 成 し ま す 。 与 え ら れ た デ ィ レ ク ト リ か ら 再 帰 検 索 し 、 .dsc フ ァ イ ル を 取 得 し ま す 。 ま た ソ ー ス レ コ ー ド を 標 準 出 力 に そ れ ぞ れ 出 力 し ま す 。 こ の コ マ ン ド は 、 dpkg-scansources(1) と ほ ぼ 同 じ で す 。
override フ ァ イ ル を 指 定 し た 場 合 、 src 拡 張 子 が つ い た ソ ー ス オ ー バ ー ラ イ ド フ ァ イ ル を 探 し ま す 。 使 用 す る ソ ー ス オ ー バ ー ラ イ ド フ ァ イ ル を 変 更 す る の に は 、 --source-override オ プ シ ョ ン を 使 用 し ま す 。
contents
contents コ マ ン ド は 、 デ ィ レ ク ト リ ツ リ ー か ら コ ン テ ン ツ フ ァ イ ル を 生 成 し ま す 。 与 え ら れ た デ ィ レ ク ト リ か ら 再 帰 検 索 し 、 .deb フ ァ イ ル を 取 得 し ま す 。 ま た フ ァ イ ル ご と に フ ァ イ ル 一 覧 を 読 み 取 り ま す 。 そ の 後 、 パ ッ ケ ー ジ に 対 応 す る フ ァ イ ル 一 覧 を 標 準 出 力 に ソ ー ト し て 出 力 し ま す 。 デ ィ レ ク ト リ は 出 力 に 含 ま れ ま せ ん 。 複 数 の パ ッ ケ ー ジ が 同 じ フ ァ イ ル を 持 つ 場 合 、 パ ッ ケ ー ジ 名 を カ ン マ 区 切 り で 出 力 し ま す 。
--db オ プ シ ョ ン で 、 キ ャ ッ シ ュ DB を 指 定 で き ま す 。
release
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 フ ァ イ ル を 標 準 出 力 に 書 き 出 し ま す 。
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 で す 。
generate
generate コ マ ン ド は 、 cron ス ク リ プ ト か ら 実 行 で き る よ う 設 計 さ れ て お り 、 与 え ら れ た 設 定 フ ァ イ ル に 従 っ て イ ン デ ッ ク ス を 生 成 し ま す 。 設 定 言 語 は 、 必 要 な 設 定 を 維 持 す る 簡 単 な 方 法 を 提 供 す る と 共 に 、 イ ン デ ッ ク ス フ ァ イ ル を ど の デ ィ レ ク ト リ か ら 作 成 す る か を 指 定 す る 、 柔 軟 な 方 法 を 提 供 し ま す 。
clean
clean コ マ ン ド は 、 設 定 フ ァ イ ル で 与 え ら れ た デ ー タ ベ ー ス を 、 も う 必 要 な い レ コ ー ド を 削 除 し て 整 理 し ま す 。
GENERATE 設 定
generate コ マ ン ド は 、 生 成 す る ア ー カ イ ブ に 関 す る 記 述 を し た 設 定 フ ァ イ ル を 使 用 し ま す 。 設 定 フ ァ イ ル は 、 bind 8 や dhcpd と い っ た ISC ツ ー ル に 見 ら れ る よ う な 、 ISC 設 定 フ ォ ー マ ッ ト に 従 い ま す 。 apt.conf(5) に 、 構 文 の 説 明 が あ り ま す 。 Generate 設 定 は セ ク シ ョ ン 法 で 解 析 し ま す が 、 apt.conf(5) は ツ リ ー 法 で 解 析 す る の に 注 意 し て く だ さ い 。 こ れ は ス コ ー プ タ グ の 扱 い 方 に 違 い が あ る だ け で す 。
generate 設 定 に は 4 個 の 独 立 し た セ ク シ ョ ン が あ り ま す 。 以 下 そ れ ぞ れ 説 明 し ま す 。
Dir セ
ク シ ョ ン
Dir セ ク シ ョ ン は
、 生 成 プ ロ セ
ス で 必 要 な フ
ァ イ ル を 配 置
す る た め に 必
要 な 、 標 準 デ
ィ レ ク ト リ を
定 義 し ま す 。
こ の デ ィ レ ク
ト リ は 、 完 全
な 絶 対 パ ス を
生 成 す る た め
、 後 の セ ク シ
ョ ン で 定 義 さ
れ る 相 対 パ ス
の 前 に 結 合 さ
れ ま す 。
ArchiveDir
FTP ア ー カ イ ブ の ル ー ト を 指 定 し ま す 。 標 準 的 な Debian 設 定 で は 、 こ の デ ィ レ ク ト リ に は ls-LR と dist ノ ー ド が あ り ま す 。
OverrideDir オ ー バ ー ラ イ ド フ ァ イ ル の 場 所 を 指 定 し ま す 。
CacheDir キ ャ ッ シ ュ フ ァ イ ル の 場 所 を 指 定 し ま す 。
FileListDir
FileList 設 定 が 以 下 で 使 用 さ れ て い る 場 合 、 フ ァ イ ル リ ス ト フ ァ イ ル の 場 所 を 指 定 し ま す 。
Default
セ ク シ ョ ン
Default セ ク シ ョ ン
で は デ フ ォ ル
ト 値 を 指 定 し
ま す 。 ま た 、
生 成 器 の 動 作
を 制 御 す る 設
定 も 行 い ま す
。 他 の セ ク シ
ョ ン で は 、 こ
こ に あ る デ フ
ォ ル ト 値 を 、
セ ク シ ョ ン ご
と の 設 定 で 上
書 き し ま す 。
Packages::Compress パ ッ ケ ー ジ イ ン デ ッ ク ス フ ァ イ ル の デ フ ォ ル ト 圧 縮 方 法 を 設 定 し ま す 。 設 定 項 目 APT::Compressor に よ っ て 設 定 し た 圧 縮 形 式 の 最 低 1つ が 入 る 、 空 白 区 切 り の 文 字 列 で す 。 圧 縮 方 法 の デ フ ォ ル ト は す べ て '. gzip' で す 。
Packages::Extensions パ ッ ケ ー ジ フ ァ イ ル 拡 張 子 の デ フ ォ ル ト 値 を 列 挙 し ま す 。 こ の デ フ ォ ル ト 値 は '.deb' で す 。
Sources::Compress
Packages::Compress と 同 様 に 、 Sources フ ァ イ ル の 圧 縮 方 法 を 指 定 し ま す 。
Sources::Extensions ソ ー ス フ ァ イ ル 拡 張 子 の デ フ ォ ル ト 値 を 列 挙 し ま す 。 こ の デ フ ォ ル ト 値 は '.dsc' で す 。
Contents::Compress
Packages::Compress と 同 様 に 、 Contents フ ァ イ ル の 圧 縮 方 法 を 指 定 し ま す 。
Translation::Compress
Packages::Compress と 同 様 に 、 Translation-en マ ス タ ー フ ァ イ ル の 圧 縮 を 制 御 し ま す 。
DeLinkLimit 実 行 す る ご と に delink (及 び ハ ー ド リ ン ク の 置 き 換 え ) す る 量 を 、 キ ロ バ イ ト 単 位 で 指 定 し ま す 。 セ ク シ ョ ン ご と の External-Links 設 定 と 合 わ せ て 使 い ま す 。
FileMode 作 成 し た イ ン デ ッ ク ス フ ァ イ ル の モ ー ド を 指 定 し ま す 。 デ フ ォ ル ト は 0644 で す 。 全 イ ン デ ッ ク ス フ ァ イ ル は 、 umask を 無 視 し て こ の モ ー ド を 使 用 し ま す 。
LongDescription 長 い 説 明 文 を Packages フ ァ イ ル に 含 め る か 、 マ ス タ ー Translation-en フ ァ イ ル に 分 割 す る か を 指 定 し ま す 。
TreeDefault セ ク シ ョ ン 特 定 の Tree セ ク シ ョ ン の デ フ ォ ル ト を 設 定 し ま す 。 こ れ ら の 変 数 は す べ て 置 換 変 数 で あ り 、 文 字 列 $(DIST), $(SECTION), $(ARCH) を そ れ ぞ れ の 値 に 展 開 し ま す 。
MaxContentsChange 日 毎 に 生 成 す る contents フ ァ イ ル を キ ロ バ イ ト 単 位 で 設 定 し ま す 。 contents フ ァ イ ル を ラ ウ ン ド ロ ビ ン し 、 数 日 経 つ と す べ て 再 生 成 し ま す 。
ContentsAge 変 更 が な い contents フ ァ イ ル を チ ェ ッ ク す る 日 数 を 指 定 し ま す 。 こ の 制 限 を 越 え た contents フ ァ イ ル の mtime を 、 更 新 し ま す 。 パ ッ ケ ー ジ フ ァ イ ル が 変 更 さ れ て も 、 [例 え ば 上 書 き 編 集 で ] contents フ ァ イ ル が 更 新 さ れ な い よ う な 場 合 、 こ う い っ た こ と が 発 生 し ま す 。 新 し い .deb フ ァ イ ル を イ ン ス ト ー ル し た い 場 合 、 保 留 を 解 除 で き 、 少 な く と も 新 し い フ ァ イ ル が 必 要 で す 。 デ フ ォ ル ト は 10 で 、 単 位 は 日 で す 。
Directory
.deb デ ィ レ ク ト リ ツ リ ー の 先 頭 を 設 定 し ま す 。 デ フ ォ ル ト は $(DIST)/$(SECTION)/binary-$(ARCH)/ で す 。
SrcDirectory ソ ー ス パ ッ ケ ー ジ デ ィ レ ク ト リ ツ リ ー の 先 頭 を 設 定 し ま す 。 デ フ ォ ル ト は $(DIST)/$(SECTION)/source/ で す 。
Packages
Packages フ ァ イ ル の 出 力 先 を 設 定 し ま す 。 デ フ ォ ル ト は $(DIST)/$(SECTION)/binary-$(ARCH)/Packages で す 。
Sources
Sources フ ァ イ ル の 出 力 先 を 設 定 し ま す 。 デ フ ォ ル ト は $(DIST)/$(SECTION)/source/Sources で す 。
Translation 万 一 Packages フ ァ イ ル に 含 ま れ て い な い 場 合 、 長 い 説 明 文 が あ る Translation-en マ ス タ ー フ ァ イ ル の 出 力 先 を 設 定 し ま す 。 デ フ ォ ル ト は 、 $(DIST)/$(SECTION)/i18n/Translation-en で す 。
InternalPrefix 外 部 リ ン ク で は な く 、 内 部 リ ン ク と 見 な す 判 断 材 料 と な る 、 パ ス の プ レ フ ィ ッ ク ス を 設 定 し ま す 。 デ フ ォ ル ト は 、 $(DIST)/$(SECTION)/ で す 。
Contents
Contents フ ァ イ ル の 出 力 先 を 設 定 し ま す 。 デ フ ォ ル ト は 、 $(DIST)/$(SECTION)/Contents-$(ARCH) で す 。 複 数 の Packages フ ァ イ ル を ひ と つ の Contents フ ァ イ ル に ま と め ら れ る 設 定 (デ フ ォ ル ト ) の 場 合 、 apt-ftparchive は 自 動 で パ ッ ケ ー ジ フ ァ イ ル を ま と め ま す 。
Contents::Header
contents の 出 力 に 付 け る ヘ ッ ダ フ ァ イ ル を 設 定 し ま す 。
BinCacheDB こ の セ ク シ ョ ン で 使 用 す る バ イ ナ リ キ ャ ッ シ ュ デ ー タ ベ ー ス を 設 定 し ま す 。 複 数 の セ ク シ ョ ン で 同 じ デ ー タ ベ ー ス を 共 有 で き ま す 。
FileList デ ィ レ ク ト リ ツ リ ー を 走 査 す る 代 わ り に 、 apt-ftparchive が 読 み 込 む フ ァ イ ル 一 覧 フ ァ イ ル を 指 定 し ま す 。 相 対 フ ァ イ ル 名 は 、 ア ー カ イ ブ デ ィ レ ク ト リ が 先 頭 に つ き ま す 。
SourceFileList デ ィ レ ク ト リ ツ リ ー を 走 査 す る 代 わ り に 、 apt-ftparchive が 読 み 込 む フ ァ イ ル 一 覧 フ ァ イ ル を 指 定 し ま す 。 相 対 フ ァ イ ル 名 は 、 ア ー カ イ ブ デ ィ レ ク ト リ が 先 頭 に つ き ま す 。 ソ ー ス イ ン デ ッ ク ス を 処 理 す る 際 に 使 用 し ま す 。
Tree
セ ク シ ョ ン
Tree セ ク シ ョ ン で
は 、 ベ ー ス デ
ィ レ ク ト リ か
ら の 標 準 Debian フ ァ
イ ル ツ リ ー 、
ベ ー ス デ ィ レ
ク ト リ の 複 数
の セ ク シ ョ ン
、 最 終 的 に は
セ ク シ ョ ン ご
と の 複 数 の ア
ー キ テ ク チ ャ
を 定 義 し ま す
。 使 用 す る 正
確 な パ ス は 、
Directory 変 数 で 定 義
さ れ ま す 。
Tree セ ク シ ョ ン は 、 $(DIST) 変 数 で 設 定 さ れ て い る ス コ ー プ タ グ を と り 、 ツ リ ー の ル ー ト (ArchiveDirが 先 頭 に つ く パ ス ) を 定 義 し ま す 。 通 常 、 こ の 設 定 は dists/bookworm の よ う に な り ま す 。
TreeDefault セ ク シ ョ ン で 定 義 さ れ る 設 定 は す べ て 、 3 個 の 新 し い 変 数 と 同 様 に 、 Tree セ ク シ ョ ン で 使 用 で き ま す 。
Tree セ ク シ ョ ン を 処 理 す る 際 、 apt-ftparchive は 以 下 の よ う な 操 作 を 行 い ま す 。
for i in
Sections do
for j in Architectures do
Generate for DIST=scope SECTION=i ARCH=j
Sections
distribution 以 下 に 現 れ る セ ク シ ョ ン を 、 空 白 区 切 り で 指 定 し た リ ス ト で す 。 通 常 、 main contrib non-free non-free-firmware の よ う に な り ま す 。
Architectures 検 索 部 の 下 に 表 示 さ れ る す べ て の ア ー キ テ ク チ ャ の 空 白 区 切 り リ ス ト で す 。 特 別 な ア ー キ テ ク チ ャ 「 source」 は 、 こ の ツ リ ー が ソ ー ス ア ー カ イ ブ を 持 っ て い る こ と を 示 す た め に 使 用 さ れ ま す 。 ア ー キ テ ク チ ャ 「 all」 は 、 Packages の よ う な ア ー キ テ ク チ ャ 固 有 の フ ァ イ ル が す べ て の フ ァ イ ル 中 の ア ー キ テ ク チ ャ all パ ッ ケ ー ジ に 関 す る 情 報 を 含 ま ず 、 専 用 の フ ァ イ ル で 利 用 で き る こ と を 示 し ま す 。
LongDescription 長 い 説 明 文 を Packages フ ァ イ ル に 含 め る か 、 マ ス タ ー Translation-en フ ァ イ ル に 分 割 す る か を 指 定 し ま す 。
BinOverride バ イ ナ リ オ ー バ ー ラ イ ド フ ァ イ ル を 設 定 し ま す 。 こ の オ ー バ ー ラ イ ド フ ァ イ ル に は 、 セ ク シ ョ ン 、 優 先 度 、 メ ン テ ナ の ア ド レ ス と い っ た 情 報 が 含 ま れ て い ま す 。
SrcOverride ソ ー ス オ ー バ ー ラ イ ド フ ァ イ ル を 設 定 し ま す 。 こ の オ ー バ ー ラ イ ド フ ァ イ ル に は 、 セ ク シ ョ ン の 情 報 が 含 ま れ て い ま す 。
ExtraOverride バ イ ナ リ 特 別 オ ー バ ー ラ イ ド フ ァ イ ル を 設 定 し ま す 。
SrcExtraOverride ソ ー ス 特 別 オ ー バ ー ラ イ ド フ ァ イ ル を 設 定 し ま す 。
BinDirectory
セ ク シ ョ ン
bindirectory セ ク シ ョ ン
で は 、 特 殊 な
構 造 を 持 た な
い バ イ ナ リ デ
ィ レ ク ト リ ツ
リ ー を 定 義 し
ま す 。 ス コ ー
プ タ グ は バ イ
ナ リ デ ィ レ ク
ト リ の 場 所 を
指 定 し 、 設 定
は 変 数 展 開 の
な い Tree セ ク シ ョ
ン や SectionArchitecture 設 定
に 似 て い ま す
。
Packages
Packages フ ァ イ ル の 出 力 先 を 設 定 し ま す 。
Sources
Sources フ ァ イ ル の 出 力 先 を 設 定 し ま す 。 少 な く と も Packages か Sources の う ち 、 ひ と つ は 必 要 で す 。
Contents
Contents フ ァ イ ル の 出 力 先 を 設 定 し ま す (オ プ シ ョ ン )。
BinOverride バ イ ナ リ オ ー バ ー ラ イ ド フ ァ イ ル を 設 定 し ま す 。
SrcOverride ソ ー ス オ ー バ ー ラ イ ド フ ァ イ ル を 設 定 し ま す 。
ExtraOverride バ イ ナ リ 特 別 オ ー バ ー ラ イ ド フ ァ イ ル を 設 定 し ま す 。
SrcExtraOverride ソ ー ス 特 別 オ ー バ ー ラ イ ド フ ァ イ ル を 設 定 し ま す 。
BinCacheDB キ ャ ッ シ ュ DB を 設 定 し ま す 。
PathPrefix 全 出 力 パ ス に 付 加 す る パ ス 。
FileList, SourceFileList フ ァ イ ル 一 覧 フ ァ イ ル を 指 定 し ま す 。
バ イ ナ リ オ ー バ ー ラ イ ド フ ァ イ ル
バ イ ナ リ オ ー バ ー ラ イ ド フ ァ イ ル は 、 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 与 え た チ ェ ッ ク サ ム を 生 成 し ま す 。 こ の オ プ シ ョ ン は デ フ ォ ル ト で on で す 。 off に す る と 生 成 し た イ ン デ ッ ク ス フ ァ イ ル に は checksum フ ィ ー ル ド が 含 ま れ ま せ ん 。 設 定 項 目 : APT::FTPArchive::Checksum と APT::FTPArchive::Index::Checksum。 こ こ で Index は Packages, Sources, Release に な り ま す 。 Checksum は MD5, SHA1, SHA256 ま た は SHA512 に な り ま す 。
-d, --db バ イ ナ リ キ ャ ッ シ ュ DB を 使 用 し ま す 。 generate コ マ ン ド に は 影 響 し ま せ ん 。 設 定 項 目 : APT::FTPArchive::DB
-q, --quiet 静 粛 - 進 捗 表 示 を 省 略 し 、 ロ グ を と る の に 便 利 な 出 力 を 行 い ま す 。 最 大 2 つ ま で q を 重 ね る こ と で よ り 静 粛 に で き ま す 。 ま た 、 -q=# の よ う に 静 粛 レ ベ ル を 指 定 し て 、 設 定 フ ァ イ ル を 上 書 き す る こ と も で き ま す 。 設 定 項 目 : quiet
--delink
Delink を 実 行 し ま す 。 External-Links 設 定 を 使 用 し て い る 場 合 、 こ の オ プ シ ョ ン は フ ァ イ ル の delink を 有 効 に し ま す 。 デ フ ォ ル ト は on で 、 off に す る に は --no-delink と し て く だ さ い 。 設 定 項 目 : APT::FTPArchive::DeLinkAct
--contents
contents の 生 成 を 行 い ま す 。 こ の オ プ シ ョ ン を 指 定 し 、 パ ッ ケ ー ジ イ ン デ ッ ク ス を キ ャ ッ シ ュ DB と 共 に 生 成 す る 際 、 フ ァ イ ル リ ス ト を 後 で 使 用 す る よ う に 、 抽 出 し DB に 格 納 し ま す 。 generate コ マ ン ド を 使 用 す る 際 、 こ の オ プ シ ョ ン で い ず れ の Contents フ ァ イ ル も 作 成 で き ま す 。 デ フ ォ ル ト は on で す 。 設 定 項 目 : APT::FTPArchive::Contents
-s, --source-override
sources コ マ ン ド で 使 用 す る 、 ソ ー ス オ ー バ ー ラ イ ド フ ァ イ ル を 選 択 し ま す 。 設 定 項 目 : APT::FTPArchive::SourceOverride
--readonly キ ャ ッ シ ュ デ ー タ ベ ー ス を 読 み 取 り 専 用 に し ま す 。 設 定 項 目 : APT::FTPArchive::ReadOnlyDB
-a, --arch
packages コ マ ン ド や contents コ マ ン ド で 、 与 え た パ ス に あ る す べ て の パ ッ ケ ー ジ フ ァ イ ル で は な く 、 *_arch.deb や *_all.deb に 一 致 し た パ ッ ケ ー ジ フ ァ イ ル の み を 受 け 付 け ま す 。 設 定 項 目 : APT::FTPArchive::Architecture
APT::FTPArchive::AlwaysStat
apt-ftparchive(1) は cachedb の メ タ デ ー タ に 可 能 な 限 り キ ャ ッ シ ュ し ま す 。 パ ッ ケ ー ジ を 再 コ ン パ イ ル し 、 ま た 同 じ バ ー ジ ョ ン で 再 発 行 さ れ る と 、 古 く な っ て し ま っ た キ ャ ッ シ ュ の メ タ デ ー タ (サ イ ズ や チ ェ ッ ク サ ム ) が 使 わ れ 、 こ れ が 問 題 に な る こ と が あ り ま す 。 こ の オ プ シ ョ ン を 有 効 に す る と 、 フ ァ イ ル を 更 新 す る と チ ェ ッ ク が 行 わ れ る た め 、 問 題 が 起 こ ら な く な り ま す 。 デ フ ォ ル ト で は 、 こ の オ プ シ ョ ン は "false" に セ ッ ト さ れ て い る こ と に 注 意 し て く だ さ い 。 バ ー ジ ョ ン や 、 同 じ バ ー ジ ョ ン 番 号 の パ ッ ケ ー ジ の ビ ル ド を 、 増 や し て ア ッ プ ロ ー ド す る の は 推 奨 し な い か ら で す 。 そ の た め 理 論 上 、 誰 も そ の 問 題 に 行 き 会 わ ず 、 す べ て の 追 加 チ ェ ッ ク に は 、 意 味 が あ り ま せ ん 。
APT::FTPArchive::LongDescription こ の 設 定 オ プ シ ョ ン は デ フ ォ ル ト で "true" で 、 apt-ftparchive(1) が 生 成 し た ア ー カ イ ブ が Translation フ ァ イ ル も 提 供 す る 場 合 に の み "false" に 設 定 し て く だ さ い 。 Translation-en マ ス タ ー フ ァ イ ル は generate コ マ ン ド で の み 生 成 で き る こ と に 注 意 し て く だ さ い 。
-h, --help 使 い 方 の 短 い 要 約 を 表 示 し ま す 。
-v, --version プ ロ グ ラ ム の バ ー ジ ョ ン を 表 示 し ま す 。
-c, --config-file 設 定 フ ァ イ ル 。 使 用 す る 設 定 フ ァ イ ル を 指 定 し ま す 。 こ の プ ロ グ ラ ム は 、 デ フ ォ ル ト 設 定 フ ァ イ ル を 読 ん で か ら 、 こ の 設 定 フ ァ イ ル を 読 み ま す 。 こ の 設 定 を デ フ ォ ル ト 設 定 フ ァ イ ル よ り も 前 に 読 む 必 要 が あ る 場 合 、 APT_CONFIG 環 境 変 数 に 指 定 し て く だ さ い 。 構 文 に つ い て は apt.conf(5) を ご 覧 く だ さ い 。
-o, --option 設 定 オ プ シ ョ ン の セ ッ ト 。 任 意 の 設 定 オ プ シ ョ ン を セ ッ ト し ま す 。 構 文 -o Foo::Bar=bar と な り ま す 。 異 な る オ プ シ ョ ン を 設 定 す る た め 、 -o と --option は 、 複 数 回 使 用 で き ま す 。
サ ン プ ル
バ イ ナ リ パ ッ ケ ー ジ (.deb) が あ る デ ィ レ ク ト リ の Packages フ ァ イ ル を 生 成 す る に は 、 以 下 の よ う に し ま す 。
apt-ftparchive packages directory | gzip > Packages.gz
関 連 項 目
診 断 メ ッ セ ー ジ
apt-ftparchive は 正 常 終 了 時 に 0 を 返 し ま す 。 エ ラ ー 時 に は 十 進 の 100 を 返 し ま す 。
バ グ
APT バ グ ペ ー ジ [1] を ご 覧 く だ さ い 。 APT の バ グ を 報 告 す る 場 合 は 、 /usr/share/doc/debian/bug-reporting.txt や reportbug(1) コ マ ン ド を ご 覧 く だ さ い 。
翻 訳
倉 澤 望 <nabetaro [AT] debian.jp> (2003-2006,2009-2012), Takuma Yamada <tyamada [AT] takumayamada.com> (2016), Debian JP Documentation ML <debian-doc [AT] debian.jp> こ の 翻 訳 文 書 に は 未 訳 部 分 が 含 ま れ て い る 可 能 性 が あ る こ と に 注 意 し て く だ さ い 。 翻 訳 が オ リ ジ ナ ル に 追 従 で き て い な い 場 合 、 内 容 を 失 わ な い よ う に こ の よ う に し て い ま す 。
著 者
Gunthorpe Jason[FAMILY Given]
[FAMILY Given]
注 記
|
1. |
APT バ グ ペ ー ジ |