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 を実行すると、パッケージは更新されます。この場合、インストールされているバージョンよりも、少なくともひとつは、高い優先度を持つ有効なパッケージがあるからです。

Phased Updates¶

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 プリファレンスファイルの効果¶

APT プリファレンスファイルを使うと、システム管理者が優先度を割り当てられるようになります。ファイルは、空白行で区切られた、複数行からなるレコードで構成されています。レコードは特定形式か、汎用形式のどちらかの形式をとります。

Package: perl
Pin: version 5.32*
Pin-Priority: 1001

Package: *
Pin: origin ""
Pin-Priority: 999

Package: *
Pin: origin "ftp.de.debian.org"
Pin-Priority: 999

Package: *
Pin: release a=unstable
Pin-Priority: 50

Package: *
Pin: release n=trixie
Pin-Priority: 900

Package: *
Pin: release a=stable, v=12
Pin-Priority: 500

コンマ演算子の効果は "and" 論理に似ています: ピンが一致するようにすべての条件がピンが一致しなければなりません。一つの例外があります: 条件のいずれかの型では (例えば、二つの "a" 条件)、ただ最後の条件のみがチェックされます。

Matching packages in the Package field¶

The Package field specifies the package that a pinning priority is applied to. The field can either contain a binary package name, a source package name (prefixed with "src:"), a glob(7) expression or a regular expression (surrounded by slashes). Multiple package names, glob(7) expressions and regular expressions can be listed separated by whitespace in which case the record will match any of the matched packages.

By default, only packages of the native architecture are matched. To match binary packages of any architecture, add the :any suffix to the package name. You can also limit matching to a specific architecture by appending the architecture name to the package name, separated by a colon character.

For example, the following example uses a glob expression and a regular expression to assign the priority 500 to all packages from experimental where the name starts with gnome (as a glob(7)-like expression) or contains the word kde (as a POSIX extended regular expression surrounded by slashes).

Package: gnome* /kde/
Pin: release a=experimental
Pin-Priority: 500

この表現の規則は、文字が現れうる場所なら、どこでも発生しうるという事です。したがって、以下の pin は、lunar で始まるリリース由来の、すべてのパッケージに、優先度 990 を割り当てます。

Package: *
Pin: release n=lunar*
Pin-Priority: 990

Package フィールドも正規表現が現れる場合、正規表現を、マッチするすべてのパッケージ名のリストに置き換えたものとして、動作します。これは将来変更されるかどうか、まだ決定していません。そのため、まずはじめにワイルドカード pin を、常に記述するようにしてください。その後に続く pin で上書きされます。Package フィールドの "*" パターンは、glob(7) 表現自体とは見なされません。

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.9.8
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

The :any suffix makes sure to select binary packages from any architecture. Without that suffix, apt implicitly assumes the :native suffix which would only select packages from the native architecture.

APT が優先度に割り込む方法¶

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.32*
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/bookworm/Release です。これは、このディレクトリ以下にある全パッケージに適用する、複数行のレコード 1 つから成っています。Packages ファイルと違い Release ファイルは、以下のようにほとんどの行が APT 優先度の設定に関連します。

Archive: 行や Suite: 行

Pin: release a=stable

Codename: 行

Pin: release n=trixie

Version: 行

Pin: release v=12
Pin: release a=stable, v=12
Pin: release 12

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 プリファレンスレコードのオプション行¶

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 trixie or sid
Package: *
Pin: release n=trixie
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) ファイルと上記のプリファレンスファイルにより、以下のコマンドのいずれかで、リリースコード名が trixie である最新バージョンにアップグレードできます。

apt-get install package-name
apt-get upgrade
apt-get dist-upgrade

以下のコマンドで、指定したパッケージを sid ディストリビューションの最新バージョンにアップグレードします。それ以降、apt-get upgrade は trixie バージョンのパッケージが更新されていれば trixie の最新版に、sid バージョンのパッケージが更新されていれば sidの最新版にアップグレードします。

apt-get install package/sid