APTs Standardprioritätszuweisungen¶

Wenn es keine Einstellungsdatei gibt oder es in der Datei keinen Eintrag gibt, der sich auf eine bestimmte Version bezieht, dann ist die dieser Version zugewiesene Priorität, die Priorität der Distribution zu der die Version gehört. Es ist möglich, eine Distribution auszuzeichnen, »das Ziel-Release«, die eine höhere Priorität erhält, als dies bei anderen Distributionen standardmäßig der Fall ist. Das Ziel-Release kann auf der apt-get-Befehlszeile oder in der APT-Konfigurationsdatei /etc/apt/apt.conf gesetzt werden. Beachten Sie, dass dies Vorrang vor einer allgemeinen Priorität hat, die Sie, wie später beschrieben, in der Datei /etc/apt/preferences setzen, aber nicht vor bestimmten mit Pinning festgehaltenen Paketen. Beispielsweise

apt-get install -t testing irgendein_Paket

APT::Default-Release "stable";

Wenn das Ziel-Release angegeben wurde, dann benutzt APT den folgenden Algorithmus, um die Prioritäten der Versionen eines Paketes zu setzen. Zuweisung:

Priorität 1

Priorität 100

Priorität 500

Priorität 990

Wenn das Ziel-Release nicht angegeben wurde, dann weist APT einfach allen installierten Paketversionen eine Priorität von 100 und allen nicht installierten Paketversionen eine Priorität von 500 zu, außer wenn Versionen aus Archiven kommen, die in deren Release-Dateien mit »NotAutomatic: yes« markiert sind – diese Versionen erhalten die Priorität 1 oder die Priorität 100, falls sie zusätzlich als »ButAutomaticUpgrades: yes« markiert sind.

APT wendet dann die folgenden Regeln an, aufgelistet in der Reihenfolge ihres Vorrangs, um zu bestimmen, in welcher Version das Paket zu installieren ist.

In einer typischen Situation ist die Version eines Paketes (Priorität 100) nicht so aktuell, wie eine der verfügbaren Versionen, die in den Quellen in der Datei sources.list(5) aufgeführt sind (Priorität 500 oder 990). Dann wird ein Upgrade des Pakets durchgeführt, wenn apt-get install irgendein_Paket oder apt-get upgrade ausgeführt wird.

Seltener ist die installierte Version eines Pakets neuer als jede andere der verfügbaren Versionen. Für das Paket wird kein Downgrade durchgeführt, wenn apt-get install irgendein_Paket oder apt-get upgrade ausgeführt wird.

Manchmal ist die installierte Version eines Pakets aktueller, als die Version, die zum Ziel-Release gehört, aber nicht so aktuell, wie eine Version, die zu einer anderen Distribution gehört. Für ein derartiges Paket wird tatsächlich ein Upgrade durchgeführt, wenn apt-get install irgendein_Paket oder apt-get upgrade ausgeführt wird, weil mindestens eine der verfügbaren Versionen eine höhere Priorität als die installierte Version hat.

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.

Die Auswirkungen von APT-Einstellungen¶

Die APT-Einstellungsdatei erlaubt dem Systemverwalter die Zuweisung von Prioritäten zu steuern. Die Datei besteht aus einem oder mehreren mehrzeiligen Datensätzen, die durch leere Zeilen getrennt sind. Datensätze können eine von zwei Gestalten haben, eine spezielle Gestalt oder eine allgemeine Gestalt.

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

Package: perl
Pin: source-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

Die Auswirkungen des trennenden Kommas ist einem »und« in der Logik ähnlich: Alle Bedingungen müssen erfüllt werden, dass die Pin passt. Es gibt jedoch eine Ausnahme: Bei jedem Bedingungstyp (wie zwei »a«-Bedingungen) wird nur die letzte Bedingungen geprüft.

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

Die Regel für diese Ausdrücke ist, dass sie überall dort auftreten können, wo eine Zeichenkette auftreten kann. Somit weist die folgende Pin allen Paketen von einem Release seit lunar die Priorität 900 zu.

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

Falls ein regulärer Ausdruck in einem Package-Feld vorkommt, ist das Verhalten dasselbe, als wenn der reguläre Ausdruck durch eine Liste aller Paketnamen ersetzt würde, auf die er passt. Es ist noch nicht entschieden, wie sich dies in Zukunft ändern wird, daher sollten Sie immer zuerst Platzhalter-Pins auflisten, so dass sie später spezielle Pins außer Kraft setzen können. Das Muster »*« in einem »Package«-Feld wird selbst nicht als ein glob(7)-Ausdruck angesehen.

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.11
Pin-Priority: 990

Quellpaket-Pinning kann mit regulären Ausdrücken und Glob-Mustern (expandierbare Platzhalter) kombiniert werden und obendrein eine binäre Architektur annehmen.

Lassen Sie uns zum Beispiel ein Pinning aller Programme für alle Architekturen, die durch ein Quellpaket erzeugt wurden, das »apt« in seinem Namen enthält, auf 990 durchführen:

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.

Wie APT Prioritäten interpretiert¶

Die in der APT-Einstellungsdatei zugewiesenen Prioritäten (P) müssen positive oder negative Ganzzahlen sein. Sie werden wie folgt interpretiert (grob gesagt):

P >= 1000

990 <= P < 1000

500 <= P < 990

100 <= P < 500

0 < P < 100

P < 0

P = 0

Der erste Datensatz mit speziellem Format der zu einer verfügbaren Paketversion passt, legt die Priorität der Paketversion fest. Schlägt dies fehl, wird die Priorität als Maximum aller Prioritäten der Datensätze mit generischem Format definiert, die zu einer verfügbaren Version passen. Datensätze, die so definiert sind, dass sie andere Muster als »*« im Feld Pin verwenden, werden wie Datensätze mit speziellem Format betrachtet.

Nehmen wir zum Beispiel an, die APT-Einstellungsdatei enthält die drei bereits gezeigten Datensätze:

Package: perl
Pin: version 5.32*
Pin-Priority: 1001
Package: *
Pin: origin ""
Pin-Priority: 999
Package: *
Pin: release unstable
Pin-Priority: 50

Dann:

Festlegung von Paketversion und Distributions-Eigenschaften¶

Die in der sources.list(5)-Datei aufgelisteten Orte sollten Packages- und Release-Dateien bereitstellen, um die an diesem Ort verfügbaren Pakete zu beschreiben.

Die Packages-Datei wird normalerweise im Verzeichnis .../dists/Distributions-Name/Bestandteil/Architektur gefunden, zum Beispiel .../dists/stable/main/binary-i386/Packages. Sie besteht aus einer Serie mehrzeiliger Datensätze, einem für jedes verfügbare Paket in diesem Verzeichnis. In jedem Datensatz sind nur zwei Zeilen zum Setzen der APT-Prioritäten relevant:

die Package:-Zeile

die Version:-Zeile

Die Release-Datei ist normalerweise im Verzeichnis .../dists/Distributionsname zu finden, zum Beispiel .../dists/stable/Release oder .../dists/bookworm/Release. Sie besteht aus einem einzelnen mehrzeiligen Datensatz, der auf alle Pakete im Verzeichnisbaum unterhalb des übergeordneten Verzeichnisses zutrifft. Anders als die Packages-Datei sind nahezu alle Zeilen in einer Release-Datei für das Setzen von APT-Prioritäten relevant:

die Archive:- oder Suite:-Zeile

Pin: release a=stable

die Codename:-Zeile

Pin: release n=trixie

die Version:-Zeile

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

die Component:-Zeile

Pin: release c=main

die Origin:-Zeile

Pin: release o=Debian

die Label:-Zeile

Pin: release l=Debian

Alle Packages- und Release-Dateien, die von Orten heruntergeladen werden, die in der Datei sources.list(5) aufgelistet sind, werden im Verzeichnis /var/lib/apt/lists oder in der von der Variablen Dir::State::Lists in der Datei apt.conf benannten Datei gespeichert. Die Datei debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release enthält zum Beispiel die Release-Datei, die von der Site debian.lcs.mit.edu für die binary-i386-Architekturdateien von der contrib-Bestandteil der unstable-Distribution heruntergeladen wurde.

Optionale Zeilen in einem APT-Einstellungsdatensatz¶

Optional kann jeder Datensatz in der APT-Einstellungsdatei mit einer oder mehreren Zeilen beginnen, die mit dem Wort Explanation: anfangen. Dieses stellt einen Platz für Kommentare bereit.

Stable verfolgen¶

Die folgende APT-Einstellungsdatei wird APT veranlassen, allen Paketversionen eine höhere Priorität als die Vorgabe (500) zu geben, die zu einer stable-Distribution gehören und eine ungeheuer niedrige Priorität zu Paketversionen, die zu anderen Debian-Distributionen gehören.

Explanation: Deinstallieren oder nicht installieren von anderen von Debian
Explanation: stammenden Paketversionen als denen der Stable-Distribution
Package: *
Pin: release a=stable
Pin-Priority: 900
Package: *
Pin: release o=Debian
Pin-Priority: -10

Mit einer geeigneten sources.list(5)-Datei und der obigen Einstellungsdatei wird jeder der folgenden Befehle APT veranlassen, ein Upgrade auf die neuste(n) stable-Version(en) durchzuführen.

apt-get install Paketname
apt-get upgrade
apt-get dist-upgrade

Der folgende Befehl wird APT veranlassen, ein Upgrade des angegebenen Pakets auf die neuste Version der testing-Distribution durchzuführen. Von dem Paket wird kein weiteres Upgrade durchgeführt, außer wenn dieser Befehl wieder angegeben wird.

apt-get install Paket/testing

Testing oder Unstable verfolgen¶

Die folgende APT-Einstellungsdatei wird APT veranlassen, Paketversionen der testing-Distribution eine hohe Priorität, Paketversionen der unstable-Distribution eine niedrigere Priorität und eine ungeheuer niedrige Priorität zu Paketversionen von anderen Debian-Distributionen zuzuweisen.

Package: *
Pin: release a=testing
Pin-Priority: 900
Package: *
Pin: release a=unstable
Pin-Priority: 800
Package: *
Pin: release o=Debian
Pin-Priority: -10

Mit einer geeigneten sources.list(5)-Datei und der obigen Einstellungsdatei wird jeder der folgenden Befehle APT veranlassen, ein Upgrade auf die neuste(n) testing-Version(en) durchzuführen.

apt-get install Paketname
apt-get upgrade
apt-get dist-upgrade

Der folgende Befehl wird APT veranlassen, ein Upgrade des angegebenen Pakets auf die neuste Version der unstable-Distribution durchzuführen. Danach wird apt-get upgrade ein Upgrade des Pakets auf die aktuellste testing-Version durchführen, falls diese aktueller als die installierte Version ist, andernfalls auf die aktuellste unstable-Version, wenn diese aktueller als die installierte Version ist.

apt-get install Paket/unstable

Die Entwicklung eines Codename-Releases verfolgen¶

Die folgende APT-Einstellungsdatei wird APT veranlassen, allen Paketen, die zu einem bestimmten Codenamen einer Distribution gehören, eine höhere Priorität als die Vorgabe (500) zu geben und Paketversionen, die zu anderen Debian-Distributionen, Codenamen und Archiven gehören, eine ungeheuer niedrige Priorität zu geben. Beachten Sie, dass APT mit diesen APT-Einstellungen der Migration eines Releases vom Archiv testing zu stable und später zu oldstable folgen wird. Wenn Sie zum Beispiel dem Fortschritt in testing folgen möchten, obwohl der Codename sich ändert, sollten Sie die Beispielkonfigurationen oberhalb benutzen.

Explanation: Deinstallieren oder nicht installieren von anderen von Debian
Explanation: stammenden Paketversionen als denen der trixie-
Explanation: oder Sid-Distribution
Package: *
Pin: release n=trixie
Pin-Priority: 900
Explanation: Debian-Unstable hat immer den Codenamen sid
Package: *
Pin: release a=sid
Pin-Priority: 800
Package: *
Pin: release o=Debian
Pin-Priority: -10

Mit einer geeigneten sources.list(5)-Datei und der obigen Einstellungsdatei wird jeder der folgenden Befehle APT veranlassen, ein Upgrade auf die letzte(n) Version(en) im Release mit Codenamen trixie durchzuführen.

apt-get install Paketname
apt-get upgrade
apt-get dist-upgrade

Der folgende Befehl wird APT veranlassen, ein Upgrade des angegebenen Pakets auf die neuste Version der sid-Distribution durchzuführen. Danach wird apt-get upgrade ein Upgrade des Pakets auf die aktuellste trixie-Version durchführen, wenn diese aktueller als die installierte Version ist, andernfalls auf die aktuellste sid-Version, wenn diese aktueller als die installierte Version ist.

apt-get install Paket/sid