名前¶

apt.conf - APT の設定ファイル

説明¶

/etc/apt/apt.conf は、APT スイートの全ツールで使用するメイン設定ファイルです。しかし、間違いなくオプションを設定しておくだけの場所などではありません。そのため、APT スイートは統一環境を提供するため、共通のコマンドラインパーサを共有しています。

APT ツールの起動時に、設定ファイルを以下の順番で読み込みます。

構文¶

設定ファイルは、機能グループごとに系統立てられたオプションを木構造で表します。オプションの指定は、2 つのコロンで区切ります。例えば APT::Get::Assume-Yes は、APT ツールグループの Get ツール用オプションです。オプションは、親グループからは継承しません。

Syntactically the configuration language is modeled after what the ISC tools such as bind and dhcp use. Lines starting with // are treated as comments (ignored), as well as all text between /* and */, just like C/C++ comments. Lines starting with # are also treated as comments. Each line is of the form APT::Get::Assume-Yes "true";. The quotation marks and trailing semicolon are required. The value must be on one line, and there is no kind of string concatenation. Values must not include backslashes or extra quotation marks. Option names are made up of alphanumeric characters and the characters "/-:._+". A new scope can be opened with curly braces, like this:

   
APT {


  Get {


    Assume-Yes "true";


    Fix-Broken "true";


  };
};

また適宜改行することで、より読みやすくなります。リストは、開いたスコープ、クォートで囲まれた 1 単語、そしてセミコロンと続けることで作成できます。セミコロンで区切って、複数のエントリを表せます。

   
DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};

/usr/share/doc/apt/examples/configure-index.gz は一般的な設定ファイルのサンプルです。どのように設定するか参考になるでしょう。

設定項目の名前にある文字の大小は、重要ではありません。そのため、前述の例を dpkg::pre-install-pkgs とすることもできます。

前述した DPkg::Pre-Install-Pkgs の例で見られるように、リストを定義した場合、設定項目名はオプションになります。名前を指定しない場合、新しいエントリは、単純に新しいオプションをリストに追加します。名前を指定して同様にすると、あらゆる他の選択肢をオプションに再割り当てし、オプションを上書きできます。

#include (これは廃止予定でサポートしない他の実装もあります) と #clear の 2 つの特別なコマンドがあります。#include は指定したファイルを取り込みます。ファイル名がスラッシュで終わった場合には、そのディレクトリをすべて取り込みます。#clear は、設定ツリーの一部を削除するのに使用します。指定した要素と、それ以下の要素を削除します (これらの行も、セミコロンで終わる必要があることに注意してください)。

#clear コマンドは、リストや完全なスコープを削除する唯一の方法です。スコープの再オープン (や後述する :: スタイル)は、それまで書いたエントリを上書きしません。オプションでは新しい値を与えて上書きするしかありませんが、リストやスコープは上書きできません。クリアされるだけです。

すべての APT ツールでは、コマンドラインで任意の設定ディレクティブを指定できる -o オプションが使用できます。構文は、完全なオプション名 (例: APT::Get::Assume-Yes) に続き等号、その後オプションの新しい値となります。リスト名に続き :: を加えることで、リストを追加できます (疑問に思われたように、スコープ構文はコマンドラインで使用できません)。

:: を用いたリストへの項目追加は、1 行で 1 項目の場合にのみ使用でき、スコープ構文と組み合わせるべきではないことに注意してください (スコープ構文には暗黙で :: が追加されます)。両方の構文を同時に使用すると、「他のオプションと同様に名前と共に動作する、通常ではありえない名前 "::" のオプションである」といった、(残念なことに) 複数のユーザに渡るバグの引き金になります。たくさんの問題の中には、リストに追加しようと誤った構文で複数行書いたユーザが、このオプション "::" を最後に割り当てようとして、正反対の結果を得るということも含まれます。APT の次期バージョンでは、この誤用を検出すると、動作を停止しエラーを上げるようになります。そのため、APT がこの件で明白にエラーを吐かない限りは、自分でそのような構文を修正してください。

APT グループ¶

このオプショングループは、ツール全体に影響のある、一般的な APT の振る舞いを制御します。

Architecture

Architectures

Compressor

APT::Compressor::rev {
	Name "rev";
	Extension ".reversed";
	Binary "rev";
	CompressArg {};
	UncompressArg {};
	Cost "10";
};

Build-Profiles

Default-Release

Ignore-Hold

Clean-Installed

Immediate-Configure

Force-LoopBreak

Cache-Start, Cache-Grow, Cache-Limit

Build-Essential

Get

Cache

CDROM

ACQUIRE グループ¶

オプションの Acquire グループは、パッケージのダウンロードやダウンロードに関して責任を持つ、様々な「取得 (acquire) 方法」 を制御します (sources.list(5) も参照)。

Check-Date

Max-FutureTime

Check-Valid-Until

Max-ValidTime

Min-ValidTime

AllowTLS

PDiffs

By-Hash

Queue-Mode

Retries

Source-Symlinks

http https

ftp

cdrom

/cdrom/::Mount "foo";

gpgv

CompressionTypes

Acquire::CompressionTypes::FileExtension "Methodname";

Acquire::CompressionTypes::Order:: "gz";

Acquire::CompressionTypes::Order { "xz"; "gz"; };

Dir::Bin::bzip2 "/bin/bzip2";

GzipIndexes

Languages

Acquire::Languages { "environment"; "de"; "en"; "none"; "fr"; };

ForceIPv4

ForceIPv6

MaxReleaseFileSize

EnableSrvRecords

AllowInsecureRepositories

AllowWeakRepositories

AllowDowngradeToInsecureRepositories

Changelogs::URI スコープ

バイナリユーザ設定¶

特に、apt のバイナリの導入では、APT::Get::Show-Versions が apt と同様に apt-get に効果を与えるように、特定のバイナリのみに影響を与えるように見えるオプションであっても、特定のバイナリのために特定のオプションを設定することは有用であり得ます。

特定のバイナリ用のオプション設定は、Binary::specific-binary スコープ内でオプションを設定して達成することができます。 apt 用のAPT::Get::Show-Versions オプションの設定は、例えば、Binary::apt::APT::Get::Show-Versions 設定の代わりに実行されることができます。

さらに上記の説明の節に見られるように、コマンドライン上のオプション自体またはコマンドラインからロードされた設定ファイル中でバイナリ固有のオプションを設定することはできません。

ディレクトリ¶

Dir::State セクションは、ローカル状態情報に関するディレクトリを保持します。lists は、ダウンロードしたパッケージ一覧を格納するディレクトリで、status は dpkg(1) の状態ファイルの名前を表します。preferences は APT の preferences ファイルの名前です。Dir::State には、/ や ./ で始まらないサブアイテムすべてに、前に付加するデフォルトディレクトリを含んでいます。

Dir::Cache は、ローカルキャッシュ情報に関する場所を格納しています。これは、ダウンロード済アーカイブの場所を示す Dir::Cache::archives と同様に、srcpkgcache と pkgcache のパッケージキャッシュの場所になります。pkgcache や srcpkgcache に "" をセットすることで、キャッシュの生成を無効にできます。これにより起動時に遅くなりますが、ディスク容量を節約できます。おそらく、srcpkgcache よりも pkgcache を無効にすることが多いと思います。Dir::State と同様、Dir::Cache はデフォルトディレクトリを含んでいます。

Dir::Etc は設定ファイルの場所を格納しています。sourcelist はソースリストの場所を示し、main はデフォルトの設定ファイルです。(APT_CONFIG で設定ファイルを指定された場合のみ、この設定の効果があります)

Dir::Parts 設定は、指定されたディレクトリから、字句単位の全ての設定断片を読みこみます。これを設定した後に、メイン設定ファイルをロードします。

バイナリプログラムは Dir::Bin で指定します。Dir::Bin::Methods はメソッドハンドラの場所を指定し、gzip, bzip2, lzma, dpkg, apt-get dpkg-source dpkg-buildpackage, apt-cache はそれぞれプログラムの場所を指定します。

設定項目 RootDir は特別な意味を持ちます。設定されていると、すべてのパスは 絶対パスとして指定してもRootDir からの相対パスとなります。そのため例えば、RootDir が /tmp/staging にセットされており、Dir::State::status が /var/lib/dpkg/status にセットされている場合、status ファイルを /tmp/staging/var/lib/dpkg/status から探します。相対バスのみをプレフィックスにしたい場合は、代わりに Dir を設定します。

Ignore-Files-Silently リストは、断片ディレクトリの解析中に、APT が黙って無視をするファイルを指定します。デフォルトではそれぞれ、.disabled, ~, .bak, .dpkg-[a-z]+ で終わるものが、黙って無視されます。最後のデフォルト値を見ればわかる通り、このパターンには正規表現を使用できます。

DSELECT での APT¶

dselect(1) メソッドで APT を使用する際、いくつかの設定ディレクティブでデフォルトの動作を制御します。これは DSelect セクション以下にあります。

Clean

options

Updateoptions

PromptAfterUpdate

APT が DPKG(1) を呼ぶ方法¶

いくつかの設定項目で APT がどのように dpkg(1) を呼び出すかを制御できます。DPkg セクションにあります。

options

Path

Pre-Invoke, Post-Invoke

Pre-Install-Pkgs

Run-Directory

Build-options

DPkg::ConfigurePending

PERIODIC オプションと ARCHIVES オプション¶

オプションの APT::Periodic グループと APT::Archives グループは、/usr/lib/apt/apt.systemd.daily スクリプトを使用して、apt の定期更新の挙動を設定します。このオプションのドキュメントは、このスクリプトの先頭を参照してください。

デバッグオプション¶

Debug:: セクションのオプションを有効にすると、apt ライブラリを利用するプログラムの標準エラー出力に、デバッグ情報を送るようになったり、主に apt の挙動をデバッグするのに便利な、特殊モードを有効にしたりできます。普通のユーザには、ほとんどのオプションは興味がないでしょうが、以下のものは興味を引くかもしれません。

以下は apt に対するデバッグオプションのすべてです。

Debug::Acquire::cdrom

Debug::Acquire::ftp

Debug::Acquire::http

Debug::Acquire::https

Debug::Acquire::gpgv

Debug::aptcdrom

Debug::BuildDeps

Debug::Hashes

Debug::IdentCDROM

Debug::NoLocking

Debug::pkgAcquire

Debug::pkgAcquire::Auth

Debug::pkgAcquire::Diffs

Debug::pkgAcquire::RRed

Debug::pkgAcquire::Worker

Debug::pkgAutoRemove

Debug::pkgDepCache::AutoInstall

Debug::pkgDepCache::Marker

Debug::pkgDPkgPM

Debug::pkgDPkgProgressReporting

Debug::pkgOrderList

Debug::pkgPackageManager

Debug::pkgPolicy

Debug::pkgProblemResolver

Debug::pkgProblemResolver::ShowScores

Debug::sourceList

Debug::RunScripts

サンプル¶

/usr/share/doc/apt/examples/configure-index.gz は、全利用可能オプション値のサンプルを参照できる、設定ファイルのサンプルです。

ファイル¶

/etc/apt/apt.conf

/etc/apt/apt.conf.d/

関連項目¶

apt-cache(8), apt-config(8), apt_preferences(5).

バグ¶

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]

Burrows Daniel[FAMILY Given] <dburrows@debian.org>

注記¶

1.

APT バグページ