'\" t
.\"     Title: apt_preferences
.\"    Author: \('Equipe de d\('eveloppement d\*(AqAPT
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03\ \&janvier\ \&2022
.\"    Manual: APT
.\"    Source: APT 2.9.1
.\"  Language: French
.\"
.TH "APT_PREFERENCES" "5" "03\ \&janvier\ \&2022" "APT 2.9.1" "APT"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NOM"
apt_preferences \- Fichier de contr\(^ole des pr\('ef\('erences pour APT
.SH "DESCRIPTION"
.PP
Le fichier d\*(AqAPT,
/etc/apt/preferences
et les fichiers fragments situ\('es dans le dossier
/etc/apt/preferences\&.d/, peuvent \(^etre utilis\('es pour choisir la version des paquets que l\*(Aqon veut installer\&.
.PP
Quand le fichier
\fBsources.list\fR(5)
contient des r\('ef\('erences \(`a plusieurs distributions (par exemple,
stable
et
testing), plusieurs versions d\*(Aqun paquet peuvent \(^etre install\('ees\&. APT affecte une priorit\('e \(`a chaque version disponible\&. La commande
\fBapt\-get\fR, tenant compte des contraintes de d\('ependance, installe la version qui poss\(`ede la priorit\('e la plus haute\&. Le fichier
preferences
annule les priorit\('es assign\('ees par d\('efaut aux versions des paquets\ \&: ainsi l\*(Aqutilisateur peut choisir la version qu\*(Aqil veut installer\&.
.PP
Si le fichier
\fBsources.list\fR(5)
contient, pour une m\(^eme distribution, des r\('ef\('erences \(`a plusieurs sites de t\('el\('echargement, il peut exister plusieurs exemplaires de la m\(^eme version d\*(Aqun paquet\&. Dans ce cas,
\fBapt\-get\fR
t\('el\('echarge l\*(Aqexemplaire qui appara\(^it en premier dans le fichier
\fBsources.list\fR(5)\&. Le fichier
preferences
n\*(Aqinflue pas sur le choix des exemplaires, seulement sur le choix de la version\&.
.PP
Les pr\('ef\('erences sont un outil puissant pour les administrateurs syst\(`eme mais peuvent devenir leur pire cauchemar si elles sont utilis\('ees sans pr\('ecautions\&. APT ne remettra pas en doute les r\('eglages choisis\&. Des valeurs erron\('ees pourront alors conduire \(`a des paquets non installables ou \(`a des d\('ecisions incorrectes lors de la mise \(`a jour des paquets\&. Des probl\(`emes suppl\('ementaires peuvent survenir si des distributions multiples sont m\('elang\('ees sans une bonne compr\('ehension des paragraphes qui suivent\&.
.PP
Veuillez noter que les fichiers du r\('epertoire
/etc/apt/preferences\&.d
sont analys\('es par ordre alphanum\('erique ascendant, doivent avoir l\*(Aqextension "pref" ou aucune extension et ne peuvent contenir que des caract\(`eres alphanum\('eriques, des tirets (\-), des caract\(`eres de soulignement (_) et des points (\&.)\&. Dans le cas contraire, APT affichera un avertissement indiquant qu\*(Aqil a ignor\('e un fichier si celui\-ci ne correspond par \(`a un motif d\('efini dans
Dir::Ignore\-Files\-Silently
(les fichiers correspondant \(`a cette variable de configuration \('etant, eux, ignor\('es silencieusemennt)\&.
.SS "Priorit\('es affect\('ees par d\('efaut"
.PP
Quand le fichier des pr\('ef\('erences n\*(Aqexiste pas, ou quand aucune entr\('ee de ce fichier ne s\*(Aqapplique \(`a une version pr\('ecise, la priorit\('e affect\('ee \(`a cette version est la priorit\('e de la distribution \(`a laquelle elle appartient\&. On peut distinguer une distribution et lui donner une priorit\('e plus haute que celle des autres distributions\ \&: on l\*(Aqappelle la distribution par d\('efaut ou \(Fo\ \&target release\ \&\(Fc et elle peut \(^etre d\('efinie sur la ligne de commande de
\fBapt\-get\fR
ou dans le fichier de configuration d\*(AqAPT,
/etc/apt/apt\&.conf\&. Par exemple\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
\fBapt\-get install \-t testing \fR\fB\fIpaquet\fR\fR
.fi
.if n \{\
.RE
.\}
.sp

.sp
.if n \{\
.RS 4
.\}
.nf
APT::Default\-Release "stable";
.fi
.if n \{\
.RE
.\}
.PP
Quand une distribution par d\('efaut a \('et\('e indiqu\('ee, APT utilise l\*(Aqalgorithme suivant pour d\('eterminer la priorit\('e des versions d\*(Aqun paquet\ \&:
.PP
priorit\('e 1
.RS 4
to the versions coming from archives which in their
Release
files are marked as "NotAutomatic: yes" but
\fInot\fR
as "ButAutomaticUpgrades: yes" like the Debian
experimental
archive, as well as versions that are not phased on this systems\&.
.RE
.PP
une priorit\('e \('egale \(`a 100
.RS 4
pour les versions issues d\*(Aqarchives dont le fichier
Release
comporte la mention \(Fo\ \&NotAutomatic: yes\ \&\(Fc et \(Fo\ \&ButAutomaticUpgrades: yes\ \&\(Fc comme l\*(Aqarchive des r\('etroportages de Debian depuis
squeeze\-backports\&.
.RE
.PP
une priorit\('e \('egale \(`a\ \&500
.RS 4
est affect\('ee aux versions qui n\*(Aqappartiennent pas \(`a la distribution par d\('efaut\&.
.RE
.PP
une priorit\('e \('egale \(`a\ \&990
.RS 4
est affect\('ee aux versions qui appartiennent \(`a la distribution par d\('efaut\&.
.RE
La priorit\('e la plus \('elev\('ee dont la description correspond \(`a la version est affect\('ee \(`a la version\&.
.PP
Quand aucune distribution par d\('efaut n\*(Aqa \('et\('e indiqu\('ee, APT affecte simplement une priorit\('e \('egale \(`a\ \&100 \(`a toute version install\('ee d\*(Aqun paquet et une priorit\('e \('egale \(`a\ \&500 \(`a tout version non install\('ee\&. Cela \(`a l\*(Aqexception des versions issues des archives qui ont la mention \(Fo\ \&NotAutomatic: yes\ \&\(Fc dans leur fichier
Release, qui auront alors une priorit\('e \('egale \(`a\ \&1 ou \(`a\ \&100 si elles sont \('egalement marqu\('ees avec \(Fo\ \&ButAutomaticUpgrades: yes\ \&\(Fc\&.
.PP
Puis APT applique les r\(`egles suivantes pour d\('eterminer la version du paquet qu\*(Aqil faut installer (par ordre de priorit\('e)\ \&:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Ne jamais revenir en arri\(`ere, sauf si la priorit\('e d\*(Aqune version disponible d\('epasse\ \&1000\&. \(Fo\ \&Revenir en arri\(`ere\ \&\(Fc signifie installer une version moins r\('ecente que la version install\('ee\&. Il faut noter qu\*(Aqaucune des priorit\('es par d\('efaut n\*(Aqexc\(`ede\ \&1000\ \&; de telles valeurs ne peuvent \(^etre d\('efinies que dans le fichier des pr\('ef\('erences\&. Notez aussi qu\*(Aqil est risqu\('e de revenir en arri\(`ere\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Installer la version qui poss\(`ede la priorit\('e la plus haute\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Quand deux (ou plus) versions ont la m\(^eme priorit\('e, installer la version la plus r\('ecente (c\&.\-\(`a\-d\&. celle dont le num\('ero de version est le plus grand)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Quand deux (ou plus) versions ont la m\(^eme priorit\('e et le m\(^eme num\('ero de version, mais soit les paquets diff\(`erent par certaines m\('etadonn\('ees, soit l\*(Aqoption
\-\-reinstall
a \('et\('e donn\('ee, installer la version qui n\*(Aqest pas install\('ee\&.
.RE
.PP
En g\('en\('eral, la version install\('ee d\*(Aqun paquet (priorit\('e\ \&100) n\*(Aqest pas aussi r\('ecente que les versions disponibles dans les sources list\('ees dans le fichier
\fBsources.list\fR(5)
(priorit\('e\ \&500 ou\ \&990)\&. Et donc le paquet sera mis \(`a niveau avec la commande\ \&:
\fBapt\-get install \fR\fB\fIpaquet\fR\fR
ou
\fBapt\-get dist\-upgrade\fR\&.
.PP
La version install\('ee d\*(Aqun paquet peut \(^etre \- rarement \-
\fIplus\fR
r\('ecente que tout autre version disponible\&. Les commandes
\fBapt\-get install \fR\fB\fIpaquet\fR\fR
ou
\fBapt\-get upgrade\fR
ne provoquent pas de retour en arri\(`ere\&.
.PP
Parfois, la version install\('ee d\*(Aqun paquet est plus r\('ecente que la version appartenant \(`a la distribution par d\('efaut, mais moins r\('ecente que la version appartenant \(`a une autre distribution\&. Une telle version sera mise \(`a niveau par les commandes
\fBapt\-get install \fR\fB\fIpaquet\fR\fR
ou
\fBapt\-get upgrade\fR
car au moins
\fIl\*(Aqune\fR
des versions disponibles poss\(`ede une plus haute priorit\('e que celle de la version install\('ee\&.
.SS "Phased Updates"
.PP
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\&.
.PP
A system\*(Aqs 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\&.
.PP
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\&.
.SS "Cons\('equences des pr\('ef\('erences"
.PP
Le fichier des pr\('ef\('erences permet \(`a l\*(Aqadministrateur syst\(`eme de contr\(^oler l\*(Aqaffectation des priorit\('es\&. Ce fichier est constitu\('e d\*(Aqune ou plusieurs entr\('ees s\('epar\('ees par des lignes blanches\&. Ces entr\('ees peuvent avoir deux formes, une forme particuli\(`ere et une forme g\('en\('erale\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
La forme particuli\(`ere affecte une priorit\('e (\fIPin\-Priority\fR) \(`a un paquet pr\('ecis, \(`a une version pr\('ecise ou \(`a un intervalle sp\('ecifiant plusieurs versions\&. Par exemple, l\*(Aqentr\('ee suivante affecte une priorit\('e haute \(`a toutes les versions du paquet
perl
dont le num\('ero de version commence par
5\&.32\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Package: perl
Pin: version 5\&.32*
Pin\-Priority: 1001
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
La forme g\('en\('erale affecte une priorit\('e \(`a toutes les versions d\*(Aqun paquet dans une distribution donn\('ee (c\*(Aqest\-\(`a\-dire, \(`a toutes les versions d\*(Aqun paquet qui sont list\('ees dans un fichier
Release), ou \(`a toutes les versions d\*(Aqun paquet provenant d\*(Aqun site Internet identifi\('e par un nom compl\(`etement qualifi\('e\&.
.sp
Cette forme g\('en\('erale des entr\('ees du fichier des pr\('ef\('erences s\*(Aqapplique seulement aux groupes de paquets\&. Par exemple, l\*(Aqentr\('ee suivante affecte une priorit\('e haute \(`a toutes les versions disponibles dans le site local\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Package: *
Pin: origin ""
Pin\-Priority: 999
.fi
.if n \{\
.RE
.\}
.sp
Il est important de noter que le mot\-cl\('e utilis\('e ici est \(Fo\ \&origin\ \&\(Fc qui peut servir \(`a indiquer un nom d\*(Aqh\(^ote\&. Dans l\*(Aqexemple qui suit, une haute priorit\('e est donn\('ee \(`a toutes les versions disponibles sur le serveur identifi\('e par le nom d\*(Aqh\(^ote \(Fo\ \&ftp\&.de\&.debian\&.org\ \&\(Fc\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Package: *
Pin: origin "ftp\&.de\&.debian\&.org"
Pin\-Priority: 999
.fi
.if n \{\
.RE
.\}
.sp
Veuillez noter que le mot\-cl\('e utilis\('e ici,
origin, ne doit pas \(^etre confondu avec l\*(AqOrigine d\*(Aqune distribution indiqu\('ee dans un fichier
Release\&. Ce qui suit l\*(Aq\('etiquette \(Fo\ \&Origin:\ \&\(Fc dans un fichier
Release
n\*(Aqest pas une adresse Internet mais le nom d\*(Aqun auteur ou d\*(Aqun distributeur, comme \(Fo\ \&Debian\ \&\(Fc ou \(Fo\ \&Ximian\ \&\(Fc\&.
.sp
L\*(Aqentr\('ee suivante affecte une priorit\('e basse \(`a toutes les versions d\*(Aqun paquet appartenant \(`a toute distribution dont le nom d\*(Aq\(Fo\ \&Archive\ \&\(Fc est
unstable\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Package: *
Pin: release a=unstable
Pin\-Priority: 50
.fi
.if n \{\
.RE
.\}
.sp
L\*(Aqentr\('ee suivante affecte une priorit\('e haute \(`a toutes les versions d\*(Aqun paquet appartenant \(`a toute distribution dont le nom de code est
trixie\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Package: *
Pin: release n=trixie
Pin\-Priority: 900
.fi
.if n \{\
.RE
.\}
.sp
L\*(Aqentr\('ee suivante affecte une priorit\('e haute \(`a toutes les versions d\*(Aqun paquet appartenant \(`a toute distribution dont le nom d\*(Aq\(Fo\ \&Archive\ \&\(Fc est
stable
et dont le num\('ero de \(Fo\ \&Version\ \&\(Fc est
12\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Package: *
Pin: release a=stable, v=12
Pin\-Priority: 500
.fi
.if n \{\
.RE
.\}
.RE
.sp
L\*(Aqeffet de l\*(Aqop\('erateur virgule est identique \(`a un \(Fo\ \&and\ \&\(Fc logique\ \&: toutes les conditions doivent \(^etre satisfaites pour que l\*(Aq\('epinglage corresponde\&. Il existe une exception\ \&: pour chaque type de condition (telles que deux conditions \(Fo\ \&a\ \&\(Fc), seule la derni\(`ere condition est v\('erifi\('ee\&.
.SS "Matching packages in the Package field"
.PP
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
\fBglob\fR(7)
expression or a regular expression (surrounded by slashes)\&. Multiple package names,
\fBglob\fR(7)
expressions and regular expressions can be listed separated by whitespace in which case the record will match any of the matched packages\&.
.PP
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\&.
.PP
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
\fBglob\fR(7)\-like expression) or contains the word kde (as a POSIX extended regular expression surrounded by slashes)\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Package: gnome* /kde/
Pin: release a=experimental
Pin\-Priority: 500
.fi
.if n \{\
.RE
.\}
.PP
La r\(`egle pour ces expressions est qu\*(Aqelles peuvent prendre place d\(`es que la cha\(^ine correspondante est trouv\('ee\&. Ainsi, l\*(Aq\('epinglage qui suit affecte une priorit\('e de 990 \(`a tous les paquets d\*(Aqune version de distribution commen\(,cant par lunar\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Package: *
Pin: release n=lunar*
Pin\-Priority: 990
.fi
.if n \{\
.RE
.\}
.PP
Si une expression r\('eguli\(`ere est rencontr\('ee dans un champ
Package, le comportement sera celui qui aurait eu lieu si cette expression \('etait remplac\('ee par la liste de tous les paquets auxquels elle correspond\&. Il n\*(Aqest pas encore d\('ecid\('e si cela sera conserv\('e dans le futur\ \&:\ \&il est donc conseill\('e d\*(Aqutiliser des \('epinglages avec caract\(`eres g\('en\('eriques en premier afin qu\*(Aqils soient remplac\('es par des \('epinglages plus sp\('ecifiques\&. Le motif \(Fo\ \&*\ \&\(Fc dans un champ Package n\*(Aqest pas consid\('er\('e comme une expression
\fBglob\fR(7)
en soi\&.
.PP
To pin all binaries produced by the apt source package of this APT\*(Aqs version to 990, you can do:
.sp
.if n \{\
.RS 4
.\}
.nf
Package: src:apt
Pin: version 2\&.9\&.1
Pin\-Priority: 990
.fi
.if n \{\
.RE
.\}
.PP
Source package pinning can be combined with regular expressions and glob patterns, and can also take a binary architecture\&.
.PP
For example, let\*(Aqs pin all binaries for all architectures produced by any source package containing apt in its name to 990:
.sp
.if n \{\
.RS 4
.\}
.nf
Package: src:*apt*:any
Pin: version *
Pin\-Priority: 990
.fi
.if n \{\
.RE
.\}
.PP
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\&.
.SS "M\('ethode d\*(Aqinterpr\('etation des priorit\('es par APT"
.PP
Les priorit\('es (P) indiqu\('ees dans le fichier des pr\('ef\('erences doivent \(^etre des entiers positifs ou n\('egatifs\&. Ils sont interpr\('et\('es \(`a peu pr\(`es comme suit\ \&:
.PP
P >= 1000
.RS 4
cette priorit\('e entra\(^ine l\*(Aqinstallation du paquet m\(^eme s\*(Aqil s\*(Aqagit d\*(Aqun retour en arri\(`ere\&.
.RE
.PP
990 <= P < 1000
.RS 4
la version sera install\('ee, m\(^eme si elle n\*(Aqappartient pas \(`a la distribution par d\('efaut\ \&; mais elle ne sera pas install\('ee si la version install\('ee est plus r\('ecente\&.
.RE
.PP
500 <= P < 990
.RS 4
La version sera install\('ee, sauf s\*(Aqil existe une version appartenant \(`a la distribution par d\('efaut ou si la version install\('ee est plus r\('ecente\&.
.RE
.PP
100 <= P < 500
.RS 4
la version sera install\('ee, sauf s\*(Aqil existe une version appartenant \(`a une autre distribution ou si la version install\('ee est plus r\('ecente\&.
.RE
.PP
0 < P < 100
.RS 4
la version sera install\('ee si aucune version du paquet n\*(Aqest install\('ee\&.
.RE
.PP
P < 0
.RS 4
cette priorit\('e emp\(^eche l\*(Aqinstallation de la version\&.
.RE
.PP
P = 0
.RS 4
a un comportement ind\('efini, ne pas l\*(Aqutiliser\&.
.RE
.PP
La premi\(`ere entr\('ee de forme particuli\(`ere correspondant \(`a une version disponible de paquet d\('etermine la priorit\('e de la version du paquet\&. S\*(Aqil n\*(Aqen existe pas, la priorit\('e du paquet est d\('efinie comme la plus haute de toutes les priorit\('es par les entr\('ees de forme g\('en\('erale correspondant \(`a la version\&. Les entr\('ees d\('efinies en utilisant des motifs dans le champ Pin autre que \(Fo\ \&*\ \&\(Fc sont trait\('ees comme des entr\('ees de forme g\('en\('erale\&.
.PP
Supposons par exemple que le fichier des pr\('ef\('erences contienne les trois entr\('ees d\('ecrites ci\-dessous\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
Package: perl
Pin: version 5\&.32*
Pin\-Priority: 1001

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

Package: *
Pin: release unstable
Pin\-Priority: 50
.fi
.if n \{\
.RE
.\}
.PP
Alors\ \&:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
La version la plus r\('ecente du paquet
perl
sera install\('e pour autant que son num\('ero de version commence par
5\&.32\&. Si l\*(Aq\fIune\fR
des versions 5\&.32* existe et si la version install\('ee est une version 5\&.36*, il y aura un retour en arri\(`ere\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Les versions des paquets (autres que
perl) disponibles dans le site local ont priorit\('e sur les autres versions, m\(^eme celles appartenant \(`a la distribution par d\('efaut\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
La version d\*(Aqun paquet dont l\*(Aqorigine n\*(Aqest pas le site local mais un site Internet mentionn\('e dans
\fBsources.list\fR(5)
et qui appartient \(`a une distribution
unstable, ne sera install\('ee que si aucune version du paquet n\*(Aqest d\('ej\(`a install\('ee\&.
.RE
.sp
.SS "D\('etermination de la version des paquets et des propri\('et\('es des distributions"
.PP
Chaque source indiqu\('ee dans le fichier
\fBsources.list\fR(5)
doit fournir les fichiers
Packages
et
Release
qui d\('ecrivent les paquets disponibles \(`a cet endroit\&.
.PP
Le fichier
Packages
se trouve normalement dans le r\('epertoire
\&.\&.\&./dists/\fIdist\-name\fR/\fIcomponent\fR/\fIarch\fR, par exemple,
\&.\&.\&./dists/stable/main/binary\-i386/Packages\&. Il consiste en entr\('ees compos\('ees de lignes, une pour chaque paquet disponible dans le r\('epertoire\&. Seules deux lignes des entr\('ees sont pertinentes pour la d\('etermination des priorit\('es\ \&:
.PP
la ligne Package:
.RS 4
donne le nom du paquet
.RE
.PP
la ligne Version:
.RS 4
donne le num\('ero de version du paquet
.RE
.PP
Le fichier
Release
se trouve normalement dans le r\('epertoire
\&.\&.\&./dists/\fInom\-distribution\fR, par exemple,
\&.\&.\&./dists/stable/Release, ou
\&.\&.\&./dists/bookworm/Release\&. Il consiste en une seule entr\('ee compos\('ee de plusieurs lignes qui s\*(Aqapplique \(`a
\fItous\fR
les paquets situ\('es dans les r\('epertoires sous le r\('epertoire parent\&. Contrairement au fichier
Packages, presque toutes les lignes du fichier
Release
sont pertinentes pour d\('eterminer les priorit\('es\ \&:
.PP
La ligne Archive: ou Suite:
.RS 4
nomme l\*(Aqarchive \(`a laquelle appartiennent tous les paquets situ\('es dans les r\('epertoires\&. Par exemple, la ligne
Archive: stable
indique que tous les paquets dans les r\('epertoires situ\('es sous le r\('epertoire parent du fichier
Release
appartiennent \(`a l\*(Aqarchive
stable\&. Indiquer cette valeur dans le fichier des pr\('ef\('erences demanderait cette ligne\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
Pin: release a=stable
.fi
.if n \{\
.RE
.\}
.RE
.PP
la ligne Codename:
.RS 4
indique le nom de code auquel appartiennent tous les paquets situ\('es dans les r\('epertoires\&. Par exemple, la ligne
Codename: trixie
indique que tous les paquets dans les r\('epertoires situ\('es sous le r\('epertoire parent du fichier
Release
appartiennent \(`a la version portant le nom de code
trixie\&. Indiquer cette valeur dans le fichier des pr\('ef\('erences demanderait cette ligne\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
Pin: release n=trixie
.fi
.if n \{\
.RE
.\}
.RE
.PP
la ligne Version:
.RS 4
indique la version de la distribution\&. Par exemple, les paquets dans les r\('epertoires peuvent appartenir \(`a la distribution Debian version 12\&. Il n\*(Aqy a pas de num\('ero de version pour les distributions
testing
et
unstable
car elles n\*(Aqont pas encore \('et\('e publi\('ees\&. Indiquer cette valeur dans le fichier des pr\('ef\('erences demanderait ces lignes\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
Pin: release v=12
Pin: release a=stable, v=12
Pin: release 12
.fi
.if n \{\
.RE
.\}
.RE
.PP
La ligne Component:
.RS 4
nomme un composant qui indique le type de licence associ\('ee aux paquets situ\('es dans les r\('epertoires sous le fichier
Release\&. Par exemple, la ligne
Component: main
indique que tous les exemplaires dans les r\('epertoires appartiennent au composant
main, c\*(Aqest\-\(`a\-dire que leur licence est en accord avec les Directives Debian pour le logiciel libre\&. Indiquer ce composant dans le fichier des pr\('ef\('erences demanderait cette ligne\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
Pin: release c=main
.fi
.if n \{\
.RE
.\}
.RE
.PP
La ligne Origin:
.RS 4
nomme l\*(Aqorigine des paquets situ\('es dans les r\('epertoires sous le fichier
Release\&. En g\('en\('eral, c\*(Aqest
Debian\&. Indiquer cette origine dans le fichier des pr\('ef\('erences demanderait cette ligne\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
Pin: release o=Debian
.fi
.if n \{\
.RE
.\}
.RE
.PP
La ligne Label:
.RS 4
indique une \('etiquette pour les paquets qui se trouvent dans les r\('epertoires sous le fichier
Release\&. En g\('en\('eral, c\*(Aqest
Debian\&. Indiquer cette origine dans le fichier des pr\('ef\('erences demanderait cette ligne\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
Pin: release l=Debian
.fi
.if n \{\
.RE
.\}
.RE
.PP
Tous les fichiers
Packages
et
Release
r\('ecup\('er\('es dans des sources indiqu\('ees dans le fichier
\fBsources.list\fR(5)
sont conserv\('es dans le r\('epertoire
/var/lib/apt/lists
ou dans le fichier sp\('ecifi\('e par la variable
Dir::State::Lists
dans le fichier
apt\&.conf\&. Par exemple, le fichier
debian\&.lcs\&.mit\&.edu_debian_dists_unstable_contrib_binary\-i386_Release
contient le fichier
Release
du site
debian\&.lcs\&.mit\&.edu, architecture
binary\-i386
et composant
contrib
de la distribution
unstable\&.
.SS "Lignes facultatives dans le fichier des pr\('ef\('erences"
.PP
Toute entr\('ee du fichier des pr\('ef\('erences peut commencer par une ou plusieurs lignes contenant le mot
Explanation:\&. Cela permet des commentaires\&.
.SH "EXEMPLES"
.SS "M\('ethode pour suivre Stable"
.PP
Le fichier des pr\('ef\('erences suivant affecte une priorit\('e plus haute que la priorit\('e par d\('efaut (500) \(`a tous les exemplaires appartenant \(`a la distribution
stable
et une priorit\('e prohibitivement basse \(`a tous les exemplaires appartenant \(`a d\*(Aqautres distributions
Debian\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Explanation: Ne pas installer des exemplaires d\*(Aqorigine Debian
Explanation: sauf ceux de la distribution stable
Package: *
Pin: release a=stable
Pin\-Priority: 900

Package: *
Pin: release o=Debian
Pin\-Priority: \-10
.fi
.if n \{\
.RE
.\}
.PP
Avec le fichier des pr\('ef\('erences ci\-dessus et un fichier
\fBsources.list\fR(5)
ad\('equat, les commandes suivantes utiliseront les versions les plus r\('ecentes de
stable
pour faire la mise \(`a niveau\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
apt\-get install \fIpaquet\fR
apt\-get upgrade
apt\-get dist\-upgrade
.fi
.if n \{\
.RE
.\}
.PP
La commande suivante utilisera la version la plus r\('ecente de la distribution
testing
pour mettre \(`a niveau le paquet sp\('ecifi\('e\ \&; cependant les mises \(`a niveau ult\('erieures du paquet ne se feront pas \(`a moins de relancer la commande\&.
.sp
.if n \{\
.RS 4
.\}
.nf
apt\-get install \fIpaquet\fR/testing
.fi
.if n \{\
.RE
.\}
.sp
.SS "M\('ethode pour suivre Testing ou Unstable"
.PP
Le fichier des pr\('ef\('erences suivant affecte une priorit\('e haute aux versions des paquets appartenant \(`a la distribution
testing, une priorit\('e moindre aux versions appartenant \(`a la distribution
unstable
et une priorit\('e prohibitivement basse aux versions appartenant \(`a d\*(Aqautres distributions
Debian\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Package: *
Pin: release a=testing
Pin\-Priority: 900

Package: *
Pin: release a=unstable
Pin\-Priority: 800

Package: *
Pin: release o=Debian
Pin\-Priority: \-10
.fi
.if n \{\
.RE
.\}
.PP
Avec un fichier
\fBsources.list\fR(5)
appropri\('e et le fichier des pr\('ef\('erences ci\-dessus, les commandes suivantes utiliseront les versions les plus r\('ecentes de
testing
pour faire la mise \(`a niveau\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
apt\-get install \fIpaquet\fR
apt\-get upgrade
apt\-get dist\-upgrade
.fi
.if n \{\
.RE
.\}
.PP
La commande suivante utilisera la version la plus r\('ecente de la distribution
unstable
pour mettre \(`a niveau le paquet sp\('ecifi\('e\ \&; Par la suite,
\fBapt\-get upgrade\fR
mettra le paquet \(`a jour avec la plus r\('ecente version dans
testing
si elle est plus r\('ecente que la version install\('ee ou avec la plus r\('ecente version dans
unstable
si elle est plus r\('ecente que la version install\('ee\&.
.sp
.if n \{\
.RS 4
.\}
.nf
apt\-get install \fIpaquet\fR/unstable
.fi
.if n \{\
.RE
.\}
.sp
.SS "Suivre l\*(Aq\('evolution d\*(Aqune version par son nom de code"
.PP
Le fichier des pr\('ef\('erences suivant affecte une priorit\('e plus haute que la priorit\('e par d\('efaut (500) \(`a tous les exemplaires appartenant \(`a la version portant le nom de code indiqu\('e et une priorit\('e prohibitivement basse \(`a tous les exemplaires appartenant \(`a d\*(Aqautres distributions
Debian\&. Veuillez noter qu\*(Aqavec ce fichier de pr\('ef\('erences, APT suivra la transformation d\*(Aqune version
testing
en
stable
puis
oldstable\&. Si, au contraire, vous souhaitez suivre la version
testing, vous devriez utiliser un des exemples pr\('ec\('edents\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Explanation: Ne pas installer des exemplaires d\*(Aqorigine Debian
Explanation: sauf ceux de la distribution trixie ou sid
Package: *
Pin: release n=trixie
Pin\-Priority: 900

Explanation: Debian unstable porte toujours le nom sid
Package: *
Pin: release n=sid
Pin\-Priority: 800

Package: *
Pin: release o=Debian
Pin\-Priority: \-10
.fi
.if n \{\
.RE
.\}
.PP
Avec le fichier des pr\('ef\('erences ci\-dessus et un fichier
\fBsources.list\fR(5)
ad\('equat, les commandes suivantes utiliseront les versions les plus r\('ecentes de
trixie
pour faire la mise \(`a niveau\ \&:
.sp
.if n \{\
.RS 4
.\}
.nf
apt\-get install \fIpaquet\fR
apt\-get upgrade
apt\-get dist\-upgrade
.fi
.if n \{\
.RE
.\}
.PP
La commande suivante utilisera la version la plus r\('ecente de la distribution
sid
pour mettre \(`a niveau le paquet sp\('ecifi\('e\ \&; Par la suite,
\fBapt\-get upgrade\fR
mettra le paquet \(`a jour avec la plus r\('ecente version dans
trixie
si elle est plus r\('ecente que la version install\('ee ou avec la plus r\('ecente version dans
sid
si elle est plus r\('ecente que la version install\('ee\&.
.sp
.if n \{\
.RS 4
.\}
.nf
apt\-get install \fIpaquet\fR/sid
.fi
.if n \{\
.RE
.\}
.sp
.SH "FICHIERS"
.PP
/etc/apt/preferences
.RS 4
Fichier des pr\('ef\('erences\&. C\*(Aqest dans ce fichier qu\*(Aqon peut faire de l\*(Aq\('epinglage (pinning) c\*(Aqest\-\(`a\-dire, choisir d\*(Aqobtenir des paquets d\*(Aqune source distincte ou d\*(Aqune distribution diff\('erente\&. \('El\('ement de configuration :
Dir::Etc::Preferences\&.
.RE
.PP
/etc/apt/preferences\&.d/
.RS 4
Fragments de fichiers pour la pr\('ef\('erence des versions\&. \('El\('ement de configuration :
Dir::Etc::PreferencesParts\&.
.RE
.SH "VOIR AUSSI"
.PP
\fBapt-get\fR(8)
\fBapt-cache\fR(8)
\fBapt.conf\fR(5)
\fBsources.list\fR(5)
.SH "BOGUES"
.PP
\m[blue]\fBPage des bogues d\*(AqAPT\fR\m[]\&\s-2\u[1]\d\s+2\&. Si vous souhaitez signaler un bogue \(`a propos d\*(AqAPT, veuillez lire
/usr/share/doc/debian/bug\-reporting\&.txt
ou utiliser la commande
\fBreportbug\fR(1)\&.
.SH "TRADUCTEURS"
.PP
J\('er\(^ome Marant, Philippe Batailler, Christian Perrier
<bubulle@debian\&.org>
(2000, 2005, 2009, 2010), \('Equipe de traduction francophone de Debian
<debian\-l10n\-french@lists\&.debian\&.org>
.PP
Veuillez noter que cette traduction peut contenir des parties non traduites\&. Cela est volontaire, pour \('eviter de perdre du contenu quand la traduction est l\('eg\(`erement en retard sur le contenu d\*(Aqorigine\&.
.SH "AUTEUR"
.PP
\fB\('Equipe de d\('eveloppement d\*(AqAPT\fR
.RS 4
.RE
.SH "NOTES"
.IP " 1." 4
Page des bogues d'APT
.RS 4
\%https://bugs.debian.org/src:apt
.RE