APT プリファレンスファイル /etc/apt/preferences と /etc/apt/preferences.d/ フォルダにある断片ファイルは、インストールするパッケージのバージョンを制御するのに使用します。
sources.list(5) ファイルに複数のディストリビューション (stable と testing など) が指定されていて、パッケージに対し複数のバージョンがインストールできることがあります。このとき APT は、利用できるバージョンごとに優先度を割り当てます。依存関係規則を条件として、apt-get は、最も高い優先度を持つバージョンをインストールするよう選択します。APT プリファレンスファイルは、APT がデフォルトで割り当てた、パッケージのバージョンの優先度を上書きします。その結果インストールするものの選択を、ユーザが選択できるようになります。
sources.list(5) ファイルに複数の参照が書かれている場合、パッケージの同じバージョンのインスタンスが複数利用できる可能性があります。この場合、apt-get は sources.list(5) ファイルの初めの方に指定されているところからダウンロードします。APT プリファレンスファイルはバージョンの選択にのみ影響し、インスタンスの選択には影響しません。
プリファレンスファイルは、システム管理者の強い力ですが、注意して使わないと大きな悪夢にもなります! APT はプリファレンスについて問い合わせることはしません。そのため、設定を誤ったことにより、インストールできないパッケージに誘導されたり、パッケージのアップグレード中に誤った判断をしたりという事がありえます。以降の段落の内容をよく理解しないで、複数のディストリビューションリリースを混ぜてしまうと、より多くの問題が発生する事になります。特定のリリースに含まれるパッケージは、古い/新しいリリースや、異なるリリースから持ってきた他のパッケージとでは、テストされていません (し、予想通りに常に動作するとは限りません)。以上、警告しました。
/etc/apt/preferences.d ディレクトリにあるファイルは、英数字の昇順で解析され、以下の命名規約に従う必要があることに注意してください。ファイル名の拡張子はないか、"pref" となっており、英数字、ハイフン (-)、アンダースコア (_)、ピリオド (.) でできています。そうでなければ、Dir::Ignore-Files-Silently 設定リストのパターンに一致するもの以外に対して、ファイルを無視するという注意を APT が出力します。一致する場合は黙って無視します。
プリファレンスファイルがなかったり、プリファレンスファイルに特定のパッケージを割り当てるエントリがない場合、そのバージョンの優先度は、そのバージョンが属しているディストリビューションの優先度となります。デフォルトで他のディストリビューションより高い優先度を持つ、特定のディストリビューションを「ターゲットリリース」としておけます。ターゲットリリースは、apt-get のコマンドラインや、APT 設定ファイル /etc/apt/apt.conf で設定できます。後述する /etc/apt/preferences ファイルで設定した一般優先度よりもこれは優先されますが、pin 止めしたパッケージには及ばないことに注意してください。例えば以下のようになります。
apt-get install -t testing some-package
APT::Default-Release "stable";
ターゲットリリースが指定されると、APT は以下のアルゴリズムで、パッケージのバージョンの優先度を設定します。以下のように割り当てます。
優先度 1
優先度 100
優先度 500
優先度 990
ターゲットリリースが指定されていなければ、APT は単純にインストールしているパッケージのバージョンには優先度 100 を、インストールしていないパッケージのバージョンには優先度 500 を割り当てます。ただし、Release ファイルに "NotAutomatic: yes" とマークされたアーカイブ由来のバージョンは違います。こういったバージョンでは優先度 1 を割り当て、さらに "ButAutomaticUpgrades: yes" とマークされている場合には、優先度 100 を割り当てます。
APT は、インストールするパッケージのバージョンを決定するために、以下のルールを上から順番に適用します。
よくある状況として、あるインストールされているパッケージのバージョン (優先度 100) が、sources.list(5) ファイルのリストから得られるバージョン (優先度 500 か 990) よりも新しくないということがあります。この場合、apt-get install some-package や apt-get upgrade を実行するとパッケージが更新されます。
まれに、インストールされているパッケージのバージョンが、他の有効なバージョンよりも新しい場合があります。この時 apt-get install some-package や apt-get upgrade を実行しても、ダウングレードしません。
時々、インストールしているパッケージのバージョンが、ターゲットリリースに属するバージョンよりも新しく、他のディストリビューションよりも古い場合があります。そのようなパッケージに対して apt-get install some-package や apt-get upgrade を実行すると、パッケージは更新されます。この場合、インストールされているバージョンよりも、少なくともひとつは、高い優先度を持つ有効なパッケージがあるからです。
APT understands a field called Phased-Update-Percentage which can be used to control the rollout of a new version. It is an integer between 0 and 100.
A system's eligibility to a phased update is determined by seeding random number generator with the package source name, the version number, and /etc/machine-id, and then calculating an integer in the range [0, 100]. If this integer is larger than the Phased-Update-Percentage, the version is pinned to 1, and thus held back. Otherwise, normal policy rules apply.
In case you have multiple systems that you want to receive the same set of updates, you can set APT::Machine-ID to a UUID such that they all phase the same, or set APT::Get::Never-Include-Phased-Updates or APT::Get::Always-Include-Phased-Updates to true such that APT will never/always consider phased updates.
APT プリファレンスファイルを使うと、システム管理者が優先度を割り当てられるようになります。ファイルは、空白行で区切られた、複数行からなるレコードで構成されています。レコードは特定形式か、汎用形式のどちらかの形式をとります。
Package: perl Pin: version 5.20* Pin-Priority: 1001
APT プリファレンスファイルに書かれている汎用形式のエントリは、パッケージのグループについてのみ適用されます。例えば以下のレコードは、ローカルサイトにある全パッケージについて、高い優先度を割り当てます。
Package: * Pin: origin "" Pin-Priority: 999
注意: ここで使われるキーワードは、ホスト名にマッチするのに使われる "origin" です。以下のレコードは、ホスト名が "ftp.de.debian.org" で識別されるサーバ由来のすべてのバージョンに、高い優先度を割り当てます。
Package: * Pin: origin "ftp.de.debian.org" Pin-Priority: 999
Release ファイルに指定されたような、ディストリビューションの Origin と 混同しないようにしてください。Release ファイルにある "Origin:" タグは、インターネットアドレスではなく、"Debian" や "Ximian" といった作者やベンダ名です。
以下のレコードは、アーカイブ名が "unstable" となっているディストリビューションに属するパッケージを、すべて低い優先度に割り当てます。
Package: * Pin: release a=unstable Pin-Priority: 50
以下のレコードは、コード名が "bookworm" となっているディストリビューションに属するパッケージのバージョンを、高い優先度に割り当てます。
Package: * Pin: release n=bookworm Pin-Priority: 900
以下のレコードは、アーカイブ名が "stable" で、リリースバージョン番号が "11" となっているリリースに属するパッケージを、すべて高い優先度に割り当てます。
Package: * Pin: release a=stable, v=11 Pin-Priority: 500
コンマ演算子の効果は "and" 論理に似ています: ピンが一致するようにすべての条件がピンが一致しなければなりません。一つの例外があります: 条件のいずれかの型では (例えば、二つの "a" 条件)、ただ最後の条件のみがチェックされます。
APT は glob(7) 表現と、スラッシュで囲んだ正規表現による pin もサポートしています。例えば以下の例は、gnome で始まる (glob(7) 風表現) か kde を含む (スラッシュで囲んだ POSIX の拡張正規表現) 名前の、experimental 由来のすべてのパッケージに、優先度500を割り当てます。
Package: gnome* /kde/ Pin: release a=experimental Pin-Priority: 500
この表現の規則は、文字が現れうる場所なら、どこでも発生しうるという事です。したがって、以下の pin は、hirsute で始まるリリース由来の、すべてのパッケージに、優先度 990 を割り当てます。
Package: * Pin: release n=hirsute* Pin-Priority: 990
Package フィールドも正規表現が現れる場合、正規表現を、マッチするすべてのパッケージ名のリストに置き換えたものとして、動作します。これは将来変更されるかどうか、まだ決定していません。そのため、まずはじめにワイルドカード pin を、常に記述するようにしてください。その後に続く pin で上書きされます。Package フィールドの "*" パターンは、glob(7) 表現自体とは見なされません。
APT supports pinning by source packages. To pin by a source package, prepend "src:" to the package name.
For example, to pin all binaries produced by the apt source package of this APT's version to 990, you can do:
Package: src:apt Pin: version 2.1.20 Pin-Priority: 990
Source package pinning can be combined with regular expressions and glob patterns, and can also take a binary architecture.
For example, let's pin all binaries for all architectures produced by any source package containing apt in its name to 990:
Package: src:*apt*:any Pin: version * Pin-Priority: 990
APT プリファレンスファイルで割り当てた優先度 (P) は、正負の整数でなくてはなりません。これは (おおざっぱにいうと) 以下のように解釈されます。
P >= 1000
990 <= P < 1000
500 <= P < 990
100 <= P < 500
0 < P < 100
P < 0
P = 0
利用可能なパッケージバージョンに一致する最初の特定形式のレコードが、パッケージバージョンの優先度を決定します。それに失敗すると、パッケージバージョンの優先度は、バージョンに一致する汎用形式のレコードで定義されたすべての優先度の最大値として定義されます。
例えば、APT プリファレンスファイルの上の方に、以下のレコードが書かれていると仮定してください。
Package: perl Pin: version 5.20* Pin-Priority: 1001 Package: * Pin: origin "" Pin-Priority: 999 Package: * Pin: release unstable Pin-Priority: 50
すると、以下のように動作します。
sources.list(5) ファイルに列挙した場所では、その場所で利用できるパッケージを記述した、Packages ファイルや Release ファイルを提供します。
Packages ファイルは通常 .../dists/dist-name/component/arch ディレクトリにあります。例えば、.../dists/stable/main/binary-i386/Packages です。これは、ディレクトリにある利用可能パッケージごとに、複数行のレコードからできています。APT 優先度の設定は、レコードごとに以下の 2 行だけです。
Package: 行
Version: 行
Release ファイルは、通常 .../dists/dist-name ディレクトリにあります。例えば、.../dists/stable/Release や .../dists/bullseye/Release です。これは、このディレクトリ以下にある全パッケージに適用する、複数行のレコード 1 つから成っています。Packages ファイルと違い Release ファイルは、以下のようにほとんどの行が APT 優先度の設定に関連します。
Archive: 行や Suite: 行
Pin: release a=stable
Codename: 行
Pin: release n=bookworm
Version: 行
Pin: release v=11 Pin: release a=stable, v=11 Pin: release 11
Component: 行
Pin: release c=main
Origin: 行
Pin: release o=Debian
Label: 行
Pin: release l=Debian
sources.list(5) ファイルに列挙された場所から取得した Packages ファイルや Release ファイルはすべて、/var/lib/apt/lists ディレクトリや、apt.conf ファイルの Dir::State::Lists 変数で指定した場所に取得されます。例えば、debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release ファイルは、debian.lcs.mit.edu から取得した、unstable ディストリビューションで、contrib コンポーネントな、binary-i386 アーキテクチャ用の Release ファイルを含んでいます。
APT プリファレンスファイルのレコードごとに、任意で Explanation: で始まる行を持てます。これは、コメント用の場所を確保します。
以下の APT プリファレンスファイルは、stable ディストリビューションに属する全てのパッケージのバージョンに、デフォルト (500) より高い優先度を割り当て、他の Debian ディストリビューションのパッケージのバージョンには、低くてインストールできないような優先度を割り当てます。
Explanation: Uninstall or do not install any Debian-originated Explanation: package versions other than those in the stable distro Package: * Pin: release a=stable Pin-Priority: 900 Package: * Pin: release o=Debian Pin-Priority: -10
適切な sources.list(5) ファイルと上記のプリファレンスファイルにより、以下のコマンドのいずれかで最新の stable バージョンにアップグレードできます。
apt-get install package-name apt-get upgrade apt-get dist-upgrade
以下のコマンドで、指定したパッケージを testing ディストリビューションの最新バージョンにアップグレードします。このパッケージは、再度このコマンドを発行しないとアップグレードされません。
apt-get install package/testing
以下の APT プリファレンスファイルは、testing ディストリビューションのパッケージのバージョンに高い優先度を割り当て、unstable ディストリビューションのパッケージのバージョンには低い優先度を割り当てます。また他の Debian ディストリビューションのパッケージのバージョンには、低くてインストールできないような優先度を割り当てます。
Package: * Pin: release a=testing Pin-Priority: 900 Package: * Pin: release a=unstable Pin-Priority: 800 Package: * Pin: release o=Debian Pin-Priority: -10
適切な sources.list(5) ファイルと上記のプリファレンスファイルにより、以下のコマンドのいずれかで最新の testing バージョンにアップグレードできます。
apt-get install package-name apt-get upgrade apt-get dist-upgrade
以下のコマンドで、指定したパッケージを unstable ディストリビューションの最新バージョンにアップグレードします。それ以降、apt-get upgrade は testing バージョンのパッケージが更新されていれば testing の最新版に、unstable バージョンのパッケージが更新されていれば unstable の最新版にアップグレードします。
apt-get install package/unstable
以下の APT プリファレンスファイルは、指定したコード名のディストリビューションに属する全てのパッケージのバージョンに、デフォルト (500) より高い優先度を割り当て、他の Debian ディストリビューション、コード名、アーカイブのパッケージのバージョンには、低くてインストールできないような優先度を割り当てます。この APT プリファレンスファイルにより、APT は testing アーカイブから、stable や最新の oldstable へ移行できます。コード名の変更に関係なく testing を追跡したい場合は、上記の設定例を使用するべきです。
Explanation: Uninstall or do not install any Debian-originated package versions Explanation: other than those in the distribution codenamed with bookworm or sid Package: * Pin: release n=bookworm Pin-Priority: 900 Explanation: Debian unstable is always codenamed with sid Package: * Pin: release n=sid Pin-Priority: 800 Package: * Pin: release o=Debian Pin-Priority: -10
適切な sources.list(5) ファイルと上記のプリファレンスファイルにより、以下のコマンドのいずれかで、リリースコード名が bookworm である最新バージョンにアップグレードできます。
apt-get install package-name apt-get upgrade apt-get dist-upgrade
以下のコマンドで、指定したパッケージを sid ディストリビューションの最新バージョンにアップグレードします。それ以降、apt-get upgrade は bookworm バージョンのパッケージが更新されていれば bookworm の最新版に、sid バージョンのパッケージが更新されていれば sidの最新版にアップグレードします。
apt-get install package/sid
/etc/apt/preferences
/etc/apt/preferences.d/
apt-get(8) apt-cache(8) apt.conf(5) sources.list(5)
m[blue]APT バグページm[][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>
この翻訳文書には未訳部分が含まれている可能性があることに 注意してください。 翻訳がオリジナルに追従できていない場合、 内容を失わないようにこのようにしています。
[FAMILY Given]