apt-doc 1.8.0 - en to fr translation catalogue (841 entries)

note: type: Plain text
en: <!ENTITY apt-author.team "
       <author>
        <othername>APT team</othername>
        <contrib></contrib>
       </author>
    ">
fr: <!ENTITY apt-author.team "
       <author>
        <othername>Équipe de développement d'APT</othername>
        <contrib></contrib>
       </author>
    ">

note: type: Plain text
en: <!ENTITY apt-qapage "
    	<para>
    		<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>
    	</para>
    ">
fr: <!ENTITY apt-qapage "
    	<para>
    		<ulink url='http://packages.qa.debian.org/a/apt.html'>Page qualité</ulink>
    	</para>
    ">

note: type: Plain text
en: <!-- Boiler plate Bug reporting section -->
    <!ENTITY manbugs "
     <refsect1><title>Bugs</title>
       <para><ulink url='https://bugs.debian.org/src:apt'>APT bug page</ulink>.
       If you wish to report a bug in APT, please see
       <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the
       &reportbug; command.
       </para>
     </refsect1>
    ">
fr: <!-- Boiler plate Bug reporting section -->
    <!ENTITY manbugs "
     <refsect1><title>Bogues</title>
       <para><ulink url='https://bugs.debian.org/src:apt'>Page des bogues d'APT</ulink>. 
       Si vous souhaitez signaler un bogue à propos d'APT, veuillez lire
       <filename>/usr/share/doc/debian/bug-reporting.txt</filename> ou utiliser
       la commande &reportbug;.
       </para>
     </refsect1>
    ">

note: type: Plain text
en: <!-- Boiler plate Author section -->
    <!ENTITY manauthor "
     <refsect1><title>Author</title>
       <para>APT was written by the APT team <email>apt@packages.debian.org</email>.
       </para>
     </refsect1>
    ">
fr: <!-- Boiler plate Author section -->
    <!ENTITY manauthor "
     <refsect1><title>Author</title>
       <para>APT a été écrit par l'équipe de développement APT <email>apt@packages.debian.org</email>.
       </para>
     </refsect1>
    ">

note: type: Plain text
en: <!-- Should be used within the option section of the text to
         put in the blurb about -h, -v, -c and -o -->
    <!ENTITY apt-commonoptions "
         <varlistentry><term><option>-h</option></term>
         <term><option>--help</option></term>
         <listitem><para>Show a short usage summary.
         </para>
         </listitem>
         </varlistentry>
fr: <!-- Should be used within the option section of the text to
         put in the blurb about -h, -v, -c and -o -->
    <!ENTITY apt-commonoptions "
         <varlistentry><term><option>-h</option></term>
         <term><option>--help</option></term>
         <listitem><para>Afficher un bref résumé de l'utilisation.
         </para>
         </listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry>
          <term><option>-v</option></term>
          <term><option>--version</option></term>
          <listitem><para>Show the program version.
         </para>
         </listitem>
         </varlistentry>
fr:      <varlistentry>
          <term><option>-v</option></term>
          <term><option>--version</option></term>
          <listitem><para>Afficher la version du programme.
         </para>
         </listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry>
          <term><option>-c</option></term>
          <term><option>--config-file</option></term>
         <listitem><para>Configuration File; Specify a configuration file to use. 
         The program will read the default configuration file and then this 
         configuration file. If configuration settings need to be set before the
         default configuration files are parsed specify a file with the <envar>APT_CONFIG</envar>
         environment variable. See &apt-conf; for syntax information.
         </para>
         </listitem>
         </varlistentry>
fr:      <varlistentry>
          <term><option>-c</option></term>
          <term><option>--config-file</option></term>
         <listitem><para>Fichier de configuration ; indique le fichier de configuration à utiliser. 
         Le programme lira le fichier de configuration par défaut puis le fichier indiqué ici. 
         Si les réglages de configuration doivent être établis avant l'analyse des fichiers
         de configuration par défaut, un fichier peut être indiqué avec la variable d'environnement <envar>APT_CONFIG</envar>.     Veuillez consulter &apt-conf; pour des informations sur la syntaxe d'utilisation.
         </para>
         </listitem>
         </varlistentry>

note: type: Plain text
en: <!-- Should be used within the option section of the text to
         put in the blurb about -h, -v, -c and -o -->
    <!ENTITY apt-cmdblurb "
       <para>All command line options may be set using the configuration file, the
       descriptions indicate the configuration option to set. For boolean
       options you can override the config file by using something like 
       <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>
       or several other variations.
       </para>
    ">
fr: <!-- Should be used within the option section of the text to
         put in the blurb about -h, -v, -c and -o -->
    <!ENTITY apt-cmdblurb "
       <para>Toutes les options de la ligne de commande peuvent être définies dans le fichier de configuration, 
       les descriptions indiquant l'option de configuration concernée. Pour les options
       booléennes, vous pouvez inverser les réglages du fichiers de configuration avec 
       <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>
       et d'autres variantes analogues.
       </para>
    ">

note: type: Plain text
en: <!ENTITY file-aptconf "
         <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>
         <listitem><para>APT configuration file.
         Configuration Item: <literal>Dir::Etc::Main</literal>.</para></listitem>
         </varlistentry>
fr: <!ENTITY file-aptconf "
         <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>
         <listitem><para>Fichier de configuration d'APT.
         Élément de configuration : <literal>Dir::Etc::Main</literal>.</para></listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>
         <listitem><para>APT configuration file fragments.
         Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem>
         </varlistentry>
    ">
fr:      <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>
         <listitem><para>Fragments du fichier de configuration d'APT.
         Élément de configuration : <literal>Dir::Etc::Parts</literal>.</para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!ENTITY file-cachearchives "
         <varlistentry><term><filename>&cachedir;/archives/</filename></term>
         <listitem><para>Storage area for retrieved package files.
         Configuration Item: <literal>Dir::Cache::Archives</literal>.</para></listitem>
         </varlistentry>
fr: <!ENTITY file-cachearchives "
         <varlistentry><term><filename>&cachedir;/archives/</filename></term>
         <listitem><para>Zone de stockage des fichiers récupérés.
         Élément de configuration : <literal>Dir::Cache::Archives</literal>.</para></listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
         <listitem><para>Storage area for package files in transit.
         Configuration Item: <literal>Dir::Cache::Archives</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem>
         </varlistentry>
    ">
fr:      <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
         <listitem><para>Zone de stockage pour les paquets en transit.
         Élément de configuration : <literal>Dir::Cache::Archives</literal> (<filename>partial</filename> sera implicitement ajouté). </para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!ENTITY file-preferences "
         <varlistentry><term><filename>/etc/apt/preferences</filename></term>
         <listitem><para>Version preferences file.
         This is where you would specify &quot;pinning&quot;,
         i.e. a preference to get certain packages
         from a separate source
         or from a different version of a distribution.
         Configuration Item: <literal>Dir::Etc::Preferences</literal>.</para></listitem>
         </varlistentry>
fr: <!ENTITY file-preferences "
         <varlistentry><term><filename>/etc/apt/preferences</filename></term>
         <listitem><para>Fichier des préférences.
         C'est dans ce fichier qu'on peut faire de l'épinglage (pinning) c'est-à-dire, choisir d'obtenir des paquets d'une source distincte ou d'une distribution différente.
         Élément de configuration : <literal>Dir::Etc::Preferences</literal>.</para></listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>
         <listitem><para>File fragments for the version preferences.
         Configuration Item: <literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>
         </varlistentry>
    ">
fr:      <varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>
         <listitem><para>Fragments de fichiers pour la préférence des versions.
         Élément de configuration : <literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!ENTITY file-sourceslist "
         <varlistentry><term><filename>/etc/apt/sources.list</filename></term>
         <listitem><para>Locations to fetch packages from.
         Configuration Item: <literal>Dir::Etc::SourceList</literal>.</para></listitem>
         </varlistentry>
fr: <!ENTITY file-sourceslist "
         <varlistentry><term><filename>/etc/apt/sources.list</filename></term>
         <listitem><para>Emplacement pour la récupération des paquets.
         Élément de configuration : <literal>Dir::Etc::SourceList</literal>.</para></listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>
         <listitem><para>File fragments for locations to fetch packages from.
         Configuration Item: <literal>Dir::Etc::SourceParts</literal>.</para></listitem>
         </varlistentry>
    ">
fr:      <varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>
         <listitem><para>Fragments de fichiers définissant les emplacements de récupération de paquets.
         Élément de configuration : <literal>Dir::Etc::SourceParts</literal>.</para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!ENTITY file-statelists "
         <varlistentry><term><filename>&statedir;/lists/</filename></term>
         <listitem><para>Storage area for state information for each package resource specified in
         &sources-list;
         Configuration Item: <literal>Dir::State::Lists</literal>.</para></listitem>
         </varlistentry>
fr: <!ENTITY file-statelists "
         <varlistentry><term><filename>&statedir;/lists/</filename></term>
         <listitem><para>Zone de stockage pour les informations qui concernent chaque ressource de paquet spécifiée dans &sources-list;
         Élément de configuration : <literal>Dir::State::Lists</literal>.</para></listitem>
         </varlistentry>

note: type: Plain text
en:      <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
         <listitem><para>Storage area for state information in transit.
         Configuration Item: <literal>Dir::State::Lists</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem>
         </varlistentry>
    ">
fr:      <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
         <listitem><para>Zone de stockage pour les informations en transit.
         Élément de configuration : <literal>Dir::State::Lists</literal> (<filename>partial</filename> sera implicitement ajouté).</para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!ENTITY file-trustedgpg "
         <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>
         <listitem><para>Keyring of local trusted keys, new keys will be added here.
         Configuration Item: <literal>Dir::Etc::Trusted</literal>.</para></listitem>
         </varlistentry>
fr: <!ENTITY file-trustedgpg "
         <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>
         <listitem><para>Porte-clés des clés de confiance locales. Les nouvelles clés y seront ajoutées.
         Élément de configuration : <literal>Dir::Etc::Trusted</literal>.</para></listitem>
         </varlistentry>

note: type: Plain text
en: <!ENTITY file-extended_states "
          <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term>
          <listitem><para>Status list of auto-installed packages.
          Configuration Item: <literal>Dir::State::extended_states</literal>.
          </para></listitem>
          </varlistentry>
    ">
fr: <!ENTITY file-extended_states "
         <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term>
         <listitem><para>Liste d'état des paquets installés automatiquement.
         Élément de configuration : <literal>Dir::State::extended_states</literal>.</para></listitem>
         </varlistentry>
    ">

note: type: Plain text
en: <!-- TRANSLATOR: This is the section header for the following paragraphs - comparable
         to the other headers like NAME and DESCRIPTION and should therefore be uppercase. -->
    <!ENTITY translation-title "TRANSLATION">
fr: <!ENTITY translation-title "TRADUCTEURS">

note: type: Plain text
en: <!-- TRANSLATOR: This is a placeholder. You should write here who has contributed
         to the translation in the past, who is responsible now and maybe further information
         specially related to your translation. -->
    <!ENTITY translation-holder "
         The english translation was done by John Doe <email>john@doe.org</email> in 2009,
         2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together with the
         Debian Dummy l10n Team <email>debian-l10n-dummy@lists.debian.org</email>.
    ">
fr: <!ENTITY translation-holder "
         Jérôme Marant, Philippe Batailler, Christian Perrier <email>bubulle@debian.org</email> (2000, 2005, 2009, 2010),
         Équipe de traduction francophone de Debian <email>debian-l10n-french@lists.debian.org</email>
    ">

note: type: Plain text
en: <!-- TRANSLATOR: As a translation is allowed to have 20% of untranslated/fuzzy strings
         in a shipped manpage newer/modified paragraphs will maybe appear in english in
         the generated manpage. This sentence is therefore here to tell the reader that this
         is not a mistake by the translator - obviously the target is that at least for stable
         releases this sentence is not needed. :) -->
    <!ENTITY translation-english "
         Note that this translated document may contain untranslated parts.
         This is done on purpose, to avoid losing content when the
         translation is lagging behind the original content.
    ">
fr: <!ENTITY translation-english "
         Veuillez noter que cette traduction peut contenir des parties non traduites.
         Cela est volontaire, pour éviter de perdre du contenu quand la
         traduction est légèrement en retard sur le contenu d'origine.
    ">

note: type: Plain text
en: <!-- TRANSLATOR: used as in -o=config_string e.g. -o=Debug::pkgProblemResolver=1 --> <!ENTITY synopsis-config-string "config_string">
fr: <!ENTITY synopsis-config-string "chaîne_de_configuration">

note: type: Plain text
en: <!-- TRANSLATOR: used as in -c=config_file e.g. -c=./apt.conf --> <!ENTITY synopsis-config-file "config_file">
fr: <!ENTITY synopsis-config-file "fichier_de_configuration">

note: type: Plain text
en: <!-- TRANSLATOR: used as in -t=target_release or pkg/target_release e.g. -t=squeeze apt/experimental --> <!ENTITY synopsis-target-release "target_release">
fr: <!ENTITY synopsis-target-release "publication_cible">

note: type: Plain text
en: <!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> <!ENTITY synopsis-architecture "architecture">
fr: <!ENTITY synopsis-architecture "architecture">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome --> <!ENTITY synopsis-pkg "pkg">
fr: <!ENTITY synopsis-pkg "paquet">

note: type: Plain text
en: <!-- TRANSLATOR: used as in pkg=pkg_version_number e.g. apt=0.8.15 --> <!ENTITY synopsis-pkg-ver-number "pkg_version_number">
fr: <!ENTITY synopsis-pkg-ver-number "numéro_version_paquet">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-cache pkgnames prefix e.g. apt-cache pkgnames apt --> <!ENTITY synopsis-prefix "prefix">
fr: <!ENTITY synopsis-prefix "préfixe">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-cache search regex e.g. apt-cache search awesome --> <!ENTITY synopsis-regex "regex">
fr: <!ENTITY synopsis-regex "expression_régulière">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point e.g. apt-cdrom -d=/media/cdrom --> <!ENTITY synopsis-cdrom-mount "cdrom_mount_point">
fr: <!ENTITY synopsis-cdrom-mount "point_de_montage_CD-ROM">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory e.g. apt-extracttemplates -t=/tmp --> <!ENTITY synopsis-tmp-directory "temporary_directory">
fr: <!ENTITY synopsis-tmp-directory "répertoire_temporaire">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-extracttemplates filename --> <!ENTITY synopsis-filename "filename">
fr: <!ENTITY synopsis-filename "nom_de_fichier">

note: type: Plain text
en: <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> <!ENTITY synopsis-path "path">
fr: <!ENTITY synopsis-path "chemin">

note: type: Plain text
en: <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> <!ENTITY synopsis-override "override-file">
fr: <!ENTITY synopsis-override "fichier-override">

note: type: Plain text
en: <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> <!ENTITY synopsis-pathprefix "pathprefix">
fr: <!ENTITY synopsis-pathprefix "préfixe_de_chemin">

note: type: Plain text
en: <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive generate section --> <!ENTITY synopsis-section "section">
fr: <!ENTITY synopsis-section "section">

note: type: Plain text
en: <!-- TRANSLATOR: used as in apt-key export keyid e.g. apt-key export 473041FA --> <!ENTITY synopsis-keyid "keyid">
fr: <!ENTITY synopsis-keyid "id_de_clé">

note: type: Content of: <refentry><refnamediv><refpurpose>
en: command-line interface
fr: interface en ligne de commande

note: type: Content of: <refentry><refsect1><para>
en: <command>apt</command> provides a high-level commandline interface for the package management system. It is intended as an end user interface and enables some options better suited for interactive usage by default compared to more specialized APT tools like &apt-get; and &apt-cache;.
fr: <command>apt</command> fournit une interface en ligne de commande pour le système de gestion de paquets. Elle est conçue comme une interface utilisateur et permet certaines options plus adaptées à une utilisation interactive par défaut par rapport aux outils d'APT plus spécialisés tels que &apt-get; et &apt-cache;.

note: type: Content of: <refentry><refsect1><para>
en: Much like <command>apt</command> itself, its manpage is intended as an end user interface and as such only mentions the most used commands and options partly to not duplicate information in multiple places and partly to avoid overwhelming readers with a cornucopia of options and details.
fr: Exactement comme <command>apt</command> lui-même, cette page de manuel vise à être une interface pour l'utilisateur et ainsi elle ne mentionne que les commandes et les options les plus courantes, en partie pour ne pas répéter les informations à de multiples emplacements et en partie pour ne pas noyer le lecteur par une surabondance d'options et de détails.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <option>update</option> is used to download package information from all configured sources. Other commands operate on this data to e.g. perform package upgrades or search in and display details about all packages available for installation.
fr: La commande <option>update</option> permet de télécharger les informations sur les paquets à partir des sources configurées. D'autres commandes agissent sur ces données, par exemple, réalisent la mise à jour de paquet ou recherchent et affichent des détails à propos de tous les paquets qui peuvent être installés.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <option>upgrade</option> is used to install available upgrades of all packages currently installed on the system from the sources configured via &sources-list;. New packages will be installed if required to satisfy dependencies, but existing packages will never be removed. If an upgrade for a package requires the removal of an installed package the upgrade for this package isn't performed.
fr: La commande <literal>upgrade</literal> permet d'installer les mises à jour disponibles de tous les paquets présents sur le système en utilisant les sources énumérées dans &sources-list;. De nouveaux paquets seront installés si cela est nécessaire pour satisfaire des dépendances, mais les paquets installés ne seront jamais supprimés. Si la mise à jour d'un paquet nécessite la suppression d'un paquet installé, la mise à jour n'est pas réalisée.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>full-upgrade</literal> performs the function of upgrade but will remove currently installed packages if this is needed to upgrade the system as a whole.
fr: La commande <literal>full-upgrade</literal> remplit la même fonction que upgrade mais supprimera des paquets actuellement installés si cela est nécessaire pour mettre à jour le système dans son ensemble.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Performs the requested action on one or more packages specified via &regex;, &glob; or exact match. The requested action can be overridden for specific packages by appending a plus (+) to the package name to install this package or a minus (-) to remove it.
fr: La commande réalise l'action requise sur un ou plusieurs paquets spécifiés avec &regex;, &glob; ou avec la correspondance exacte. Les actions requises peuvent être remplacées pour certains paquets en ajoutant un plus (+) au nom du paquet pour l'installer et ou un moins (-) pour le supprimer.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: A specific version of a package can be selected for installation by following the package name with an equals (=) and the version of the package to select. Alternatively the version from a specific release can be selected by following the package name with a forward slash (/) and codename (&debian-stable-codename;, &debian-testing-codename;, sid …) or suite name (stable, testing, unstable). This will also select versions from this release for dependencies of this package if needed to satisfy the request.
fr: On peut choisir d'installer une version particulière d'un paquet en faisant suivre son nom par un signe égal (=) et par la version du paquet à sélectionner. Autrement, on peut choisir une version spécifique en faisant suivre le nom du paquet par une barre oblique (/) et le nom de code (&debian-stable-codename;, &debian-testing-codename;, sid …) ou un nom de suite (stable, testing, unstable). Cela sélectionnera aussi cette version pour les dépendances de ce paquet si cela est nécessaire pour satisfaire la requête.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Removing a package removes all packaged data, but leaves usually small (modified) user configuration files behind, in case the remove was an accident. Just issuing an installation request for the accidentally removed package will restore its function as before in that case. On the other hand you can get rid of these leftovers by calling <command>purge</command> even on already removed packages. Note that this does not affect any data or configuration stored in your home directory.
fr: La suppression d'un paquet entraîne la suppression de toutes les données empaquetées, mais conserve habituellement les petits fichiers (modifiés) de configuration de l'utilisateur, pour le cas où la suppression a été accidentelle. Dans ce cas, il suffira d'émettre une demande d'installation pour le paquet supprimé accidentellement pour restaurer son fonctionnement antérieur. D'autre part, on peut facilement se débarrasser de ces reliquats en appelant la commande <command>purge</command> même sur des paquets déjà supprimés. Notez que cela n'affecte aucune donnée ou configuration stockées dans votre répertoire personnel.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>autoremove</literal> is used to remove packages that were automatically installed to satisfy dependencies for other packages and are now no longer needed as dependencies changed or the package(s)  needing them were removed in the meantime.
fr: La commande <literal>autoremove</literal>, supprime les paquets installés automatiquement dans le but de satisfaire les dépendances d'autres paquets et qui ne sont plus nécessaires parce que les dépendances ont changé ou parce que le ou les paquets ont été supprimés entre-temps.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: You should check that the list does not include applications you have grown to like even though they were once installed just as a dependency of another package. You can mark such a package as manually installed by using &apt-mark;. Packages which you have installed explicitly via <command>install</command> are also never proposed for automatic removal.
fr: Vous devriez vérifier que la liste ne contient pas des applications que vous avez fini par apprécier, même si elles ont été installées seulement comme dépendance d'un autre paquet. Vous pouvez marquer ces paquets comme installés manuellement avec &apt-mark;. Les paquets que vous avez installés explicitement avec la commande <command>install</command> ne seront jamais proposés non plus pour une suppression automatique.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <option>search</option> can be used to search for the given &regex; term(s) in the list of available packages and display matches.  This can e.g. be useful if you are looking for packages having a specific feature.  If you are looking for a package including a specific file try &apt-file;.
fr: La commande <option>search</option> peut être utilisée pour rechercher le(s) terme(s) &regex; donné(s) dans la liste de paquets disponibles et affiche les paquets correspondants. Par exemple, cela peut être utile pour rechercher des paquets dotés d'une fonctionnalité particulière. Si vous recherchez un paquet qui fournit un fichier particulier, essayez &apt-file;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show information about the given package(s) including its dependencies, installation and download size, sources the package is available from, the description of the packages content and much more. It can e.g. be helpful to look at this information before allowing &apt; to remove a package or while searching for new packages to install.
fr: La commande affiche des informations sur le(s) paquet(s) donné(s) y compris ses dépendances, sa taille installé et au téléchargement, les sources d’où provient le paquet, la description du contenu des paquets et bien plus encore. Cela peut être utile pour consulter ces informations avant d'autoriser &apt; à supprimer un paquet ou lors d'une recherche de nouveaux paquets à installer.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: (work-in-progress)
fr: (travail en cours)

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>edit-sources</literal> lets you edit your &sources-list; files in your preferred text editor while also providing basic sanity checks.
fr: La commande <literal>edit-sources</literal> permet de modifier le fichier &sources-list; avec votre éditeur de texte préféré et fournit des vérifications de sécurité de base.

note: type: Content of: <refentry><refsect1><title>
en: Script Usage and Differences from Other APT Tools
fr: Utilisation de scripts et différences avec les autres outils d'APT

note: type: Content of: <refentry><refsect1><para>
en: The &apt; commandline is designed as an end-user tool and it may change behavior between versions. While it tries not to break backward compatibility this is not guaranteed either if a change seems beneficial for interactive use.
fr: La ligne de commande de &apt; est conçue comme un outil pour l'utilisateur et son comportement peut varier selon ses versions. Bien qu'il s'efforce de ne pas casser les compatibilités ascendantes, cela ne peut pas non plus être garanti, si une modification semble bénéfique pour une utilisation interactive.

note: type: Content of: <refentry><refsect1><para>
en: All features of &apt; are available in dedicated APT tools like &apt-get; and &apt-cache; as well.  &apt; just changes the default value of some options (see &apt-conf; and specifically the Binary scope). So you should prefer using these commands (potentially with some additional options enabled) in your scripts as they keep backward compatibility as much as possible.
fr: Toutes les fonctionnalités d'&apt; sont aussi proposées dans les outils dédiés d'APT tels que &apt-get; ou &apt-cache;. &apt; modifie seulement la valeur par défaut de certaines options (voir &apt-conf; et en particulier le champ d'action Binary). Aussi vous devriez préférer l'utilisation de ces commandes (éventuellement avec certaines options complémentaires activées) dans les scripts parce qu'elles conservent autant que possible la compatibilité ascendante.

note: type: Content of: <refentry><refsect1><title>
en: See Also
fr: Voir aussi

note: type: Content of: <refentry><refsect1><para>
en: &apt-get;, &apt-cache;, &sources-list;, &apt-conf;, &apt-config;, &apt-patterns;, The APT User's guide in &guidesdir;, &apt-preferences;, the APT Howto.
fr: &apt-get;, &apt-cache;, &sources-list;, &apt-conf;, &apt-config;, &apt-patterns;, le guide d'APT dans &guidesdir;, &apt-preferences;, le « HOWTO » d'APT.

note: type: Content of: <refentry><refsect1><para>
en: <command>apt</command> returns zero on normal operation, decimal 100 on error.
fr: <command>apt</command> renvoie zéro après une opération normale, et le décimal 100 en cas d'erreur.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: APT package handling utility -- command-line interface
fr: Utilitaire APT pour la gestion des paquets -- interface en ligne de commande.

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-get</command> is the command-line tool for handling packages, and may be considered the user's "back-end" to other tools using the APT library.  Several "front-end" interfaces exist, such as &aptitude;, &synaptic; and &wajig;.
fr: <command>apt-get</command> est le programme en ligne de commande pour la gestion des paquets. Il peut être considéré comme l'outil de base pour les autres programmes de la bibliothèque APT. Plusieurs interfaces utilisateur existent, comme &aptitude;, &synaptic; and &wajig;.

note: type: Content of: <refentry><refsect1><para>
en: Unless the <option>-h</option>, or <option>--help</option> option is given, one of the commands below must be present.
fr: À moins que l'option <option>-h</option> ou <option>--help</option> ne soit donnée, l'une des commandes suivantes doit être présente.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>update</literal> is used to resynchronize the package index files from their sources. The indexes of available packages are fetched from the location(s) specified in <filename>/etc/apt/sources.list</filename>.  For example, when using a Debian archive, this command retrieves and scans the <filename>Packages.gz</filename> files, so that information about new and updated packages is available. An <literal>update</literal> should always be performed before an <literal>upgrade</literal> or <literal>dist-upgrade</literal>. Please be aware that the overall progress meter will be incorrect as the size of the package files cannot be known in advance.
fr: La commande <literal>update</literal> permet de resynchroniser un fichier d'index répertoriant les paquets disponibles et sa source. Ces fichiers sont récupérés aux endroits spécifiés dans <filename>/etc/apt/sources.list</filename>. Ainsi, lorsqu'on utilise une archive Debian, cette commande récupère les fichiers <filename>Packages.gz</filename> et les analyse de manière à rendre disponibles les informations concernant les nouveaux paquets et les paquets mis à jour. On devrait toujours exécuter une commande <literal>update</literal> avant les commandes <literal>upgrade</literal> ou <literal>dist-upgrade</literal>. Veuillez noter que l'indicateur de progression d'ensemble peut être imprécis puisque la taille de ces fichiers ne peut être connue à l'avance.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>upgrade</literal> is used to install the newest versions of all packages currently installed on the system from the sources enumerated in <filename>/etc/apt/sources.list</filename>. Packages currently installed with new versions available are retrieved and upgraded; under no circumstances are currently installed packages removed, or packages not already installed retrieved and installed. New versions of currently installed packages that cannot be upgraded without changing the install status of another package will be left at their current version. An <literal>update</literal> must be performed first so that <command>apt-get</command> knows that new versions of packages are available.
fr: La commande <literal>upgrade</literal> permet d'installer les versions les plus récentes de tous les paquets présents sur le système en utilisant les sources énumérées dans <filename>/etc/apt/sources.list</filename>. Les paquets installés dont il existe de nouvelles versions sont récupérés et mis à niveau. En aucun cas des paquets déjà installés ne sont supprimés ; de même, des paquets qui ne sont pas déjà installés ne sont ni récupérés ni installés. Les paquets dont de nouvelles versions ne peuvent pas être installées sans changer le statut d'installation d'un autre paquet sont laissés dans leur version courante. On doit d'abord exécuter la commande <literal>update</literal> pour que <command>apt-get</command> connaisse l'existence de nouvelles versions des paquets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>dist-upgrade</literal> in addition to performing the function of <literal>upgrade</literal>, also intelligently handles changing dependencies with new versions of packages; <command>apt-get</command> has a "smart" conflict resolution system, and it will attempt to upgrade the most important packages at the expense of less important ones if necessary.  The <literal>dist-upgrade</literal> command may therefore remove some packages.  The <filename>/etc/apt/sources.list</filename> file contains a list of locations from which to retrieve desired package files.  See also &apt-preferences; for a mechanism for overriding the general settings for individual packages.
fr: La commande <literal>dist-upgrade</literal> effectue la fonction <literal>upgrade</literal> en y ajoutant une gestion intelligente des changements de dépendances dans les nouvelles versions des paquets ; <command>apt-get</command> possède un système « intelligent » de résolution des conflits et il essaye, quand c'est nécessaire, de mettre à niveau les paquets les plus importants avant les paquets les moins importants. Le fichier <filename>/etc/apt/sources.list</filename> contient une liste de sources où récupérer les paquets désirés. Voyez aussi &apt-preferences; pour un mécanisme de remplacement des paramètres généraux pour certains paquets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>dselect-upgrade</literal> is used in conjunction with the traditional Debian packaging front-end, &dselect;. <literal>dselect-upgrade</literal> follows the changes made by &dselect; to the <literal>Status</literal> field of available packages, and performs the actions necessary to realize that state (for instance, the removal of old and the installation of new packages).
fr: <literal>dselect-upgrade</literal> est utilisée conjointement avec &dselect;, la plus ancienne interface du projet Debian pour la gestion des paquets. La commande <literal>dselect-upgrade</literal> suit les modifications faites par &dselect; dans le champ <literal>Status</literal> des paquets disponibles, et effectue les actions nécessaires à la réalisation de cet état (par exemple, suppression d'anciens paquets, installation de nouveaux paquets).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>install</literal> is followed by one or more packages desired for installation or upgrading.  Each package is a package name, not a fully qualified filename (for instance, in a Debian system, <package>apt-utils</package> would be the argument provided, not <filename>apt-utils_&apt-product-version;_amd64.deb</filename>). All packages required by the package(s) specified for installation will also be retrieved and installed.  The <filename>/etc/apt/sources.list</filename> file is used to locate the desired packages. If a hyphen is appended to the package name (with no intervening space), the identified package will be removed if it is installed.  Similarly a plus sign can be used to designate a package to install. These latter features may be used to override decisions made by apt-get's conflict resolution system.
fr: La commande <literal>install</literal> est suivie par un ou plusieurs paquets à installer. Chaque paquet est un nom de paquet ; ce n'est pas un nom complet de fichier (par exemple, dans un système Debian, on indiquera <package>apt-utils</package> et non pas <filename>apt-utils_&apt-product-version;_amd64.deb</filename>). Tous les paquets requis par le(s) paquet(s) que l'on veut installer sont aussi récupérés et installés. Le fichier <filename>/etc/apt/sources.list</filename> est utilisé pour retrouver les paquets désirés. Quand un trait d'union est accolé (sans espace intermédiaire) au nom d'un paquet déjà installé, ce paquet est supprimé. De même on peut ajouter un signe « + » pour désigner un paquet à installer. Cette dernière fonctionnalité peut être utilisée pour annuler les décisions prises par le système de résolution des conflits d'apt-get.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: A specific version of a package can be selected for installation by following the package name with an equals and the version of the package to select. This will cause that version to be located and selected for install. Alternatively a specific distribution can be selected by following the package name with a slash and the version of the distribution or the Archive name (stable, testing, unstable).
fr: On peut choisir d'installer une version particulière d'un paquet en faisant suivre son nom par un signe égal et par la version. Cette version sera recherchée et l'installation sera demandée. On peut aussi choisir une distribution particulière en faisant suivre le nom du paquet par une barre oblique et par le nom de la distribution ou de l'archive (stable, testing, unstable).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Both of the version selection mechanisms can downgrade packages and must be used with care.
fr: Avec ces possibilités de choisir la version, de vieilles versions d'un paquet peuvent être installées. Cette fonctionnalité est donc à utiliser avec précaution.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is also the target to use if you want to upgrade one or more already-installed packages without upgrading every package you have on your system. Unlike the "upgrade" target, which installs the newest version of all currently installed packages, "install" will install the newest version of only the package(s)  specified. Simply provide the name of the package(s) you wish to upgrade, and if a newer version is available, it (and its dependencies, as described above) will be downloaded and installed.
fr: Cette méthode est aussi utile pour mettre à jour un ou plusieurs paquets déjà installés sans mettre à jour les autres paquets du système. À la différence de la commande « upgrade » qui installera la dernière version disponible de tous les paquets installés au moment de son exécution, « install » n'installera la nouvelle version que pour le(s) paquet(s) indiqué(s). Il suffit de fournir le nom du(des) paquet(s) à mettre à jour et si une nouvelle version est disponible, cette version (et ses dépendances, comme décrit plus haut) sera récupérée et installée.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Finally, the &apt-preferences; mechanism allows you to create an alternative installation policy for individual packages.
fr: Enfin, le mécanisme d'&apt-preferences; permet de créer d'autres règles pour l'installation des paquets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If no package matches the given expression and the expression contains one of '.', '?' or '*' then it is assumed to be a POSIX regular expression, and it is applied to all package names in the database. Any matches are then installed (or removed). Note that matching is done by substring so 'lo.*' matches 'how-lo' and 'lowest'. If this is undesired, anchor the regular expression with a '^' or '$' character, or create a more specific regular expression.
fr: Quand aucun paquet ne correspond à l'expression donnée en paramètre et que cette expression contient l'un des caractères « . », « ? » ou « * », elle est considérée comme une expression rationnelle POSIX et elle est appliquée à tous les paquets de la base de données. Tout paquet correspondant est installé (ou supprimé). Veuillez noter que la comparaison est effectuée par sous-chaîne et « lo.* » correspond aussi bien à « how-lo » qu'à « lowest ». Si ce n'est pas le comportement souhaité, l'expression peut être ancrée avec un caractère « ^ » ou un caractère « $ », une autre possibilité étant d'utiliser une expression plus précise.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>reinstall</literal> is an alias for <literal>install --reinstall</literal>.
fr: <literal>reinstall</literal> est un alias de la commande <literal>install --reinstall</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>remove</literal> is identical to <literal>install</literal> except that packages are removed instead of installed. Note that removing a package leaves its configuration files on the system. If a plus sign is appended to the package name (with no intervening space), the identified package will be installed instead of removed.
fr: La commande <literal>remove</literal> est identique à la commande <literal>install</literal>, les paquets étant alors supprimés et non installés. Veuillez noter que la suppression d'un paquet en laisse les fichiers de configuration sur le système. Quand un signe plus est accolé (sans espace intermédiaire) au nom du paquet, le paquet est installé au lieu d'être supprimé.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>purge</literal> is identical to <literal>remove</literal> except that packages are removed and purged (any configuration files are deleted too).
fr: La commande <literal>purge</literal> est identique à <literal>remove</literal> mais les paquets indiqués sont supprimés et purgés (leurs fichiers de configuration sont également effacés).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>source</literal> causes <command>apt-get</command> to fetch source packages. APT will examine the available packages to decide which source package to fetch. It will then find and download into the current directory the newest available version of that source package while respecting the default release, set with the option <literal>APT::Default-Release</literal>, the <option>-t</option> option or per package with the <literal>pkg/release</literal> syntax, if possible.
fr: Avec la commande <literal>source</literal>, <command>apt-get</command> récupère des paquets source. APT examine les paquets disponibles pour choisir le paquet source à récupérer. Il télécharge ensuite dans le répertoire courant la version la plus récente du paquet, définie par rapport à la distribution par défaut établie soit avec l'option <literal>APT::Default-Release</literal>, soit avec l'option <option>-t</option> ou soit par paquet avec la syntaxe <literal>paquet/version</literal> si possible.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The arguments are interpreted as binary and source package names.  See the <option>--only-source</option> option if you want to change that.
fr: Les arguments sont interprétés comme des noms de paquet binaire ou de paquet source. Voir l'option <option>--only-source</option> si vous souhaitez modifier cela.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Source packages are tracked separately from binary packages via <literal>deb-src</literal> lines in the &sources-list; file. This means that you will need to add such a line for each repository you want to get sources from; otherwise you will probably get either the wrong (too old/too new) source versions or none at all.
fr: Les paquets source sont gérés indépendamment des paquets binaires, avec les lignes <literal>deb-src</literal> dans le fichier &sources-list;. Il est donc nécessaire d'ajouter une telle ligne pour chaque dépôt pour lequel vous souhaitez pouvoir obtenir les sources. Dans le cas contraire, vous n'obtiendrez pas les mêmes sources que celles du paquet que vous avez installé ou que vous voulez installer.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If the <option>--compile</option> option is specified then the package will be compiled to a binary .deb using <command>dpkg-buildpackage</command> for the architecture as defined by the <command>--host-architecture</command> option.  If <option>--download-only</option> is specified then the source package will not be unpacked.
fr: Si l'option <option>--compile</option> est spécifiée, le paquet est compilé en un binaire .deb avec <command>dpkg-buildpackage</command> pour l'architecture définie par l'option <command>--host-architecture</command>. Si <option>--download-only</option> est spécifié, le source n'est pas décompacté.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: A specific source version can be retrieved by postfixing the source name with an equals and then the version to fetch, similar to the mechanism used for the package files. This enables exact matching of the source package name and version, implicitly enabling the <literal>APT::Get::Only-Source</literal> option.
fr: De la même façon qu'avec les paquets binaires, on peut récupérer une version particulière d'un paquet source en faisant suivre son nom par un signe égal et par la version. Cela permet une comparaison exacte entre le nom du paquet source et la version ; l'option correspondante est : <literal>APT::Get::Only-Source</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note that source packages are not installed and tracked in the <command>dpkg</command> database like binary packages; they are simply downloaded to the current directory, like source tarballs.
fr: Veuillez noter que les paquets source ne sont pas installés et suivis dans la base de données de <command>dpkg</command> comme le sont les paquets binaires ; ils sont simplement téléchargés dans le répertoire courant, comme les archives tar.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>build-dep</literal> causes apt-get to install/remove packages in an attempt to satisfy the build dependencies for a source package. By default the dependencies are satisfied to build the package natively. If desired a host-architecture can be specified with the <option>--host-architecture</option> option instead.
fr: Avec la commande <literal>build-dep</literal>, apt-get installe ou supprime des paquets dans le but de satisfaire les dépendances de construction d'un paquet source. Par défaut, les dépendances sont satisfaites pour la construction native du paquet. Au besoin, une architecture hôte peut être indiquée avec l'option <option>--host-architecture</option>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The arguments are interpreted as binary or source package names. See the <option>--only-source</option> option if you want to change that.
fr: Les arguments sont interprétés comme des noms de paquet binaire ou de paquet source. Voir l'option <option>--only-source</option> si vous souhaitez modifier cela.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>check</literal> is a diagnostic tool; it updates the package cache and checks for broken dependencies.
fr: La commande <literal>check</literal> est un outil de diagnostic ; il met à jour le cache des paquets et cherche les dépendances défectueuses.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>clean</literal> clears out the local repository of retrieved package files. It removes everything but the lock file from <filename>&cachedir;/archives/</filename> and <filename>&cachedir;/archives/partial/</filename>.
fr: La commande <literal>clean</literal> nettoie le dépôt local des paquets récupérés. Elle supprime tout, excepté le fichier de verrou situé dans <filename>&cachedir;/archives/</filename> et <filename>&cachedir;/archives/partial/</filename>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: (and the
fr: (et

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: alias since 1.1)
fr: l'alias depuis la version 1.1)

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Like <literal>clean</literal>, <literal>autoclean</literal> clears out the local repository of retrieved package files. The difference is that it only removes package files that can no longer be downloaded, and are largely useless. This allows a cache to be maintained over a long period without it growing out of control. The configuration option <literal>APT::Clean-Installed</literal> will prevent installed packages from being erased if it is set to off.
fr: Tout comme <literal>clean</literal>, <literal>autoclean</literal> nettoie le dépôt local des paquets récupérés. La différence est qu'il supprime uniquement les paquets qui ne peuvent plus être téléchargés et qui sont inutiles.  On peut ainsi contrôler la taille de ce cache sur une longue période.  Tant qu'elle n'est pas activée, l'option de configuration <literal>APT::Clean-Installed</literal> empêche la suppression de paquets installés.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>autoremove</literal> is used to remove packages that were automatically installed to satisfy dependencies for other packages and are now no longer needed.
fr: Avec la commande <literal>autoremove</literal>, apt-get supprime les paquets installés dans le but de satisfaire les dépendances d'autres paquets et qui ne sont plus nécessaires.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>changelog</literal> tries to download the changelog of a package and displays it through <command>sensible-pager</command>.  By default it displays the changelog for the version that is installed.  However, you can specify the same options as for the <option>install</option> command.
fr: <literal>changelog</literal> tente de télécharger le journal des modifications d'un paquet et l'affiche avec <command>sensible-pager</command>. Par défaut, c'est le journal des modifications de la version installée du paquet qui est affiché. Cependant, il est possible d'utiliser les mêmes options que pour la commande <option>install</option>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Displays by default a deb822 formatted listing of information about all data files (aka index targets) <command>apt-get update</command> would download. Supports a <option>--format</option> option to modify the output format as well as accepts lines of the default output to filter the records by. The command is mainly used as an interface for external tools working with APT to get information as well as filenames for downloaded files so they can use them as well instead of downloading them again on their own. Detailed documentation is omitted here and can instead be found in the file &apt-acquire-additional-files; shipped by the <package>apt-doc</package> package.
fr: La commande affiche par défaut une liste au format deb822 des informations sur tous les fichiers de données (ou cibles d'index) que <command>apt-get update</command> peut télécharger. Elle prend en charge une option <option>--format</option> pour modifier le format de sortie et accepte les lignes de la sortie par défaut pour filtrer les enregistrements. La commande est utilisée principalement comme interface avec les outils qui fonctionnent avec APT pour obtenir des informations comme les noms des fichiers téléchargés de telle sorte qu'ils peuvent les utiliser plutôt que de les télécharger à nouveau de leur côté. La documentation détaillée, absente ici, peut être trouvée dans le fichier &apt-acquire-additional-files; fourni par le paquet <package>apt-doc</package>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not consider recommended packages as a dependency for installing.  Configuration Item: <literal>APT::Install-Recommends</literal>.
fr: Ne pas considérer les paquets recommandés comme des dépendances à installer. Élément de configuration : <literal>APT::Install-Recommends</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Consider suggested packages as a dependency for installing.  Configuration Item: <literal>APT::Install-Suggests</literal>.
fr: Considérer les paquets suggérés comme des dépendances à installer. Élément de configuration : <literal>APT::Install-Suggests</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Download only; package files are only retrieved, not unpacked or installed.  Configuration Item: <literal>APT::Get::Download-Only</literal>.
fr: Récupération seule ; les paquets sont récupérés mais ne sont ni dépaquetés ni installés. Élément de configuration : <literal>APT::Get::Download-Only</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Fix; attempt to correct a system with broken dependencies in place. This option, when used with install/remove, can omit any packages to permit APT to deduce a likely solution. If packages are specified, these have to completely correct the problem. The option is sometimes necessary when running APT for the first time; APT itself does not allow broken package dependencies to exist on a system. It is possible that a system's dependency structure can be so corrupt as to require manual intervention (which usually means using <command>dpkg --remove</command> to eliminate some of the offending packages). Use of this option together with <option>-m</option> may produce an error in some situations.  Configuration Item: <literal>APT::Get::Fix-Broken</literal>.
fr: Correction ; cette option demande de réparer un système où existent des dépendances défectueuses. Utilisée avec install ou remove, elle peut exclure un paquet pour permettre de déduire une solution viable. Tout paquet spécifié doit complètement corriger le problème. Cette option est quelquefois nécessaire lorsque l'on exécute APT pour la première fois ; APT interdit les dépendances défectueuses dans un système. Il est possible que la structure de dépendances d'un système soit tellement corrompue qu'elle requiert une intervention manuelle (ce qui veut dire la plupart du temps utiliser <command>dpkg --remove</command> pour éliminer les paquets en cause). L'utilisation de cette option conjointement avec <option>-m</option> peut produire une erreur dans certaines situations. Élément de configuration : <literal>APT::Get::Fix-Broken</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Ignore missing packages; if packages cannot be retrieved or fail the integrity check after retrieval (corrupted package files), hold back those packages and handle the result. Use of this option together with <option>-f</option> may produce an error in some situations. If a package is selected for installation (particularly if it is mentioned on the command line) and it could not be downloaded then it will be silently held back.  Configuration Item: <literal>APT::Get::Fix-Missing</literal>.
fr: Ignorer les paquets manquants ; si des paquets ne peuvent être récupérés, ou, après récupération, ne satisfont pas au contrôle d'intégrité, cette commande met ces paquets de côté et gère le résultat. Utiliser cette option conjointement avec <option>-f</option> peut produire une erreur dans certaines situations. Quand un paquet, sélectionné pour une installation (particulièrement si c'est mentionné en ligne de commande), ne peut être récupéré, il est mis silencieusement de côté. Élément de configuration : <literal>APT::Get::Fix-Missing</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Disables downloading of packages. This is best used with <option>--ignore-missing</option> to force APT to use only the .debs it has already downloaded.  Configuration Item: <literal>APT::Get::Download</literal>.
fr: Pas de récupération. Le mieux est d'utiliser cette option avec <option>--ignore-missing</option> pour forcer APT à n'utiliser que les .deb qu'il a déjà récupérés. Élément de configuration : <literal>APT::Get::Download</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Quiet; produces output suitable for logging, omitting progress indicators.  More q's will produce more quiet up to a maximum of 2. You can also use <option>-q=#</option> to set the quiet level, overriding the configuration file.  Note that quiet level 2 implies <option>-y</option>; you should never use -qq without a no-action modifier such as -d, --print-uris or -s as APT may decide to do something you did not expect.  Configuration Item: <literal>quiet</literal>.
fr: Mode silencieux ; cette commande produit une sortie destinée à l'enregistrement dans un fichier-journal en omettant les indicateurs de progression. Un plus grand nombre de « q » (2 au plus) produit un plus grand silence. On peut aussi utiliser <option>-q=#</option> pour positionner le niveau de silence, et annuler le fichier de configuration. Notez qu'un niveau de silence égal à 2 implique <option>-y</option> et vous ne devez jamais utiliser <option>-qq</option> sans l'accompagner d'un modificateur tel que <option>-d</option>, <option>--print-uris</option> ou <option>-s</option> : APT pourrait alors exécuter des actions inattendues. Élément de configuration : <literal>quiet</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: No action; perform a simulation of events that would occur based on the current system state but do not actually change the system. Locking will be disabled (<option>Debug::NoLocking</option>)  so the system state could change while <command>apt-get</command> is running. Simulations can also be executed by non-root users which might not have read access to all apt configuration distorting the simulation.  A notice expressing this warning is also shown by default for non-root users (<option>APT::Get::Show-User-Simulation-Note</option>).  Configuration Item: <literal>APT::Get::Simulate</literal>.
fr: Pas d'action ; réalise une simulation des événements qui pourraient survenir sur la base de l'état du système actuel, mais ne modifie pas véritablement le système. Le verrouillage sera désactivé (<option>Debug::NoLocking</option>), ainsi l'état du système peut changer pendant que <command>apt-get</command> est exécuté. Les simulations peuvent aussi être exécutées par les utilisateurs ordinaires qui pourraient ne pas avoir accès en lecture à toute la configuration d'apt, ce qui fausse la simulation. Une annonce exprimant cet avertissement est aussi affichée par défaut pour les utilisateurs ordinaires (<option>APT::Get::Show-User-Simulation-Note</option>). Élément de configuration : <literal>APT::Get::Simulate</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Simulated runs print out a series of lines, each representing a <command>dpkg</command> operation: configure (<literal>Conf</literal>), remove (<literal>Remv</literal>)  or unpack (<literal>Inst</literal>). Square brackets indicate broken packages, and empty square brackets indicate breaks that are of no consequence (rare).
fr: La simulation affiche une série de lignes représentant chacune une opération de <command>dpkg</command>, Configure (<literal>Conf</literal>), Remove (<literal>Remv</literal>), Unpack (<literal>Inst</literal>). Des crochets encadrent des paquets endommagés et des crochets n'encadrant rien indiquent que les dommages n'ont aucune conséquence (rare).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Automatic yes to prompts; assume "yes" as answer to all prompts and run non-interactively. If an undesirable situation, such as changing a held package, trying to install an unauthenticated package or removing an essential package occurs then <literal>apt-get</literal> will abort.  Configuration Item: <literal>APT::Get::Assume-Yes</literal>.
fr: Répondre automatiquement oui aux questions ; présume « oui » comme réponse à toutes les questions et s'exécute de manière non interactive. Dans le cas d'une situation indésirable, comme le changement d'un paquet gelé, l'installation d'un paquet non authentifié ou la suppression d'un paquet essentiel, <literal>apt-get</literal> s'interrompt. Élément de configuration : <literal>APT::Get::Assume-Yes</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Automatic "no" to all prompts.  Configuration Item: <literal>APT::Get::Assume-No</literal>.
fr: Répondre automatiquement négativement aux questions. Élément de configuration : <literal>APT::Get::Assume-No</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not show a list of all packages that are to be upgraded.  Configuration Item: <literal>APT::Get::Show-Upgraded</literal>.
fr: Ne pas afficher la liste de tous les paquets qui doivent être mis à niveau. Élément de configuration : <literal>APT::Get::Show-Upgraded</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show full versions for upgraded and installed packages.  Configuration Item: <literal>APT::Get::Show-Versions</literal>.
fr: Afficher les versions complètes des paquets installés ou mis à niveau. Élément de configuration : <literal>APT::Get::Show-Versions</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option controls the architecture packages are built for by <command>apt-get source --compile</command> and how cross-builddependencies are satisfied. By default is it not set which means that the host architecture is the same as the build architecture (which is defined by <literal>APT::Architecture</literal>).  Configuration Item: <literal>APT::Get::Host-Architecture</literal>.
fr: Cette option contrôle comment les paquets d'architectures sont construits par <command>apt-get source --compile</command> et comment les dépendances de construction transverses sont respectées. Elle n'est pas positionnée par défaut ce qui signifie que l'architecture hôte est la même que l'architecture de construction (définie par <literal>APT::Architecture</literal>). Élément de configuration : <literal>APT::Get::Host-Architecture</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option controls the activated build profiles for which a source package is built by <command>apt-get source --compile</command> and how build dependencies are satisfied. By default no build profile is active.  More than one build profile can be activated at a time by concatenating them with a comma.  Configuration Item: <literal>APT::Build-Profiles</literal>.
fr: Cette option contrôle les profils de construction actifs pour lesquels un paquet source est construit par <command>apt-get source --compile</command> et comment les dépendances sont respectées. Par défaut, aucun profil de construction n'est actif. Plus d'un profil peut être activé en même temps en les concaténant par une virgule. Élément de configuration : <literal>APT::Build-Profiles</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Compile source packages after downloading them.  Configuration Item: <literal>APT::Get::Compile</literal>.
fr: Cette commande compile un paquet source après l'avoir récupéré. Élément de configuration : <literal>APT::Get::Compile</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Ignore package holds; this causes <command>apt-get</command> to ignore a hold placed on a package. This may be useful in conjunction with <literal>dist-upgrade</literal> to override a large number of undesired holds.  Configuration Item: <literal>APT::Ignore-Hold</literal>.
fr: Cette commande ignore la marque « Hold » (« retenu ») d'un paquet ; par ce biais, <command>apt-get</command> ignore un « hold » placé sur un paquet. cela peut être utile avec <literal>dist-upgrade</literal> pour annuler un grand nombre de « hold » indésirables. Élément de configuration : <literal>APT::Ignore-Hold</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allow installing new packages when used in conjunction with <literal>upgrade</literal>.  This is useful if the update of an installed package requires new dependencies to be installed. Instead of holding the package back <literal>upgrade</literal> will upgrade the package and install the new dependencies. Note that <literal>upgrade</literal> with this option will never remove packages, only allow adding new ones.  Configuration Item: <literal>APT::Get::Upgrade-Allow-New</literal>.
fr: Cette commande permet d'installer de nouveaux paquets lorsqu'elle est utilisée en conjonction avec la commande <literal>upgrade</literal>. C'est utile si la mise à jour d'un paquet installé exige l'installation de nouveaux paquets. Plutôt que de conserver le paquet, <literal>upgrade</literal> mettra à jour le paquet et installera les nouvelles dépendances. Remarquez que la commande <literal>upgrade</literal> avec cette option ne retirera jamais de paquets : elle ne permettra que l'ajout de nouveaux. Élément de configuration : <literal>APT::Get::Upgrade-Allow-New</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not upgrade packages; when used in conjunction with <literal>install</literal>, <literal>no-upgrade</literal> will prevent packages on the command line from being upgraded if they are already installed.  Configuration Item: <literal>APT::Get::Upgrade</literal>.
fr: Aucune mise à niveau ; quand elle est utilisée avec <literal>install</literal>, cette commande empêche les paquets mentionnés sur la ligne de commande d'être mis à niveau. Élément de configuration : <literal>APT::Get::Upgrade</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not install new packages; when used in conjunction with <literal>install</literal>, <literal>only-upgrade</literal> will install upgrades for already installed packages only and ignore requests to install new packages.  Configuration Item: <literal>APT::Get::Only-Upgrade</literal>.
fr: N'installe aucun nouveau paquet ; quand elle est utilisée avec <literal>install</literal>, <literal>only-upgrade</literal> ne met à jour que les paquets installés sans en installer de nouveaux. Élément de configuration : <literal>APT::Get::Only-Upgrade</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is a dangerous option that will cause apt to continue without prompting if it is doing downgrades. It should not be used except in very special situations. Using it can potentially destroy your system! Configuration Item: <literal>APT::Get::allow-downgrades</literal>. Introduced in APT 1.1.
fr: Cette option est dangereuse parce qu'elle laisse APT continuer sans poser de questions quand il réalise un retour en arrière. Elle ne doit être utilisée que dans des circonstances très spéciales. L'utiliser peut éventuellement détruire le système ! Élément de configuration : <literal>APT::Get::allow-downgrades</literal>. Introduite dans APT 1.1

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Force yes; this is a dangerous option that will cause apt to continue without prompting if it is removing essentials. It should not be used except in very special situations. Using it can potentially destroy your system! Configuration Item: <literal>APT::Get::allow-remove-essential</literal>. Introduced in APT 1.1.
fr: Forcer l'acceptation ; cette option est dangereuse parce qu'elle laisse APT continuer sans poser de questions quand il supprime des paquets essentiels. Cette option ne doit être utilisée que dans des circonstances très spéciales. L'utiliser peut éventuellement détruire le système ! Élément de configuration : <literal>APT::Get::allow-remove-essential</literal>. Introduite dans APT 1.1.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Force yes; this is a dangerous option that will cause apt to continue without prompting if it is changing held packages. It should not be used except in very special situations. Using it can potentially destroy your system! Configuration Item: <literal>APT::Get::allow-change-held-packages</literal>. Introduced in APT 1.1.
fr: Forcer l'acceptation ; cette option est dangereuse parce qu'elle laisse APT continuer sans poser de questions quand il modifie des paquets retenus. (« hold »). Cette option ne doit être utilisée que dans des circonstances très spéciales. L'utiliser peut éventuellement détruire le système ! Élément de configuration : <literal>APT::Get::allow-change-held-packages</literal>. Introduite dans APT 1.1.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Force yes; this is a dangerous option that will cause apt to continue without prompting if it is doing something potentially harmful. It should not be used except in very special situations. Using <literal>force-yes</literal> can potentially destroy your system! Configuration Item: <literal>APT::Get::force-yes</literal>. This is deprecated and replaced by <option>--allow-unauthenticated</option> , <option>--allow-downgrades</option> , <option>--allow-remove-essential</option> , <option>--allow-change-held-packages</option> in 1.1.
fr: Forcer l'acceptation ; cette option est dangereuse parce qu'elle laisse APT continuer sans poser de questions quand il réalise quelque chose de potentiellement dommageable. Cette option ne doit être utilisée que dans des circonstances très spéciales. Utiliser <literal>force-yes</literal> peut éventuellement détruire le système ! Élément de configuration : <literal>APT::Get::force-yes</literal>. Cette option est obsolète et remplacée par <option>--allow-unauthenticated</option>, <option>--allow-downgrades</option>, <option>--allow-remove-essential</option> et <option>--allow-change-held-packages</option> dans APT 1.1.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Instead of fetching the files to install their URIs are printed. Each URI will have the path, the destination file name, the size and the expected MD5 hash. Note that the file name to write to will not always match the file name on the remote site! This also works with the <literal>source</literal> and <literal>update</literal> commands. When used with the <literal>update</literal> command the MD5 and size are not included, and it is up to the user to decompress any compressed files.  Configuration Item: <literal>APT::Get::Print-URIs</literal>.
fr: Au lieu de récupérer les paquets à installer, leurs URI sont affichées. Chaque URI a un chemin, un nom de fichier destination, une taille et une clé MD5 attendue. Veuillez noter que le nom de fichier à afficher ne correspond pas toujours au nom de fichier sur le site distant. Cette option fonctionne aussi avec la commande <literal>source</literal> et avec la commande <literal>update</literal>. Avec la commande <literal>update</literal>, la somme MD5 et la taille ne sont pas données et c'est à l'utilisateur de décompresser les fichiers compressés. Élément de configuration : <literal>APT::Get::Print-URIs</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Use purge instead of remove for anything that would be removed.  An asterisk ("*") will be displayed next to packages which are scheduled to be purged. <option>remove --purge</option> is equivalent to the <option>purge</option> command.  Configuration Item: <literal>APT::Get::Purge</literal>.
fr: Utiliser « purge » à la place de « remove » pour supprimer tout ce qui peut être supprimé. Un astérisque (*) sera accolé aux noms des paquets qui vont être purgés. <option>remove --purge</option> est équivalent à la commande <option>purge</option>. Élément de configuration : <literal>APT::Get::Purge</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Re-install packages that are already installed and at the newest version.  Configuration Item: <literal>APT::Get::ReInstall</literal>.
fr: Réinstaller les paquets déjà installés avec leur version la plus récente.  Élément de configuration : <literal>APT::Get::ReInstall</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option is on by default; use <literal>--no-list-cleanup</literal> to turn it off. When it is on, <command>apt-get</command> will automatically manage the contents of <filename>&statedir;/lists</filename> to ensure that obsolete files are erased.  The only reason to turn it off is if you frequently change your sources list.  Configuration Item: <literal>APT::Get::List-Cleanup</literal>.
fr: Cette option est activée par défaut ; utilisez <literal>--no-list-cleanup</literal> pour la désactiver. Quand elle est activée, <command>apt-get</command> gère automatiquement le contenu de <filename>&statedir;/lists</filename> afin d'assurer que les fichiers obsolètes soient effacés. La seule raison de la désactiver est une modification fréquente de la liste de sources. Élément de configuration : <literal>APT::Get::List-Cleanup</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option controls the default input to the policy engine; it creates a default pin at priority 990 using the specified release string.  This overrides the general settings in <filename>/etc/apt/preferences</filename>.  Specifically pinned packages are not affected by the value of this option. In short, this option lets you have simple control over which distribution packages will be retrieved from. Some common examples might be <option>-t '2.1*'</option>, <option>-t unstable</option> or <option>-t sid</option>.  Configuration Item: <literal>APT::Default-Release</literal>; see also the &apt-preferences; manual page.
fr: Cette option contrôle l'entrée par défaut pour les questions de distribution ; un épinglage (pin) par défaut dont la priorité vaut 990 est créée en utilisant la chaîne spécifiée. Le fichier des préférences peut annuler cette décision. En clair, cette option permet de contrôler simplement dans quelle distribution seront récupérés les paquets. Par exemple : <option>-t '2.1*'</option>, <option>-t unstable</option> ou <option>-t sid</option>. Élément de configuration : <literal>APT::Default-Release</literal>. Voyez aussi la page de manuel d'&apt-preferences;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only perform operations that are 'trivial'. Logically this can be considered related to <option>--assume-yes</option>; where <option>--assume-yes</option> will answer yes to any prompt, <option>--trivial-only</option> will answer no.  Configuration Item: <literal>APT::Get::Trivial-Only</literal>.
fr: Ne réalise que les opérations « triviales ». Logiquement ceci peut être considéré comme relatif à <option>--assume-yes</option>. Alors que <option>--assume-yes</option> répond oui à n'importe quelle question, <option>--trivial-only</option> répond non. Élément de configuration : <literal>APT::Get::Trivial-Only</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If any packages are to be removed apt-get immediately aborts without prompting.  Configuration Item: <literal>APT::Get::Remove</literal>.
fr: Arrêter immédiatement apt-get, sans poser de questions, si des paquets doivent être supprimés. Élément de configuration : <literal>APT::Get::Remove</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If the command is either <literal>install</literal> or <literal>remove</literal>, then this option acts like running the <literal>autoremove</literal> command, removing unused dependency packages. Configuration Item: <literal>APT::Get::AutomaticRemove</literal>.
fr: Si la commande utilisée est soit <literal>install</literal> soit <literal>remove</literal>, cette option a le même effet qu'<literal>autoremove</literal> et supprime les paquets de dépendance inutilisés. Élément de configuration : <literal>APT::Get::Upgrade</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only has meaning for the <literal>source</literal> and <literal>build-dep</literal> commands.  Indicates that the given source names are not to be mapped through the binary table.  This means that if this option is specified, these commands will only accept source package names as arguments, rather than accepting binary package names and looking up the corresponding source package.  Configuration Item: <literal>APT::Get::Only-Source</literal>.
fr: Cette option n'a de sens qu'avec les commandes <literal>source</literal> et <literal>build-dep</literal>. Elle indique que les noms de sources donnés ne doivent pas être repérés à travers le tableau des binaires. Cela signifie que si cette option est choisie, la commande <literal>source</literal> acceptera seulement des noms de paquets source comme argument ; elle n'acceptera pas de les rechercher à partir des noms de paquets binaires correspondants. Élément de configuration : <literal>APT::Get::Only-Source</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Download only the diff, dsc, or tar file of a source archive.  Configuration Item: <literal>APT::Get::Diff-Only</literal>, <literal>APT::Get::Dsc-Only</literal>, and <literal>APT::Get::Tar-Only</literal>.
fr: Ne télécharger que le fichier .diff, .dsc ou .tar d'une archive source. Élément de configuration : <literal>APT::Get::Diff-Only</literal>, <literal>APT::Get::Dsc-Only</literal> et <literal>APT::Get::Tar-Only</literal>,

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only process architecture-dependent build-dependencies.  Configuration Item: <literal>APT::Get::Arch-Only</literal>.
fr: Ne traiter que les dépendances de construction dépendantes de l'architecture. Élément de configuration : <literal>APT::Get::Arch-Only</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only process architecture-independent build-dependencies.  Configuration Item: <literal>APT::Get::Indep-Only</literal>.
fr: Ne traiter que les dépendances de construction indépendantes de l'architecture. Élément de configuration : <literal>APT::Get::Indep-Only</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Ignore if packages can't be authenticated and don't prompt about it.  This can be useful while working with local repositories, but is a huge security risk if data authenticity isn't ensured in another way by the user itself.  The usage of the <option>Trusted</option> option for &sources-list; entries should usually be preferred over this global override.  Configuration Item: <literal>APT::Get::AllowUnauthenticated</literal>.
fr: Ignorer le fait que les paquets ne peuvent pas être authentifiés ; ne le signale pas à l'utilisateur. Cette option peut être utile si on travaille avec des dépôts locaux, mais cela représente un risque considérable si l'authenticité des données n'est pas assurée d'une autre manière par l'utilisateur lui-même. L'utilisation de l'option <option>Trusted</option> pour les entrées de &sources-list; devrait être habituellement préférée à ce remplacement global. Élément de configuration : <literal>APT::Get::AllowUnauthenticated</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allow the update command to continue downloading data from a repository which changed its information of the release contained in the repository indicating e.g a new major release.  APT will fail at the update command for such repositories until the change is confirmed to ensure the user is prepared for the change.  See also &apt-secure; for details on the concept and configuration.
fr: Permettre à la commande update de poursuivre le téléchargement de données à partir d'un dépôt qui a modifié ses informations sur la version contenue dans le dépôt indiquant par exemple une nouvelle version majeure. APT échouera à l'exécution de la commande update pour ces dépôts jusqu'à ce que la modification soit confirmée pour s'assurer que l'utilisateur est préparé à ce changement. Voir aussi &apt-secure; pour plus de détails sur le concept et la configuration.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Specialist options (<literal>--allow-releaseinfo-change-</literal><replaceable>field</replaceable>)  exist to allow changes only for certain fields like <literal>origin</literal>, <literal>label</literal>, <literal>codename</literal>, <literal>suite</literal>, <literal>version</literal> and <literal>defaultpin</literal>. See also &apt-preferences;.  Configuration Item: <literal>Acquire::AllowReleaseInfoChange</literal>.
fr: Des options spécialisées (<literal>--allow-releaseinfo-change-</literal> <replaceable>champ</replaceable>) existent pour permettre des modifications uniquement pour certains champs tels que <literal>origin</literal>, <literal>label</literal>, <literal>codename</literal>, <literal>suite</literal>, <literal>version</literal> et <literal>defaultpin</literal>. Voir aussi &apt-preferences;. Élément de configuration : <literal>Acquire::AllowReleaseInfoChange</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show user friendly progress information in the terminal window when packages are installed, upgraded or removed. For a machine parsable version of this data see README.progress-reporting in the apt doc directory.  Configuration Items: <literal>Dpkg::Progress</literal> and <literal>Dpkg::Progress-Fancy</literal>.
fr: Cette commande montre les informations de progression conviviales dans la fenêtre du terminal quand des paquets sont installés, mis à jour ou supprimés. Pour une version exploitable par une machine de ces données, voir README.progress-reporting dans le répertoire doc de apt. Élément de configuration : <literal>Dpkg::Progress</literal> et <literal>Dpkg::Progress-Fancy</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Adds the given file as a source for metadata. Can be repeated to add multiple files.  See <option>--with-source</option> description in &apt-cache; for further details.
fr: Ajoute le fichier donné comme source de méta-données. La commande peut être répétée pour ajouter de multiples fichiers. Voir la description de l'option <option>--with-source</option> dans &apt-cache; pour plus de détails.

note: type: Content of: <refentry><refsect1><title>
en: Files
fr: Fichiers

note: type: Content of: <refentry><refsect1><para>
en: &apt-cache;, &apt-cdrom;, &dpkg;, &sources-list;, &apt-conf;, &apt-patterns;, &apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, &apt-preferences;, the APT Howto.
fr: &apt-cache;, &apt-cdrom;, &dpkg;, &sources-list;, &apt-conf;, &apt-patterns;, &apt-config;, &apt-secure;, le guide d'APT dans &guidesdir;, &apt-preferences;, le « HOWTO » d'APT.

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-get</command> returns zero on normal operation, decimal 100 on error.
fr: <command>apt-get</command> renvoie zéro après une opération normale, le décimal 100 en cas d'erreur.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: query the APT cache
fr: recherche dans le cache d'APT

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-cache</command> performs a variety of operations on APT's package cache. <command>apt-cache</command> does not manipulate the state of the system but does provide operations to search and generate interesting output from the package metadata. The metadata is acquired and updated via the 'update' command of e.g. <command>apt-get</command>, so that it can be outdated if the last update is too long ago, but in exchange <command>apt-cache</command> works independently of the availability of the configured sources (e.g. offline).
fr: <command>apt-cache</command> réalise différentes opérations sur le cache de paquet d'APT. <command>apt-cache</command> ne manipule pas l'état du système mais fournit des moyens de recherche dans les métadonnées d'un paquet desquelles il extrait les informations intéressantes. Les métadonnées sont obtenues et mises à jour avec la commande update d'<command>apt-get</command> par exemple, et peuvent donc être périmées si la dernière mise à jour est trop ancienne, mais en contrepartie <command>apt-cache</command> fonctionne indépendamment de la disponibilité des sources configurées (par exemple hors ligne).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>gencaches</literal> creates APT's package cache. This is done implicitly by all commands needing this cache if it is missing or outdated.
fr: <literal>gencaches</literal> crée le cache d'APT. Cette action est faite implicitement par toute commande qui a besoin de ce cache s'il est manquant ou obsolète.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>showpkg</literal> displays information about the packages listed on the command line. Remaining arguments are package names. The available versions and reverse dependencies of each package listed are listed, as well as forward dependencies for each version. Forward (normal)  dependencies are those packages upon which the package in question depends; reverse dependencies are those packages that depend upon the package in question. Thus, forward dependencies must be satisfied for a package, but reverse dependencies need not be.  For instance, <command>apt-cache showpkg libreadline2</command> would produce output similar to the following:
fr: La commande <literal>showpkg</literal> affiche des informations sur les paquets donnés en argument. Les arguments restants sont les noms de paquets. Les versions disponibles et les dépendances inverses de chaque paquet répertorié sont listées, ainsi que les dépendances normales pour chaque version. Les dépendances normales d'un paquet sont constituées par les paquets dont il dépend ; les dépendances inverses sont les paquets qui dépendent du paquet en question. Les dépendances normales doivent donc être satisfaites et les dépendances inverses n'ont pas besoin de l'être. Ainsi, la commande <command>apt-cache showpkg libreadline2</command> donnera ce résultat :

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and ncurses3.0 which must be installed for libreadline2 to work.  In turn, libreadlineg2 and libreadline2-altdev depend on libreadline2. If libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be installed; libreadlineg2 and libreadline2-altdev do not have to be installed. For the specific meaning of the remainder of the output it is best to consult the apt source code.
fr: On peut voir que libreadline2, version 2.1-12, dépend de libc5 et ncurses3.0 ; ces paquets doivent être installés au préalable pour que libreadline2 fonctionne. À leur tour, libreadlineg2 et libreadline2-altdev dépendent de libreadline2. Si libreadline2 est installé, libc5 et ncurses3.0 doivent être installés ; libreadlineg2 et libreadline2-altdev n'ont pas à l'être. Pour connaître le sens de la fin de chaîne, il est préférable de consulter le code source d'APT.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>stats</literal> displays some statistics about the cache.  No further arguments are expected. Statistics reported are:
fr: La commande <literal>stats</literal> affiche des statistiques à propos du cache. Aucun autre argument n'est attendu. Voici les informations rapportées :

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Total package names</literal> is the number of package names found in the cache.
fr: <literal>Total package names</literal> est le nombre de paquets trouvés dans le cache.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Normal packages</literal> is the number of regular, ordinary package names; these are packages that bear a one-to-one correspondence between their names and the names used by other packages for them in dependencies. The majority of packages fall into this category.
fr: <literal>Normal packages</literal> est le nombre de paquets simples, ordinaires ; ces paquets tolèrent une correspondance bijective entre leur nom et le nom utilisé par les autres paquets pour les qualifier comme dépendance. La majorité des paquets appartient à cette catégorie.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Pure virtual packages</literal> is the number of packages that exist only as a virtual package name; that is, packages only "provide" the virtual package name, and no package actually uses the name. For instance, "mail-transport-agent" in the Debian system is a pure virtual package; several packages provide "mail-transport-agent", but there is no package named "mail-transport-agent".
fr: <literal>Pure virtual packages</literal> est le nombre de paquets qui n'existent que sous la forme d'un nom représentant un paquet virtuel ; ces paquets « fournissent » seulement un nom de paquet virtuel et aucun paquet n'utilise véritablement ce nom. Par exemple, au sein du système Debian GNU/Linux, le nom « mail-transport-agent » est un paquet virtuel pur ; plusieurs paquets peuvent « fournir » ce nom « mail-transport-agent », mais il n'existe aucun paquet nommé « mail-transport-agent ».

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Single virtual packages</literal> is the number of packages with only one package providing a particular virtual package. For example, in the Debian system, "X11-text-viewer" is a virtual package, but only one package, xless, provides "X11-text-viewer".
fr: <literal>Single virtual packages</literal> est le nombre de paquets virtuels qui ne peuvent être remplis que par un seul paquet. Par exemple, au sein du système Debian, « X11-text-viewer » est un paquet virtuel ; seul le paquet « xless » remplit « X11-text-viewer ».

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Mixed virtual packages</literal> is the number of packages that either provide a particular virtual package or have the virtual package name as the package name. For instance, in the Debian system, "debconf" is both an actual package, and provided by the debconf-tiny package.
fr: <literal>Mixed virtual packages</literal> est le nombre de paquets qui remplissent un paquet virtuel particulier ou dont le nom est un nom de paquet virtuel. Par exemple, au sein du système Debian, « debconf » est un paquet réel et il est aussi fourni par « debconf-tiny ».

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Missing</literal> is the number of package names that were referenced in a dependency but were not provided by any package. Missing packages may be an evidence if a full distribution is not accessed, or if a package (real or virtual) has been dropped from the distribution. Usually they are referenced from Conflicts or Breaks statements.
fr: <literal>Missing</literal> est le nombre de paquets référencés dans une dépendance mais qui ne sont fournis par aucun paquet. Les paquets manquants peuvent être mis en évidence quand on n'accède pas à une distribution complète ou si un paquet (réel ou virtuel) a été sorti d'une distribution. Habituellement on les trouve dans les champs « Conflicts » ou « Breaks ».

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Total distinct</literal> versions is the number of package versions found in the cache. If more than one distribution is being accessed (for instance, "stable" and "unstable"), this value can be considerably larger than the number of total package names.
fr: <literal>Total distinct</literal> versions est le nombre de versions de paquets trouvées dans le cache. Quand on accède à plus d'une distribution (« stable » et « unstable », par exemple), cette valeur peut être considérablement plus grande que le nombre total de paquets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
en: <literal>Total dependencies</literal> is the number of dependency relationships claimed by all of the packages in the cache.
fr: <literal>Total dependencies</literal> est le nombre de relations de dépendances déclarées par tous les paquets présents dans le cache.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>showsrc</literal> displays all the source package records that match the given package names. All versions are shown, as well as all records that declare the name to be a binary package. Use <option>--only-source</option> to display only source package names.
fr: <literal>showsrc</literal> affiche toutes les entrées de paquets source qui correspondent aux noms donnés. Toutes les versions sont affichées et toutes les entrées qui déclarent que ces noms correspondent à des paquets binaires. Utilisez l'option <option>--only-source</option> pour n'afficher que le nom des paquets source.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>dump</literal> shows a short listing of every package in the cache. It is primarily for debugging.
fr: La commande <literal>dump</literal> affiche un court résumé sur chaque paquet du cache. Elle est d'abord destinée au débogage.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>dumpavail</literal> prints out an available list to stdout. This is suitable for use with &dpkg; and is used by the &dselect; method.
fr: La commande <literal>dumpavail</literal> affiche sur la sortie standard la liste des paquets disponibles. Elle convient à une utilisation avec &dpkg; et la méthode &dselect; s'en sert.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>unmet</literal> displays a summary of all unmet dependencies in the package cache.
fr: La commande <literal>unmet</literal> affiche un résumé concernant toutes les dépendances absentes dans le cache de paquets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>show</literal> performs a function similar to <command>dpkg --print-avail</command>; it displays the package records for the named packages.
fr: La commande <literal>show</literal> est semblable à <command>dpkg --print-avail</command> ; elle affiche des informations sur les paquets donnés en argument.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>search</literal> performs a full text search on all available package lists for the POSIX regex pattern given, see &regex;.  It searches the package names and the descriptions for an occurrence of the regular expression and prints out the package name and the short description, including virtual package names.  If <option>--full</option> is given then output identical to <literal>show</literal> is produced for each matched package, and if <option>--names-only</option> is given then the long description is not searched, only the package name and provided packages are.
fr: La commande <literal>search</literal> recherche l'expression rationnelle POSIX donnée en paramètre sur tous les paquets disponibles, voir &regex;. Elle cherche une occurrence de la chaîne dans les noms de paquets et dans les descriptions puis elle affiche le nom du paquet et sa description courte. Quand l'option <option>--full</option> est fournie, la sortie est identique à <literal>show</literal> pour chaque paquet ; quand l'option <option>--names-only</option> est fournie, la recherche ne porte pas sur les descriptions longues, mais seulement sur les noms de paquets et les paquets fournis.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Separate arguments can be used to specify multiple search patterns that are and'ed together.
fr: On peut utiliser des arguments distincts pour indiquer des expressions rationnelles différentes sur lesquelles seront réalisées un « et » logique.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>depends</literal> shows a listing of each dependency a package has and all the possible other packages that can fulfill that dependency.
fr: La commande <literal>depends</literal> affiche la liste de toutes les dépendances d'un paquet et la liste de tous les paquets possibles qui satisfont ces dépendances.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>rdepends</literal> shows a listing of each reverse dependency a package has.
fr: La commande <literal>rdepends</literal> affiche la liste de toutes les dépendances inverses d'un paquet.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This command prints the name of each package APT knows. The optional argument is a prefix match to filter the name list. The output is suitable for use in a shell tab complete function and the output is generated extremely quickly. This command is best used with the <option>--generate</option> option.
fr: Cette commande affiche le nom de chaque paquet connu par APT. Un préfixe pour filtrer la liste des noms peut être donné en paramètre. La sortie est adaptée à une utilisation au sein d'une fonction complète de shell ; elle est produite très rapidement. On utilise au mieux cette commande avec l'option <option>--generate</option>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note that a package which APT knows of is not necessarily available to download, installable or installed, e.g. virtual packages are also listed in the generated list.
fr: Veuillez noter qu'un paquet connu par APT n'est pas forcément disponible, installable ou installé. Par exemple, les paquets virtuels sont également affichés dans la liste créée.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>dotty</literal> takes a list of packages on the command line and generates output suitable for use by dotty from the <ulink url="https://graphviz.org/">GraphViz</ulink> package. The result will be a set of nodes and edges representing the relationships between the packages. By default the given packages will trace out all dependent packages; this can produce a very large graph.  To limit the output to only the packages listed on the command line, set the <literal>APT::Cache::GivenOnly</literal> option.
fr: La commande <literal>dotty</literal> prend une liste de paquets sur la ligne de commande et affiche une sortie appropriée à une utilisation par la commande dotty du paquet <ulink url="https://graphviz.org/">GraphViz</ulink>. Il en résulte un ensemble de nœuds et d'arcs représentant les relations entre les paquets. Par défaut les paquets donnés en argument suivent toutes leurs dépendances, ce qui peut produire un graphe très volumineux. Pour limiter la sortie aux seuls paquets listés sur la ligne de commande, positionnez l'option <literal>APT::Cache::GivenOnly</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The resulting nodes will have several shapes; normal packages are boxes, pure virtual packages are triangles, mixed virtual packages are diamonds, missing packages are hexagons. Orange boxes mean recursion was stopped (leaf packages), blue lines are pre-depends, green lines are conflicts.
fr: Les noeuds résultants ont plusieurs formes ; les paquets normaux sont des boîtes, les « provides » purs sont des triangles, les « provides » mixtes sont des diamants et les paquets manquants sont des hexagones. Les boîtes oranges expriment un arrêt de la récursivité [paquet feuille], les lignes bleues représentent des prédépendances et les lignes vertes représentent des conflits.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Caution, dotty cannot graph larger sets of packages.
fr: Attention, dotty ne peut pas représenter des ensembles très grands de paquets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The same as <literal>dotty</literal>, only for xvcg from the <ulink url="https://www.rw.cdl.uni-saarland.de/people/sander/private/html/gsvcg1.html">VCG tool</ulink>.
fr: Identique à <literal>dotty</literal>, mais réservé à xvcg fourni avec <ulink url="https://www.rw.cdl.uni-saarland.de/people/sander/private/html/gsvcg1.html">VCG tool</ulink>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>policy</literal> is meant to help debug issues relating to the preferences file. With no arguments it will print out the priorities of each source. Otherwise it prints out detailed information about the priority selection of the named package.
fr: <literal>policy</literal> sert à déboguer des problèmes relatifs au fichier des préférences. Sans argument, la commande affiche la priorité de chaque source. Sinon, elle affiche des informations précises sur la priorité du paquet donné en argument.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>apt-cache</literal>'s <literal>madison</literal> command attempts to mimic the output format and a subset of the functionality of the Debian archive management tool, <literal>madison</literal>.  It displays available versions of a package in a tabular format.  Unlike the original <literal>madison</literal>, it can only display information for the architecture for which APT has retrieved package lists (<literal>APT::Architecture</literal>).
fr: La commande <literal>madison</literal> d'<literal>apt-cache</literal> cherche à mimer le format de sortie propre à l'outil debian de gestion d'archives, <literal>madison</literal>, ainsi qu'une partie de ses fonctionnalités. Elle affiche les versions disponibles d'un paquet dans un tableau. Contrairement au programme original <literal>madison</literal>, elle n'affiche que des informations concernant l'architecture pour laquelle Apt a lu la liste des paquets disponibles (<literal>APT::Architecture</literal>).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Select the file to store the package cache. The package cache is the primary cache used by all operations.  Configuration Item: <literal>Dir::Cache::pkgcache</literal>.
fr: Indique le fichier servant de cache des paquets. Le cache des paquets est le cache primaire utilisé par toutes les opérations. Élément de configuration : <literal>Dir::Cache::pkgcache</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Select the file to store the source cache. The source is used only by <literal>gencaches</literal> and it stores a parsed version of the package information from remote sources. When building the package cache the source cache is used to avoid reparsing all of the package files.  Configuration Item: <literal>Dir::Cache::srcpkgcache</literal>.
fr: Indique le fichier servant de cache des sources. Ce cache n'est utilisé que par <literal>gencaches</literal> ; une version des informations sur les paquets, issue d'une analyse de sources distantes, est conservée. Quand le cache des paquets est créé, le cache des sources est utilisé afin d'éviter d'analyser à nouveau tous les paquets. Élément de configuration : <literal>Dir::Cache::srcpkgcache</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Quiet; produces output suitable for logging, omitting progress indicators.  More q's will produce more quietness up to a maximum of 2. You can also use <option>-q=#</option> to set the quietness level, overriding the configuration file.  Configuration Item: <literal>quiet</literal>.
fr: Mode silencieux ; produit une sortie pertinente pour l'enregistrement dans un fichier-journal, sans afficher d'indicateur de progression. Un plus grand nombre de q produira un plus grand silence, avec un maximum de 2. Vous pouvez aussi utiliser <option>-q=#</option> pour positionner le niveau de silence, annulant le fichier de configuration. Élément de configuration : <literal>quiet</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print only important dependencies; for use with <literal>unmet</literal> and <literal>depends</literal>. Causes only Depends and Pre-Depends relations to be printed.  Configuration Item: <literal>APT::Cache::Important</literal>.
fr: N'affiche que les dépendances importantes ; à utiliser avec les commandes <literal>unmet</literal> et <literal>depends</literal> pour n'afficher que les relations Depends et Pre-Depends. Élément de configuration : <literal>APT::Cache::Important</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Per default the <command>depends</command> and <command>rdepends</command> print all dependencies. This can be tweaked with these flags which will omit the specified dependency type.  Configuration Item: <literal>APT::Cache::Show<replaceable>DependencyType</replaceable></literal> e.g. <literal>APT::Cache::ShowRecommends</literal>.
fr: Par défaut, <command>depends</command> et <command>rdepends</command> affichent toutes les dépendances. Ce comportement peut être modifié avec ces réglages qui omettront le type de dépendance indiqué. Élément de configuration : <literal>APT::Cache::Show<replaceable>TypeDépendance</replaceable></literal>, p. ex. <literal>APT::Cache::ShowRecommends</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Per default <command>depends</command> and <command>rdepends</command> print only dependencies explicitly expressed in the metadata. With this flag it will also show dependencies implicitly added based on the encountered data.  A <literal>Conflicts: foo</literal> e.g. expresses implicitly that this package also conflicts with the package foo from any other architecture.  Configuration Item: <literal>APT::Cache::ShowImplicit</literal>.
fr: Par défaut, <command>depends</command> et <command>rdepends</command> n'affichent que les dépendances indiquées explicitement dans les métadonnées. Avec ce marqueur, ils afficheront aussi les dépendances ajoutées de façon implicite basées sur les données rencontrées. Par exemple, un message <literal>Conflicts: foo</literal> exprime de façon implicite que ce paquet est aussi en conflit avec le paquet foo de n'importe quelle autre architecture. Élément de configuration : <literal>APT::Cache::ShowImplicit</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print full package records when searching.  Configuration Item: <literal>APT::Cache::ShowFull</literal>.
fr: Affiche la totalité des champs d'information sur le paquet lors d'une recherche. Élément de configuration : <literal>APT::Cache::ShowFull</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print full records for all available versions. This is the default; to turn it off, use <option>--no-all-versions</option>.  If <option>--no-all-versions</option> is specified, only the candidate version will be displayed (the one which would be selected for installation).  This option is only applicable to the <literal>show</literal> command.  Configuration Item: <literal>APT::Cache::AllVersions</literal>.
fr: Affiche la totalité des champs d'information pour toutes les versions disponibles : c'est la valeur par défaut. Pour la désactiver, utilisez l'option <option>--no-all-versions</option>. Quand l'option <option>--no-all-versions</option> est choisie, seuls les éléments de la version choisie (celle qui serait installée) seront affichés. Cette option concerne seulement la commande <literal>show</literal>. Élément de configuration : <literal>APT::Cache::AllVersions</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Perform automatic package cache regeneration, rather than use the cache as it is. This is the default; to turn it off, use <option>--no-generate</option>.  Configuration Item: <literal>APT::Cache::Generate</literal>.
fr: Réalise une mise à jour automatique du cache des paquets plutôt que de se servir du cache tel qu'il est. Pour désactiver cette option (option par défaut), utilisez l'option <option>--no-generate</option>. Élément de configuration : <literal>APT::Cache::Generate</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only search on the package and provided package names, not the long descriptions.  Configuration Item: <literal>APT::Cache::NamesOnly</literal>.
fr: N'effectue une recherche que sur les noms de paquets et de paquets fournis, pas sur les descriptions longues. Élément de configuration : <literal>APT::Cache::NamesOnly</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Make <literal>pkgnames</literal> print all names, including virtual packages and missing dependencies.  Configuration Item: <literal>APT::Cache::AllNames</literal>.
fr: Avec cette option, <literal>pkgnames</literal> affiche tous les noms, les noms des paquets virtuels et les dépendances manquantes. Élément de configuration : <literal>APT::Cache::AllNames</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Make <literal>depends</literal> and <literal>rdepends</literal> recursive so that all packages mentioned are printed once.  Configuration Item: <literal>APT::Cache::RecurseDepends</literal>.
fr: Avec cette option, <literal>depends</literal> et <literal>rdepends</literal> sont récursives de manière à n'afficher qu'une seule fois les paquets mentionnés. Élément de configuration : <literal>APT::Cache::RecurseDepends</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Limit the output of <literal>depends</literal> and <literal>rdepends</literal> to packages which are currently installed.  Configuration Item: <literal>APT::Cache::Installed</literal>.
fr: Cette option limite la sortie de <literal>depends</literal> et de <literal>rdepends</literal> aux paquets qui sont actuellement installés. Élément de configuration : <literal>APT::Cache::Installed</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Adds the given file as a source for metadata. Can be repeated to add multiple files.  Supported are currently <literal>*.deb</literal>, <literal>*.dsc</literal>, <literal>*.changes</literal>, <literal>Sources</literal> and <literal>Packages</literal> files as well as source package directories.  Files are matched based on their name only, not their content!
fr: Ajoute le fichier donné comme source de métadonnées. La commande peut être répétée pour ajouter de multiples fichiers. Actuellement, les fichiers<literal>*.deb</literal>, <literal>*.dsc</literal>, <literal>*.changes</literal>, <literal>Sources</literal> et <literal>Packages</literal>, aussi bien que les répertoires de paquets source sont pris en charge. Les correspondances de fichier sont basées sur leur nom seulement et non sur leur contenu !

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>Sources</literal> and <literal>Packages</literal> can be compressed in any format apt supports as long as they have the correct extension. If you need to store multiple of these files in one directory you can prefix a name of your choice with the last character being an underscore ("<literal>_</literal>"). Example: my.example_Packages.xz
fr: Les <literal>Sources</literal> et <literal>Packages</literal> peuvent être compressés dans n'importe quel format qu'APT prend en charge à condition qu'ils portent la bonne extension. Si vous avez besoin de stocker plusieurs de ces fichiers dans un seul répertoire, vous pouvez ajouter comme préfixe le nom que vous voulez pourvu que le dernier caractère soit un tiret bas (« <literal>_</literal> »). Exemple : mon.exemple_Packages.xz

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note that these sources are treated as trusted (see &apt-secure;).  Configuration Item: <literal>APT::Sources::With</literal>.
fr: Veuillez noter que ces sources sont traitées comme fiables (voir &apt-secure;). Élément de configuration : <literal>APT::Sources::With</literal>.

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-cache</command> returns zero on normal operation, decimal 100 on error.
fr: <command>apt-cache</command> retourne zéro après un déroulement normal et le nombre décimal 100 en cas d'erreur.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: show, set and unset various settings for a package
fr: affiche, définit ou redéfinit divers paramètres d'un paquet

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-mark</command> can be used as a unified front-end to set various settings for a package, such as marking a package as being automatically/manually installed or changing <command>dpkg</command> selections such as hold, install, deinstall and purge which are respected e.g. by <command>apt-get dselect-upgrade</command> or <command>aptitude</command>.
fr: La commande <command>apt-mark</command> peut être utilisée comme interface unique pour diverses configurations d'un paquet, par exemple pour le marquer comme installé automatiquement ou manuellement, ou pour modifier les sélections de <command>dpkg</command> telles que <option>hold</option> <option>install</option> <option>deinstall</option> et <option>purge</option> qui sont suivies par exemple par les commandes <command>apt-get dselect-upgrade</command> ou <command>aptitude</command>.

note: type: Content of: <refentry><refsect1><title>
en: Automatically and Manually Installed Packages
fr: Paquets installés automatiquement et manuellement

note: type: Content of: <refentry><refsect1><para>
en: When you request that a package is installed, and as a result other packages are installed to satisfy its dependencies, the dependencies are marked as being automatically installed, while the package you installed explicitly is marked as manually installed.  Once an automatically installed package is no longer depended on by any manually installed package it is considered no longer needed and e.g. <command>apt-get</command> or <command>aptitude</command> will at least suggest removing them.
fr: Lorsque l'installation d'un paquet est demandée et que par voie de dépendances d'autres paquets sont installés, ces paquets sont marqués comme ayant été automatiquement installés, tandis que le paquet que vous avez installé explicitement est marqué comme manuellement installé. Une fois que ces paquets automatiquement installés ne sont plus liés à un paquet installé manuellement, ils ne seront plus considérés comme nécessaires et <command>apt-get</command> ou <command>aptitude</command>, par exemple, proposeront au moins de les supprimer.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>auto</literal> is used to mark a package as being automatically installed, which will cause the package to be removed when no more manually installed packages depend on this package.
fr: <literal>auto</literal> permet de marquer un paquet comme ayant été installé automatiquement. Un tel paquet sera supprimé automatiquement dès que plus aucun paquet installé manuellement ne dépend de lui.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>manual</literal> is used to mark a package as being manually installed, which will prevent the package from being automatically removed if no other packages depend on it.
fr: <literal>manual</literal> permet de marquer un paquet comme installé manuellement. Un tel paquet ne sera pas supprimé automatiquement, même si aucun autre paquet n'en dépend.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>minimize-manual</literal> is used to mark (transitive) dependencies of metapackages as automatically installed.  This can be used after an installation for example, to minimize the number of manually installed packages; or continuously on systems managed by system configuration metapackages.
fr: <literal>minimize-manual</literal> permet de marquer les dépendances (transitives) de métapaquets comme ayant été installées automatiquement. Cela peut être utilisé par exemple après une installation pour réduire le nombre de paquets installés manuellement, ou de façon permanente sur des systèmes gérés par des métapaquets de configuration système.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>showauto</literal> is used to print a list of automatically installed packages with each package on a new line.  All automatically installed packages will be listed if no package is given.  If packages are given only those which are automatically installed will be shown.
fr: <literal>showauto</literal>, affiche les paquets installés automatiquement, un paquet par ligne. Si aucun paramètre n'est indiqué, tous les paquets installés automatiquement seront affichés. Si des noms de paquets sont passés en paramètre, seuls ceux qui sont automatiquement installés seront affichés.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>showmanual</literal> can be used in the same way as <literal>showauto</literal> except that it will print a list of manually installed packages instead.
fr: <literal>showmanual</literal> peut être utilisé de manière analogue à <literal>showauto</literal> pour afficher la liste des paquets installés manuellement.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Read/Write package stats from the filename given with the parameter &synopsis-param-filename; instead of from the default location, which is <filename>extended_states</filename> in the directory defined by the Configuration Item: <literal>Dir::State</literal>.
fr: Lecture/écriture des statistiques d'un paquet dans &synopsis-param-filename; au lieu du fichier par défaut (<filename>extended_states</filename> dans le répertoire défini par l'élément de configuration <literal>Dir::State</literal>).

note: type: Content of: <refentry><refsect1><title>
en: Prevent Changes for a Package
fr: Empêcher les modifications d'un paquet

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>hold</literal> is used to mark a package as held back, which will prevent the package from being automatically installed, upgraded or removed.
fr: <literal>hold</literal> permet de marquer un paquet comme retenu, ce qui empêchera qu'il soit installé, mis à jour ou supprimé automatiquement.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>unhold</literal> is used to cancel a previously set hold on a package to allow all actions again.
fr: <literal>unhold</literal> est utilisé pour supprimer l'état « hold » (retenu) d'un paquet afin de permettre toute action qui y est liée.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>showhold</literal> is used to print a list of packages on hold in the same way as for the other show commands.
fr: <literal>showhold</literal> permet d'afficher la liste des paquets retenus de manière analogue aux commandes de même type.

note: type: Content of: <refentry><refsect1><title>
en: Schedule Packages for Install, Remove and Purge
fr: Programmer des paquets pour Install, Remove et Purge

note: type: Content of: <refentry><refsect1><para>
en: Some front-ends like <command>apt-get dselect-upgrade</command> can be used to apply previously scheduled changes to the install state of packages. Such changes can be scheduled with the <option>install</option>, <option>remove</option> (also known as <option>deinstall</option>) and <option>purge</option> commands.  Packages with a specific selection can be displayed with <option>showinstall</option>, <option>showremove</option> and <option>showpurge</option> respectively.  More information about these so called dpkg selections can be found in &dpkg;.
fr: Certains frontaux comme <command>apt-get dselect-upgrade</command> peuvent être utilisés pour appliquer des modifications, préalablement programmées, de l'état d'installation de paquets. Ces modifications peuvent être programmées avec les commandes <option>install</option>, <option>remove</option> (connue aussi sous le nom de <option>deinstall</option>) et <option>purge</option>. Les paquets faisant l'objet d'une sélection particulière peuvent être affichés respectivement avec les options <option>showinstall</option>, <option>showremove</option> et <option>showpurge</option>. Vous trouverez plus d'information sur ce que l'on appelle les sélections de dpkg dans &dpkg;.

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-mark</command> returns zero on normal operation, non-zero on error.
fr: <command>apt-mark</command> retourne zéro après un déroulement normal, et un autre chiffre en cas d'erreur.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Archive authentication support for APT
fr: Gestion de l'authentification d'archive avec APT

note: type: Content of: <refentry><refsect1><para>
en: Starting with version 0.6, <command>APT</command> contains code that does signature checking of the Release file for all repositories. This ensures that data like packages in the archive can't be modified by people who have no access to the Release file signing key. Starting with version 1.1 <command>APT</command> requires repositories to provide recent authentication information for unimpeded usage of the repository. Since version 1.5 changes in the information contained in the Release file about the repository need to be confirmed before APT continues to apply updates from this repository.
fr: Depuis sa version 0.6, <command>apt</command> sait vérifier la signature du fichier Release de chaque dépôt. On s'assure ainsi que les paquets dans l'archive ne peuvent pas être modifiés par quelqu'un qui ne possède pas la clé de la signature du fichier Release. À partir de la version 1.1, <command>apt</command> exige que les dépôts fournissent des informations récentes d'authentification pour une utilisation libre du dépôt. Depuis la version 1.5, les modifications dans les informations contenues dans le fichier Release sur le dépôt, doivent être confirmées avant qu'APT continue à appliquer les mises à jour depuis ce dépôt.

note: type: Content of: <refentry><refsect1><para>
en: Note: All APT-based package management front-ends like &apt-get;, &aptitude; and &synaptic; support this authentication feature, so this manpage uses <literal>APT</literal> to refer to them all for simplicity only.
fr: Attention : toutes les interfaces de gestion de paquets comme &apt-get;, &aptitude; et &synaptic; possèdent cette fonction de certification, aussi cette page de manuel utilise <literal>APT</literal> pour se référer à l'ensemble d'entre elles, pour des raisons de simplicité.

note: type: Content of: <refentry><refsect1><title>
en: User Configuration
fr: Configuration utilisateur

note: type: Content of: <refentry><refsect1><title>
en: Unsigned Repositories
fr: Dépôts non signés

note: type: Content of: <refentry><refsect1><para>
en: If an archive has an unsigned Release file or no Release file at all current APT versions will refuse to download data from them by default in <command>update</command> operations and even if forced to download front-ends like &apt-get; will require explicit confirmation if an installation request includes a package from such an unauthenticated archive.
fr: Si une archive possède un fichier Release non signé ou pas de fichier Release du tout, les versions actuelles d'APT refuseront par défaut d'en télécharger des données dans les opérations <command>update</command>. Même si un frontal tel que &apt-get; est forcé de télécharger, il demandera une confirmation explicite si une installation inclut un paquet d'une archive non authentifiée.

note: type: Content of: <refentry><refsect1><para>
en: You can force all APT clients to raise only warnings by setting the configuration option <option>Acquire::AllowInsecureRepositories</option> to <literal>true</literal>. Individual repositories can also be allowed to be insecure via the &sources-list; option <literal>allow-insecure=yes</literal>.  Note that insecure repositories are strongly discouraged and all options to force apt to continue supporting them will eventually be removed.  Users also have the <option>Trusted</option> option available to disable even the warnings, but be sure to understand the implications as detailed in &sources-list;.
fr: Vous pouvez contraindre les clients APT à n'émettre que des avertissements en configurant l'option <option>Acquire::AllowInsecureRepositories</option> à <literal>true</literal>. L'option <literal>allow-insecure=yes</literal> de &sources-list; peut aussi permettre à des dépôts individuels d'être non sécurisés. Veuillez noter que les dépôts non sécurisés sont fortement déconseillés et toutes les options pour contraindre APT à continuer à les prendre en charge devront être éventuellement supprimées. Les utilisateurs disposent aussi de l'option <option>Trusted</option> pour désactiver même les avertissements, mais il faut être sûr de comprendre ses implications détaillées dans &sources-list;.

note: type: Content of: <refentry><refsect1><para>
en: A repository which previously was authenticated but would loose this state in an <command>update</command> operation raises an error in all APT clients irrespective of the option to allow or forbid usage of insecure repositories.  The error can be overcome by additionally setting <option>Acquire::AllowDowngradeToInsecureRepositories</option> to <literal>true</literal> or for Individual repositories with the &sources-list; option <literal>allow-downgrade-to-insecure=yes</literal>.
fr: Un dépôt qui auparavant était authentifié, mais qui perdrait cet état lors d'une opération <command>update</command> envoie un message d'erreur à tous les clients d'APT quelle que soit l'option d'autoriser ou d'interdire l'utilisation de dépôts non sécurisés. L'erreur peut être contournée par le réglage supplémentaire de <option>Acquire::AllowDowngradeToInsecureRepositories</option> à <literal>true</literal>, ou, pour des dépôts individuels avec l'option <literal>allow-downgrade-to-insecure=yes</literal> de &sources-list;.

note: type: Content of: <refentry><refsect1><title>
en: Signed Repositories
fr: Dépôts signés

note: type: Content of: <refentry><refsect1><para>
en: The chain of trust from an APT archive to the end user is made up of several steps. <command>apt-secure</command> is the last step in this chain; trusting an archive does not mean that you trust its packages not to contain malicious code, but means that you trust the archive maintainer. It's the archive maintainer's responsibility to ensure that the archive's integrity is preserved.
fr: D'une archive APT jusqu'à l'utilisateur, la chaîne de confiance se construit en plusieurs étapes. <command>Apt-secure</command> est la dernière étape. Faire confiance à une archive ne signifie pas que les paquets qu'elle contient sont exempts de code malveillant, mais signifie que vous faites confiance au responsable de l'archive. C'est ensuite au responsable de l'archive de faire en sorte que l'archive soit fiable.

note: type: Content of: <refentry><refsect1><para>
en: apt-secure does not review signatures at a package level. If you require tools to do this you should look at <command>debsig-verify</command> and <command>debsign</command> (provided in the debsig-verify and devscripts packages respectively).
fr: <command>Apt-secure</command> n'examine pas la signature d'un paquet. Certains programmes peuvent le faire comme <command>debsig-verify</command> ou <command>debsign</command>, qu'on peut trouver dans les paquets debsig-verify et devscripts.

note: type: Content of: <refentry><refsect1><para>
en: The chain of trust in Debian starts (e.g.) when a maintainer uploads a new package or a new version of a package to the Debian archive. In order to become effective, this upload needs to be signed by a key contained in one of the Debian package maintainer keyrings (available in the debian-keyring package). Maintainers' keys are signed by other maintainers following pre-established procedures to ensure the identity of the key holder. Similar procedures exist in all Debian-based distributions.
fr: La chaîne de confiance dans Debian commence, par exemple, quand un responsable de paquet envoie un nouveau paquet ou une nouvelle version d'un paquet dans l'archive. Cet envoi, pour être effectif, doit être signé avec la clé d'un responsable qui se trouve dans un des trousseaux des responsables de paquet Debian (disponibles dans le paquet debian-keyring). Les clés des responsables de paquet sont signées par d'autres responsables, suivant des procédures préétablies pour s'assurer de l'identité des propriétaires de la clé. Des procédures similaires existent dans toutes les distributions basées sur Debian.

note: type: Content of: <refentry><refsect1><para>
en: Once the uploaded package is verified and included in the archive, the maintainer signature is stripped off, and checksums of the package are computed and put in the Packages file. The checksums of all of the Packages files are then computed and put into the Release file. The Release file is then signed by the archive key for this &keyring-distro; release, and distributed alongside the packages and the Packages files on &keyring-distro; mirrors. The keys are in the &keyring-distro; archive keyring available in the &keyring-package; package.
fr: Une fois que le paquet envoyé a été vérifié et inclus dans l'archive, la signature du responsable est enlevée, une somme de contrôle du paquet est calculée et mise dans le fichier Packages. Une somme de contrôle de tous les paquets est ensuite calculée et mise dans le fichier Release. Ce fichier est signé par la clé de l'archive pour la version courante de la distribution et distribuée en même temps que les paquets et les fichiers Packages sur les miroirs. Les clés sont dans le trousseau de clés de l'archive fournies par le paquet &keyring-package;.

note: type: Content of: <refentry><refsect1><para>
en: End users can check the signature of the Release file, extract a checksum of a package from it and compare it with the checksum of the package they downloaded by hand - or rely on APT doing this automatically.
fr: Un utilisateur peut consulter la signature du fichier Release, extraire la somme de contrôle d'un paquet et la comparer avec la somme du paquet qu'il a téléchargé, ou tout simplement compter sur APT pour faire ces opérations automatiquement.

note: type: Content of: <refentry><refsect1><para>
en: Notice that this is distinct from checking signatures on a per package basis. It is designed to prevent two possible attacks:
fr: Cette façon de faire est différente d'une vérification de la signature d'un paquet. Elle vise à empêcher deux types d'attaque possibles :

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <literal>Network "man in the middle" attacks</literal>. Without signature checking, malicious agents can introduce themselves into the package download process and provide malicious software either by controlling a network element (router, switch, etc.) or by redirecting traffic to a rogue server (through ARP or DNS spoofing attacks).
fr: <literal>Attaque réseau de type « homme au milieu »</literal>. Sans vérification de signature, quelqu'un de malveillant peut s'introduire au milieu du processus de téléchargement et insérer du code soit en contrôlant un élément du réseau, routeur, commutateur, etc. soit en détournant le trafic vers un serveur fourbe (par usurpation d'adresses).

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <literal>Mirror network compromise</literal>.  Without signature checking, a malicious agent can compromise a mirror host and modify the files in it to propagate malicious software to all users downloading packages from that host.
fr: <literal>Attaque par compromission d'un miroir sur le réseau</literal>. Sans vérification de signature, quelqu'un de malveillant peut compromettre un miroir et modifier les fichiers. Ainsi tous ceux qui téléchargent les paquets de ce miroir propagent du code malveillant.

note: type: Content of: <refentry><refsect1><para>
en: However, it does not defend against a compromise of the master server itself (which signs the packages) or against a compromise of the key used to sign the Release files. In any case, this mechanism can complement a per-package signature.
fr: Cependant cette méthode ne protège pas contre une compromission du serveur principal lui-même (qui signe les paquets) ni contre la compromission de la clé qui sert à signer les fichiers Release. Mais elle peut compléter la signature des paquets.

note: type: Content of: <refentry><refsect1><title>
en: Information changes
fr: Modifications des informations

note: type: Content of: <refentry><refsect1><para>
en: A Release file contains beside the checksums for the files in the repository also general information about the repository like the origin, codename or version number of the release.
fr: Le fichier Release renferme, en plus des sommes de contrôle pour les fichiers du dépôt, des informations générales sur le dépôt comme l'origine, le nom de code ou le numéro de la version.

note: type: Content of: <refentry><refsect1><para>
en: This information is shown in various places so a repository owner should always ensure correctness. Further more user configuration like &apt-preferences; can depend and make use of this information. Since version 1.5 the user must therefore explicitly confirm changes to signal that the user is sufficiently prepared e.g. for the new major release of the distribution shipped in the repository (as e.g. indicated by the codename).
fr: Ces informations apparaissent à plusieurs endroits, aussi, le propriétaire d'un dépôt devrait toujours s'assurer de leur exactitude. Par ailleurs, les configurations de l'utilisateur, comme &apt-preferences;, peuvent dépendre de ces informations et les utiliser. Depuis la version 1.5, l'utilisateur doit par conséquent confirmer de façon explicite les modifications pour signaler qu'il est suffisamment préparé, par exemple, pour la nouvelle version majeure de la distribution fournie dans le dépôt (comme indiqué par exemple par le nom de code).

note: type: Content of: <refentry><refsect1><title>
en: Repository Configuration
fr: Configuration du dépôt

note: type: Content of: <refentry><refsect1><para>
en: If you want to provide archive signatures in an archive under your maintenance you have to:
fr: Si vous voulez signer les archives dont vous avez la responsabilité, vous devez :

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <emphasis>Create a toplevel Release file</emphasis>, if it does not exist already. You can do this by running <command>apt-ftparchive release</command> (provided in apt-utils).
fr: <emphasis>créer un fichier Release à la racine de l'archive</emphasis>, s'il n'existe pas déjà. Vous pouvez le créer avec la commande <command>apt-ftparchive release</command> (fournie dans le paquet apt-utils).

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <emphasis>Sign it</emphasis>. You can do this by running <command>gpg --clearsign -o InRelease Release</command> and <command>gpg -abs -o Release.gpg Release</command>.
fr: <emphasis>le signer</emphasis>, avec les commandes <command>gpg --clearsign -o InRelease Release</command> et <command>gpg -abs -o Release.gpg Release</command>.

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <emphasis>Publish the key fingerprint</emphasis>, so that your users will know what key they need to import in order to authenticate the files in the archive. It is best to ship your key in its own keyring package like &keyring-distro; does with &keyring-package; to be able to distribute updates and key transitions automatically later.
fr: <emphasis>publier l'empreinte de la clé</emphasis>. Ainsi les utilisateurs de votre archive connaîtront la clé qu'ils doivent importer pour authentifier les fichiers de l'archive. Le mieux est de diffuser sa clé dans son propre paquet de trousseau comme le fait &keyring-distro; avec &keyring-package; pour ensuite distribuer automatiquement les mises à jour et les transitions de clés.

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <emphasis>Provide instructions on how to add your archive and key</emphasis>.  If your users can't acquire your key securely the chain of trust described above is broken.  How you can help users add your key depends on your archive and target audience ranging from having your keyring package included in another archive users already have configured (like the default repositories of their distribution) to leveraging the web of trust.
fr: <emphasis>fournir les instructions pour ajouter l'archive et la clé</emphasis>. Si les utilisateurs ne peuvent récupérer de façon sûre votre clé, la chaîne de confiance décrite plus haut est rompue. La façon d'aider les utilisateurs à ajouter votre clé de l'archive dépend de l'archive et de l'audience cible : cela va d'un paquet de trousseau inclus dans une autre archive que des utilisateurs ont déjà configurée (comme les dépôts par défaut de leur distribution) à la mobilisation du web de confiance.

note: type: Content of: <refentry><refsect1><para>
en: Whenever the contents of the archive change (new packages are added or removed) the archive maintainer has to follow the first two steps outlined above.
fr: Chaque fois que le contenu de l'archive change, (suppression ou ajout de nouveaux paquets) le responsable doit refaire les deux premières étapes.

note: type: Content of: <refentry><refsect1><para>
en: For more background information you might want to review the <ulink url="https://www.debian.org/doc/manuals/securing-debian-manual/ch07">Debian Security Infrastructure</ulink> chapter of the Securing Debian Manual (also available in the harden-doc package) and the <ulink url="http://www.cryptnet.net/fdp/crypto/strong_distro.html" >Strong Distribution HOWTO</ulink> by V. Alex Brennen.
fr: Pour des informations plus complètes, vous pouvez consulter <ulink url="https://www.debian.org/doc/manuals/securing-debian-manual/ch07"> l'infrastructure debian pour la sécurité</ulink> un chapitre du manuel Debian sur la sécurité (disponible dans le paquet harden-doc) et le <ulink url="http://www.cryptnet.net/fdp/crypto/strong_distro.html">Strong Distribution HOWTO</ulink> par V. Alex Brennen.

note: type: Content of: <refentry><refsect1><title>
en: Manpage Authors
fr: Auteurs des pages de manuel

note: type: Content of: <refentry><refsect1><para>
en: This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac Jones, Colin Walters, Florian Weimer and Michael Vogt.
fr: Cette page a été écrite à partir des travaux de Javier Fernández-Sanguino Peña, Isaac Jones, Colin Walters, Florian Weimer et Michael Vogt.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: APT CD-ROM management utility
fr: Utilitaire de gestion des CD d'APT

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-cdrom</command> is used to add a new CD-ROM to APT's list of available sources. <command>apt-cdrom</command> takes care of determining the structure of the disc as well as correcting for several possible mis-burns and verifying the index files.
fr: <command>apt-cdrom</command> est utilisé pour ajouter un nouveau CD à la liste des sources disponibles. <command>apt-cdrom</command> prend soin de déterminer la structure du disque, de corriger de possibles erreurs de gravure et de vérifier les fichiers d'index.

note: type: Content of: <refentry><refsect1><para>
en: It is necessary to use <command>apt-cdrom</command> to add CDs to the APT system; it cannot be done by hand. Furthermore each disc in a multi-CD set must be inserted and scanned separately to account for possible mis-burns.
fr: Il est nécessaire d'utiliser <command>apt-cdrom</command> pour ajouter des CD au système APT car cela ne peut être réalisé manuellement. Par ailleurs, chaque disque d'un ensemble de CD doit être séparément inséré et parcouru pour prendre en compte de possibles erreurs de gravure.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>add</literal> is used to add a new disc to the source list. It will unmount the CD-ROM device, prompt for a disc to be inserted and then proceed to scan it and copy the index files. If the disc does not have a proper <filename>.disk</filename> directory you will be prompted for a descriptive title.
fr: La commande <literal>add</literal> est utilisée pour ajouter un nouveau disque à la liste des sources. Elle démonte le CD, réclame l'insertion d'un disque, parcourt ensuite le disque et copie les fichiers d'index. Si le disque ne possède pas de répertoire <filename>.disk</filename> correct, un titre descriptif est demandé.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: APT uses a CD-ROM ID to track which disc is currently in the drive and maintains a database of these IDs in <filename>&statedir;/cdroms.list</filename>
fr: APT utilise un identifiant de CD pour reconnaître le disque qui se trouve actuellement dans le lecteur et maintient une base de données de ces identifiants dans <filename>&statedir;/cdroms.list</filename>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: A debugging tool to report the identity of the current disc as well as the stored file name
fr: Cette commande de débogage retourne l'identifiant du disque actuel ainsi que le nom du fichier stocké.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not try to auto-detect the CD-ROM path. Usually combined with the <option>--cdrom</option> option.  Configuration Item: <literal>Acquire::cdrom::AutoDetect</literal>.
fr: Ne pas essayer de détecter automatiquement le chemin du CD-ROM. Habituellement combiné avec l'option <option>--cdrom</option>. Élément de configuration : <literal>Acquire::cdrom::AutoDetect</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Mount point; specify the location to mount the CD-ROM. This mount point must be listed in <filename>/etc/fstab</filename> and properly configured.  Configuration Item: <literal>Acquire::cdrom::mount</literal>.
fr: Point de montage ; spécifie l'emplacement de montage du CD. Ce point de montage doit être spécifié dans <filename>/etc/fstab</filename> et correctement configuré. Élément de configuration : <literal>Acquire::cdrom::mount</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Rename a disc; change the label of a disc or override the disc's given label. This option will cause <command>apt-cdrom</command> to prompt for a new label.  Configuration Item: <literal>APT::CDROM::Rename</literal>.
fr: Change le nom d'un disque ; change le nom d'un disque ou remplace un disque pour un nom donné. Cette option oblige <command>apt-cdrom</command> à demander un nouveau nom à l'utilisateur. Élément de configuration : <literal>APT::CDROM::Rename</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: No mounting; prevent <command>apt-cdrom</command> from mounting and unmounting the mount point.  Configuration Item: <literal>APT::CDROM::NoMount</literal>.
fr: Pas de montage ; empêche <command>apt-cdrom</command> de monter ou démonter le point de montage. Élément de configuration : <literal >APT::CDROM::NoMount</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Fast Copy; Assume the package files are valid and do not check every package. This option should be used only if <command>apt-cdrom</command> has been run on this disc before and did not detect any errors.  Configuration Item: <literal>APT::CDROM::Fast</literal>.
fr: Copie rapide ; suppose que les fichiers de paquets sont valables et ne vérifie pas chaque paquet. Cette option ne devrait être utilisée que si <command>apt-cdrom</command> a préalablement utilisé ce disque et n'a trouvé aucune erreur. Élément de configuration : <literal>APT::CDROM::Fast</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Thorough Package Scan; This option may be needed with some old Debian 1.1/1.2 discs that have Package files in strange places. It takes much longer to scan the CD but will pick them all up.
fr: Parcours minutieux des paquets ; cette option peut être nécessaire avec des CD d'anciens systèmes Debian 1.1 ou 1.2 dont les fichiers Packages sont situés dans des endroits inhabituels. Il faudra plus de temps pour parcourir le CD mais tous les paquets seront repérés.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: No Changes; Do not change the &sources-list; file and do not write index files. Everything is still checked however.  Configuration Item: <literal>APT::CDROM::NoAct</literal>.
fr: Aucune modification ; ne pas modifier le fichier &sources-list; ni les fichiers d'index. Cependant, tout est vérifié. Élément de configuration : <literal>APT::CDROM::NoAct</literal>.

note: type: Content of: <refentry><refsect1><para>
en: &apt-conf;, &apt-get;, &sources-list;
fr: &apt-conf;, &apt-get;, &sources-list;.

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-cdrom</command> returns zero on normal operation, decimal 100 on error.
fr: <command>apt-cdrom</command> renvoie zéro après un déroulement normal, et le nombre décimal 100 en cas d'erreur.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: APT Configuration Query program
fr: Programme d'interrogation de la configuration d'APT

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-config</command> is an internal program used by various portions of the APT suite to provide consistent configurability. It accesses the main configuration file <filename>/etc/apt/apt.conf</filename> in a manner that is easy to use for scripted applications.
fr: <command>apt-config</command> est un programme interne utilisé par différents composants d'APT ; il offre la possibilité d'une configuration cohérente et permet aux applications conçues sous forme de script une utilisation simple du fichier de configuration principal <filename>/etc/apt/apt.conf</filename>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: shell is used to access the configuration information from a shell script. It is given pairs of arguments, the first being a shell variable and the second the configuration value to query. As output it lists shell assignment commands for each value present.  In a shell script it should be used as follows:
fr: Le terme shell est utilisé pour accéder aux informations de configuration depuis un script shell. Deux arguments doivent lui être donnés ; le premier est une variable du shell et le second une valeur de configuration à demander. La sortie standard consiste en une liste de commandes d'assignation de shell pour chaque valeur présente. Dans un script shell, cette commande devrait être utilisée comme suit :

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
en: OPTS="-f"
    RES=`apt-config shell OPTS MyApp::options`
    eval $RES
fr: OPTS="-f"
    RES=`apt-config shell OPTS MyApp::Options`
    eval $RES

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This will set the shell environment variable $OPTS to the value of MyApp::options with a default of <option>-f</option>.
fr: La variable d'environnement du shell $OPTS sera définie par la valeur de MyApp::Options ou, par défaut, la valeur -f.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The configuration item may be postfixed with a /[fdbi]. f returns file names, d returns directories, b returns true or false and i returns an integer. Each of the returns is normalized and verified internally.
fr: L'élément de configuration peut être suivi par /[fdbi]. « f » renvoie un nom de fichier, « d » un nom de répertoire, « b » renvoie « true » ou « false » et « i » renvoie un entier. Chacune de ses valeurs est normalisée et vérifiée.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Just show the contents of the configuration space.
fr: Affiche seulement le contenu de l'espace de configuration.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Include options which have an empty value. This is the default, so use --no-empty to remove them from the output.
fr: Inclure les options qui ont une valeur vide. Ce comportement est celui par défaut ; il est donc conseillé d'utiliser --no-empty pour les supprimer de ce qui est retourné.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Defines the output of each config option. &percnt;t will be replaced with its individual name, &percnt;f with its full hierarchical name and &percnt;v with its value.  Use uppercase letters and special characters in the value will be encoded to ensure that it can e.g. be safely used in a quoted-string as defined by RFC822. Additionally &percnt;n will be replaced by a newline, and &percnt;N by a tab. A &percnt; can be printed by using &percnt;&percnt;.
fr: Définit ce que retourne chaque option de configuration. &percnt;t sera remplacé par son nom individuel, &percnt;f par le nom hiérarchique complet et &percnt;v par la valeur. Les majuscules et les caractères spéciaux dans la valeur seront encodés afin de pouvoir être utilisés sans problèmes, par exemple dans une chaîne définie par RFC822. Par ailleurs, &percnt;n sera remplacé par un retour à la ligne et &percnt;N  par une tabulation. Le caractère &percnt; peut être affiché avec &percnt;&percnt; .

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-config</command> returns zero on normal operation, decimal 100 on error.
fr: <command>apt-config</command> retourne zéro après un déroulement normal, et le nombre 100 en cas d'erreur.

note: type: Content of: <refentry><refentryinfo><author><contrib>
en: Initial documentation of Debug::*.
fr: Documentation initiale de Debug::*.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Configuration file for APT
fr: Fichier de configuration pour APT

note: type: Content of: <refentry><refsect1><para>
en: <filename>/etc/apt/apt.conf</filename> is the main configuration file shared by all the tools in the APT suite of tools, though it is by no means the only place options can be set. The suite also shares a common command line parser to provide a uniform environment.
fr: Le fichier <filename>apt.conf</filename> est le fichier de configuration principal du l'ensemble de programmes APT, mais n'est de loin pas le seul endroit où des choix d'options peuvent être effectués. L'ensemble des outils partagent leur analyse de la ligne de commande, ce qui permet de garantir un environnement d'utilisation uniforme.

note: type: Content of: <refentry><refsect1><orderedlist><para>
en: When an APT tool starts up it will read the configuration files in the following order:
fr: Lorsqu'un programme de l'ensemble APT est utilisé, il lit le fichier de configuration dans l'ordre suivant :

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: the file specified by the <envar>APT_CONFIG</envar> environment variable (if any)
fr: fichier indiqué par la variable d'environnement <envar>APT_CONFIG</envar> si elle existe

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: all files in <literal>Dir::Etc::Parts</literal> in alphanumeric ascending order which have either no or "<literal>conf</literal>" as filename extension and which only contain alphanumeric, hyphen (-), underscore (_) and period (.) characters.  Otherwise APT will print a notice that it has ignored a file, unless that file matches a pattern in the <literal>Dir::Ignore-Files-Silently</literal> configuration list - in which case it will be silently ignored.
fr: tous les fichiers de <literal>Dir::Etc::Parts</literal> dans l'ordre alphanumérique ascendant qui ont soit l'extension "<literal>conf</literal>", soit aucune extension et qui ne contiennent que des caractères alphanumériques, des tirets (-), des caractères de soulignement (_) et des points (.), les autres fichiers étant ignorés. Dans le cas contraire, APT affichera un avertissement indiquant qu'il a ignoré un fichier si celui-ci ne correspond par à un motif défini dans <literal>Dir::Ignore-Files-Silently</literal> (les fichiers correspondant à cette variable de configuration étant, eux, ignorés silencieusemennt).

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: the main configuration file specified by <literal>Dir::Etc::main</literal>
fr: le fichier de configuration défini par <literal>Dir::Etc::Main</literal>

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: all options set in the binary specific configuration subtree are moved into the root of the tree.
fr: toutes les options définie dans le sous-arbre binaire de configuration spécifique sont déplacées à la racine de l'arbre.

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: the command line options are applied to override the configuration directives or to load even more configuration files.
fr: les options de ligne de commande sont appliquées pour remplacer les directives de configuration ou pour charger d'autres fichiers de configuration.

note: type: Content of: <refentry><refsect1><title>
en: Syntax
fr: Syntaxe

note: type: Content of: <refentry><refsect1><para>
en: The configuration file is organized in a tree with options organized into functional groups. Option specification is given with a double colon notation; for instance <literal>APT::Get::Assume-Yes</literal> is an option within the APT tool group, for the Get tool. Options do not inherit from their parent groups.
fr: Le fichier de configuration est construit comme un arbre d'options organisées en groupes fonctionnels. On se sert du double deux points (« :: ») pour indiquer une option ; par exemple, <literal>APT::Get::Assume-Yes</literal> est une option pour le groupe d'outils APT, destinée à l'outil Get. Il n'y a pas d'héritage des options des groupes parents.

note: type: Content of: <refentry><refsect1><para>
en: with newlines placed to make it more readable. Lists can be created by opening a scope and including a single string enclosed in quotes followed by a semicolon. Multiple entries can be included, separated by a semicolon.
fr: avec des retours à la ligne pour faciliter la lecture. On peut créer une liste en ouvrant un champ d'action et en y insérant une chaîne entre guillemets suivie d'un point virgule. Des entrées multiples peuvent être incluses, séparées par des points-virgules.

note: type: Content of: <refentry><refsect1><para>
en: In general the sample configuration file &configureindex; is a good guide for how it should look.
fr: Les modèles &configureindex; montrent à quoi devrait ressembler le fichier de configuration.

note: type: Content of: <refentry><refsect1><para>
en: Case is not significant in names of configuration items, so in the previous example you could use <literal>dpkg::pre-install-pkgs</literal>.
fr: Les identifiants des options de configuration ne sont pas sensibles à la casse. Dans l'exemple précédent, on pourrait donc aussi bien utiliser <literal>dpkg::pre-install-pkgs</literal>.

note: type: Content of: <refentry><refsect1><para>
en: Names for the configuration items are optional if a list is defined as can be seen in the <literal>DPkg::Pre-Install-Pkgs</literal> example above. If you don't specify a name a new entry will simply add a new option to the list. If you specify a name you can override the option in the same way as any other option by reassigning a new value to the option.
fr: Les noms des éléments de configuration sont optionnels si une liste est définie, comme cela peut se voir avec l'exemple <literal>DPkg::Pre-Install-Pkgs</literal> précédent. Si vous n'indiquez pas de nom, une nouvelle entrée ajoutera une nouvelle option à la liste. Dans le cas contraire, l'option correspondante peut être remplacée, comme toute autre option, en lui réaffectant une valeur.

note: type: Content of: <refentry><refsect1><para>
en: Two special commands are defined: <literal>#include</literal> (which is deprecated and not supported by alternative implementations) and <literal>#clear</literal>. <literal>#include</literal> will include the given file, unless the filename ends in a slash, in which case the whole directory is included.  <literal>#clear</literal> is used to erase a part of the configuration tree. The specified element and all its descendants are erased.  (Note that these lines also need to end with a semicolon.)
fr: Deux éléments spéciaux sont autorisés : <literal>#include</literal> (qui est obsolète et n'est plus géré par des implémentations alternatives) et <literal>#clear</literal>. <literal>#include</literal> inclut le fichier donné en paramètre, à moins que le nom ne se termine par une barre oblique auquel cas le répertoire entier est inclus. <literal>#clear</literal> sert à effacer une partie de l'arbre de configuration. L'élément désigné et tout ses descendants sont supprimés. Veuillez noter que ces lignes doivent également se terminer avec un point-virgule.

note: type: Content of: <refentry><refsect1><para>
en: The <literal>#clear</literal> command is the only way to delete a list or a complete scope. Reopening a scope (or using the syntax described below with an appended <literal>::</literal>) will <emphasis>not</emphasis> override previously written entries. Options can only be overridden by addressing a new value to them - lists and scopes can't be overridden, only cleared.
fr: La commande <literal>#clear</literal> est la seule façon de supprimer une liste ou un champ d'action (« scope »). La réouverture d'un scope ou le style « :: » décrit plus loin ne remplaceront <emphasis>pas</emphasis> les entrées écrites précédemment. Les options ne peuvent être remplacées qu'en leur affectant une nouvelle valeur. Les listes et les champs d'action ne peuvent être remplacés mais seulement effacés.

note: type: Content of: <refentry><refsect1><para>
en: All of the APT tools take an -o option which allows an arbitrary configuration directive to be specified on the command line. The syntax is a full option name (<literal>APT::Get::Assume-Yes</literal> for instance) followed by an equals sign then the new value of the option. To append a new element to a list, add a trailing <literal>::</literal> to the name of the list.  (As you might suspect, the scope syntax can't be used on the command line.)
fr: Tous les outils d'APT possèdent une option <option>-o</option> qui permet de spécifier une configuration quelconque depuis la ligne de commande. La syntaxe consiste en un nom complet d'option (par exemple <literal>APT::Get::Assume-Yes</literal>) suivi par un signe égal, puis par la nouvelle valeur de l'option. On peut compléter une liste en ajoutant un <literal>::</literal> final au nom de la liste. Comme on peut s'en douter, la syntaxe de champ d'action (« scope ») ne peut pas être indiquée à la ligne de commande.

note: type: Content of: <refentry><refsect1><para>
en: Note that appending items to a list using <literal>::</literal> only works for one item per line, and that you should not use it in combination with the scope syntax (which adds <literal>::</literal> implicitly). Using both syntaxes together will trigger a bug which some users unfortunately depend on: an option with the unusual name "<literal>::</literal>" which acts like every other option with a name. This introduces many problems; for one thing, users who write multiple lines in this <emphasis>wrong</emphasis> syntax in the hope of appending to a list will achieve the opposite, as only the last assignment for this option "<literal>::</literal>" will be used. Future versions of APT will raise errors and stop working if they encounter this misuse, so please correct such statements now while APT doesn't explicitly complain about them.
fr: Veuillez noter que vous ne pouvez utiliser <literal>::</literal> que pour ajouter un élément par ligne à la liste et que cela ne devrait pas être utilisé en combinaison avec la syntaxe de champ d'action (« scope ») qui inclut implicitement <literal>::</literal>. L'utilisation simultanée des deux syntaxes déclenchera un bogue dont certains utilisateurs se servent comme d'une fonctionnalité : une option avec le nom inhabituel « <literal>::</literal> » se comportera comme toute autre option nommée. Cela risque d'avoir de nombreux problèmes comme conséquence, par exemple si un utilisateur écrit plusieurs lignes avec cette syntaxe <emphasis>erronée</emphasis> afin de faire un ajout à la liste, l'effet obtenu sera inverse puisque seule la dernière valeur pour l'option « <literal>::</literal> » sera utilisée. Les futures versions d'APT retourneront une erreur et l'exécution sera interrompue si cette utilisation incorrecte est rencontrée. Il est donc conseillé de corriger ces défauts tant qu'APT ne s'en plaint pas explicitement.

note: type: Content of: <refentry><refsect1><title>
en: The APT Group
fr: Le groupe APT

note: type: Content of: <refentry><refsect1><para>
en: This group of options controls general APT behavior as well as holding the options for all of the tools.
fr: Ce groupe d'options contrôle le comportement global d'APT et contient également des options communes à tous les outils.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: System Architecture; sets the architecture to use when fetching files and parsing package lists. The internal default is the architecture apt was compiled for.
fr: L'architecture du système ; cette option positionne l'architecture à utiliser pour récupérer des fichiers et analyser des listes de paquets. La valeur interne par défaut est l'architecture pour laquelle APT a été compilé.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: All Architectures the system supports. For instance, CPUs implementing the <literal>amd64</literal> (also called <literal>x86-64</literal>)  instruction set are also able to execute binaries compiled for the <literal>i386</literal> (<literal>x86</literal>) instruction set. This list is used when fetching files and parsing package lists. The initial default is always the system's native architecture (<literal>APT::Architecture</literal>), and foreign architectures are added to the default list when they are registered via <command>dpkg --add-architecture</command>.
fr: Toutes les architectures gérées par le système. Par exemple, les processeurs qui mettent en œuvre le jeu d'instructions <literal>amd64</literal> (aussi appelé <literal>x86-64</literal>) peuvent exécuter des binaires compilés pour le jeu d'instructions<literal>i386</literal> (<literal>x86</literal>). Cette liste est utilisé pour récupérer des fichiers et analyser les listes de paquets. La valeur par défaut initiale est toujours celle de l'architecture native du système (<literal>APT::Architecture</literal>) et les autres architectures sont ajoutées à la liste par défaut lorsqu'elles sont enregistrées avec <command>dpkg --add-architecture</command>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This scope defines which compression formats are supported, how compression and decompression can be performed if support for this format isn't built into apt directly and a cost-value indicating how costly it is to compress something in this format. As an example the following configuration stanza would allow apt to download and uncompress as well as create and store files with the low-cost <literal>.reversed</literal> file extension which it will pass to the command <command>rev</command> without additional commandline parameters for compression and uncompression:
fr: Ce champ d'action (« scope ») définit quels formats de compression sont gérés, comment la compression et la décompression peuvent être réalisées si ce format n'est pas pris en charge directement dans APT et une indication du coût d'une compression dans ce format. Dans cet exemple, le paragraphe suivant de la configuration permettra à APT de télécharger, décompresser, créer et stocker des fichiers avec l'extension de fichier à bas coût <literal>.reversed</literal> qu'il passera à la commande <command>rev</command> sans paramètre supplémentaire en ligne de commande pour la compression et la décompression :

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: List of all build profiles enabled for build-dependency resolution, without the "<literal>profile.</literal>" namespace prefix.  By default this list is empty. The <envar>DEB_BUILD_PROFILES</envar> as used by &dpkg-buildpackage; overrides the list notation.
fr: Liste de tous les profils de construction activés pour la résolution de dépendances de construction, sans le préfixe de l'espace de nommage du "<literal>profile.</literal>". Par défaut, cette liste est vide. La variable <envar>DEB_BUILD_PROFILES</envar> comme l'utilise &dpkg-buildpackage; annule la notation de liste.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default release to install packages from if more than one version is available. Contains release name, codename or release version. Examples: 'stable', 'testing', 'unstable', '&debian-stable-codename;', '&debian-testing-codename;', '4.0', '5.0*'. See also &apt-preferences;.
fr: Indique la distribution à utiliser par défaut lors de l'installation d'un paquet si plusieurs versions sont disponibles. La valeur peut être un nom de distribution ou un numéro de version. Exemples : « stable », « testing », « &debian-stable-codename; », « &debian-testing-codename; », « 4.0 », « 5.0* ». Voir aussi &apt-preferences;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Ignore held packages; this global option causes the problem resolver to ignore held packages in its decision making.
fr: Ignore les paquets « gelés » ; cette option globale indique au système de résolution de ne pas tenir compte des paquets « gelés » dans sa prise de décision.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Defaults to on. When turned on the autoclean feature will remove any packages which can no longer be downloaded from the cache. If turned off then packages that are locally installed are also excluded from cleaning - but note that APT provides no direct means to reinstall them.
fr: Avec cette option qui est activée par défaut, la fonctionnalité « autoclean » supprime du cache tout paquet qui ne peut plus être récupéré. Quand cette option est désactivée, les paquets qui sont installés localement sont aussi exclus du nettoyage - mais notez que APT ne fournit aucun moyen direct pour les réinstaller.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Defaults to on, which will cause APT to install essential and important packages as soon as possible in an install/upgrade operation, in order to limit the effect of a failing &dpkg; call. If this option is disabled, APT treats an important package in the same way as an extra package: between the unpacking of the package A and its configuration there can be many other unpack or configuration calls for other unrelated packages B, C etc. If these cause the &dpkg; call to fail (e.g. because package B's maintainer scripts generate an error), this results in a system state in which package A is unpacked but unconfigured - so any package depending on A is now no longer guaranteed to work, as its dependency on A is no longer satisfied.
fr: La valeur par défaut est « on » ce qui a pour conséquence qu'APT installera les paquets essentiels et importants dès que possible pendant les opérations d'installation ou de mise à jour, afin de limiter les conséquences d'un échec de &dpkg;. Si cette option est désactivée, APT traitera les paquets importants comme les paquets de priorité « extra » : entre la décompaction du paquet A et sa configuration, de nombreuses opérations de décompaction ou de configuration peuvent prendre place pour des paquets B ou C qui n'ont rien à voir. Si ces opérations provoquent un échec de &dpkg; (par exemple si les scripts du responsable du paquet B provoquent une erreur), le résultat est que le paquet A est décompacté mais non configuré. En conséquence, les paquets qui en dépendent pourraient ne plus fonctionner puisque leurs dépendances ne sont pas satisfaites.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The immediate configuration marker is also applied in the potentially problematic case of circular dependencies, since a dependency with the immediate flag is equivalent to a Pre-Dependency. In theory this allows APT to recognise a situation in which it is unable to perform immediate configuration, abort, and suggest to the user that the option should be temporarily deactivated in order to allow the operation to proceed.  Note the use of the word "theory" here; in the real world this problem has rarely been encountered, in non-stable distribution versions, and was caused by wrong dependencies of the package in question or by a system in an already broken state; so you should not blindly disable this option, as the scenario mentioned above is not the only problem it can help to prevent in the first place.
fr: Le marqueur de configuration immédiate est également utilisé dans le cas potentiellement délicat de dépendances circulaires, car une dépendance avec le marqueur « immediate » est équivalent à une pré-dépendance. Cela permet en théorie à APT de reconnaître le cas où il ne peut effectuer de configuration immédiate et de s'interrompre pour suggérer de désactiver temporairement l'option pour permettre aux opérations de s'effectuer. Veuillez noter l'utilisation du terme « en théorie » : en réalité, ce problème est rarement rencontré, dans des versions non stables de distributions, et était causé par des dépendances incorrectes ou par un système déjà dans un état instable. Vous ne devriez donc pas désactiver cette option sans savoir ce que vous faites car le scénario ci-dessus n'est le seul qu'elle permet d'éviter.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Before a big operation like <literal>dist-upgrade</literal> is run with this option disabled you should try to explicitly <literal>install</literal> the package APT is unable to configure immediately; but please make sure you also report your problem to your distribution and to the APT team with the bug link below, so they can work on improving or correcting the upgrade process.
fr: Avant qu'une opération importante comme <literal>dist-upgrade</literal> ne soit exécutée avec cette option désactivée, vous devriez essayer d'installer (<literal>install</literal>) explicitement le paquet qu'APT ne peut pas configurer immédiatement. Ne manquez toutefois pas de signaler le problème dans votre distribution et à l'équipe de maintenance d'APT avec le lien de système de gestion de bogues ci-dessous, afin qu'ils puissent améliorer ou corriger les processus de mise à jour.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Never enable this option unless you <emphasis>really</emphasis> know what you are doing. It permits APT to temporarily remove an essential package to break a Conflicts/Conflicts or Conflicts/Pre-Depends loop between two essential packages. <emphasis>Such a loop should never exist and is a grave bug</emphasis>. This option will work if the essential packages are not <command>tar</command>, <command>gzip</command>, <command>libc</command>, <command>dpkg</command>, <command>dash</command> or anything that those packages depend on.
fr: Ne jamais activer cette option à moins que vous ne sachiez <emphasis>réellement</emphasis> ce que vous faites. Elle autorise APT à supprimer temporairement un paquet essentiel pour mettre fin à une boucle Conflicts / Conflicts ou Conflicts / Pre-Depends entre deux paquets essentiels. <emphasis>Une telle boucle ne devrait jamais se produire : c'est un bogue très important</emphasis>. Cette option fonctionne si les paquets essentiels ne sont pas <command>tar</command>, <command>gzip</command>, <command>libc</command>, <command>dpkg</command>, <command>dash</command> ou tous les paquets dont ces paquets dépendent.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: APT uses since version 0.7.26 a resizable memory mapped cache file to store the available information. <literal>Cache-Start</literal> acts as a hint of the size the cache will grow to, and is therefore the amount of memory APT will request at startup. The default value is 20971520 bytes (~20 MB). Note that this amount of space needs to be available for APT; otherwise it will likely fail ungracefully, so for memory restricted devices this value should be lowered while on systems with a lot of configured sources it should be increased.  <literal>Cache-Grow</literal> defines in bytes with the default of 1048576 (~1 MB) how much the cache size will be increased in the event the space defined by <literal>Cache-Start</literal> is not enough. This value will be applied again and again until either the cache is big enough to store all information or the size of the cache reaches the <literal>Cache-Limit</literal>.  The default of <literal>Cache-Limit</literal> is 0 which stands for no limit.  If <literal>Cache-Grow</literal> is set to 0 the automatic growth of the cache is disabled.
fr: À partir de la version 0.7.26, APT utilise un fichier de cache de taille variable indexé en mémoire (« resizable memory mapped cache file ») pour conserver les informations du fichier « available ». <literal>Cache-Start</literal> définit la taille minimale de ce cache et par conséquent la quantité de mémoire qu'APT utilisera dès son lancement. La valeur par défaut est de 20971520 octets (environ 20 Mo). Il est indispensable que l'ensemble de cette mémoire soit disponible, sinon APT ne pourra se lancer. Il peut donc être nécessaire de diminuer cette valeur sur des systèmes disposant de peu de mémoire. Au contraire, pour des systèmes qui utilisent de nombreuses sources de paquet, il peut être nécessaire de l'augmenter. La valeur de <literal>Cache-Grow</literal> définit, en octets, la quantité de mémoire supplémentaire qui peut être allouée au cache si la valeur définie par <literal>Cache-Start</literal> est insuffisante. La valeur par défaut de <literal>Cache-Grow</literal> est de 1048576 octets (environ 1 Mo). Cette augmentation se fera tant que la taille du cache sera insuffisante pour contenir toutes les informations nécessaires ou qu'elle atteint la valeur limite définie par <literal>Cache-Limit</literal>. La valeur par défaut de <literal>Cache-Limit</literal> est nulle (il n'existe donc pas de limite à la taille maximale du cache). Si <literal>Cache-Grow</literal> est égal à 0, l'augmentation automatique de la taille du cache est désactivée.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Defines which packages are considered essential build dependencies.
fr: Cette option définit les paquets qui sont considérés comme faisant partie des dépendances essentielles pour la construction de paquets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The Get subsection controls the &apt-get; tool; please see its documentation for more information about the options here.
fr: La sous-section <literal>Get</literal> contrôle l'outil &apt-get;, veuillez consulter sa documentation pour avoir plus d'informations sur les options en question.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The Cache subsection controls the &apt-cache; tool; please see its documentation for more information about the options here.
fr: La sous-section <literal>Cache</literal> contrôle l'outil &apt-cache;, veuillez consulter sa documentation pour avoir plus d'informations sur les options en question.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The CDROM subsection controls the &apt-cdrom; tool; please see its documentation for more information about the options here.
fr: La sous-section <literal>CDROM</literal> contrôle l'outil &apt-cdrom;, veuillez consulter sa documentation pour avoir plus d'informations sur les options en question.

note: type: Content of: <refentry><refsect1><title>
en: The Acquire Group
fr: Le groupe Acquire

note: type: Content of: <refentry><refsect1><para>
en: The <literal>Acquire</literal> group of options controls the download of packages as well as the various "acquire methods" responsible for the download itself (see also &sources-list;).
fr: Le groupe d'options <literal>Acquire</literal> contrôle le téléchargement des paquets ainsi que les différentes « méthodes d'acquisition » qui effectuent ce téléchargement (voir aussi &sources-list;).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Security related option defaulting to true, enabling time-related checks. Disabling it means that the machine's time cannot be trusted, and APT will hence disable all time-related checks, such as <option>Check-Valid-Until</option> and verifying that the Date field of a release file is not in the future.
fr: Les options relatives à la sécurité sont positionnées par défaut à « true »,permettant des vérifications relatives à l'heure. Leur désactivation signifie qu'on ne peut pas faire confiance à l'heure de la machine, et APT de ce fait désactivera toutes les vérifications de ce type, telles que <option>Check-Valid-Until</option> et la vérification que le champ Date d'un fichier Release n'est pas dans le futur.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Maximum time (in seconds) before its creation (as indicated by the <literal>Date</literal> header) that the <filename>Release</filename> file should be considered valid.  The default value is <literal>10</literal>.  Archive specific settings can be made by appending the label of the archive to the option name. Preferably, the same can be achieved for specific &sources-list; entries by using the <option>Date-Max-Future</option> option there.
fr: Durée maximale (en secondes) pendant laquelle un fichier Release est considéré comme valable, à partir du moment de sa création (tel que cela est indiqué dans l'en-tête <literal>Date</literal>). La valeur par défaut est <literal>10</literal>. Un réglage spécifique pour une archive donnée peut être défini en ajoutant l'étiquette de l'archive au nom de l'option. De préférence, le même résultat peut être obtenu pour des entrées particulières de &sources-list; en utilisant ici l'option <option>Date-Max-Future</option>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Security related option defaulting to true, as giving a Release file's validation an expiration date prevents replay attacks over a long timescale, and can also for example help users to identify mirrors that are no longer updated - but the feature depends on the correctness of the clock on the user system. Archive maintainers are encouraged to create Release files with the <literal>Valid-Until</literal> header, but if they don't or a stricter value is desired the <literal>Max-ValidTime</literal> option below can be used.  The <option>Check-Valid-Until</option> option of &sources-list; entries should be preferred to disable the check selectively instead of using this global override.
fr: L'activation de l'option de sécurité qui permet de mettre une limite temporelle de validité au fichier Release permet d'éviter des attaques de type « replay » et permet d'éviter d'utiliser des miroirs qui ne sont plus à jour. Cependant, cette fonctionnalité a besoin que l'horloge du système soit à jour. Les gestionnaires d'archives devraient créer des fichiers Release comportant l'en-tête <literal>Valid-Until</literal>. Cependant, si cet en-tête est absent, ou si une valeur plus stricte est désirée, la valeur du paramètre <literal>Max-ValidTime</literal> est alors utilisée. L'option <option>Check-Valid-Until</option> des entrées de &sources-list; devrait être préférée pour désactiver sélectivement la vérification plutôt que d'utiliser ce remplacement global.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Maximum time (in seconds) after its creation (as indicated by the <literal>Date</literal> header) that the <filename>Release</filename> file should be considered valid.  If the Release file itself includes a <literal>Valid-Until</literal> header the earlier date of the two is used as the expiration date.  The default value is <literal>0</literal> which stands for "valid forever".  Archive specific settings can be made by appending the label of the archive to the option name. Preferably, the same can be achieved for specific &sources-list; entries by using the <option>Valid-Until-Max</option> option there.
fr: Durée maximale (en secondes) pendant laquelle un fichier Release est considéré comme valable, à partir du moment de sa création (tel que cela est indiqué dans l'en-tête <literal>Date</literal>). Si ce fichier lui-même comporte un en-tête <literal>Valid-Until</literal> la plus ancienne des deux dates est utilisée comme date d'expiration. La valeur par défaut (<literal>0</literal>) signifie « valable éternellement ». Un réglage spécifique pour une archive donnée peut être défini en ajoutant l'étiquette de l'archive au nom de l'option. De préférence, le même résultat peut être obtenu pour des entrées particulières de &sources-list; en utilisant ici l'option <option>Valid-Until-Max</option>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Minimum time (in seconds) after its creation (as indicated by the <literal>Date</literal> header) that the <filename>Release</filename> file should be considered valid.  Use this if you need to use a seldom updated (local) mirror of a more frequently updated archive with a <literal>Valid-Until</literal> header instead of completely disabling the expiration date checking.  Archive specific settings can and should be used by appending the label of the archive to the option name. Preferably, the same can be achieved for specific &sources-list; entries by using the <option>Valid-Until-Min</option> option there.
fr: Durée minimale (en secondes) pendant laquelle un fichier Release est considéré comme valable, à partir du moment de sa création (tel que cela est indiqué dans l'en-tête <literal>Date</literal>). Il est conseillé d'utiliser ce réglage si vous utilisez un miroir mis à jour ponctuellement (par exemple un miroir local) d'une archive mise à jour plus fréquemment avec un en-tête <literal>Valid-Until</literal> plutôt que de désactiver complètement le contrôle des dates d'expiration. Un réglage spécifique pour une archive donnée peut être défini en ajoutant l'étiquette de l'archive au nom de l'option. De préférence, le même résultat peut être obtenu pour des entrées particulières de &sources-list; en utilisant ici l'option <option>Valid-Until-Min</option>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allow use of the internal TLS support in the http method. If set to false, this completely disables support for TLS in apt's own methods (excluding the curl-based https method). No TLS-related functions will be called anymore.
fr: Permet l'utilisation de la prise en charge interne de TLS dans la méthode http. Si la valeur de l'option est « false », cela désactive totalement la prise en charge de TLS dans les méthodes propres d'Apt (à l'exclusion de la méthode https basée sur curl). Plus aucune des fonctions liées à TLS ne peut être appelée.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Try to download deltas called <literal>PDiffs</literal> for indexes (like <filename>Packages</filename> files) instead of downloading whole ones. True by default. Preferably, this can be set for specific &sources-list; entries or index files by using the <option>PDiffs</option> option there.
fr: Essayer de télécharger les fichiers différentiels appelés <literal>PDiffs</literal> pour les index (par exemple les fichiers <filename>Packages</filename>), plutôt que de les télécharger entièrement. Par défaut à « true ». De préférence, cela peut être défini pour des entrées particulières de &sources-list; ou des fichiers d'index en utilisant ici l'option <option>PDiffs</option>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Two sub-options to limit the use of PDiffs are also available: <literal>FileLimit</literal> can be used to specify a maximum number of PDiff files should be downloaded to update a file. <literal>SizeLimit</literal> on the other hand is the maximum percentage of the size of all patches compared to the size of the targeted file. If one of these limits is exceeded the complete file is downloaded instead of the patches.
fr: Deux sous-options permettant de limiter l'utilisation de fichiers « pdiff » sont également disponibles. <literal>FileLimit</literal> permet d'indiquer le nombre maximal de fichiers de différences peuvent être téléchargés pour modifier un fichier. <literal>SizeLimit</literal> permet par ailleurs de limiter la taille combinée des fichiers de différences récupérés à un certain pourcentage du fichier à modifier. Si une de ces limites est dépassée, le fichier complet est téléchargé au lieu de télécharger les fichiers de différences.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Try to download indexes via an URI constructed from a hashsum of the expected file rather than downloaded via a well-known stable filename. True by default, but automatically disabled if the source indicates no support for it. Usage can be forced with the special value "force". Preferably, this can be set for specific &sources-list; entries or index files by using the <option>By-Hash</option> option there.
fr: Essayer de télécharger les index avec un URI construit à partir de la somme de hachage du fichier attendu plutôt que de les télécharger à partir d'un nom de fichier stable bien connu. Par défaut à « true », mais automatiquement désactivé si la source n'indique pas sa prise en charge. Son utilisation peut être forcée avec la valeur spéciale « force ». De préférence, cela peut être défini pour des entrées particulières de &sources-list; ou des fichiers d'index en utilisant ici l'option <option>By-Hash</option>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Queuing mode; <literal>Queue-Mode</literal> can be one of <literal>host</literal> or <literal>access</literal> which determines how APT parallelizes outgoing connections. <literal>host</literal> means that one connection per target host will be opened, <literal>access</literal> means that one connection per URI type will be opened.
fr: Mode de file d'attente ; <literal>Queue-Mode</literal> peut prendre les valeurs <literal>host</literal> ou <literal>access</literal>, ce qui détermine comment APT parallélise les connexions sortantes. <literal>Host</literal> signifie qu'une connexion par cible sera initiée, tandis que <literal>access</literal> signifie qu'une connexion par type d'URI sera initiée.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Number of retries to perform. If this is non-zero APT will retry failed files the given number of times.
fr: Nombre d'essais à effectuer. Si ce nombre n'est pas nul, APT essaie de récupérer, le nombre donné de fois, les fichiers dont la récupération a échoué.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Use symlinks for source archives. If set to true then source archives will be symlinked when possible instead of copying. True is the default.
fr: Utilise des liens symboliques pour les archives de sources. Positionnée à « true », cette option crée si possible des liens symboliques vers les archives de sources au lieu de les copier. Par défaut à « true ».

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The options in these scopes configure APT's acquire transports for the protocols HTTP and HTTPS and are documented in the &apt-transport-http; and &apt-transport-https; manpages respectively.
fr: Les options dans ces champs d'action configurent les transports d'acquisition d'APT pour les protocoles HTTP et HTTPS et sont documentées dans les pages de manuel &apt-transport-http; et &apt-transport-https; respectivement.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <literal>ftp::Proxy</literal> sets the default proxy to use for FTP URIs.  It is in the standard form of <literal>ftp://[[user][:pass]@]host[:port]/</literal>.  Per host proxies can also be specified by using the form <literal>ftp::Proxy::&lt;host&gt;</literal> with the special keyword <literal>DIRECT</literal> meaning to use no proxies. If no one of the above settings is specified, <envar>ftp_proxy</envar> environment variable will be used. To use an FTP proxy you will have to set the <literal>ftp::ProxyLogin</literal> script in the configuration file. This entry specifies the commands to send to tell the proxy server what to connect to. Please see &configureindex; for an example of how to do this. The substitution variables representing the corresponding URI component are <literal>$(PROXY_USER)</literal>, <literal>$(PROXY_PASS)</literal>, <literal>$(SITE_USER)</literal>, <literal>$(SITE_PASS)</literal>, <literal>$(SITE)</literal> and <literal>$(SITE_PORT)</literal>.
fr: <literal>ftp::Proxy</literal> est le mandataire (proxy) FTP à utiliser par défaut pour les URI FTP.  Il se présente sous la forme standard : <literal>ftp://[[user][:pass]@]host[:port]/</literal>. On peut spécifier un mandataire particulier par hôte distant en utilisant la syntaxe : <literal>ftp::Proxy::&lt;hôte&gt;</literal>. Le mot-clé spécial <literal>DIRECT</literal> indique alors de n'utiliser aucun mandataire pour l'hôte. Si aucun des paramètres précédents n'est définis, la variable d'environnement <envar>ftp_proxy</envar> annule et replace toutes les options de mandataire FTP. Pour utiliser un mandataire FTP, vous devrez renseigner l'entrée <literal>ftp::ProxyLogin</literal> dans le fichier de configuration. Cette entrée spécifie les commandes à envoyer au mandataire pour lui préciser à quoi il doit se connecter. Voyez &configureindex; pour savoir comment faire. Les variables de substitution qui représentent le composant d'URI correspondant sont : <literal>$(PROXY_USER)</literal>, <literal>$(PROXY_PASS)</literal>, <literal>$(SITE_USER)</literal>, <literal>$(SITE_PASS)</literal>, <literal>$(SITE)</literal> et <literal>$(SITE_PORT)</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The option <literal>timeout</literal> sets the timeout timer used by the method; this value applies to the connection as well as the data timeout.
fr: L'option <literal>timeout</literal> positionne le compteur d'expiration du délai (timeout) utilisé par la méthode. Cela s'applique aussi bien à la connexion qu'aux données.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Several settings are provided to control passive mode. Generally it is safe to leave passive mode on; it works in nearly every environment.  However, some situations require that passive mode be disabled and port mode FTP used instead. This can be done globally or for connections that go through a proxy or for a specific host (see the sample config file for examples).
fr: Plusieurs options de configuration sont fournies pour contrôler le mode passif. Il est généralement plus sûr d'activer le mode passif et cela marche dans presque tous les environnements. Cependant, certaines situations nécessitent que le mode passif soit désactivé et que le mode « port » de ftp soit utilisé à la place. On peut le faire globalement, pour des connexions qui passent par un mandataire ou pour une machine spécifique (examinez le modèle de fichier de configuration).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: It is possible to proxy FTP over HTTP by setting the <envar>ftp_proxy</envar> environment variable to an HTTP URL - see the discussion of the http method above for syntax. You cannot set this in the configuration file and it is not recommended to use FTP over HTTP due to its low efficiency.
fr: Il est possible de faire transiter le trafic FTP par un mandataire HTTP en positionnant la variable d'environnement <envar>ftp_proxy</envar> à une URL HTTP -- consultez la méthode http ci-dessus pour la syntaxe. On ne peut pas le faire dans le fichier de configuration et il n'est de toute façon pas recommandé d'utiliser FTP au travers de HTTP en raison de la faible efficacité de cette méthode.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The setting <literal>ForceExtended</literal> controls the use of RFC2428 <literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is false, which means these commands are only used if the control connection is IPv6. Setting this to true forces their use even on IPv4 connections. Note that most FTP servers do not support RFC2428.
fr: L'option <literal>ForceExtended</literal> contrôle l'utilisation des commandes liées à la RFC 2428, <literal>EPSV</literal> et <literal>EPRT</literal>. Par défaut, elle vaut « false » ce qui signifie que ces commandes ne sont utilisées que pour une connexion de type IPv6. Quand elle vaut « true », on les utilise même si la connexion est de type IPv4. La plupart des serveurs FTP ne suivent pas la RFC 2428.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: For URIs using the <literal>cdrom</literal> method, the only configurable option is the mount point, <literal>cdrom::Mount</literal>, which must be the mount point for the CD-ROM (or DVD, or whatever) drive as specified in <filename>/etc/fstab</filename>. It is possible to provide alternate mount and unmount commands if your mount point cannot be listed in the fstab.  The syntax is to put <placeholder type="literallayout" id="0"/> within the <literal>cdrom</literal> block. It is important to have the trailing slash.  Unmount commands can be specified using UMount.
fr: La seule option de configuration pour les URI qui utilisent la méthode <literal>cdrom</literal> est le point de montage : <literal>cdrom::Mount</literal> ; il doit représenter le point de montage du lecteur de CD-ROM (ou DVD, etc.) indiqué dans <filename>/etc/fstab</filename>. D'autres commandes de montage et de démontage peuvent être fournies quand le point de montage ne peut être listé dans le fichier <filename>/etc/fstab</filename>. Syntaxiquement, il faut placer <placeholder type="literallayout" id="0"/> dans le bloc <literal>cdrom</literal>. La barre oblique finale est importante. Les commandes de démontage peuvent être spécifiées en utilisant <literal>UMount</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: For GPGV URIs the only configurable option is <literal>gpgv::Options</literal>, which passes additional parameters to gpgv.
fr: La seule option pour les URI GPGV est <literal>gpgv::Options</literal>, qui permet de passer des paramètres à gpgv

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><synopsis>
en: Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> "<replaceable>Methodname</replaceable>";
fr: Acquire::CompressionTypes::<replaceable>ExtensionFichier</replaceable> "<replaceable>NomMethode</replaceable>";

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: List of compression types which are understood by the acquire methods.  Files like <filename>Packages</filename> can be available in various compression formats.  By default the acquire methods can decompress and recompress many common formats like <command>xz</command> and <command>gzip</command>; with this scope the supported formats can be queried, modified as well as support for more formats added (see also <option>APT::Compressor</option>). The syntax for this is: <placeholder type="synopsis" id="0"/>
fr: Cette option indique la liste des types de compression comprises par les méthodes d'acquisition. Des fichiers comme <filename>Packages</filename> peuvent être disponibles dans divers formats de compression. Par défaut, les méthodes d'acquisition décompressent et recompressent dans beaucoup de formats courants les fichiers compressés comme avec <command>xz</command> et <command>gzip</command> ; ce champ d'action permet de rechercher les formats pris en charge ou de les modifier, et l'ajout de prise en charge de formats supplémentaires est aussi possible (voir aussi <option>APT::Compressor</option>). La syntaxe à utiliser est : <placeholder type="synopsis" id="0"/>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Also, the <literal>Order</literal> subgroup can be used to define in which order the acquire system will try to download the compressed files. The acquire system will try the first and proceed with the next compression type in this list on error, so to prefer one over the other type simply add the preferred type first - types not already added will be implicitly appended to the end of the list, so e.g. <placeholder type="synopsis" id="0"/> can be used to prefer <command>gzip</command> compressed files over all other compression formats.  If <command>xz</command> should be preferred over <command>gzip</command> and <command>bzip2</command> the configure setting should look like this: <placeholder type="synopsis" id="1"/> It is not needed to add <literal>bz2</literal> to the list explicitly as it will be added automatically.
fr: Le sous-groupe <literal>Order</literal> peut être également utilisé pour définir l'ordre dans lequel le système d'acquisition tentera de télécharger les fichiers compressés. Le premier système mentionné sera essayé en premier, puis le suivant en cas d'échec. Ainsi, pour privilégier un format par rapport à un autre, il suffit de le placer en premier dans cette liste. Les types qui ne sont pas déjà indiqués seront ajoutés implicitement à la fin de la liste. Ainsi, par exemple, <placeholder type="synopsis" id="0"/> peut être utilisé pour préférer les fichiers compressés avec <command>gzip</command> par rapport à tous les autres formats de compression. Si l'objectif est d'utiliser <command>xz</command> en priorité par rapport à <command>gzip</command> et <command>bzip2</command>, ce réglage doit ressembler à <placeholder type="synopsis" id="1"/>. Il est inutile d'ajouter explicitement <literal>bz2</literal> à liste car il sera ajouté automatiquement.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note that the <literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will be checked at run time. If this option has been set and support for this format isn't directly built into apt, the method will only be used if this file exists; e.g. for the <literal>bzip2</literal> method (the inbuilt) setting is: <placeholder type="literallayout" id="0"/> Note also that list entries specified on the command line will be added at the end of the list specified in the configuration files, but before the default entries. To prefer a type in this case over the ones specified in the configuration files you can set the option direct - not in list style.  This will not override the defined list; it will only prefix the list with this type.
fr: Veuillez noter que <literal>Dir::Bin::<replaceable>NomMethode</replaceable></literal> sera contrôlé à l'exécution : si cette option est utilisée et que la prise en charge de ce format n'est pas construite dans APT, la méthode ne sera utilisée que si ce fichier existe. Ainsi, pour la méthode <literal>bzip2</literal>, le réglage (utilisé en interne) est <placeholder type="literallayout" id="0"/>. Veuillez également noter que les éléments de liste indiqués à la ligne de commande seront ajoutés à la fin de la liste indiquée dans les fichiers de configuration, mais avant les valeurs par défaut. Dans ce cas, pour établir une préférence par rapport aux types mentionnés dans les fichiers de configuration, il est possible de placer l'option directement, pas sous forme de liste. Cela ne remplacera pas la liste par défaut mais elle sera simplement préfixée avec l'option en question.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The special type <literal>uncompressed</literal> can be used to give uncompressed files a preference, but note that most archives don't provide uncompressed files so this is mostly only usable for local mirrors.
fr: Le type spécial <literal>uncompressed</literal> peut servir à donner la préférence aux fichiers non compressés. Veuillez noter que la plupart des archives ne fournissent pas de fichiers non compressés, donc ce réglage est surtout destiné aux miroirs locaux.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: When downloading <literal>gzip</literal> compressed indexes (Packages, Sources, or Translations), keep them gzip compressed locally instead of unpacking them. This saves quite a lot of disk space at the expense of more CPU requirements when building the local package caches. False by default.
fr: Lorsque des index compressés par gzip doivent être utilisés (pour les fichiers Packages, Sources, Translations), ceux-ci seront compressés avec gzip au lieu d'être laissés décompressés. Cela peut permettre de gagner beaucoup d'espace disque au prix d'une utilisation plus importante du processeur lorsque les caches locaux sont créés. Valeur par défaut : Faux (« False »).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The Languages subsection controls which <filename>Translation</filename> files are downloaded and in which order APT tries to display the description-translations. APT will try to display the first available description in the language which is listed first. Languages can be defined with their short or long language codes. Note that not all archives provide <filename>Translation</filename> files for every language - the long language codes are especially rare.
fr: La sous-section « Languages » contrôle quels fichiers <filename>Translation</filename> sont téléchargés et dans quel ordre APT les utilisera pour afficher les traductions de descriptions. APT recherchera d'abord la première traduction disponible pour le champ Description dans la langue choisie en premier. Les langues peuvent être indiquées par leur code long ou court. Veuillez noter que tous les dépôts ne fournissent pas les fichiers <filename>Translation</filename> pour toutes les langues, les codes longs de langues étant particulièrement rares.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><programlisting>
en: Acquire::Languages { "environment"; "de"; "en"; "none"; "fr"; };
fr: Acquire::Languages { "environment"; "fr"; "en"; "none"; "de"; };

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The default list includes "environment" and "en". "<literal>environment</literal>" has a special meaning here: it will be replaced at runtime with the language codes extracted from the <literal>LC_MESSAGES</literal> environment variable.  It will also ensure that these codes are not included twice in the list. If <literal>LC_MESSAGES</literal> is set to "C" only the <filename>Translation-en</filename> file (if available) will be used.  To force APT to use no Translation file use the setting <literal>Acquire::Languages=none</literal>. "<literal>none</literal>" is another special meaning code which will stop the search for a suitable <filename>Translation</filename> file.  This tells APT to download these translations too, without actually using them unless the environment specifies the languages. So the following example configuration will result in the order "en, de" in an English locale or "de, en" in a German one. Note that "fr" is downloaded, but not used unless APT is used in a French locale (where the order would be "fr, de, en").  <placeholder type="programlisting" id="0"/>
fr: La liste par défaut contient « environment » et « en ». La valeur « environment » a une signification spéciale : elle sera remplacée, à l'exécution, par les codes de langues utilisés dans la variable d'environnement <literal>LC_MESSAGES</literal>. Les codes utilisés en double ne seront pas inclus deux fois dans la liste. Si <literal>LC_MESSAGES</literal> contient « C », seul le fichier <filename>Translation-en</filename> sera utilisé, s'il est disponible. Pour forcer APT à n'utiliser aucun fichier de traduction, il est nécessaire d'utiliser le réglage <literal>Acquire::Languages=none</literal>. La valeur « <literal>none</literal> » a une signification spéciale et indique de ne rechercher aucun fichier <filename>Translation</filename>. Cela indique à APT de télécharger ces traductions, sans nécessairement les utiliser sauf si la variable d'environnement indique ces langues. Ainsi, dans l'exemple qui suit, l'ordre utilisé sera « en, fr » si dans un environnement configuré pour l'anglais et « fr, en » pour un environnement configuré en français. Les fichiers pour l'allemand seront également téléchargés mais ne sont utilisés que dans un environnement configuré pour l'allemand. Dans ce dernier cas, l'ordre est alors « de, fr, en ». <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Note: To prevent problems resulting from APT being executed in different environments (e.g. by different users or by other programs) all Translation files which are found in <filename>/var/lib/apt/lists/</filename> will be added to the end of the list (after an implicit "<literal>none</literal>").
fr: Note : afin d'éviter des problèmes lorsqu'APT est exécuté dans différents environnements (p. ex. par différents utilisateurs ou différents programmes), tous les fichiers « Translation »qui sont trouvés dans <filename>/var/lib/apt/lists/</filename> seront ajoutés à la fin de la liste (après un « <literal>none</literal> » implicite).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: When downloading, force to use only the IPv4 protocol.
fr: Utilisation imposée du protocole IPv4 lors des téléchargements.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: When downloading, force to use only the IPv6 protocol.
fr: Utilisation imposée du protocole IPv6 lors des téléchargements.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The maximum file size of Release/Release.gpg/InRelease files.  The default is 10MB.
fr: La taille maximale des fichiers Release/Release.gpg/InRelease. La taille par défaut est 10 Mo.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option controls if apt will use the DNS SRV server record as specified in RFC 2782 to select an alternative server to connect to.  The default is "true".
fr: Cette option vérifie si APT utilisera l'entrée de serveur DNS SRV telle que définie dans la RFC 2782 pour choisir un serveur alternatif auquel se connecter. La valeur par défaut est « true ».

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allow update operations to load data files from repositories without sufficient security information.  The default value is "<literal>false</literal>".  Concept, implications as well as alternatives are detailed in &apt-secure;.
fr: Autoriser les opérations de mise à jour à charger des fichiers de données à partir de dépôts sans informations de sécurité suffisantes. La valeur par défaut est « <literal>false</literal> ». Le concept, les implications ainsi que les alternatives sont détaillés dans &apt-secure;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allow update operations to load data files from repositories which provide security information, but these are deemed no longer cryptographically strong enough.  The default value is "<literal>false</literal>".  Concept, implications as well as alternatives are detailed in &apt-secure;.
fr: Autoriser les opérations de mise à jour à charger des fichiers de données à partir de dépôts qui fournissent des informations de sécurité, mais qui ne sont plus considérés comme suffisamment robustes sur le plan de la cryptographie. La valeur par défaut est « <literal>false</literal> ». Le concept, les implications ainsi que les alternatives sont détaillés dans &apt-secure;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allow that a repository that was previously gpg signed to become unsigned during an update operation. When there is no valid signature for a previously trusted repository apt will refuse the update. This option can be used to override this protection. You almost certainly never want to enable this. The default is <literal>false</literal>.  Concept, implications as well as alternatives are detailed in &apt-secure;.
fr: Permettre qu'un dépôt qui était auparavant signé par pgp devienne non signé durant l'opération de la mise à jour. Quand il n'y a pas de signature valable pour un ancien dépôt de confiance, APT refusera la mise à jour. Cette option peut être utilisée pour contourner cette protection. Vous ne souhaiterez presque certainement jamais activer cette option. La valeur pas défaut est « <literal>false</literal> ». Le concept, les implications ainsi que les alternatives sont détaillés dans &apt-secure;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: scope
fr: champ d'action

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Acquiring changelogs can only be done if an URI is known from where to get them.  Preferable the Release file indicates this in a 'Changelogs' field. If this isn't available the Label/Origin field of the Release file is used to check if a <literal>Acquire::Changelogs::URI::Label::<replaceable>LABEL</replaceable></literal> or <literal>Acquire::Changelogs::URI::Origin::<replaceable>ORIGIN</replaceable></literal> option exists and if so this value is taken. The value in the Release file can be overridden with <literal>Acquire::Changelogs::URI::Override::Label::<replaceable>LABEL</replaceable></literal> or <literal>Acquire::Changelogs::URI::Override::Origin::<replaceable>ORIGIN</replaceable></literal>.  The value should be a normal URI to a text file, except that package specific data is replaced with the placeholder <literal>@CHANGEPATH@</literal>. The value for it is: 1. if the package is from a component (e.g. <literal>main</literal>)  this is the first part otherwise it is omitted, 2. the first letter of source package name, except if the source package name starts with '<literal>lib</literal>' in which case it will be the first four letters. 3. The complete source package name. 4. the complete name again and 5. the source version.  The first (if present), second, third and fourth part are separated by a slash ('<literal>/</literal>')  and between the fourth and fifth part is an underscore ('<literal>_</literal>').  The special value '<literal>no</literal>' is available for this option indicating that this source can't be used to acquire changelog files from. Another source will be tried if available in this case.
fr: La récupération des journaux des modifications n'est possible que si l'URI où les télécharger est connu. De préférence, le fichier Release l'indique dans un champ « Changelogs ». S'il n'est pas disponible, les champs Label ou Origine du fichier Release sont utilisés pour vérifier si les options <literal>Acquire::Changelogs::URI::Label::<replaceable>LABEL</replaceable></literal> ou <literal>Acquire::Changelogs::URI::Origin::<replaceable>ORIGINE</replaceable></literal> existent, et si c'est le cas, cette valeur est prise. La valeur dans le fichier Release peut être contournée par <literal>Acquire::Changelogs::URI::Override::Label::<replaceable>LABEL</replaceable></literal> ou <literal>Acquire::Changelogs::URI::Override::Origin::<replaceable>ORIGINE</replaceable></literal>. La valeur devrait être un URI normal vers un fichier texte, à l'exception que les données spécifiques du paquet sont remplacées par le paramètre <literal>@CHANGEPATH@</literal>. Sa valeur est la suivante : 1. si le paquet provient d'un composant (par exemple <literal>main</literal>) il constitue la première partie, sinon elle est omise ; 2. est la première lettre du nom du paquet source, sauf si le nom du paquet source commence par <literal>lib</literal> auquel cas les quatre premières lettres seront utilisées ; 3. le nom complet du paquet source ; 4. le nom complet une fois de plus ; 5. la version de la source. Les quatres premières parties (ou trois si le composant est absent) sont séparées par des barres obliques (« <literal>/</literal> »), et les deux dernières sont séparées par un caractère de soulignement (« <literal>_</literal> »). La valeur spéciale « <literal>no</literal> » est disponible pour indiquer que cette source ne peut être utilisée pour récupérer les fichiers changelog. Dans ce cas, une autre source sera essayée.

note: type: Content of: <refentry><refsect1><title>
en: Binary specific configuration
fr: Configuration spécifique d'exécutable

note: type: Content of: <refentry><refsect1><para>
en: Especially with the introduction of the <command>apt</command> binary it can be useful to set certain options only for a specific binary as even options which look like they would effect only a certain binary like <option>APT::Get::Show-Versions</option> effect <command>apt-get</command> as well as <command>apt</command>.
fr: Particulièrement avec l'introduction de l'exécutable <command>apt</command> il peut être utile de configurer certaines options seulement pour un exécutable particulier dans la mesure ou même des options qui semblent affecter seulement certains binaires telles que <option>APT::Get::Show-Versions</option> affectent <command>apt-get</command> autant qu'<command>apt</command>.

note: type: Content of: <refentry><refsect1><para>
en: Setting an option for a specific binary only can be achieved by setting the option inside the <option>Binary::<replaceable>specific-binary</replaceable></option> scope. Setting the option <option>APT::Get::Show-Versions</option> for the <command>apt</command> only can e.g. by done by setting <option>Binary::apt::APT::Get::Show-Versions</option> instead.
fr: La configuration d'une option pour un exécutable particulier peut être réalisée en réglant l'option dans le champ d'action <option>Binary::<replaceable>exécutable-spécifique</replaceable></option>. Affecter l'option <option>APT::Get::Show-Versions</option> à <command>apt</command> seulement peut être fait, par exemple en configurant plutôt <option>Binary::apt::APT::Get::Show-Versions</option>.

note: type: Content of: <refentry><refsect1><para>
en: Note that as seen in the DESCRIPTION section further above you can't set binary-specific options on the commandline itself nor in configuration files loaded via the commandline.
fr: Veuillez noter que comme cela est indiqué dans la section DESCRIPTION plus haut, il n'est pas possible de configurer les options spécifiques aux exécutables en ligne de commande ni dans des fichiers de configuration chargés par la ligne de commande.

note: type: Content of: <refentry><refsect1><title>
en: Directories
fr: Les répertoires

note: type: Content of: <refentry><refsect1><para>
en: The <literal>Dir::State</literal> section has directories that pertain to local state information. <literal>lists</literal> is the directory to place downloaded package lists in and <literal>status</literal> is the name of the &dpkg; status file.  <literal>preferences</literal> is the name of the APT <filename>preferences</filename> file.  <literal>Dir::State</literal> contains the default directory to prefix on all sub-items if they do not start with <filename>/</filename> or <filename>./</filename>.
fr: Les répertoires de la section <literal>Dir::State</literal> concernent le système local. <literal>lists</literal> est le répertoire où placer les listes de paquets téléchargés et <literal>status</literal> est le nom du fichier d'état de &dpkg;. <literal>preferences</literal> concerne APT : c'est le nom du fichier <filename>preferences</filename>. <literal>Dir::State</literal> contient le répertoire par défaut préfixé à tous les sous-éléments, quand ceux-ci ne commencent pas par <filename>/</filename> ou <filename>./</filename>.

note: type: Content of: <refentry><refsect1><para>
en: <literal>Dir::Cache</literal> contains locations pertaining to local cache information, such as the two package caches <literal>srcpkgcache</literal> and <literal>pkgcache</literal> as well as the location to place downloaded archives, <literal>Dir::Cache::archives</literal>. Generation of caches can be turned off by setting <literal>pkgcache</literal> or <literal>srcpkgcache</literal> to <literal>""</literal>.  This will slow down startup but save disk space. It is probably preferable to turn off the pkgcache rather than the srcpkgcache.  Like <literal>Dir::State</literal> the default directory is contained in <literal>Dir::Cache</literal>
fr: <literal>Dir::Cache</literal> contient les emplacements qui renseignent sur le cache local : par exemple, les deux caches de paquets <literal>srcpkgcache</literal> et <literal>pkgcache</literal>, ainsi que l'endroit où sont placées les archives téléchargées, <literal>Dir::Cache::archives</literal>. On peut empêcher la création des caches en positionnant <literal>pkgcache</literal> ou <literal>srcpkgcache</literal> à la valeur <literal>""</literal>. Cela ralentit le démarrage mais économise de l'espace disque. Il vaut mieux se passer du cache <literal>pkgcache</literal> plutôt que se passer du cache <literal>srcpkgcache</literal>. Comme pour <literal>Dir::State</literal>, le répertoire par défaut est contenu dans <literal>Dir::Cache</literal>.

note: type: Content of: <refentry><refsect1><para>
en: <literal>Dir::Etc</literal> contains the location of configuration files, <literal>sourcelist</literal> gives the location of the sourcelist and <literal>main</literal> is the default configuration file (setting has no effect, unless it is done from the config file specified by <envar>APT_CONFIG</envar>).
fr: <literal>Dir::Etc</literal> contient l'emplacement des fichiers de configuration, <literal>sourcelist</literal> indique l'emplacement de la liste de sources et <literal>main</literal> est le fichier de configuration par défaut (le modifier n'a aucun effet, à moins qu'on ne le modifie avec le fichier de configuration indiqué par la variable <envar>APT_CONFIG</envar>).

note: type: Content of: <refentry><refsect1><para>
en: The <literal>Dir::Parts</literal> setting reads in all the config fragments in lexical order from the directory specified. After this is done then the main config file is loaded.
fr: <literal>Dir::Parts</literal> lit, par ordre d'entrée, tous les fragments de configuration dans le répertoire indiqué. Ensuite, le fichier principal de configuration est chargé.

note: type: Content of: <refentry><refsect1><para>
en: Binary programs are pointed to by <literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> specifies the location of the method handlers and <literal>gzip</literal>, <literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, <literal>apt-get</literal> <literal>dpkg-source</literal> <literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> specify the location of the respective programs.
fr: Les programmes binaires sont pointés par <literal>Dir::Bin</literal>. L'emplacement des gestionnaires de méthodes est indiqué par <literal>Dir::Bin::Methods</literal> ; <literal>gzip</literal>, <literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, <literal>apt-get</literal>, <literal>dpkg-source</literal>, <literal>dpkg-buildpackage</literal> et <literal>apt-cache</literal> indiquent l'emplacement des programmes correspondants.

note: type: Content of: <refentry><refsect1><para>
en: The configuration item <literal>RootDir</literal> has a special meaning.  If set, all paths will be relative to <literal>RootDir</literal>, <emphasis>even paths that are specified absolutely</emphasis>.  So, for instance, if <literal>RootDir</literal> is set to <filename>/tmp/staging</filename> and <literal>Dir::State::status</literal> is set to <filename>/var/lib/dpkg/status</filename>, then the status file will be looked up in <filename>/tmp/staging/var/lib/dpkg/status</filename>.  If you want to prefix only relative paths, set <literal>Dir</literal> instead.
fr: L'option de configuration <literal>RootDir</literal> a une signification particulière. Lorsqu'elle est définie, tous les chemins sont considérés relativement à <literal>RootDir</literal>, <emphasis>même les chemins spécifiés de manière absolue</emphasis>. Ainsi par exemple si <literal>RootDir</literal> est défini comme <filename>/tmp/staging</filename>, et que chemin du fichier d'état <literal>Dir::State::status</literal> est déclaré comme <filename>/var/lib/dpkg/status</filename> alors ce fichier sera cherché dans <filename>/tmp/staging/var/lib/dpkg/status</filename>. Si vous souhaitez seulement préfixer des chemins relatifs, définissez plutôt <literal>Dir</literal>.

note: type: Content of: <refentry><refsect1><para>
en: The <literal>Ignore-Files-Silently</literal> list can be used to specify which files APT should silently ignore while parsing the files in the fragment directories. Per default a file which ends with <literal>.disabled</literal>, <literal>~</literal>, <literal>.bak</literal> or <literal>.dpkg-[a-z]+</literal> is silently ignored. As seen in the last default value these patterns can use regular expression syntax.
fr: La liste <literal>Ignore-Files-Silently</literal> permet d'indiquer quels sont les fichiers qu'APT peut ignorer sans avertissement dans les répertoires contenant des fragments de configuration. Par défaut, les fichiers qui se terminent par <literal>.disabled</literal>, <literal>~</literal>, <literal>.bak</literal> ou <literal>.dpkg-[a-z]+</literal> sont ignorés. Comme cela est visible dans le dernier élément de cette liste, il est possible d'utiliser la syntaxe des expressions rationnelles.

note: type: Content of: <refentry><refsect1><title>
en: APT in DSelect
fr: APT et DSelect

note: type: Content of: <refentry><refsect1><para>
en: When APT is used as a &dselect; method several configuration directives control the default behavior. These are in the <literal>DSelect</literal> section.
fr: Quand APT est utilisé comme une méthode de &dselect;, plusieurs directives contrôlent le comportement par défaut. On les trouve dans la section <literal>DSelect</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Cache Clean mode; this value may be one of <literal>always</literal>, <literal>prompt</literal>, <literal>auto</literal>, <literal>pre-auto</literal> and <literal>never</literal>.  <literal>always</literal> and <literal>prompt</literal> will remove all packages from the cache after upgrading, <literal>prompt</literal> (the default) does so conditionally.  <literal>auto</literal> removes only those packages which are no longer downloadable (replaced with a new version for instance).  <literal>pre-auto</literal> performs this action before downloading new packages.
fr: Mode de nettoyage du cache ; cette variable peut prendre l'une des valeurs suivantes : « <literal>always</literal> », « <literal>prompt</literal> », « <literal>auto</literal> », « <literal>pre-auto</literal> » et « <literal>never</literal> ». « <literal>always</literal> » et « <literal>prompt</literal> » suppriment tous les paquets du cache après la mise à niveau ; « <literal>prompt</literal> » (valeur par défaut) les supprime après une demande et « <literal>auto</literal> » ne supprime que les archives qui ne peuvent plus être téléchargées (remplacées, par exemple, par une nouvelle version). « <literal>pre-auto</literal> » les supprime avant de récupérer de nouveaux paquets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The contents of this variable are passed to &apt-get; as command line options when it is run for the install phase.
fr: Le contenu de cette variable est passé comme options de ligne de commande à &apt-get; lors de la phase d'installation.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The contents of this variable are passed to &apt-get; as command line options when it is run for the update phase.
fr: Le contenu de cette variable est passé comme options de ligne de commande à &apt-get; lors de la phase de mise à jour.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If true the [U]pdate operation in &dselect; will always prompt to continue.  The default is to prompt only on error.
fr: Si cette option est « true », l'opération [U]pdate de &dselect; interroge toujours l'utilisateur avant de continuer. Par défaut, ce n'est qu'en cas d'erreur que l'on propose à l'utilisateur d'intervenir.

note: type: Content of: <refentry><refsect1><title>
en: How APT calls &dpkg;
fr: Méthode d'appel de &dpkg; par APT

note: type: Content of: <refentry><refsect1><para>
en: Several configuration directives control how APT invokes &dpkg;. These are in the <literal>DPkg</literal> section.
fr: Plusieurs directives de configuration contrôlent la manière dont APT invoque &dpkg; : elles figurent dans la section <literal>DPkg</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is a list of options to pass to &dpkg;. The options must be specified using the list notation and each list item is passed as a single argument to &dpkg;.
fr: Il s'agit d'une liste d'options à passer à &dpkg;. Les options doivent être déclarées en utilisant la notation de liste et chaque élément de la liste est passé comme un seul paramètre à &dpkg;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is a string that defines the <envar>PATH</envar> environment variable used when running dpkg. It may be set to any valid value of that environment variable; or the empty string, in which case the variable is not changed.
fr: Il s'agit d'une chaîne qui définit la variable d'environnement <envar>PATH</envar> utilisée lors de l'exécution de dpkg. Elle peut être définie à n'importe quelle valeur valable pour cette variable d'environnement ou être une chaîne vide, dans ce cas la variable n'est pas modifiée.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is a list of shell commands to run before/after invoking &dpkg;.  Like <literal>options</literal> this must be specified in list notation. The commands are invoked in order using <filename>/bin/sh</filename>; should any fail APT will abort.
fr: Il s'agit d'une liste de commandes shell à exécuter avant ou après l'appel de &dpkg;. Tout comme pour <literal>Options</literal>, on doit utiliser la notation de liste. Les commandes sont appelées dans l'ordre, en utilisant <filename>/bin/sh</filename> : APT s'arrête dès que l'une d'elles échoue.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This is a list of shell commands to run before invoking &dpkg;. Like <literal>options</literal> this must be specified in list notation. The commands are invoked in order using <filename>/bin/sh</filename>; should any fail APT will abort. APT will pass the filenames of all .deb files it is going to install to the commands, one per line on the requested file descriptor, defaulting to standard input.
fr: Il s'agit d'une liste de commandes shell à exécuter avant d'appeler &dpkg;. Tout comme pour <literal>Options</literal>, on doit utiliser la notation de liste. Les commandes sont appelées dans l'ordre, en utilisant <filename>/bin/sh</filename> : APT s'arrête dès que l'une d'elles échoue. APT transmet aux commandes les noms de tous les fichiers .deb qu'il va installer, à raison d'un par ligne sur le descripteur de fichier demandé, par défaut sur l'entrée standard.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Version 2 of this protocol sends more information through the requested file descriptor: a line with the text <literal>VERSION 2</literal>, the APT configuration space, and a list of package actions with filename and version information.
fr: La version 2 de ce protocole envoie plus d'informations à travers le descripteur du fichier requis : une ligne avec le texte <literal>VERSION 2</literal>, l'espace de configuration d'APT et une liste d'actions de paquet avec le nom de fichier et l'information de version.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Each configuration directive line has the form <literal>key=value</literal>.  Special characters (equal signs, newlines, nonprintable characters, quotation marks, and percent signs in <literal>key</literal> and newlines, nonprintable characters, and percent signs in <literal>value</literal>) are %-encoded. Lists are represented by multiple <literal>key::=value</literal> lines with the same key. The configuration section ends with a blank line.
fr: Chaque ligne de directive de configuration a la forme <literal>clé=valeur</literal>. Les caractères spéciaux (signes égal, fin de ligne, caractères non imprimables, guillemets et signe pourcentage dans <literal>clé</literal> et fin de ligne, caractères non imprimables et signe pourcentage dans <literal>valeur</literal>) sont %-encodés (encodage URL). Les listes sont représentés par des lignes <literal>clé::=valeur</literal> multiples avec la même clé. Les sections de la configuration se terminent par une ligne vide.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Package action lines consist of five fields in Version 2: package name (without architecture qualification even if foreign), old version, direction of version change (&lt; for upgrades, &gt; for downgrades, = for no change), new version, action. The version fields are "-" for no version at all (for example when installing a package for the first time; no version is treated as earlier than any real version, so that is an upgrade, indicated as <literal>- &lt; 1.23.4</literal>). The action field is "**CONFIGURE**" if the package is being configured, "**REMOVE**" if it is being removed, or the filename of a .deb file if it is being unpacked.
fr: Les lignes d'action de paquet consistent en cinq champs dans la version 2 : le nom du paquet (sans qualification d'architecture, même si c'est une architecture supplémentaire – « foreign »), la version ancienne, la direction du changement de version (&lt; pour les mises à niveau, &gt; pour les retours en arrière, = pour pas de modification), la nouvelle version, l'action. Les champs versions sont « - » pour pas de version du tout (par exemple lors de la première installation d'un paquet ; pas de version est traité comme antérieur à n'importe quelle version réelle, ainsi c'est une mise à jour, indiquée comme <literal>- &lt; 1.23.4</literal>). Le champ action est « **CONFIGURE** » si le paquet est en cours de configuration, « **REMOVE** » s'il est en cours de suppression, ou bien le nom d'un fichier .deb s'il est en cours de dépaquetage.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: In Version 3 after each version field follows the architecture of this version, which is "-" if there is no version, and a field showing the MultiArch type "same", "foreign", "allowed" or "none". Note that "none" is an incorrect typename which is just kept to remain compatible, it should be read as "no" and users are encouraged to support both.
fr: Dans la Version 3, après chaque champ version, se trouve l’architecture de cette version qui est « - » s'il n'y a pas de version, puis un champ montrant le type MultiArch « same », « foreign », « allowed » ou « none ». Veuillez noter que « none » est un nom de type incorrect qui est juste conservé pour des raisons de compatibilité, il devrait être lu comme « no » et les utilisateurs sont encouragés à prendre en charge les deux.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The version of the protocol to be used for the command <literal><replaceable>cmd</replaceable></literal> can be chosen by setting <literal>DPkg::Tools::options::<replaceable>cmd</replaceable>::Version</literal> accordingly, the default being version 1. If APT isn't supporting the requested version it will send the information in the highest version it has support for instead.
fr: La version du protocole qu'il faut utiliser pour la commande <literal><replaceable>cmd</replaceable></literal> peut être choisie en réglant <literal>DPkg::Tools::options::<replaceable>cmd</replaceable>::Version</literal> en conséquence, la version par défaut étant la première. Si APT ne gère pas la version demandée, il enverra les informations dans la version la plus haute qu'il gère.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The file descriptor to be used to send the information can be requested with <literal>DPkg::Tools::options::<replaceable>cmd</replaceable>::InfoFD</literal> which defaults to <literal>0</literal> for standard input and is available since version 0.9.11. Support for the option can be detected by looking for the environment variable <envar>APT_HOOK_INFO_FD</envar> which contains the number of the used file descriptor as a confirmation.
fr: Le descripteur de fichier à utiliser pour l'envoi des informations peut être demandé avec l'option <literal>DPkg::Tools::options::<replaceable>cmd</replaceable>::InfoFD</literal> qui est par défaut <literal>0</literal> comme entrée standard ; l'option est disponible depuis la version 0.9.11. La prise en charge de l'option peut être détectée en regardant la variable d'environnement <envar>APT_HOOK_INFO_FD</envar> qui contient comme confirmation le numéro du descripteur de fichier utilisé.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: APT chdirs to this directory before invoking &dpkg;, the default is <filename>/</filename>.
fr: APT se place dans ce répertoire avant d'appeler &dpkg; ; par défaut, c'est le répertoire <filename>/</filename>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: These options are passed to &dpkg-buildpackage; when compiling packages; the default is to disable signing and produce all binaries.
fr: Ces options sont passées à &dpkg-buildpackage; lors de la compilation des paquets ; par défaut la signature est désactivée et tous les binaires sont créés.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If this option is set APT will call <command>dpkg --configure --pending</command> to let &dpkg; handle all required configurations and triggers. This option is activated by default, but deactivating it could be useful if you want to run APT multiple times in a row - e.g. in an installer.  In this scenario you could deactivate this option in all but the last run.
fr: Si cette option est choisie, APT lancera <command>dpkg --configure --pending</command> pour laisser &dpkg; gérer les configurations de paquets et les actions différées. Cette option est automatiquement activée. Il peut par contre être utile de la désactiver pour lancer APT plusieurs fois successives, par exemple quand il est utilisé depuis un outil d'installation. Dans ce cas, seul le dernier de tous les appels successifs peut conserver l'option active.

note: type: Content of: <refentry><refsect1><title>
en: Periodic and Archives options
fr: Options « Periodic » et « Archive »

note: type: Content of: <refentry><refsect1><para>
en: <literal>APT::Periodic</literal> and <literal>APT::Archives</literal> groups of options configure behavior of apt periodic updates, which is done by the <literal>/usr/lib/apt/apt.systemd.daily</literal> script. See the top of this script for the brief documentation of these options.
fr: Les groupes d'options <literal>APT::Periodic</literal> et <literal>APT::Archive</literal> configurent les comportements périodiques réalisés par le script <literal>/usr/lib/apt/apt.systemd.daily</literal>, lancé quotidiennement.

note: type: Content of: <refentry><refsect1><title>
en: Debug options
fr: Les options de débogage

note: type: Content of: <refentry><refsect1><para>
en: Enabling options in the <literal>Debug::</literal> section will cause debugging information to be sent to the standard error stream of the program utilizing the <literal>apt</literal> libraries, or enable special program modes that are primarily useful for debugging the behavior of <literal>apt</literal>.  Most of these options are not interesting to a normal user, but a few may be:
fr: Les options de la section <literal>Debug::</literal> servent soit à provoquer l'affichage d'informations de débogage sur la sortie d'erreur standard du programme qui utilise les bibliothèques APT, soit à activer des modes de fonctionnement spéciaux qui sont principalement utiles pour déboguer le comportement de <literal>APT</literal>. La plupart de ces options n'ont pas d'intérêt pour un utilisateur normal, mais certaines peuvent tout de même être utiles :

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <literal>Debug::pkgProblemResolver</literal> enables output about the decisions made by <literal>dist-upgrade, upgrade, install, remove, purge</literal>.
fr: <literal>Debug::pkgProblemResolver</literal> affiche d'intéressantes informations sur les décisions prises par les commandes <literal>dist-upgrade, upgrade, install, remove et purge</literal>.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <literal>Debug::NoLocking</literal> disables all file locking.  This can be used to run some operations (for instance, <literal>apt-get -s install</literal>) as a non-root user.
fr: <literal>Debug::NoLocking</literal> désactive le verrouillage de fichier de manière à ce qu'APT puisse effectuer quelques opérations (telles que <literal>apt-get -s install</literal>) sans avoir les privilèges du superutilisateur.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <literal>Debug::pkgDPkgPM</literal> prints out the actual command line each time that <literal>apt</literal> invokes &dpkg;.
fr: <literal>Debug::pkgDPkgPM</literal> affiche la ligne de commande à chaque appel de &dpkg;.

note: TODO: provide a motivating example, except I haven't a clue why you'd want to do this. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data in CD-ROM IDs.
fr: <literal>Debug::IdentCdrom</literal> désactive l'inclusion de données de type statfs dans les identifiants de CD.

note: type: Content of: <refentry><refsect1><para>
en: A full list of debugging options to apt follows.
fr: Liste complète des options de débogage de APT :

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information related to accessing <literal>cdrom://</literal> sources.
fr: Affiche les informations concernant les sources de type <literal>cdrom://</literal>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information related to downloading packages using FTP.
fr: Affiche les informations concernant le téléchargement de paquets par FTP.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information related to downloading packages using HTTP.
fr: Affiche les informations concernant le téléchargement de paquets par HTTP.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information related to verifying cryptographic signatures using <literal>gpg</literal>.
fr: Affiche les informations relatives à la vérification de signatures cryptographiques avec <literal>gpg</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output information about the process of accessing collections of packages stored on CD-ROMs.
fr: Affiche des informations concernant l'accès aux collections de paquets stockées sur CD.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output each cryptographic hash that is generated by the <literal>apt</literal> libraries.
fr: Affiche toutes les clés de hachage cryptographiques créées par les librairies d'<literal>apt</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not include information from <literal>statfs</literal>, namely the number of used and free blocks on the CD-ROM filesystem, when generating an ID for a CD-ROM.
fr: Désactive l'inclusion des données de type <literal>statfs</literal> pour la génération des identifiants de CD, c'est-à-dire le nombre de blocs libres et utilisés sur le système de fichier du CD.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Disable all file locking.  For instance, this will allow two instances of <quote><literal>apt-get update</literal></quote> to run at the same time.
fr: Désactive le verrouillage de fichiers. Cela permet par exemple de lancer deux instances de <quote><literal>apt-get update</literal></quote> en même temps.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Log when items are added to or removed from the global download queue.
fr: Trace les ajouts et suppressions d'éléments de la queue globale de téléchargement.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output status messages and errors related to verifying checksums and cryptographic signatures of downloaded files.
fr: Affiche les détails de la vérification des sommes de contrôle et des signatures cryptographiques des fichiers téléchargés, ainsi que les erreurs éventuelles.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output information about downloading and applying package index list diffs, and errors relating to package index list diffs.
fr: Affiche les informations de téléchargement et de prise en compte des fichiers différentiels des indexes de paquets, ainsi que les erreurs éventuelles.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output information related to patching apt package lists when downloading index diffs instead of full indices.
fr: Affiche les détails de l'application des fichiers de différences aux listes de paquets d'APT quand ces fichiers de différences sont téléchargés à la place des fichiers complets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Log all interactions with the sub-processes that actually perform downloads.
fr: Affiche toutes les interactions avec les processus enfants qui se chargent effectivement des téléchargements.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Log events related to the automatically-installed status of packages and to the removal of unused packages.
fr: Affiche les changements concernant le marquage des paquets comme installés automatiquement, et la suppression des paquets inutiles.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Generate debug messages describing which packages are being automatically installed to resolve dependencies.  This corresponds to the initial auto-install pass performed in, e.g., <literal>apt-get install</literal>, and not to the full <literal>apt</literal> dependency resolver; see <literal>Debug::pkgProblemResolver</literal> for that.
fr: Crée les informations de débogage décrivant quels paquets sont installés automatiquement pour satisfaire les dépendances. Cela concerne la passe initiale d'installation automatique effectuée par exemple par <literal>apt-get install</literal> et pas le système de résolution de dépendances complet de APT ; voir <literal>Debug::pkgProblemResolver</literal> pour ce dernier.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Generate debug messages describing which packages are marked as keep/install/remove while the ProblemResolver does his work.  Each addition or deletion may trigger additional actions; they are shown indented two additional spaces under the original entry.  The format for each line is <literal>MarkKeep</literal>, <literal>MarkDelete</literal> or <literal>MarkInstall</literal> followed by <literal>package-name &lt;a.b.c -&gt; d.e.f | x.y.z&gt; (section)</literal> where <literal>a.b.c</literal> is the current version of the package, <literal>d.e.f</literal> is the version considered for installation and <literal>x.y.z</literal> is a newer version, but not considered for installation (because of a low pin score). The later two can be omitted if there is none or if it is the same as the installed version.  <literal>section</literal> is the name of the section the package appears in.
fr: Crée les informations de débogage décrivant quels paquets sont gardés/installés/supprimés pendant le travail de l'outil de résolution de problèmes. Chaque ajout ou suppression peut impliquer des actions supplémentaires ; elles sont alors indiquées avec une indentation de deux espaces de plus que l'action qui les a déclenchées. Le format de chaque ligne est <literal>MarkKeep</literal>, <literal>MarkDelete</literal> ou <literal>MarkInstall</literal> suivi de <literal>nom-paquet &lt;a.b.c -&gt; d.e.f | x.y.z&gt; (section)</literal> où <literal>a.b.c</literal> est la version actuelle du paquet, <literal>d.e.f</literal> la version devant être installée et <literal>x.y.z</literal> une version plus récente qui n'est pas prévue pour être installée (à cause d'un score plus faible). Ces deux derniers éléments peuvent ne pas être mentionnés s'ils ne sont pas pertinents où lorsque ils sont identiques à la version installée. <literal>section</literal> est le nom de la section où figure le paquet.automatiquement pour satisfaire les dépendances. Cela concerne la passe initiale d'installation automatique effectuée par exemple par <literal>apt-get install</literal> et pas le système de résolution de dépendances complet de APT ; voir <literal>Debug::pkgProblemResolver</literal> pour ce dernier.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: When invoking &dpkg;, output the precise command line with which it is being invoked, with arguments separated by a single space character.
fr: Affiche la commande exacte d'invocation de &dpkg; à chaque appel ; les paramètres sont séparés par des espaces.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output all the data received from &dpkg; on the status file descriptor and any errors encountered while parsing it.
fr: Affiche l'ensemble des informations reçues de &dpkg; par l'intermédiaire du descripteur de fichier d'état, et les éventuelles erreurs d'analyse de ce fichier.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Generate a trace of the algorithm that decides the order in which <literal>apt</literal> should pass packages to &dpkg;.
fr: Affiche les étapes de l'algorithme utilisé pour choisir l'ordre dans lequel <literal>apt</literal> passe les paquets à &dpkg;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output status messages tracing the steps performed when invoking &dpkg;.
fr: Affiche le détail des opérations liées à l'invocation de &dpkg;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Output the priority of each package list on startup.
fr: Affiche, au lancement, la priorité de chaque liste de paquets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Trace the execution of the dependency resolver (this applies only to what happens when a complex dependency problem is encountered).
fr: Affiche la trace d'exécution du système de résolution de dépendances (ne concerne que les cas où un problème de dépendances complexe se présente).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Display a list of all installed packages with their calculated score used by the pkgProblemResolver. The description of the package is the same as described in <literal>Debug::pkgDepCache::Marker</literal>
fr: Affiche la liste de tous les paquets installés avec leur score calculé par l'outil de résolution de problèmes. La description du paquet est celle qui est décrite dans <literal>Debug::pkgDepCache::Marker</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Print information about the vendors read from <filename>/etc/apt/vendors.list</filename>.
fr: Affiche les fournisseurs déclarés dans le fichier <filename>/etc/apt/vendors.list</filename>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Display the external commands that are called by apt hooks.  This includes e.g. the config options <literal>DPkg::{Pre,Post}-Invoke</literal> or <literal>APT::Update::{Pre,Post}-Invoke</literal>.
fr: Affiche les commandes externes qui sont appelés par le point d'entrée apt. Cela inclut par exemple les options de configuration <literal>DPkg::{Pre,Post}-Invoke</literal> ou <literal>APT::Update::{Pre,Post}-Invoke</literal>.

note: type: Content of: <refentry><refsect1><title>
en: Examples
fr: Exemples

note: type: Content of: <refentry><refsect1><para>
en: &configureindex; is a configuration file showing example values for all possible options.
fr: Le fichier &configureindex; contient un modèle de fichier montrant des exemples pour toutes les options existantes.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Preference control file for APT
fr: Fichier de contrôle des préférences pour APT

note: type: Content of: <refentry><refsect1><para>
en: The APT preferences file <filename>/etc/apt/preferences</filename> and the fragment files in the <filename>/etc/apt/preferences.d/</filename> folder can be used to control which versions of packages will be selected for installation.
fr: Le fichier d'APT, <filename>/etc/apt/preferences</filename> et les fichiers fragments situés dans le dossier <filename>/etc/apt/preferences.d/</filename>, peuvent être utilisés pour choisir la version des paquets que l'on veut installer.

note: type: Content of: <refentry><refsect1><para>
en: Several versions of a package may be available for installation when the &sources-list; file contains references to more than one distribution (for example, <literal>stable</literal> and <literal>testing</literal>).  APT assigns a priority to each version that is available.  Subject to dependency constraints, <command>apt-get</command> selects the version with the highest priority for installation.  The APT preferences override the priorities that APT assigns to package versions by default, thus giving the user control over which one is selected for installation.
fr: Quand le fichier &sources-list; contient des références à plusieurs distributions (par exemple, <literal>stable</literal> et <literal>testing</literal>), plusieurs versions d'un paquet peuvent être installées. APT affecte une priorité à chaque version disponible. La commande <command>apt-get</command>, tenant compte des contraintes de dépendance, installe la version qui possède la priorité la plus haute.  Le fichier <filename>preferences</filename> annule les priorités assignées par défaut aux versions des paquets : ainsi l'utilisateur peut choisir la version qu'il veut installer.

note: type: Content of: <refentry><refsect1><para>
en: Several instances of the same version of a package may be available when the &sources-list; file contains references to more than one source.  In this case <command>apt-get</command> downloads the instance listed earliest in the &sources-list; file.  The APT preferences do not affect the choice of instance, only the choice of version.
fr: Si le fichier &sources-list; contient, pour une même distribution, des références à plusieurs sites de téléchargement, il peut exister plusieurs exemplaires de la même version d'un paquet. Dans ce cas, <command>apt-get</command> télécharge l'exemplaire qui apparaît en premier dans le fichier &sources-list;. Le fichier <filename>preferences</filename> n'influe pas sur le choix des exemplaires, seulement sur le choix de la version.

note: type: Content of: <refentry><refsect1><para>
en: Preferences are a strong power in the hands of a system administrator but they can become also their biggest nightmare if used without care! APT will not question the preferences, so wrong settings can lead to uninstallable packages or wrong decisions while upgrading packages.  Even more problems will arise if multiple distribution releases are mixed without a good understanding of the following paragraphs.  Packages included in a specific release aren't tested in (and therefore don't always work as expected in) older or newer releases, or together with other packages from different releases.  You have been warned.
fr: Les préférences sont un outil puissant pour les administrateurs système mais peuvent devenir leur pire cauchemar si elles sont utilisées sans précautions. APT ne remettra pas en doute les réglages choisis. Des valeurs erronées pourront alors conduire à des paquets non installables ou à des décisions incorrectes lors de la mise à jour des paquets. Des problèmes supplémentaires peuvent survenir si des distributions multiples sont mélangées sans une bonne compréhension des paragraphes qui suivent.

note: type: Content of: <refentry><refsect1><para>
en: Note that the files in the <filename>/etc/apt/preferences.d</filename> directory are parsed in alphanumeric ascending order and need to obey the following naming convention: The files have either no or "<literal>pref</literal>" as filename extension and only contain alphanumeric, hyphen (-), underscore (_) and period (.) characters.  Otherwise APT will print a notice that it has ignored a file, unless that file matches a pattern in the <literal>Dir::Ignore-Files-Silently</literal> configuration list - in which case it will be silently ignored.
fr: Veuillez noter que les fichiers du répertoire <filename>/etc/apt/preferences.d</filename> sont analysés par ordre alphanumérique ascendant, doivent avoir l'extension "<literal>pref</literal>" ou aucune extension et ne peuvent contenir que des caractères alphanumériques, des tirets (-), des caractères de soulignement (_) et des points (.). Dans le cas contraire, APT affichera un avertissement indiquant qu'il a ignoré un fichier si celui-ci ne correspond par à un motif défini dans <literal>Dir::Ignore-Files-Silently</literal> (les fichiers correspondant à cette variable de configuration étant, eux, ignorés silencieusemennt).

note: type: Content of: <refentry><refsect1><refsect2><title>
en: APT's Default Priority Assignments
fr: Priorités affectées par défaut

note: type: Content of: <refentry><refsect1><refsect2><para><programlisting>
en: <command>apt-get install -t testing <replaceable>some-package</replaceable></command>
fr: <command>apt-get install -t testing <replaceable>paquet</replaceable></command>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: If there is no preferences file or if there is no entry in the file that applies to a particular version then the priority assigned to that version is the priority of the distribution to which that version belongs.  It is possible to single out a distribution, "the target release", which receives a higher priority than other distributions do by default.  The target release can be set on the <command>apt-get</command> command line or in the APT configuration file <filename>/etc/apt/apt.conf</filename>.  Note that this has precedence over any general priority you set in the <filename>/etc/apt/preferences</filename> file described later, but not over specifically pinned packages.  For example, <placeholder type="programlisting" id="0"/> <placeholder type="programlisting" id="1"/>
fr: Quand le fichier des préférences n'existe pas, ou quand aucune entrée de ce fichier ne s'applique à une version précise, la priorité affectée à cette version est la priorité de la distribution à laquelle elle appartient.  On peut distinguer une distribution et lui donner une priorité plus haute que celle des autres distributions : on l'appelle la distribution par défaut ou « target release » et elle peut être définie sur la ligne de commande de <command>apt-get</command> ou dans le fichier de configuration d'APT, <filename>/etc/apt/apt.conf</filename>.  Par exemple : <placeholder type="programlisting" id="0"/> <placeholder type="programlisting" id="1"/>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: If the target release has been specified then APT uses the following algorithm to set the priorities of the versions of a package.  Assign:
fr: Quand une distribution par défaut a été indiquée, APT utilise l'algorithme suivant pour déterminer la priorité des versions d'un paquet :

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: priority 1
fr: priorité 1

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: priority 100
fr: une priorité égale à 100

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: to the version that is already installed (if any) and to the versions coming from archives which in their <filename>Release</filename> files are marked as "NotAutomatic: yes" and "ButAutomaticUpgrades: yes" like the Debian backports archive since <literal>squeeze-backports</literal>.
fr: pour les versions issues d'archives dont le fichier <filename>Release</filename> comporte la mention « NotAutomatic: yes » et « ButAutomaticUpgrades: yes » comme l'archive des rétroportages de Debian depuis <literal>squeeze-backports</literal>.

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: priority 500
fr: une priorité égale à 500

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: to the versions that do not belong to the target release.
fr: est affectée aux versions qui n'appartiennent pas à la distribution par défaut.

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: priority 990
fr: une priorité égale à 990

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: to the versions that belong to the target release.
fr: est affectée aux versions qui appartiennent à la distribution par défaut.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The highest of those priorities whose description matches the version is assigned to the version.
fr: La priorité la plus élevée dont la description correspond à la version est affectée à la version.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: If the target release has not been specified then APT simply assigns priority 100 to all installed package versions and priority 500 to all uninstalled package versions, except versions coming from archives which in their <filename>Release</filename> files are marked as "NotAutomatic: yes" - these versions get the priority 1 or priority 100 if it is additionally marked as "ButAutomaticUpgrades: yes".
fr: Quand aucune distribution par défaut n'a été indiquée, APT affecte simplement une priorité égale à 100 à toute version installée d'un paquet et une priorité égale à 500 à tout version non installée. Cela à l'exception des versions issues des archives qui ont la mention « NotAutomatic: yes » dans leur fichier <filename>Release</filename>, qui auront alors une priorité égale à 1 ou à 100 si elles sont également marquées avec « ButAutomaticUpgrades: yes ».

note: type: Content of: <refentry><refsect1><refsect2><para>
en: APT then applies the following rules, listed in order of precedence, to determine which version of a package to install.
fr: Puis APT applique les règles suivantes pour déterminer la version du paquet qu'il faut installer (par ordre de priorité) :

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: Never downgrade unless the priority of an available version exceeds 1000.  ("Downgrading" is installing a less recent version of a package in place of a more recent version.  Note that none of APT's default priorities exceeds 1000; such high priorities can only be set in the preferences file.  Note also that downgrading a package can be risky.)
fr: Ne jamais revenir en arrière, sauf si la priorité d'une version disponible dépasse 1000. « Revenir en arrière » signifie installer une version moins récente que la version installée. Il faut noter qu'aucune des priorités par défaut n'excède 1000 ; de telles valeurs ne peuvent être définies que dans le fichier des préférences. Notez aussi qu'il est risqué de revenir en arrière.

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: Install the highest priority version.
fr: Installer la version qui possède la priorité la plus haute.

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: If two or more versions have the same priority, install the most recent one (that is, the one with the higher version number).
fr: Quand deux (ou plus) versions ont la même priorité, installer la version la plus récente (c.-à-d. celle dont le numéro de version est le plus grand).

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: If two or more versions have the same priority and version number but either the packages differ in some of their metadata or the <literal>--reinstall</literal> option is given, install the uninstalled one.
fr: Quand deux (ou plus) versions ont la même priorité et le même numéro de version, mais soit les paquets diffèrent par certaines métadonnées, soit l'option <literal>--reinstall</literal> a été donnée, installer la version qui n'est pas installée.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: In a typical situation, the installed version of a package (priority 100)  is not as recent as one of the versions available from the sources listed in the &sources-list; file (priority 500 or 990).  Then the package will be upgraded when <command>apt-get install <replaceable>some-package</replaceable></command> or <command>apt-get upgrade</command> is executed.
fr: En général, la version installée d'un paquet (priorité 100) n'est pas aussi récente que les versions disponibles dans les sources listées dans le fichier &sources-list; (priorité 500 ou 990). Et donc le paquet sera mis à niveau avec la commande : <command>apt-get install <replaceable>paquet</replaceable></command> ou <command>apt-get dist-upgrade</command>.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: More rarely, the installed version of a package is <emphasis>more</emphasis> recent than any of the other available versions.  The package will not be downgraded when <command>apt-get install <replaceable>some-package</replaceable></command> or <command>apt-get upgrade</command> is executed.
fr: La version installée d'un paquet peut être - rarement - <emphasis>plus</emphasis> récente que tout autre version disponible. Les commandes <command>apt-get install <replaceable>paquet</replaceable></command> ou <command>apt-get upgrade</command> ne provoquent pas de retour en arrière.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Sometimes the installed version of a package is more recent than the version belonging to the target release, but not as recent as a version belonging to some other distribution.  Such a package will indeed be upgraded when <command>apt-get install <replaceable>some-package</replaceable></command> or <command>apt-get upgrade</command> is executed, because at least <emphasis>one</emphasis> of the available versions has a higher priority than the installed version.
fr: Parfois, la version installée d'un paquet est plus récente que la version appartenant à la distribution par défaut, mais moins récente que la version appartenant à une autre distribution. Une telle version sera mise à niveau par les commandes <command>apt-get install <replaceable>paquet</replaceable></command> ou <command>apt-get upgrade</command> car au moins <emphasis>l'une</emphasis> des versions disponibles possède une plus haute priorité que celle de la version installée.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: The Effect of APT Preferences
fr: Conséquences des préférences

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The APT preferences file allows the system administrator to control the assignment of priorities.  The file consists of one or more multi-line records separated by blank lines.  Records can have one of two forms, a specific form and a general form.
fr: Le fichier des préférences permet à l'administrateur système de contrôler l'affectation des priorités. Ce fichier est constitué d'une ou plusieurs entrées séparées par des lignes blanches. Ces entrées peuvent avoir deux formes, une forme particulière et une forme générale.

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The specific form assigns a priority (a "Pin-Priority") to one or more specified packages with a specified version or version range.  For example, the following record assigns a high priority to all versions of the <filename>perl</filename> package whose version number begins with "<literal>&good-perl;</literal>".  Multiple packages can be separated by spaces.
fr: La forme particulière affecte une priorité (<emphasis>Pin-Priority</emphasis>) à un paquet précis, à une version précise ou à un intervalle spécifiant plusieurs versions. Par exemple, l'entrée suivante affecte une priorité haute à toutes les versions du paquet <filename>perl</filename> dont le numéro de version commence par <literal>&good-perl;</literal>.

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The general form assigns a priority to all of the package versions in a given distribution (that is, to all the versions of packages that are listed in a certain <filename>Release</filename> file) or to all of the package versions coming from a particular Internet site, as identified by the site's fully qualified domain name.
fr: La forme générale affecte une priorité à toutes les versions d'un paquet dans une distribution donnée (c'est-à-dire, à toutes les versions d'un paquet qui sont listées dans un fichier <filename>Release</filename>), ou à toutes les versions d'un paquet provenant d'un site Internet identifié par un nom complètement qualifié.

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: This general-form entry in the APT preferences file applies only to groups of packages.  For example, the following record assigns a high priority to all package versions available from the local site.
fr: Cette forme générale des entrées du fichier des préférences s'applique seulement aux groupes de paquets. Par exemple, l'entrée suivante affecte une priorité haute à toutes les versions disponibles dans le site local.

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: A note of caution: the keyword used here is "<literal>origin</literal>" which can be used to match a hostname. The following record will assign a high priority to all versions available from the server identified by the hostname "ftp.de.debian.org"
fr: Il est important de noter que le mot-clé utilisé ici est « <literal>origin</literal> » qui peut servir à indiquer un nom d'hôte. Dans l'exemple qui suit, une haute priorité est donnée à toutes les versions disponibles sur le serveur identifié par le nom d'hôte « ftp.de.debian.org ».

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: This should <emphasis>not</emphasis> be confused with the Origin of a distribution as specified in a <filename>Release</filename> file.  What follows the "Origin:" tag in a <filename>Release</filename> file is not an Internet address but an author or vendor name, such as "Debian" or "Ximian".
fr: Veuillez noter que le mot-clé utilisé ici, <literal>origin</literal>, ne doit pas être confondu avec l'Origine d'une distribution indiquée dans un fichier <filename>Release</filename>. Ce qui suit l'étiquette « Origin: » dans un fichier <filename>Release</filename> n'est pas une adresse Internet mais le nom d'un auteur ou d'un distributeur, comme « Debian » ou « Ximian ».

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The following record assigns a low priority to all package versions belonging to any distribution whose Archive name is "<literal>unstable</literal>".
fr: L'entrée suivante affecte une priorité basse à toutes les versions d'un paquet appartenant à toute distribution dont le nom d'« Archive » est <literal>unstable</literal>.

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The following record assigns a high priority to all package versions belonging to any distribution whose Codename is "<literal>&debian-testing-codename;</literal>".
fr: L'entrée suivante affecte une priorité haute à toutes les versions d'un paquet appartenant à toute distribution dont le nom de code est <literal>&debian-testing-codename;</literal>.

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The following record assigns a high priority to all package versions belonging to any release whose Archive name is "<literal>stable</literal>" and whose release Version number is "<literal>&debian-stable-version;</literal>".
fr: L'entrée suivante affecte une priorité haute à toutes les versions d'un paquet appartenant à toute distribution dont le nom d'« Archive » est <literal>stable</literal> et dont le numéro de « Version » est <literal>&debian-stable-version;</literal>.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The effect of the comma operator is similar to an "and" in logic: All conditions must be satisfied for the pin to match. There is one exception: For any type of condition (such as two "a" conditions), only the last such condition is checked.
fr: L'effet de l'opérateur virgule est identique à un « and » logique : toutes les conditions doivent être satisfaites pour que l'épinglage corresponde. Il existe une exception : pour chaque type de condition (telles que deux conditions « a »), seule la dernière condition est vérifiée.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The rule for those expressions is that they can occur anywhere where a string can occur. Thus, the following pin assigns the priority 990 to all packages from a release starting with &ubuntu-codename;.
fr: La règle pour ces expressions est qu'elles peuvent prendre place dès que la chaîne correspondante est trouvée. Ainsi, l'épinglage qui suit affecte une priorité de 990 à tous les paquets d'une version de distribution commençant par &ubuntu-codename;.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: If a regular expression occurs in a <literal>Package</literal> field, the behavior is the same as if this regular expression were replaced with a list of all package names it matches. It is undecided whether this will change in the future; thus you should always list wild-card pins first, so later specific pins override it.  The pattern "<literal>*</literal>" in a Package field is not considered a &glob; expression in itself.
fr: Si une expression régulière est rencontrée dans un champ <literal>Package</literal>, le comportement sera celui qui aurait eu lieu si cette expression était remplacée par la liste de tous les paquets auxquels elle correspond. Il n'est pas encore décidé si cela sera conservé dans le futur : il est donc conseillé d'utiliser des épinglages avec caractères génériques en premier afin qu'ils soient remplacés par des épinglages plus spécifiques. Le motif « <literal>*</literal> » dans un champ Package n'est pas considéré comme une expression &glob; en soi.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: How APT Interprets Priorities
fr: Méthode d'interprétation des priorités par APT

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Priorities (P) assigned in the APT preferences file must be positive or negative integers.  They are interpreted as follows (roughly speaking):
fr: Les priorités (P) indiquées dans le fichier des préférences doivent être des entiers positifs ou négatifs. Ils sont interprétés à peu près comme suit :

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: causes a version to be installed even if this constitutes a downgrade of the package
fr: cette priorité entraîne l'installation du paquet même s'il s'agit d'un retour en arrière.

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: causes a version to be installed even if it does not come from the target release, unless the installed version is more recent
fr: la version sera installée, même si elle n'appartient pas à la distribution par défaut ; mais elle ne sera pas installée si la version installée est plus récente.

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: causes a version to be installed unless there is a version available belonging to the target release or the installed version is more recent
fr: La version sera installée, sauf s'il existe une version appartenant à la distribution par défaut ou si la version installée est plus récente.

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: causes a version to be installed unless there is a version available belonging to some other distribution or the installed version is more recent
fr: la version sera installée, sauf s'il existe une version appartenant à une autre distribution ou si la version installée est plus récente.

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: causes a version to be installed only if there is no installed version of the package
fr: la version sera installée si aucune version du paquet n'est installée.

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: prevents the version from being installed
fr: cette priorité empêche l'installation de la version.

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: has undefined behaviour, do not use it.
fr: a un comportement indéfini, ne pas l'utiliser.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The first specific-form record matching an available package version determines the priority of the package version.  Failing that, the priority of the package is defined as the maximum of all priorities defined by generic-form records matching the version.  Records defined using patterns in the Pin field other than "*" are treated like specific-form records.
fr: La première entrée de forme particulière correspondant à une version disponible de paquet détermine la priorité de la version du paquet. S'il n'en existe pas, la priorité du paquet est définie comme la plus haute de toutes les priorités par les entrées de forme générale correspondant à la version. Les entrées définies en utilisant des motifs dans le champ Pin autre que « * » sont traitées comme des entrées de forme générale.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: For example, suppose the APT preferences file contains the three records presented earlier:
fr: Supposons par exemple que le fichier des préférences contienne les trois entrées décrites ci-dessous :

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Then:
fr: Alors :

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: The most recent available version of the <literal>perl</literal> package will be installed, so long as that version's version number begins with "<literal>&good-perl;</literal>".  If <emphasis>any</emphasis> &good-perl;* version of <literal>perl</literal> is available and the installed version is &bad-perl;*, then <literal>perl</literal> will be downgraded.
fr: La version la plus récente du paquet <literal>perl</literal> sera installé pour autant que son numéro de version commence par <literal>&good-perl;</literal>. Si l'<emphasis>une</emphasis> des versions &good-perl;* existe et si la version installée est une version &bad-perl;*, il y aura un retour en arrière.

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: A version of any package other than <literal>perl</literal> that is available from the local system has priority over other versions, even versions belonging to the target release.
fr: Les versions des paquets (autres que <literal>perl</literal>) disponibles dans le site local ont priorité sur les autres versions, même celles appartenant à la distribution par défaut.

note: type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
en: A version of a package whose origin is not the local system but some other site listed in &sources-list; and which belongs to an <literal>unstable</literal> distribution is only installed if it is selected for installation and no version of the package is already installed.
fr: La version d'un paquet dont l'origine n'est pas le site local mais un site Internet mentionné dans &sources-list; et qui appartient à une distribution <literal>unstable</literal>, ne sera installée que si aucune version du paquet n'est déjà installée.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Determination of Package Version and Distribution Properties
fr: Détermination de la version des paquets et des propriétés des distributions

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The locations listed in the &sources-list; file should provide <filename>Packages</filename> and <filename>Release</filename> files to describe the packages available at that location.
fr: Chaque source indiquée dans le fichier &sources-list; doit fournir les fichiers <filename>Packages</filename> et <filename>Release</filename> qui décrivent les paquets disponibles à cet endroit.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <filename>Packages</filename> file is normally found in the directory <filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>: for example, <filename>.../dists/stable/main/binary-i386/Packages</filename>.  It consists of a series of multi-line records, one for each package available in that directory.  Only two lines in each record are relevant for setting APT priorities:
fr: Le fichier <filename>Packages</filename> se trouve normalement dans le répertoire <filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>, par exemple, <filename>.../dists/stable/main/binary-i386/Packages</filename>. Il consiste en entrées composées de lignes, une pour chaque paquet disponible dans le répertoire. Seules deux lignes des entrées sont pertinentes pour la détermination des priorités :

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Package:</literal> line
fr: la ligne <literal>Package:</literal>

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: gives the package name
fr: donne le nom du paquet

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Version:</literal> line
fr: la ligne <literal>Version:</literal>

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: gives the version number for the named package
fr: donne le numéro de version du paquet

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <filename>Release</filename> file is normally found in the directory <filename>.../dists/<replaceable>dist-name</replaceable></filename>: for example, <filename>.../dists/stable/Release</filename>, or <filename>.../dists/&debian-stable-codename;/Release</filename>.  It consists of a single multi-line record which applies to <emphasis>all</emphasis> of the packages in the directory tree below its parent.  Unlike the <filename>Packages</filename> file, nearly all of the lines in a <filename>Release</filename> file are relevant for setting APT priorities:
fr: Le fichier <filename>Release</filename> se trouve normalement dans le répertoire <filename>.../dists/<replaceable>nom-distribution</replaceable></filename>, par exemple, <filename>.../dists/stable/Release</filename>, ou <filename>.../dists/&debian-stable-codename;/Release</filename>. Il consiste en une seule entrée composée de plusieurs lignes qui s'applique à <emphasis>tous</emphasis> les paquets situés dans les répertoires sous le répertoire parent. Contrairement au fichier <filename>Packages</filename>, presque toutes les lignes du fichier <filename>Release</filename> sont pertinentes pour déterminer les priorités :

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Archive:</literal> or <literal>Suite:</literal> line
fr: La ligne <literal>Archive:</literal> ou <literal>Suite:</literal>

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the archive to which all the packages in the directory tree belong.  For example, the line "Archive: stable" or "Suite: stable" specifies that all of the packages in the directory tree below the parent of the <filename>Release</filename> file are in a <literal>stable</literal> archive.  Specifying this value in the APT preferences file would require the line:
fr: nomme l'archive à laquelle appartiennent tous les paquets situés dans les répertoires. Par exemple, la ligne <literal>Archive: stable</literal> indique que tous les paquets dans les répertoires situés sous le répertoire parent du fichier <filename>Release</filename> appartiennent à l'archive <literal>stable</literal>. Indiquer cette valeur dans le fichier des préférences demanderait cette ligne :

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Codename:</literal> line
fr: la ligne <literal>Codename:</literal>

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the codename to which all the packages in the directory tree belong.  For example, the line "Codename: &debian-testing-codename;" specifies that all of the packages in the directory tree below the parent of the <filename>Release</filename> file belong to a version named <literal>&debian-testing-codename;</literal>.  Specifying this value in the APT preferences file would require the line:
fr: indique le nom de code auquel appartiennent tous les paquets situés dans les répertoires. Par exemple, la ligne <literal>Codename: &debian-testing-codename;</literal> indique que tous les paquets dans les répertoires situés sous le répertoire parent du fichier <filename>Release</filename> appartiennent à la version portant le nom de code <literal>&debian-testing-codename;</literal>. Indiquer cette valeur dans le fichier des préférences demanderait cette ligne :

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the release version.  For example, the packages in the tree might belong to Debian release version &debian-stable-version;.  Note that there is normally no version number for the <literal>testing</literal> and <literal>unstable</literal> distributions because they have not been released yet.  Specifying this in the APT preferences file would require one of the following lines.
fr: indique la version de la distribution. Par exemple, les paquets dans les répertoires peuvent appartenir à la distribution Debian version &debian-stable-version;. Il n'y a pas de numéro de version pour les distributions <literal>testing</literal> et <literal>unstable</literal> car elles n'ont pas encore été publiées. Indiquer cette valeur dans le fichier des préférences demanderait ces lignes :

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Component:</literal> line
fr: La ligne <literal>Component:</literal>

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the licensing component associated with the packages in the directory tree of the <filename>Release</filename> file.  For example, the line "Component: main" specifies that all the packages in the directory tree are from the <literal>main</literal> component, which entails that they are licensed under terms listed in the Debian Free Software Guidelines.  Specifying this component in the APT preferences file would require the line:
fr: nomme un composant qui indique le type de licence associée aux paquets situés dans les répertoires sous le fichier <filename>Release</filename>. Par exemple, la ligne <literal>Component: main</literal> indique que tous les exemplaires dans les répertoires appartiennent au composant <literal>main</literal>, c'est-à-dire que leur licence est en accord avec les Directives Debian pour le logiciel libre. Indiquer ce composant dans le fichier des préférences demanderait cette ligne :

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Origin:</literal> line
fr: La ligne <literal>Origin:</literal>

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the originator of the packages in the directory tree of the <filename>Release</filename> file.  Most commonly, this is <literal>Debian</literal>.  Specifying this origin in the APT preferences file would require the line:
fr: nomme l'origine des paquets situés dans les répertoires sous le fichier <filename>Release</filename>. En général, c'est <literal>Debian</literal>. Indiquer cette origine dans le fichier des préférences demanderait cette ligne :

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
en: the <literal>Label:</literal> line
fr: La ligne <literal>Label:</literal>

note: type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
en: names the label of the packages in the directory tree of the <filename>Release</filename> file.  Most commonly, this is <literal>Debian</literal>.  Specifying this label in the APT preferences file would require the line:
fr: indique une étiquette pour les paquets qui se trouvent dans les répertoires sous le fichier <filename>Release</filename>. En général, c'est <literal>Debian</literal>. Indiquer cette origine dans le fichier des préférences demanderait cette ligne :

note: type: Content of: <refentry><refsect1><refsect2><para>
en: All of the <filename>Packages</filename> and <filename>Release</filename> files retrieved from locations listed in the &sources-list; file are stored in the directory <filename>/var/lib/apt/lists</filename>, or in the file named by the variable <literal>Dir::State::Lists</literal> in the <filename>apt.conf</filename> file.  For example, the file <filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> contains the <filename>Release</filename> file retrieved from the site <literal>debian.lcs.mit.edu</literal> for <literal>binary-i386</literal> architecture files from the <literal>contrib</literal> component of the <literal>unstable</literal> distribution.
fr: Tous les fichiers <filename>Packages</filename> et <filename>Release</filename> récupérés dans des sources indiquées dans le fichier &sources-list; sont conservés dans le répertoire <filename>/var/lib/apt/lists</filename> ou dans le fichier spécifié par la variable <literal>Dir::State::Lists</literal> dans le fichier <filename>apt.conf</filename>. Par exemple, le fichier <filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> contient le fichier <filename>Release</filename> du site <literal>debian.lcs.mit.edu</literal>, architecture <literal>binary-i386</literal> et composant <literal>contrib</literal> de la distribution <literal>unstable</literal>.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Optional Lines in an APT Preferences Record
fr: Lignes facultatives dans le fichier des préférences

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Each record in the APT preferences file can optionally begin with one or more lines beginning with the word <literal>Explanation:</literal>.  This provides a place for comments.
fr: Toute entrée du fichier des préférences peut commencer par une ou plusieurs lignes contenant le mot <literal>Explanation:</literal>. Cela permet des commentaires.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Tracking Stable
fr: Méthode pour suivre Stable

note: type: Content of: <refentry><refsect1><refsect2><para><programlisting>
en: 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
fr: Explanation: Ne pas installer des exemplaires d'origine Debian
    Explanation: sauf ceux de la distribution stable
    Package: *
    Pin: release a=stable
    Pin-Priority: 900
    
    Package: *
    Pin: release o=Debian
    Pin-Priority: -10

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following APT preferences file will cause APT to assign a priority higher than the default (500) to all package versions belonging to a <literal>stable</literal> distribution and a prohibitively low priority to package versions belonging to other <literal>Debian</literal> distributions.  <placeholder type="programlisting" id="0"/>
fr: Le fichier des préférences suivant affecte une priorité plus haute que la priorité par défaut (500) à tous les exemplaires appartenant à la distribution <literal>stable</literal> et une priorité prohibitivement basse à tous les exemplaires appartenant à d'autres distributions <literal>Debian</literal>.  <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para><programlisting>
en: apt-get install <replaceable>package-name</replaceable>
    apt-get upgrade
    apt-get dist-upgrade
fr: apt-get install <replaceable>paquet</replaceable>
    apt-get upgrade
    apt-get dist-upgrade

note: type: Content of: <refentry><refsect1><refsect2><para>
en: With a suitable &sources-list; file and the above preferences file, any of the following commands will cause APT to upgrade to the latest <literal>stable</literal> version(s).  <placeholder type="programlisting" id="0"/>
fr: Avec le fichier des préférences ci-dessus et un fichier &sources-list; adéquat, les commandes suivantes utiliseront les versions les plus récentes de <literal>stable</literal> pour faire la mise à niveau : <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para><programlisting>
en: apt-get install <replaceable>package</replaceable>/testing
fr: apt-get install <replaceable>paquet</replaceable>/testing

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following command will cause APT to upgrade the specified package to the latest version from the <literal>testing</literal> distribution; the package will not be upgraded again unless this command is given again.  <placeholder type="programlisting" id="0"/>
fr: La commande suivante utilisera la version la plus récente de la distribution <literal>testing</literal> pour mettre à niveau le paquet spécifié ; cependant les mises à niveau ultérieures du paquet ne se feront pas à moins de relancer la commande. <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Tracking Testing or Unstable
fr: Méthode pour suivre Testing ou Unstable

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following APT preferences file will cause APT to assign a high priority to package versions from the <literal>testing</literal> distribution, a lower priority to package versions from the <literal>unstable</literal> distribution, and a prohibitively low priority to package versions from other <literal>Debian</literal> distributions.  <placeholder type="programlisting" id="0"/>
fr: Le fichier des préférences suivant affecte une priorité haute aux versions des paquets appartenant à la distribution <literal>testing</literal>, une priorité moindre aux versions appartenant à la distribution <literal>unstable</literal> et une priorité prohibitivement basse aux versions appartenant à d'autres distributions <literal>Debian</literal>. <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: With a suitable &sources-list; file and the above preferences file, any of the following commands will cause APT to upgrade to the latest <literal>testing</literal> version(s).  <placeholder type="programlisting" id="0"/>
fr: Avec un fichier &sources-list; approprié et le fichier des préférences ci-dessus, les commandes suivantes utiliseront les versions les plus récentes de <literal>testing</literal> pour faire la mise à niveau : <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para><programlisting>
en: apt-get install <replaceable>package</replaceable>/unstable
fr: apt-get install <replaceable>paquet</replaceable>/unstable

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following command will cause APT to upgrade the specified package to the latest version from the <literal>unstable</literal> distribution.  Thereafter, <command>apt-get upgrade</command> will upgrade the package to the most recent <literal>testing</literal> version if that is more recent than the installed version, otherwise, to the most recent <literal>unstable</literal> version if that is more recent than the installed version.  <placeholder type="programlisting" id="0"/>
fr: La commande suivante utilisera la version la plus récente de la distribution <literal>unstable</literal> pour mettre à niveau le paquet spécifié ; Par la suite, <command>apt-get upgrade</command> mettra le paquet à jour avec la plus récente version dans <literal>testing</literal> si elle est plus récente que la version installée ou avec la plus récente version dans <literal>unstable</literal> si elle est plus récente que la version installée. <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Tracking the evolution of a codename release
fr: Suivre l'évolution d'une version par son nom de code

note: type: Content of: <refentry><refsect1><refsect2><para><programlisting>
en: Explanation: Uninstall or do not install any Debian-originated package versions
    Explanation: other than those in the distribution codenamed with &debian-testing-codename; or sid
    Package: *
    Pin: release n=&debian-testing-codename;
    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
fr: Explanation: Ne pas installer des exemplaires d'origine Debian
    Explanation: sauf ceux de la distribution &debian-testing-codename; ou sid
    Package: *
    Pin: release n=&debian-testing-codename;
    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

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following APT preferences file will cause APT to assign a priority higher than the default (500) to all package versions belonging to a specified codename of a distribution and a prohibitively low priority to package versions belonging to other <literal>Debian</literal> distributions, codenames and archives.  Note that with this APT preference APT will follow the migration of a release from the archive <literal>testing</literal> to <literal>stable</literal> and later <literal>oldstable</literal>. If you want to follow for example the progress in <literal>testing</literal> notwithstanding the codename changes you should use the example configurations above.  <placeholder type="programlisting" id="0"/>
fr: Le fichier des préférences suivant affecte une priorité plus haute que la priorité par défaut (500) à tous les exemplaires appartenant à la version portant le nom de code indiqué et une priorité prohibitivement basse à tous les exemplaires appartenant à d'autres distributions <literal>Debian</literal>. Veuillez noter qu'avec ce fichier de préférences, APT suivra la transformation d'une version <literal>testing</literal> en <literal>stable</literal> puis <literal>oldstable</literal>. Si, au contraire, vous souhaitez suivre la version <literal>testing</literal>, vous devriez utiliser un des exemples précédents. <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: With a suitable &sources-list; file and the above preferences file, any of the following commands will cause APT to upgrade to the latest version(s) in the release codenamed with <literal>&debian-testing-codename;</literal>.  <placeholder type="programlisting" id="0"/>
fr: Avec le fichier des préférences ci-dessus et un fichier &sources-list; adéquat, les commandes suivantes utiliseront les versions les plus récentes de <literal>&debian-testing-codename;</literal> pour faire la mise à niveau : <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><para><programlisting>
en: apt-get install <replaceable>package</replaceable>/sid
fr: apt-get install <replaceable>paquet</replaceable>/sid

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following command will cause APT to upgrade the specified package to the latest version from the <literal>sid</literal> distribution.  Thereafter, <command>apt-get upgrade</command> will upgrade the package to the most recent <literal>&debian-testing-codename;</literal> version if that is more recent than the installed version, otherwise, to the most recent <literal>sid</literal> version if that is more recent than the installed version.  <placeholder type="programlisting" id="0"/>
fr: La commande suivante utilisera la version la plus récente de la distribution <literal>sid</literal> pour mettre à niveau le paquet spécifié ; Par la suite, <command>apt-get upgrade</command> mettra le paquet à jour avec la plus récente version dans <literal>&debian-testing-codename;</literal> si elle est plus récente que la version installée ou avec la plus récente version dans <literal>sid</literal> si elle est plus récente que la version installée. <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refnamediv><refpurpose>
en: List of configured APT data sources
fr: Liste des sources de données APT configurées

note: type: Content of: <refentry><refsect1><para>
en: The source list <filename>/etc/apt/sources.list</filename> and the files contained in <filename>/etc/apt/sources.list.d/</filename> are designed to support any number of active sources and a variety of source media. The files list one source per line (one-line style) or contain multiline stanzas defining one or more sources per stanza (deb822 style), with the most preferred source listed first (in case a single version is available from more than one source). The information available from the configured sources is acquired by <command>apt-get update</command> (or by an equivalent command from another APT front-end).
fr: Le fichier de liste de sources <filename>/etc/apt/sources.list</filename> et les fichiers contenus dans <filename>/etc/apt/sources.list.d/</filename> sont conçus pour pouvoir gérer un nombre quelconque de sources actives et de médias. Le fichier donne une source par ligne (One-Line style) ou fournit des paragraphes multilignes définissant une ou plusieurs sources par paragraphe (style deb822), avec les sources prioritaires en premier (dans le cas où il y a une seule version disponible à partir de plus d'une source). L'information relative aux sources configurées est récupérée par la commande <command>apt-get update</command> (ou par une commande équivalente avec une autre interface à APT).

note: type: Content of: <refentry><refsect1><para>
en: The <filename>/etc/apt/sources.list.d</filename> directory provides a way to add sources.list entries in separate files.  Two different file formats are allowed as described in the next two sections.  Filenames need to have either the extension <filename>.list</filename> or <filename>.sources</filename> depending on the contained format.  The filenames may only contain letters (a-z and A-Z), digits (0-9), underscore (_), hyphen (-) and period (.) characters.  Otherwise APT will print a notice that it has ignored a file, unless that file matches a pattern in the <literal>Dir::Ignore-Files-Silently</literal> configuration list - in which case it will be silently ignored.
fr: Le répertoire <filename>/etc/apt/sources.list.d</filename> permet de spécifier des sources de paquets dans des fichiers distincts. Deux formats de fichiers différents sont permis comme cela est décrit dans les deux sections suivantes. Les noms de fichier doivent se terminer par <filename>.list</filename> ou par <filename>.sources</filename> selon le format fourni. Ils ne peuvent contenir que des lettres (a-z et A-Z), des chiffres (0-9), des caractères de soulignement (_), des tirets (-) et des points (.). Dans le cas contraire, APT affichera un avertissement indiquant qu'il a ignoré un fichier si celui-ci ne correspond par à un motif défini dans <literal>Dir::Ignore-Files-Silently</literal> (les fichiers correspondant à cette variable de configuration étant, eux, ignorés silencieusement).

note: type: Content of: <refentry><refsect1><title>
en: One-Line-Style Format
fr: Format One-Line-Style

note: type: Content of: <refentry><refsect1><para>
en: Files in this format have the extension <filename>.list</filename>.  Each line specifying a source starts with a type (e.g. <literal>deb-src</literal>)  followed by options and arguments for this type.  Individual entries cannot be continued onto a following line. Empty lines are ignored, and a <literal>#</literal> character anywhere on a line marks the remainder of that line as a comment. Consequently an entry can be disabled by commenting out the entire line.  If options should be provided they are separated by spaces and all of them together are enclosed by square brackets (<literal>[]</literal>)  included in the line after the type separated from it with a space.  If an option allows multiple values these are separated from each other with a comma (<literal>,</literal>). An option name is separated from its value(s) by an equals sign (<literal>=</literal>). Multivalue options also have <literal>-=</literal> and <literal>+=</literal> as separators, which instead of replacing the default with the given value(s) modify the default value(s) to remove or include the given values.
fr: Les entrées individuelles ne peuvent pas se poursuivre sur la ligne suivante. Les lignes vides sont ignorées et un caractère <literal>#</literal> n'importe où sur une ligne signale que le reste de la ligne est un commentaire. Par conséquent, une entrée peut être désactivée en commentant la totalité de la ligne. Si plusieurs options doivent être fournies, elles sont séparées par des espaces et sont entourées toutes ensembles par des crochets (<literal>[]</literal>) inclus sur la ligne après le type séparé par un espace. Si une option permet plusieurs valeurs, elles sont séparées les unes des autres par une virgule (<literal>,</literal>). Un nom d'option est séparé de ses options par une signe égal (<literal>=</literal>). Des options à plusieurs valeurs disposent aussi des séparateurs <literal>-=</literal> et <literal>+=</literal>, qui, au lieu de remplacer la valeur par défaut par la ou les valeurs données, modifient la ou les valeurs par défaut pour supprimer ou inclure les valeurs données.

note: type: Content of: <refentry><refsect1><para>
en: This is the traditional format and supported by all apt versions.  Note that not all options as described below are supported by all apt versions.  Note also that some older applications parsing this format on their own might not expect to encounter options as they were uncommon before the introduction of multi-architecture support.
fr: Il s'agit du format traditionnel, géré par toute les version de APT. Veuillez noter que toutes les options décrites plus bas ne sont pas prises en charge par toutes les versions d'APT. Notez aussi que certaine des plus anciennes applications qui analysent ce format elles-mêmes ne s'attendent pas à rencontrer des options qui étaient rares avant l'introduction de la prise en charge multi-architecture.

note: type: Content of: <refentry><refsect1><title>
en: deb822-Style Format
fr: Format deb822-Style

note: type: Content of: <refentry><refsect1><para>
en: Files in this format have the extension <filename>.sources</filename>.  The format is similar in syntax to other files used by Debian and its derivatives, such as the metadata files that apt will download from the configured sources or the <filename>debian/control</filename> file in a Debian source package.  Individual entries are separated by an empty line; additional empty lines are ignored, and a <literal>#</literal> character at the start of the line marks the entire line as a comment. An entry can hence be disabled by commenting out each line belonging to the stanza, but it is usually easier to add the field "Enabled: no" to the stanza to disable the entry. Removing the field or setting it to yes re-enables it.  Options have the same syntax as every other field: A field name separated by a colon (<literal>:</literal>) and optionally spaces from its value(s).  Note especially that multiple values are separated by whitespaces (like spaces, tabs and newlines), not by commas as in the one-line format.  Multivalue fields like <literal>Architectures</literal> also have <literal>Architectures-Add</literal> and <literal>Architectures-Remove</literal> to modify the default value rather than replacing it.
fr: Les fichiers dans ce format possèdent l'extension <filename>.sources</filename>. La syntaxe du format est similaire à celle des autres fichiers utilisés par Debian et ses dérivés, comme les fichiers de métadonnées qu'APT télécharge des sources configurées ou le fichier <filename>debian/control</filename> d'un paquet source de Debian. Les entrées individuelles sont séparées par une ligne vide ; les lignes vides supplémentaires sont ignorées et un caractère <literal>#</literal> en début de ligne signale la ligne comme un commentaire. Une entrée, par conséquent, peut être désactivée en commentant chaque ligne appartenant au paragraphe, mais il est habituellement plus facile d'ajouter le champ « Enabled: no » au paragraphe pour désactiver l'entrée. Retirer ce champ ou le définir à « yes » le réactive. Les options ont la même syntaxe que tous les autres champs : un nom de champ séparé par le caractère deux-points (<literal>:</literal>) et éventuellement des valeurs séparées par des espaces. Veuillez noter particulièrement que des valeurs multiples sont séparées par des espacements (espaces, tabulations ou nouvelles lignes) et non par des virgules comme dans le format « One-Line ». Les champs multivaleurs comme <literal>Architectures</literal> disposent aussi des options <literal>Architectures-Add</literal> et <literal>Architectures-Remove</literal> pour modifier la valeur par défaut plutôt que de la remplacer.

note: type: Content of: <refentry><refsect1><para>
en: This is a new format supported by apt itself since version 1.1. Previous versions ignore such files with a notice message as described earlier.  It is intended to make this format gradually the default format, deprecating the previously described one-line-style format, as it is easier to create, extend and modify for humans and machines alike especially if a lot of sources and/or options are involved.  Developers who are working with and/or parsing apt sources are highly encouraged to add support for this format and to contact the APT team to coordinate and share this work. Users can freely adopt this format already, but may encounter problems with software not supporting the format yet.
fr: Il s'agit d'un nouveau format pris en charge par APT lui-même depuis la version 1.1. Les versions précédentes ignorent ce type de fichier avec un message d'avertissement tel que décrit précédemment. L'objectif est de faire de ce format le format par défaut, et de rendre obsolète le format « One-Line-Style » décrit plus haut, parce qu'il est plus facile à créer, à étendre et à modifier pour les humains comme pour les machines, surtout s'il inclut beaucoup de sources et/ou d'options. Les développeurs qui travaillent avec les sources apt ou les analysent sont fortement encouragés à ajouter la prise en charge de ce format et à prendre contact avec l'équipe APT pour coordonner et partager ce travail. Les utilisateurs sont libres d'adopter déjà ce format, mais peuvent se confronter à des problèmes avec les logiciels qui ne le gèrent pas encore.

note: type: Content of: <refentry><refsect1><title>
en: The deb and deb-src Types: General Format
fr: Les types deb et deb-src : format général

note: type: Content of: <refentry><refsect1><para>
en: The <literal>deb</literal> type references a typical two-level Debian archive, <filename>distribution/component</filename>. The <literal>distribution</literal> is generally a suite name like <literal>stable</literal> or <literal>testing</literal> or a codename like <literal>&debian-stable-codename;</literal> or <literal>&debian-testing-codename;</literal> while component is one of <literal>main</literal>, <literal>contrib</literal>, <literal>non-free</literal> or <literal>non-free-firmware</literal>. The <literal>deb-src</literal> type references a Debian distribution's source code in the same form as the <literal>deb</literal> type.  A <literal>deb-src</literal> line is required to fetch source indexes.
fr: Le type <literal>deb</literal> décrit une archive Debian classique à deux niveaux, <filename>distribution/composant</filename>. <literal>distribution</literal> peut prendre l'une des valeurs suivantes : un nom de suite tel que <literal>stable</literal> ou <literal>testing</literal> ou bien un nom de code comme <literal>&debian-stable-codename;</literal> ou <literal>&debian-testing-codename;</literal>, alors que composant prend les valeurs : <literal>main</literal>, <literal>contrib</literal>, <literal>non-free</literal>, ou <literal>non-free-firmware</literal>. Le type <literal>deb-src</literal> décrit une archive de distribution de code source pour une distribution Debian dans le même format que le type <literal>deb</literal>. Une ligne <literal>deb-src</literal> est nécessaire pour récupérer les index des sources.

note: type: Content of: <refentry><refsect1><para>
en: The format for two one-line-style entries using the <literal>deb</literal> and <literal>deb-src</literal> types is:
fr: Le format de deux entrées du genre « One-Line-Style » utilisant les types <literal>deb</literal> et <literal>deb-src</literal> est :

note: type: Content of: <refentry><refsect1><para>
en: Alternatively the equivalent entry in deb822 style looks like this: <placeholder type="literallayout" id="0"/>
fr: Autrement, l'entrée équivalente de style deb822 ressemble à ceci : <placeholder type="literallayout" id="0"/>

note: type: Content of: <refentry><refsect1><para>
en: The URI for the <literal>deb</literal> type must specify the base of the Debian distribution, from which APT will find the information it needs.  <literal>suite</literal> can specify an exact path, in which case the components must be omitted and <literal>suite</literal> must end with a slash (<literal>/</literal>). This is useful for the case when only a particular sub-directory of the archive denoted by the URI is of interest.  If <literal>suite</literal> does not specify an exact path, at least one <literal>component</literal> must be present.
fr: L'URI de type <literal>deb</literal> doit indiquer la base de la distribution Debian dans laquelle APT trouvera les informations dont il a besoin. <literal>suite</literal> peut spécifier le chemin exact : dans ce cas, on doit omettre les composants et <literal>suite</literal> doit se terminer par une barre oblique (<literal>/</literal>). C'est utile quand seul un sous-répertoire particulier de l'archive décrite par cet URI est intéressant. Quand <literal>suite</literal> n'indique pas un chemin exact, un <literal>composant</literal> au moins doit être présent.

note: type: Content of: <refentry><refsect1><para>
en: <literal>suite</literal> may also contain a variable, <literal>$(ARCH)</literal> which expands to the Debian architecture (such as <literal>amd64</literal> or <literal>armel</literal>) used on the system. This permits architecture-independent <filename>sources.list</filename> files to be used. In general this is only of interest when specifying an exact path; <literal>APT</literal> will automatically generate a URI with the current architecture otherwise.
fr: <literal>suite</literal> peut aussi contenir une variable <literal>$(ARCH)</literal>, qui sera remplacée par l'architecture Debian (comme <literal>amd64</literal> ou <literal>armel</literal>) sur laquelle s'exécute le système. On peut ainsi utiliser un fichier <filename>sources.list</filename> qui ne dépend pas d'une architecture. En général, ce n'est intéressant que si l'on indique un chemin exact ; sinon <literal>APT</literal> crée automatiquement un URI en fonction de l'architecture effective.

note: type: Content of: <refentry><refsect1><para>
en: Especially in the one-line-style format since only one distribution can be specified per line it may be necessary to have multiple lines for the same URI, if a subset of all available distributions or components at that location is desired.  APT will sort the URI list after it has generated a complete set internally, and will collapse multiple references to the same Internet host, for instance, into a single connection, so that it does not inefficiently establish a connection, close it, do something else, and then re-establish a connection to that same host. APT also parallelizes connections to different hosts to more effectively deal with sites with low bandwidth.
fr: Particulièrement lorsqu'on utilise le format « One-Line-Style », puisqu'on ne peut indiquer qu'une seule distribution par ligne, il peut être nécessaire de disposer le même URI sur plusieurs lignes quand on veut accéder à un sous-ensemble des distributions ou composants disponibles à cette adresse. APT trie les URI après avoir crée pour lui-même la liste complète ; il regroupe les références multiples au même hôte Internet en vue d'une connexion unique et il évite ainsi, par exemple, d'établir une connexion FTP, de la fermer, faire autre chose, puis d'établir encore cette connexion. Cette fonctionnalité permet l'accès à des sites FTP surchargés qui limitent le nombre de connexions simultanées pour les utilisateurs anonymes. APT parallélise aussi les connexions à différents hôtes pour tirer plus efficacement parti des sites à faible bande passante.

note: type: Content of: <refentry><refsect1><para>
en: It is important to list sources in order of preference, with the most preferred source listed first. Typically this will result in sorting by speed from fastest to slowest (CD-ROM followed by hosts on a local network, followed by distant Internet hosts, for example).
fr: Il est important d'indiquer les sources par ordre de préférence, la source principale apparaissant en premier. Un tri est fait, de la plus rapide à la plus lente ; par exemple, un CD suivi par les hôtes d'un réseau local, puis les hôtes distants.

note: type: Content of: <refentry><refsect1><para>
en: As an example, the sources for your distribution could look like this in one-line-style format: <placeholder type="literallayout" id="0"/> or like this in deb822 style format: <placeholder type="literallayout" id="1"/>
fr: À titre d'exemple, les sources de votre distribution au format « One-Line-Style » pourraient ressembler à ceci : <placeholder type="literallayout" id="0"/> ou à ceci au format de style deb822 : <placeholder type="literallayout" id="1"/>

note: type: Content of: <refentry><refsect1><title>
en: The deb and deb-src types: Options
fr: Les types deb et deb-src : options

note: type: Content of: <refentry><refsect1><para>
en: Each source entry can have options specified to modify which source is accessed and how data is acquired from it. Format, syntax and names of the options vary between the one-line-style and deb822-style formats as described, but they both have the same options available. For simplicity we list the deb822 field name and provide the one-line name in brackets.  Remember that besides setting multivalue options explicitly, there is also the option to modify them based on the default, but we aren't listing those names explicitly here. Unsupported options are silently ignored by all APT versions.
fr: Chaque entrée de source peut avoir des options spécifiées pour modifier la source à laquelle accéder et comment les données y sont récupérées. Le format, la syntaxe et les noms des options peuvent être différents entre le format « One-Line-Style » et le format de style deb822, mais les mêmes options sont disponibles dans les deux formats. Pour simplifier, nous listons les noms de champ avec deb822 et fournissons le nom « One-Line » entre parenthèses. Il faut se souvenir que en plus du réglage explicite des options multi-valeurs, il y a aussi l'option de les modifier en se basant sur les valeurs par défaut, mais nous ne listons pas ces noms explicitement ici. Les options non prises en charge sont ignorées par toutes les version d'APT.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Architectures</option> (<option>arch</option>) is a multivalue option defining for which architectures information should be downloaded. If this option isn't set the default is all architectures as defined by the <option>APT::Architectures</option> config option.
fr: <option>Architectures</option> (<option>arch</option>) est une option multivaleur pour définir les architectures pour lesquelles l'information doit être téléchargée. Si cette option n'est pas utilisée, l'option par défaut est toutes les architectures définies par l'option de configuration <literal>APT::Architectures</literal>.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Languages</option> (<option>lang</option>) is a multivalue option defining for which languages information such as translated package descriptions should be downloaded.  If this option isn't set the default is all languages as defined by the <option>Acquire::Languages</option> config option.
fr: <option>Languages</option> (<option>lang</option>) est une option multivaleur pour définir les langues pour lesquelles les informations, telles que les descriptions de paquet traduites, doivent être téléchargées. Si cette option n'est pas utilisée, l'option par défaut est toutes les langues définies par l'option de configuration <option>Acquire::Languages</option>.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Targets</option> (<option>target</option>) is a multivalue option defining which download targets apt will try to acquire from this source. If not specified, the default set is defined by the <option>Acquire::IndexTargets</option> configuration scope (targets are specified by their name in the <literal>Created-By</literal> field).  Additionally, targets can be enabled or disabled by using the <literal>Identifier</literal> field as an option with a boolean value instead of using this multivalue option.
fr: <option>Targets</option> (<option>target</option>) est une option multivaleur pour définir les cibles qu'apt essaiera d’acquérir à partir de cette source. Si cette option n'est pas spécifiée, la configuration par défaut est définie par le champ d'action de configuration <option>Acquire::IndexTargets</option> (les cibles sont définies par leur nom dans le champ <literal>Created-By</literal>). De plus, les cibles peuvent être activées ou désactivées en utilisant le champ <literal>Identifier</literal> comme option avec une valeur booléenne plutôt que d'utiliser cette option multivaleur.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>PDiffs</option> (<option>pdiffs</option>)  is a yes/no value which controls if APT should try to use PDiffs to update old indexes instead of downloading the new indexes entirely. The value of this option is ignored if the repository doesn't announce the availability of PDiffs.  Defaults to the value of the option with the same name for a specific index file defined in the <option>Acquire::IndexTargets</option> scope, which itself defaults to the value of configuration option <option>Acquire::PDiffs</option> which defaults to <literal>yes</literal>.
fr: <option>PDiffs</option> (<option>pdiffs</option>) est une valeur yes/no qui contrôle si APT doit essayer d'utiliser PDiffs pour mettre à jour des index anciens plutôt que de télécharger les nouveaux index en totalité. La valeur de cette option est ignorée si le dépôt n'annonce pas la disponibilité de PDiffs. Elle a, par défaut, la valeur de l'option du même nom pour un fichier particulier défini dans le champ d'action <option>Acquire::IndexTargets</option>, qui prend lui-même par défaut la valeur de l'option de configuration <option>Acquire::PDiffs</option>, dont la valeur par défaut est <literal>yes</literal>.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>By-Hash</option> (<option>by-hash</option>)  can have the value <literal>yes</literal>, <literal>no</literal> or <literal>force</literal> and controls if APT should try to acquire indexes via a URI constructed from a hashsum of the expected file instead of using the well-known stable filename of the index. Using this can avoid hashsum mismatches, but requires a supporting mirror. A <literal>yes</literal> or <literal>no</literal> value activates/disables the use of this feature if this source indicates support for it, while <literal>force</literal> will enable the feature regardless of what the source indicates. Defaults to the value of the option of the same name for a specific index file defined in the <option>Acquire::IndexTargets</option> scope, which itself defaults to the value of configuration option <option>Acquire::By-Hash</option> which defaults to <literal>yes</literal>.
fr: <option>By-Hash</option> (<option>by-hash</option>)peut avoir la valeur <literal>yes</literal>, <literal>no</literal> ou <literal>force</literal> et contrôle si APT doit essayer d’acquérir des index grâce à un URI construit à partir de la somme de hachage du fichier attendu plutôt que d'utiliser le nom de fichier de stable bien connu de l'index. Son utilisation peut éviter des décalages de somme de hachage, mais nécessite un miroir de prise en charge. Une valeur <literal>yes</literal> ou <literal>no</literal> active ou désactive l'utilisation de cette fonctionnalité si cette source indique sa prise en charge, tandis que <literal>force</literal> activera la fonctionnalité quel que soit ce que la source indique. Elle a, par défaut, la valeur de l'option du même nom pour un fichier particulier défini dans le champ d'action <option>Acquire::IndexTargets</option>, qui prend lui-même par défaut la valeur de l'option de configuration <option>Acquire::By-Hash</option>, dont la valeur par défaut est <literal>yes</literal>.

note: type: Content of: <refentry><refsect1><para>
en: Furthermore, there are options which if set affect <emphasis>all</emphasis> sources with the same URI and Suite, so they have to be set on all such entries and can not be varied between different components. APT will try to detect and error out on such anomalies.
fr: Par ailleurs, si certaines options sont définies, elles affectent <emphasis>toutes</emphasis> les sources avec les mêmes URI et Suite, et donc doivent être définies sur toutes ces entrées et ne peuvent être modifiées entre les différents composants. APT essaiera de détecter et provoquera une erreur avec de telles anomalies.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Allow-Insecure</option> (<option>allow-insecure</option>), <option>Allow-Weak</option> (<option>allow-weak</option>) and <option>Allow-Downgrade-To-Insecure</option> (<option>allow-downgrade-to-insecure</option>)  are boolean values which all default to <literal>no</literal>.  If set to <literal>yes</literal> they circumvent parts of &apt-secure; and should therefore not be used lightly!
fr: <option>Allow-Insecure</option> (<option>allow-insecure</option>), <option>Allow-Weak</option> (<option>allow-weak</option>) et <option>Allow-Downgrade-To-Insecure</option> (<option>allow-downgrade-to-insecure</option>) sont des valeurs booléennes dont la valeur par défaut est <literal>no</literal>. Si elles sont définies à <literal>yes</literal>, elles contournent certains éléments d'&apt-secure; et par conséquent ne devraient pas utilisées à la légère.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Trusted</option> (<option>trusted</option>)  is a tri-state value which defaults to APT deciding if a source is considered trusted or if warnings should be raised before e.g.  packages are installed from this source. This option can be used to override that decision. The value <literal>yes</literal> tells APT always to consider this source as trusted, even if it doesn't pass authentication checks. It disables parts of &apt-secure;, and should therefore only be used in a local and trusted context (if at all) as otherwise security is breached. The value <literal>no</literal> does the opposite, causing the source to be handled as untrusted even if the authentication checks passed successfully. The default value can't be set explicitly.
fr: <option>Trusted</option> (<option>trusted</option>) comporte trois valeurs d'état qui définissent par défaut si APT décide de considérer une source comme sûre ou doit lancer un avertissement avant qu'un paquet soit, par exemple, installé à partir de cette source. Cette option peut être utilisée pour outrepasser cette décision. La valeur <literal>yes</literal> dit à APT de considérer cette source comme sûre, même si elle échoue au test d'authentification. Elle désactive des éléments d'&apt-secure; et elle ne devrait être utilisée que dans un contexte local et sécurisé si possible, parce qu'autrement elle ouvre une brèche dans la sécurité. La valeur <literal>no</literal> fait le contraire et fait que la source est traitée comme non sûre, même si les tests d'authentification sont réussis. La valeur par défaut ne peut pas être définie explicitement.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Check-Valid-Until</option> (<option>check-valid-until</option>)  is a yes/no value which controls if APT should try to detect replay attacks. A repository creator can declare a time until which the data provided in the repository should be considered valid, and if this time is reached, but no new data is provided, the data is considered expired and an error is raised.  Besides increasing security, as a malicious attacker can't send old data forever to prevent a user from upgrading to a new version, this also helps users identify mirrors which are no longer updated. However, some repositories such as historic archives are not updated any more by design, so this check can be disabled by setting this option to <literal>no</literal>.  Defaults to the value of configuration option <option>Acquire::Check-Valid-Until</option> which itself defaults to <literal>yes</literal>.
fr: <option>Check-Valid-Until</option> (<option>check-valid-until</option>) est une valeur yes/no qui détermine si APT doit tenter de détecter les attaques par replay. Un créateur de dépôt peut déclarer une période pendant laquelle les données fournies par le dépôt peuvent être considérées comme valables, une fois ce délai échu, et si les données n'ont pas été fournies, elles sont considérées comme expirées, et un message d'erreur est envoyé. En plus d'accroître la sécurité, puisqu'un attaquant malveillant ne peut plus envoyer des données anciennes pour empêcher un utilisateur de mettre à niveau vers une nouvelle version, elle facilite l'identification de miroirs qui ne sont plus mis à jour. Néanmoins, certains dépôts, comme les archives historiques ne sont plus mis à jour à dessein, aussi cette vérification peut être désactivée en réglant cette option à <literal>no</literal>. Elle possède la valeur par défaut de l'option <option>Acquire::Check-Valid-Until</option> qui elle-même possède la valeur <literal>yes</literal> par défaut.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Valid-Until-Min</option> (<option>valid-until-min</option>) and <option>Valid-Until-Max</option> (<option>valid-until-max</option>) can be used to raise or lower the time period in seconds in which the data from this repository is considered valid. -Max can be especially useful if the repository provides no Valid-Until field on its Release file to set your own value, while -Min can be used to increase the valid time on seldom updated (local) mirrors of a more frequently updated but less accessible archive (which is in the sources.list as well) instead of disabling the check entirely.  Default to the value of the configuration options <option>Acquire::Min-ValidTime</option> and <option>Acquire::Max-ValidTime</option> which are both unset by default.
fr: <option>Valid-Until-Min</option> (<option>valid-until-min</option>) et <option>Valid-Until-Max</option> (<option>valid-until-max</option>) peuvent être utilisées pour augmenter ou diminuer la durée, en secondes pendant laquelle les données de ce dépôt sont considérées comme valables. -Max peut être particulièrement utile pour définir une valeur propre si le dépôt ne fournit pas de champ Valid-Until dans son fichier Release, tandis que -Min peut être utilisé pour augmenter la durée de validité sur des miroirs (locaux), rarement mis à jour, d'une archive plus fréquemment mise à jour mais moins accessible (qui est aussi dans le sources.list), plutôt que de désactiver totalement la vérification. Elle possède la valeur par défaut des options de configuration <option>Acquire::Min-ValidTime</option> et <option>Acquire::Max-ValidTime</option> qui toutes les deux ne sont pas définies par défaut.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Check-Date</option> (<option>check-date</option>)  is a yes/no value which controls if APT should consider the machine's time correct and hence perform time related checks, such as verifying that a Release file is not from the future. Disabling it also disables the <option>Check-Valid-Until</option> option mentioned above.
fr: <option>Check-Date</option> (<option>check-date</option>) est une valeur yes/no qui contrôle si APT doit considérer que la date de la machine est correcte et donc effectuer les vérifications liées au temps, comme vérifier si le fichier Release n'est pas dans le futur. Sa désactivation désactive l'option <option>Check-Valid-Until</option> mentionnée ci-dessus.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>Date-Max-Future</option> (<option>date-max-future</option>) controls how far from the future a repository may be.  Default to the value of the configuration option <option>Acquire::Max-FutureTime</option> which is 10 seconds by default.
fr: <option>Date-Max-Future</option> (<option>date-max-future</option>) contrôle jusqu'où un dépôt peut être dans le futur. Elle possède la valeur del'option de configuration <option>Acquire::Max-FutureTime</option> qui est par défaut de 10 secondes.

note: type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
en: <option>InRelease-Path</option> (<option>inrelease-path</option>)  determines the path to the InRelease file, relative to the normal position of an <filename>InRelease</filename> file.  By default, this option is unset and APT will try to fetch an <filename>InRelease</filename> or, if that fails, a <filename>Release</filename> file and its associated <filename>Release.gpg</filename> file. By setting this option, the specified path will be tried instead of the InRelease file, and the fallback to <filename>Release</filename> files will be disabled.
fr: <option>InRelease-Path</option> (<option>inrelease-path</option>) détermine le chemin du fichier InRelease, relativement à la position normale d'un fichier <filename>InRelease</filename>. Par défaut, cette option n'est pas définie et APT cherchera à récupérer un fichier <filename>InRelease</filename> ou, s'il échoue, un fichier <filename>Release</filename> et le fichier <filename>Release.gpg</filename> associé. Si cette option est définie, le chemin spécifié sera essayé à la place du fichier InRelease, et le repli vers les fichiers <filename>Release</filename> sera désactivé.

note: type: Content of: <refentry><refsect1><title>
en: URI Specification
fr: Spécification des URI

note: type: Content of: <refentry><refsect1><para>
en: The currently recognized URI types are:
fr: Les types d'URI actuellement reconnus sont :

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The http scheme specifies an HTTP server for an archive and is the most commonly used method. The URI can directly include login information if the archive requires it, but the use of &apt-authconf; should be preferred.  The method also supports SOCKS5 and HTTP(S) proxies either configured via apt-specific configuration or specified by the environment variable <envar>http_proxy</envar> in the format (assuming an HTTP proxy requiring authentication) <replaceable>http://user:pass@server:port/</replaceable>.  The authentication details for proxies can also be supplied via &apt-authconf;.
fr: Le procédé http précise un serveur HTTP pour une archive et c'est la méthode la plus couramment utilisée. L'URI peut inclure directement les information de connexion si l'archive le requiert, mais l'utilisation de &apt-authconf; devrait être préférée. La méthode prend également en charge SOCKS5 et les mandataires HTTP(S) configurés soit au moyen d'une configuration spécifique à apt ou spécifiés par la variable d'environnement <envar>http_proxy</envar> au format <replaceable>http://user:pass@server:port/</replaceable> (en supposant un mandataire HTTP nécessitant une authentification). Les détails de l'authentification pour les mandataires peuvent aussi être fournis avec &apt-authconf;.

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: Note that these forms of authentication are insecure as the whole communication with the remote server (or proxy) is not encrypted so a sufficiently capable attacker can observe and record login as well as all other interactions. The attacker can <emphasis>not</emphasis> modify the communication through as APT's data security model is independent of the chosen transport method. See &apt-secure; for details.
fr: Veuillez noter que ces formes d'authentification ne sont pas sûres puisque toutes les communications avec le serveur distant (ou le mandataire) ne sont pas chiffrées, donc un attaquant suffisamment compétent peut observer et enregistrer la connexion ainsi que les autres interactions. L'attaquant ne peut <emphasis>pas</emphasis> modifier la communication dans la mesure où le modèle de sécurité des données d'Apt est indépendant de la méthode de transport choisie. Voir &apt-secure; pour plus de détails.

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The https scheme specifies an HTTPS server for an archive and is very similar in use and available options to the http scheme. The main difference is that the communication between apt and server (or proxy) is encrypted. Note that the encryption does not prevent an attacker from knowing which server (or proxy) apt is communicating with and deeper analysis can potentially still reveal which data was downloaded. If this is a concern the Tor-based schemes mentioned further below might be a suitable alternative.
fr: Le procédé https précise un serveur HTTPS pour une archive et il est très semblable au procédé http en termes d'utilisation et d'options disponibles. La principale différence est que les communications entre apt et le serveur (ou le mandataire) sont chiffrées. Veuillez noter que le chiffrage n'empêche pas un attaquant de savoir avec quel serveur (ou mandataire) apt est en communication et que des analyses approfondies peuvent encore potentiellement révéler quelles données sont téléchargées. Si cela est une préoccupation, des procédés basés sur Tor, mentionnés plus bas, pourraient être une alternative appropriée.

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term><command><replaceable>
en: scheme
fr: procédé

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The mirror scheme specifies the location of a mirrorlist. By default the scheme used for the location is <literal>http</literal>, but any other scheme can be used via <command>mirror+<replaceable>scheme</replaceable></command>.  The mirrorlist itself can contain many different URIs for mirrors the APT client can transparently pick, choose and fallback between intended to help both with distributing the load over the available mirrors and ensuring that clients can acquire data even if some configured mirrors are not available.
fr: Le procédé miroir définit la localisation d'une liste de miroirs. Par défaut, le procédé utilisé par la localisation est <literal>http</literal>, mais n'importe quel autre procédé peut être utilisé avec la commande <command>mirror+<replaceable>scheme</replaceable></command>. La liste de miroirs elle-même peut contenir plusieurs URI de miroirs différentes que le client APT peut, de façon transparente, repérer, choisir et sur lesquelles se rabattre, afin d'aider à la fois à répartir la charge sur les miroirs disponibles et à garantir que les clients puissent récupérer les données même si certains des miroirs configurés ne sont pas disponibles.

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The file scheme allows an arbitrary directory in the file system to be considered an archive. This is useful for NFS mounts and local mirrors or archives.
fr: Le procédé <literal>file</literal> permet qu'un répertoire arbitraire au sein du système de fichiers soit considéré comme une archive. Cela est utilisé avec les montages NFS, les miroirs et les archives locaux.

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The cdrom scheme allows APT to use a local CD-ROM, DVD or USB drive with media swapping. Use the &apt-cdrom; program to create cdrom entries in the source list.
fr: Le procédé <literal>cdrom</literal> permet l'utilisation d'un lecteur de CD, de DVD ou USB, avec la possibilité de changer de média. Utilisez le programme &apt-cdrom; pour créer des entrées <literal>cdrom</literal> dans la liste des sources.

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The ftp scheme specifies an FTP server for an archive. Use of FTP is on the decline in favour of <literal>http</literal> and <literal>https</literal> and many archives either never offered or are retiring FTP access. If you still need this method many configuration options for it are available in the <literal>Acquire::ftp</literal> scope and detailed in &apt-conf;.
fr: Le procédé <literal>ftp</literal> indique un serveur FTP comme archive. L'utilisation de FTP décline en faveur de <literal>http</literal> et <literal>https</literal> et plusieurs archives soit n'ont jamais offert d'accès FTP, soit le retirent. Si vous avez encore besoin de cette méthode, plusieurs options de configuration sont disponibles dans le champ d'action <literal>Acquire::ftp</literal> et détaillées dans &apt-conf;.

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: Please note that an FTP proxy can be specified by using the <envar>ftp_proxy</envar> environment variable. It is possible to specify an HTTP proxy (HTTP proxy servers often understand FTP URLs)  using this environment variable and <emphasis>only</emphasis> this environment variable. Proxies using HTTP specified in the configuration file will be ignored.
fr: Veuillez noter qu'on peut spécifier un mandataire FTP en utilisant la variable d'environnement <envar>ftp_proxy</envar>. On peut aussi spécifier un mandataire HTTP (les serveurs mandataires HTTP comprennent souvent les URL FTP) en utilisant cette méthode et <emphasis>seulement</emphasis> cette méthode. Les mandataires qui utilisent HTTP et qui sont spécifiés dans le fichier de configuration seront ignorés.

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The copy scheme is identical to the file scheme except that packages are copied into the cache directory instead of used directly at their location.  This is useful for people using removable media to copy files around with APT.
fr: Le procédé <literal>copy</literal> est identique au procédé <literal>file</literal> excepté que les paquets sont copiés dans le cache du répertoire au lieu d'être utilisés directement depuis leur emplacement. Ce réglage peut servir aux utilisateurs qui se servent d'un support amovible pour recopier des fichiers avec APT.

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: The rsh/ssh method invokes RSH/SSH to connect to a remote host and access the files as a given user. Prior configuration of rhosts or RSA keys is recommended. The standard <command>find</command> and <command>dd</command> commands are used to perform the file transfers from the remote host.
fr: Le procédé rsh/ssh utilise rsh/ssh pour se connecter à une machine distante et pour accéder aux fichiers en tant qu'un certain utilisateur. Il est recommandé de régler préalablement les hôtes distants (rhosts) ou les clés RSA. Les commandes standard <command>find</command> et <command>dd</command> sont utilisées pour l'accès aux fichiers de la machine distante.

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
en: adding more recognizable URI types
fr: ajout de types d'URI supplémentaires reconnus

note: type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
en: APT can be extended with more methods shipped in other optional packages, which should follow the naming scheme <package>apt-transport-<replaceable>method</replaceable></package>.  For instance, the APT team also maintains the package <package>apt-transport-tor</package>, which provides access methods for HTTP and HTTPS URIs routed via the Tor network.
fr: APT peut être complété avec des méthodes supplémentaires fournies par des paquets optionnels dont le schéma de nommage est <literal>apt-transport-<replaceable>méthode</replaceable></literal>. Ainsi, l'équipe de maintenance d'APT gère un paquet <package>apt-transport-tor</package> qui gère les méthodes d'accès par URI de type HTTP et HTTPS routées à travers le réseau Tor.

note: type: Content of: <refentry><refsect1><para>
en: Uses the archive stored locally (or NFS mounted) at /home/apt/debian for stable/main, stable/contrib, stable/non-free and stable/non-free-firmware.
fr: Utiliser l'archive stockée localement (ou montée via NFS) dans /home/apt/debian pour stable/main, stable/contrib, stable/non-free et stable/non-free-firmware.

note: type: Content of: <refentry><refsect1><para>
en: As above, except this uses the unstable (development) distribution.
fr: Comme ci-dessus, excepté que cette ligne utilise la distribution « unstable » (développement).

note: type: Content of: <refentry><refsect1><para>
en: Sources specification for the above.
fr: Indication des sources pour les lignes précédentes.

note: type: Content of: <refentry><refsect1><para>
en: The first line gets package information for the architectures in <literal>APT::Architectures</literal> while the second always retrieves <literal>amd64</literal> and <literal>armel</literal>.
fr: La première ligne récupère l'information des paquets pour les architectures de <literal>APT::Architectures</literal> alors que la deuxième récupère <literal>amd64</literal> et <literal>armel</literal>.

note: type: Content of: <refentry><refsect1><para>
en: Uses HTTP to access the archive at archive.debian.org, and uses only the hamm/main area.
fr: Utiliser HTTP pour accéder à l'archive située à archive.debian.org, et n'utiliser que la section hamm/main.

note: type: Content of: <refentry><refsect1><para>
en: Uses FTP to access the archive at ftp.debian.org, under the debian directory, and uses only the &debian-stable-codename;/contrib area.
fr: Utiliser FTP pour accéder à l'archive située à ftp.debian.org, dans le répertoire debian, et n'utiliser que la section &debian-stable-codename;/contrib.

note: type: Content of: <refentry><refsect1><para>
en: Uses FTP to access the archive at ftp.debian.org, under the debian directory, and uses only the unstable/contrib area. If this line appears as well as the one in the previous example in <filename>sources.list</filename> a single FTP session will be used for both resource lines.
fr: Utiliser FTP pour accéder à l'archive située à ftp.debian.org, dans le répertoire debian, et n'utiliser que la section unstable/contrib. Si cette ligne et celle de l'exemple précédent dans <filename>sources.list</filename> apparaissent, une seule session FTP sera utilisée pour les deux lignes.

note: type: Content of: <refentry><refsect1><para>
en: Uses HTTP to access the archive at ftp.tlh.debian.org, under the universe directory, and uses only files found under <filename>unstable/binary-i386</filename> on i386 machines, <filename>unstable/binary-amd64</filename> on amd64, and so forth for other supported architectures. [Note this example only illustrates how to use the substitution variable; official debian archives are not structured like this] <placeholder type="literallayout" id="0"/> <placeholder type="literallayout" id="1"/>
fr: Utiliser HTTP pour accéder à l'archive située à ftp.tlh.debian.org, dans le répertoire universe, et n'utiliser que les fichiers trouvés dans <filename>unstable/binary-i386</filename> pour les machines i386, dans <filename>unstable/binary-amd64</filename> pour les machines amd64 et ainsi de suite pour les autres architectures reconnues. [Notez que cet exemple montre seulement la manière d'utiliser la variable à substituer, les archives Debian officielles n'étant pas structurées de cette manière.] <placeholder type="literallayout" id="0"/> <placeholder type="literallayout" id="1"/>

note: type: Content of: <refentry><refsect1><para>
en: Uses HTTP to get binary packages as well as sources from the stable, testing and unstable suites and the components main and contrib.
fr: Utiliser HTTP pour pouvoir obtenir les paquets binaires ainsi que les sources des suites stable, testing et unstable et des composants main et contrib.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Utility to extract <command>debconf</command> config and templates from Debian packages
fr: Outil d'extraction des textes et fichiers de configuration pour <command>debconf</command> contenu dans un paquet Debian

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-extracttemplates</command> will take one or more Debian package files as input and write out (to a temporary directory) all associated config scripts and template files. For each passed in package that contains config scripts and templates, one line of output will be generated in the format:
fr: <command>Apt-extracttemplates</command> prend un ou plusieurs paquets Debian en paramètre et extrait (dans un répertoire temporaire) tous les scripts et guides de configuration associés. Pour chaque paquet traité contenant des scripts et guides de configuration, une ligne est affichée au format suivant :

note: type: Content of: <refentry><refsect1><para>
en: package version template-file config-script
fr: paquet version guide-de-configuration script-de-configuration

note: type: Content of: <refentry><refsect1><para>
en: template-file and config-script are written to the temporary directory specified by the <option>-t</option> or <option>--tempdir</option> (<literal>APT::ExtractTemplates::TempDir</literal>) directory, with filenames of the form <filename>package.template.XXXXXX</filename> and <filename>package.config.XXXXXX</filename>
fr: Les scripts et guides de configuration sont écrits dans le répertoire temporaire indiqué par l'option <option>-t</option> ou <option>--tempdir</option> (<literal>APT::ExtractTemplates::TempDir</literal>) ; les noms de fichier sont de la forme <filename>package.template.XXXXXX</filename> ou <filename>package.config.XXXXXX</filename>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Temporary directory in which to write extracted <command>debconf</command> template files and config scripts.  Configuration Item: <literal>APT::ExtractTemplates::TempDir</literal>
fr: Répertoire temporaire dans lequel écrire les scripts de configuration et modèles d'écrans pour <command>debconf</command>. Élément de configuration : <literal>APT::ExtractTemplates::TempDir</literal>.

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-extracttemplates</command> returns zero on normal operation, decimal 100 on error.
fr: <command>apt-extracttemplates</command> retourne zéro si tout se passe bien, le nombre 100 en cas d'erreur.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Utility to sort package index files
fr: Outil de tri des index de paquets.

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-sortpkgs</command> will take an index file (source index or package index) and sort the records so that they are ordered by the package name.  It will also sort the internal fields of each record according to the internal sorting rules.
fr: <command>Apt-sortpkgs</command> prend un index (un index de Source ou un index de paquet) et trie leurs enregistrements selon le nom de paquet. Un tri des champs de chaque enregistrement est réalisé selon des règles internes.

note: type: Content of: <refentry><refsect1><para>
en: All output is sent to standard output; the input must be a seekable file.
fr: Le résultat est envoyé sur la sortie standard ; l'entrée doit être un fichier analysable.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Use source index field ordering.  Configuration Item: <literal>APT::SortPkgs::Source</literal>.
fr: Utiliser un index de sources pour le tri des champs. Élément de configuration : <literal>APT::SortPkgs::Source</literal>.

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-sortpkgs</command> returns zero on normal operation, decimal 100 on error.
fr: <command>apt-sortpkgs</command> retourne zéro si tout se passe bien ou 100 en cas d'erreur.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Utility to generate index files
fr: Outil de création de fichiers d'index

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-ftparchive</command> is the command line tool that generates the index files that APT uses to access a distribution source. The index files should be generated on the origin site based on the content of that site.
fr: <command>apt-ftparchive</command> est l'outil en ligne de commande qui crée les index dont APT se sert pour accéder aux sources des distributions. Un index doit être créé pour un site et basé sur le contenu de ce site.

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; program, incorporating its entire functionality via the <literal>packages</literal> command.  It also contains a contents file generator, <literal>contents</literal>, and an elaborate means to 'script' the generation process for a complete archive.
fr: <command>apt-ftparchive</command> est un ensemble comprenant le programme &dpkg-scanpackages; et toutes ses fonctionnalités via la commande <literal>packages</literal> ; il comprend aussi un générateur de fichier « Contents », la commande <literal>contents</literal>, et une technique élaborée pour automatiser le processus de création d'une archive complète.

note: type: Content of: <refentry><refsect1><para>
en: Internally <command>apt-ftparchive</command> can make use of binary databases to cache the contents of a .deb file and it does not rely on any external programs aside from &gzip;. When doing a full generate it automatically performs file-change checks and builds the desired compressed output files.
fr: <command>Apt-ftparchive</command> peut utiliser lui-même des bases de données binaires pour « cacher » le contenu d'un fichier .deb ; il n'a pas besoin de programmes extérieurs, sauf &gzip;. Lors d'une exécution, il vérifie les changements dans les fichiers et crée les fichiers compressés voulus.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The packages command generates a package file from a directory tree. It takes the given directory and recursively searches it for .deb files, emitting a package record to stdout for each. This command is approximately equivalent to &dpkg-scanpackages;.
fr: La commande packages crée un fichier « Packages » à partir d'une arborescence. Elle recherche récursivement à travers le répertoire donné les fichiers .deb et, pour chaque fichier trouvé, envoie une entrée pour ce paquet sur la sortie standard. Cette commande est approximativement équivalente à &dpkg-scanpackages;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The option <option>--db</option> can be used to specify a binary caching DB.
fr: On peut se servir de l'option <option>--db</option> pour demander un cache binaire.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <literal>sources</literal> command generates a source index file from a directory tree.  It takes the given directory and recursively searches it for .dsc files, emitting a source record to stdout for each. This command is approximately equivalent to &dpkg-scansources;.
fr: La commande <literal>sources</literal> crée un index des sources à partir d'une arborescence. Elle recherche récursivement à travers le répertoire donné les fichiers .dsc et, pour chaque fichier trouvé, envoie une entrée pour ce paquet sur la sortie standard. Cette commande est approximativement équivalente à &dpkg-scansources;.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If an override file is specified then a source override file will be looked for with an extension of .src. The --source-override option can be used to change the source override file that will be used.
fr: Quand on précise un fichier « override », c'est un fichier source avec une extension .src qui est recherché. On peut se servir de l'option --source-override pour changer de fichier source d'« override ».

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <literal>contents</literal> command generates a contents file from a directory tree. It takes the given directory and recursively searches it for .deb files, and reads the file list from each file. It then sorts and writes to stdout the list of files matched to packages. Directories are not written to the output. If multiple packages own the same file then each package is separated by a comma in the output.
fr: La commande <literal>contents</literal> crée un fichier « Contents » à partir d'une arborescence. Elle recherche récursivement à travers le répertoire donné les fichiers .deb et, pour chaque fichier trouvé, lit la liste des fichiers. Elle trie la liste des fichiers correspondant à des paquets et l'envoie sur la sortie standard. Les répertoires ne font pas partie du résultat. Quand un fichier appartient à plusieurs paquets, une virgule sépare les paquets.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <literal>release</literal> command generates a Release file from a directory tree. It recursively searches the given directory for uncompressed and compressed <filename>Packages</filename>, <filename>Sources</filename>, <filename>Contents</filename>, <filename>Components</filename> and <filename>icons</filename> files as well as <filename>Release</filename>, <filename>Index</filename> and <filename>md5sum.txt</filename> files by default (<literal>APT::FTPArchive::Release::Default-Patterns</literal>).  Additional filename patterns can be added by listing them in <literal>APT::FTPArchive::Release::Patterns</literal>.  It then writes to stdout a <filename>Release</filename> file containing (by default) an MD5, SHA1, SHA256 and SHA512 digest for each file.
fr: La commande <literal>release</literal> crée un fichier Release à partir d'une arborescence. Elle recherche récursivement dans le répertoire indiqué des fichiers <filename>Packages</filename>, <filename>Sources</filename>, <filename>Contents</filename>, <filename>Components</filename> et <filename>icons</filename> non compressés et compressés ainsi que des fichiers <filename>Release</filename>, <filename>Index</filename> et <filename>md5sum.txt</filename> par défaut (<literal>APT::FTPArchive::Release::Default-Patterns</literal>). Des motifs supplémentaires pour les noms de fichiers peuvent être ajoutés en les mentionnant dans <literal>APT::FTPArchive::Release::Patterns</literal>. Le fichier <filename>Release</filename> est ensuite affiché sur la sortie standard et comporte (par défaut) des sommes de contrôle MD5, SHA1 et SHA256 et SHA512 pour chaque fichier.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Values for the additional metadata fields in the Release file are taken from the corresponding variables under <literal>APT::FTPArchive::Release</literal>, e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The supported fields are <literal>Origin</literal>, <literal>Label</literal>, <literal>Suite</literal>, <literal>Version</literal>, <literal>Codename</literal>, <literal>Date</literal>, <literal>NotAutomatic</literal>, <literal>ButAutomaticUpgrades</literal>, <literal>Acquire-By-Hash</literal>, <literal>Valid-Until</literal>, <literal>Signed-By</literal>, <literal>Architectures</literal>, <literal>Components</literal> and <literal>Description</literal>.
fr: La valeur des autres champs de métadonnées du fichier Release sont tirées de la valeur correspondante dans <literal>APT::FTPArchive::Release</literal>, p. ex. <literal>APT::FTPArchive::Release::Origin</literal>. Les champs reconnus sont : <literal>Origin</literal>, <literal>Label</literal>, <literal>Suite</literal>, <literal>Version</literal>, <literal>Codename</literal>, <literal>Date</literal>, <literal>NotAutomatic</literal>, <literal>ButAutomaticUpgrades</literal>, <literal>Acquire-By-Hash</literal>, <literal>Valid-Until</literal>, <literal>Signed-By</literal>, <literal>Architectures</literal>, <literal>Components</literal>, <literal>Description</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <literal>generate</literal> command is designed to be runnable from a cron script and builds indexes according to the given config file. The config language provides a flexible means of specifying which index files are built from which directories, as well as providing a simple means of maintaining the required settings.
fr: La commande <literal>generate</literal> est conçue pour être exécutable par le programme cron et elle crée un index en suivant le fichier de configuration donné. Le langage de configuration fournit un moyen souple de préciser index et répertoires aussi bien que les paramètres requis.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <literal>clean</literal> command tidies the databases used by the given configuration file by removing any records that are no longer necessary.
fr: La commande <literal>clean</literal> nettoie les bases de données utilisées par le fichier de configuration en supprimant les enregistrements qui ne sont plus nécessaires.

note: type: Content of: <refentry><refsect1><title>
en: The Generate Configuration
fr: Configuration de la commande generate

note: type: Content of: <refentry><refsect1><para>
en: The <literal>generate</literal> command uses a configuration file to describe the archives that are going to be generated. It follows the typical ISC configuration format as seen in ISC tools like bind 8 and dhcpd.  &apt-conf; contains a description of the syntax. Note that the generate configuration is parsed in sectional manner, but &apt-conf; is parsed in a tree manner. This only effects how the scope tag is handled.
fr: La commande <literal>generate</literal> utilise un fichier de configuration pour décrire l'archive qui va être créée. Le format de ce fichier est le format ISC classique utilisé par des outils ISC comme bind 8 et dhcpd. Le fichier &apt-conf; décrit ce format. Il faut noter que l'analyse de ce fichier se fait par section tandis que celle d'&apt-conf; se fait par arborescence. Cela n'affecte que l'usage de l'étiquette de visée (scope tag).

note: type: Content of: <refentry><refsect1><para>
en: The generate configuration has four separate sections, each described below.
fr: Ce fichier de configuration possède quatre sections, décrites ci-dessous.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: <literal>Dir</literal> Section
fr: La section <literal>Dir</literal>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <literal>Dir</literal> section defines the standard directories needed to locate the files required during the generation process. These directories are prepended certain relative paths defined in later sections to produce a complete an absolute path.
fr: La section <literal>Dir</literal> définit les répertoires standards où situer les fichiers nécessaires au processus de création. Ces répertoires sont précédés de chemins relatifs définis dans les sections suivantes de manière à produire un chemin absolu et complet.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the root of the FTP archive, in a standard Debian configuration this is the directory that contains the <filename>ls-LR</filename> and dist nodes.
fr: Indique la racine de l'archive FTP ; Pour une configuration Debian classique, c'est le répertoire qui contient le fichier <filename>ls-LR</filename> et les noeuds des distributions.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the location of the override files.
fr: Indique l'emplacement des fichiers d'« override ».

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the location of the cache files.
fr: Indique l'emplacement des fichiers de cache.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the location of the file list files, if the <literal>FileList</literal> setting is used below.
fr: Indique l'emplacement des fichiers contenant la liste des fichiers (si on se sert de la valeur <literal>FileList</literal> définie plus bas).

note: type: Content of: <refentry><refsect1><refsect2><title>
en: <literal>Default</literal> Section
fr: La section <literal>Default</literal>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <literal>Default</literal> section specifies default values, and settings that control the operation of the generator. Other sections may override these defaults with a per-section setting.
fr: La section <literal>Default</literal> précise les valeurs par défaut et les paramètres qui contrôlent la marche du générateur. Ces valeurs peuvent être annulées dans d'autres sections (paramètrage par section).

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the default compression schemes to use for the package index files. It is a string that contains a space separated list of at least one of the compressors configured via the <option>APT::Compressor</option> configuration scope.  The default for all compression schemes is '. gzip'.
fr: Indique comment sont compressés les fichiers d'index. C'est une chaîne qui contient une liste séparée par des espaces qui contient au moins l'un des compresseurs configuré à travers le champ d'action de configuration <option>APT::Compressor</option>. La valeur par défaut pour tous les schémas de compression est « . gzip ».

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the default list of file extensions that are package files.  This defaults to '.deb'.
fr: Indique la liste par défaut des extensions de fichier qui constituent des paquets. Par défaut, c'est « .deb ».

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This is similar to <literal>Packages::Compress</literal> except that it controls the compression for the Sources files.
fr: Identique à <literal>Packages::Compress</literal> mais précise comment sont compressés les fichiers sources.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the default list of file extensions that are source files.  This defaults to '.dsc'.
fr: Indique la liste par défaut des extensions de fichier qui constituent des fichiers sources. Par défaut, c'est « .dsc ».

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This is similar to <literal>Packages::Compress</literal> except that it controls the compression for the Contents files.
fr: Identique à <literal>Packages::Compress</literal> mais précise comment sont compressés les fichiers « Contents ».

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This is similar to <literal>Packages::Compress</literal> except that it controls the compression for the Translation-en master file.
fr: Identique à <literal>Packages::Compress</literal> mais précise comment est compressé le fichier maître Translations-en.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the number of kilobytes to delink (and replace with hard links) per run. This is used in conjunction with the per-section <literal>External-Links</literal> setting.
fr: Indique le nombre de kilo-octets à délier (et à remplacer par des liens en dur) pour chaque exécution. On s'en sert, pour chaque section, avec le paramètre <literal>External-Links</literal>.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the mode of all created index files. It defaults to 0644. All index files are set to this mode with no regard to the umask.
fr: Indique le système de permissions des fichiers d'index créés. Par défaut, c'est le mode 0644. Tous les fichiers d'index ont ce mode et le masque utilisateur (umasq) est ignoré.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies whether long descriptions should be included in the <filename>Packages</filename> file or split out into a master <filename>Translation-en</filename> file.
fr: Définit si les descriptions longues doivent être incluses dans le fichier <filename>Packages</filename> ou déplacées dans un fichier maître <filename>Translation-en</filename>.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: <literal>TreeDefault</literal> Section
fr: La section <literal>TreeDefault</literal>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Sets defaults specific to <literal>Tree</literal> sections. All of these variables are substitution variables and have the strings $(DIST), $(SECTION) and $(ARCH) replaced with their respective values.
fr: Indique les valeurs par défaut particulières à la section <literal>Tree</literal>. Toutes ces variables sont des variables de substitution ; les chaînes $(DIST), $(SECTION) et $(ARCH) sont remplacées par leur valeur respective.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the number of kilobytes of contents files that are generated each day. The contents files are round-robined so that over several days they will all be rebuilt.
fr: Indique le nombre de kilo-octets de fichiers « Contents » qui sont créés chaque jour. Les fichiers « Contents » sont choisis selon le système « round-robin » de manière que, sur plusieurs jours, tous soient reconstruits.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Controls the number of days a contents file is allowed to be checked without changing. If this limit is passed the mtime of the contents file is updated. This case can occur if the package file is changed in such a way that does not result in a new contents file [override edit for instance]. A hold off is allowed in hopes that new .debs will be installed, requiring a new file anyhow. The default is 10, the units are in days.
fr: Contrôle le nombre de jours pendant lequel un fichier « Contents » peut être utilisé sans actualisation. Quand cette limite est franchie, le « mtime » du fichier « Contents » est mis à jour. Cela peut arriver quand un fichier est modifié sans que cela modifie le fichier « Contents » (modification par « override » par exemple). Un délai est permis dans l'espoir que de nouveaux « .deb » seront installés, exigeant un nouveau « Contents ». Par défaut ce nombre vaut 10, l'unité étant le jour.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the top of the .deb directory tree. Defaults to <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>
fr: Indique la racine de l'arborescence des « .deb ». Par défaut, c'est <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the top of the source package directory tree. Defaults to <filename>$(DIST)/$(SECTION)/source/</filename>
fr: Indique la racine de l'arborescence des paquets source. Par défaut, c'est <filename>$(DIST)/$(SECTION)/source/</filename>.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the output Packages file. Defaults to <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>
fr: Indique le fichier « Packages » créé. Par défaut, c'est <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the output Sources file. Defaults to <filename>$(DIST)/$(SECTION)/source/Sources</filename>
fr: Indique le fichier « Sources » créé. Par défaut, c'est <filename>$(DIST)/$(SECTION)/source/Sources</filename>.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the output Translation-en master file with the long descriptions if they should be not included in the Packages file. Defaults to <filename>$(DIST)/$(SECTION)/i18n/Translation-en</filename>
fr: Définit le fichier maître Translation-en qui comporte les descriptions longues si elles ne sont pas incluses dans le fichier Packages. Valeur par défaut : <filename>$(DIST)/$(SECTION)/i18n/Translation-en</filename>

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the path prefix that causes a symlink to be considered an internal link instead of an external link. Defaults to <filename>$(DIST)/$(SECTION)/</filename>
fr: Indique un préfixe de chemin ; ce préfixe fait qu'un lien symbolique sera considéré comme un lien interne plutôt que comme un lien externe. Par défaut, c'est <filename>$(DIST)/$(SECTION)/</filename>.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the output Contents file. Defaults to <filename>$(DIST)/$(SECTION)/Contents-$(ARCH)</filename>. If this setting causes multiple Packages files to map onto a single Contents file (as is the default)  then <command>apt-ftparchive</command> will integrate those package files together automatically.
fr: Indique le fichier « Contents » créé. Par défaut, c'est <filename>$(DIST)/Contents-$(ARCH)</filename>. Quand le paramètrage fait que différents fichiers « Packages » se réfèrent à un seul fichier « Contents », <command>apt-ftparchive</command> les intègre automatiquement.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets header file to prepend to the contents output.
fr: Indique l'en-tête à préfixer au fichier « Contents » créé.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the binary cache database to use for this section. Multiple sections can share the same database.
fr: Indique la base de données binaire servant de cache pour cette section. Différentes sections peuvent partager cette base de données.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies that instead of walking the directory tree, <command>apt-ftparchive</command> should read the list of files from the given file. Relative files names are prefixed with the archive directory.
fr: Indique qu'au lieu de lire l'arborescence, <command>apt-ftparchive</command> doit lire la liste de fichiers dans le fichier donné en paramètre. Les noms relatifs sont préfixés par le répertoire de l'archive.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies that instead of walking the directory tree, <command>apt-ftparchive</command> should read the list of files from the given file. Relative files names are prefixed with the archive directory.  This is used when processing source indexes.
fr: Indique qu'au lieu de lire l'arborescence, <command>apt-ftparchive</command> doit lire la liste de fichiers dans le fichier donné en paramètre. Les noms relatifs sont préfixés par le répertoire de l'archive. On s'en sert pour traiter les index de sources.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: <literal>Tree</literal> Section
fr: La section <literal>Tree</literal>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <literal>Tree</literal> section defines a standard Debian file tree which consists of a base directory, then multiple sections in that base directory and finally multiple Architectures in each section. The exact pathing used is defined by the <literal>Directory</literal> substitution variable.
fr: La section <literal>Tree</literal> définit une arborescence debian classique avec un répertoire de base, différentes sections dans ce répertoire et différentes architectures dans chaque section. Le chemin exact est défini par la variable de substitution <literal>Directory</literal>.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <literal>Tree</literal> section takes a scope tag which sets the <literal>$(DIST)</literal> variable and defines the root of the tree (the path is prefixed by <literal>ArchiveDir</literal>).  Typically this is a setting such as <filename>dists/&debian-stable-codename;</filename>.
fr: La section <literal>Tree</literal> accepte une étiquette de visée (scope tag) qui détermine la variable <literal>$(DIST)</literal> et la racine de l'arborescence (le chemin est préfixé par <literal>ArchiveDir</literal>). C'est par exemple : <filename>dists/&debian-stable-codename;</filename>.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: All of the settings defined in the <literal>TreeDefault</literal> section can be used in a <literal>Tree</literal> section as well as three new variables.
fr: Tous les paramètres définis dans la section <literal>TreeDefault</literal> peuvent s'utiliser dans la section <literal>Tree</literal> ainsi que les trois nouvelles variables suivantes.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: When processing a <literal>Tree</literal> section <command>apt-ftparchive</command> performs an operation similar to: <placeholder type="programlisting" id="0"/>
fr: Quand il exécute la section <literal>Tree</literal>, <command>apt-ftparchive</command> effectue une opération analogue à : <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This is a space separated list of sections which appear under the distribution; typically this is something like <literal>main contrib non-free non-free-firmware</literal>
fr: C'est une liste de sections séparées par des espaces qui appartiennent à une distribution ; classiquement, on trouve <literal>main contrib non-free non-free-firmware</literal>.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This is a space separated list of all the architectures that appear under search section. The special architecture 'source' is used to indicate that this tree has a source archive.  The architecture 'all' signals that architecture specific files like <filename>Packages</filename> should not include information about architecture <literal>all</literal> packages in all files as they will be available in a dedicated file.
fr: C'est une liste de toutes les architectures séparées par des espaces qui appartiennent à chaque section. L'architecture spéciale « source » indique que l'arborescence est une arborescence de sources. L'architecture « all » indique que les fichiers spécifiques à l'architecture comme <filename>Packages</filename> ne devraient pas inclure d'informations sur les paquets de l'architecture <literal>all</literal> dans tous les fichiers comme elles devraient être disponibles dans un fichier dédié.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the binary override file. The override file contains section, priority and maintainer address information.
fr: Indique le fichier binaire d'« override ». Ce fichier contient des informations sur la section, la priorité et le responsable du paquet.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the source override file. The override file contains section information.
fr: Indique le fichier source d'« override ». Ce fichier contient des informations sur la section.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the binary extra override file.
fr: Indique un autre fichier d'« override » pour les binaires.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the source extra override file.
fr: Indique un autre fichier d'« override » pour les sources.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: <literal>BinDirectory</literal> Section
fr: La section <literal>BinDirectory</literal>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The <literal>bindirectory</literal> section defines a binary directory tree with no special structure. The scope tag specifies the location of the binary directory and the settings are similar to the <literal>Tree</literal> section with no substitution variables or <literal>Section</literal><literal>Architecture</literal> settings.
fr: La section <literal>bindirectory</literal> définit une arborescence binaire sans structure particulière. L'étiquette de visée (scope tag) indique l'emplacement du répertoire binaire et le paramètrage est identique à celui pour la section <literal>Tree</literal> sans substitution de variables ou au paramètrage de <literal>Section</literal><literal>Architecture</literal>.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the Packages file output.
fr: Définit le fichier « Packages » créé.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the Sources file output. At least one of <literal>Packages</literal> or <literal>Sources</literal> is required.
fr: Définit le fichier « Sources » créé. L'un des deux fichiers, <literal>Packages</literal> ou <literal>Sources</literal> est nécessaire.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the Contents file output (optional).
fr: Définit le fichier « Contents » créé.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the binary override file.
fr: Définit le fichier d'« override » pour les binaires.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the source override file.
fr: Définit le fichier d'« override » pour les sources.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the cache DB.
fr: Définit la base de données cache.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Appends a path to all the output paths.
fr: Ajoute un chemin à tous les chemins créés.

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Specifies the file list file.
fr: Définit le fichier contenant la liste des fichiers.

note: type: Content of: <refentry><refsect1><title>
en: The Binary Override File
fr: Le fichier d'« Override » pour les binaires.

note: type: Content of: <refentry><refsect1><para>
en: The binary override file is fully compatible with &dpkg-scanpackages;. It contains four fields separated by spaces. The first field is the package name, the second is the priority to force that package to, the third is the section to force that package to and the final field is the maintainer permutation field.
fr: Le fichier d'« Override » est pleinement compatible avec &dpkg-scanpackages;. Il contient quatre champs séparés par des espaces. Le premier est le nom du paquet ; le deuxième est la priorité à donner à ce paquet ; le troisième est sa section et le dernier champ est un champ pour changer le nom du responsable de paquet.

note: type: Content of: <refentry><refsect1><para>
en: The general form of the maintainer field is: <placeholder type="literallayout" id="0"/> or simply, <placeholder type="literallayout" id="1"/> The first form allows a double-slash separated list of old email addresses to be specified. If any of those are found then new is substituted for the maintainer field. The second form unconditionally substitutes the maintainer field.
fr: Le champ du responsable est de cette forme : <placeholder type="literallayout" id="0"/> ou simplement, <placeholder type="literallayout" id="1"/> La première forme permet de spécifier de vieilles adresses dans une liste (le séparateur est la double barre oblique). Si l'une de ces deux formes est rencontrée, la valeur de new remplace la valeur du champ. La deuxième forme remplace inconditionnellement le champ.

note: type: Content of: <refentry><refsect1><title>
en: The Source Override File
fr: Le fichier d'« Override » pour les sources

note: type: Content of: <refentry><refsect1><para>
en: The source override file is fully compatible with &dpkg-scansources;. It contains two fields separated by spaces. The first field is the source package name, the second is the section to assign it.
fr: Le fichier d'« Override » est pleinement compatible avec &dpkg-scansources;. Il contient deux champs. Le premier est le nom du paquet source ; le second, sa section.

note: type: Content of: <refentry><refsect1><title>
en: The Extra Override File
fr: Le fichier supplémentaire d'« Override »

note: type: Content of: <refentry><refsect1><para>
en: The extra override file allows any arbitrary tag to be added or replaced in the output. It has three columns, the first is the package, the second is the tag and the remainder of the line is the new value.
fr: Le fichier supplémentaire d'« Override » permet d'ajouter ou de remplacer des étiquettes sur la sortie. Il possède trois colonnes : la première représente le paquet, la seconde est une étiquette et la troisième en fin de ligne est la nouvelle valeur.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Generate the given checksum. These options default to on, when turned off the generated index files will not have the checksum fields where possible.  Configuration Items: <literal>APT::FTPArchive::<replaceable>Checksum</replaceable></literal> and <literal>APT::FTPArchive::<replaceable>Index</replaceable>::<replaceable>Checksum</replaceable></literal> where <literal><replaceable>Index</replaceable></literal> can be <literal>Packages</literal>, <literal>Sources</literal> or <literal>Release</literal> and <literal><replaceable>Checksum</replaceable></literal> can be <literal>MD5</literal>, <literal>SHA1</literal>, <literal>SHA256</literal> or <literal>SHA512</literal>.
fr: Crée la somme de contrôle indiquée. Si ces options sont actives par défaut. Quand elles sont désactivées, les fichiers d'index créés n'auront pas de champ de somme de contrôle là où cela était possible. Éléments de configuration :<literal>APT::FTPArchive::<replaceable>Checksum</replaceable></literal> et <literal>APT::FTPArchive::<replaceable>Index</replaceable>::<replaceable>Checksum</replaceable></literal> où <literal><replaceable>Index</replaceable></literal> peut être <literal>Packages</literal>, <literal>Sources</literal> ou <literal>Release</literal> et <literal><replaceable>Checksum</replaceable></literal> peut être <literal>MD5</literal>, <literal>SHA1</literal>, <literal>SHA256</literal> ou <literal>SHA512</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Use a binary caching DB. This has no effect on the generate command.  Configuration Item: <literal>APT::FTPArchive::DB</literal>.
fr: Utiliser une base de données binaire pour cache. Cela n'a aucun effet sur la commande generate. Élément de configuration : <literal>APT::FTPArchive::DB</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Quiet; produces output suitable for logging, omitting progress indicators.  More q's will produce more quiet up to a maximum of 2. You can also use <option>-q=#</option> to set the quiet level, overriding the configuration file.  Configuration Item: <literal>quiet</literal>.
fr: Mode silencieux ; cette commande produit une sortie destinée à l'enregistrement dans un fichier-journal en omettant les indicateurs de progression. Un plus grand nombre de « q » (2 au plus) rend le programme de plus en plus silencieux. On peut aussi utiliser <option>-q=#</option> pour définir ce « niveau de silence », et ne plus tenir compte des réglages du fichier de configuration. Élément de configuration : <literal>quiet</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Perform Delinking. If the <literal>External-Links</literal> setting is used then this option actually enables delinking of the files. It defaults to on and can be turned off with <option>--no-delink</option>.  Configuration Item: <literal>APT::FTPArchive::DeLinkAct</literal>.
fr: Défaire une liaison. Si <literal>External-Links</literal> est activé, cette option permet réellement de délier les fichiers. Par défaut, elle est activée mais elle peut être désactivée avec l'option <option>--no-delink</option>. Élément de configuration : <literal>APT::FTPArchive::DeLinkAct</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Perform contents generation. When this option is set and package indexes are being generated with a cache DB then the file listing will also be extracted and stored in the DB for later use. When using the generate command this option also allows the creation of any Contents files. The default is on.  Configuration Item: <literal>APT::FTPArchive::Contents</literal>.
fr: Permettre la création d'un fichier « Contents ». Quand cette option est activée et que les index sont créés sous forme de base de données binaire, la liste des fichiers est aussi extraite et conservée dans la base de données pour un usage futur. Avec la commande generate, cette option permet la création de fichiers « Contents ». Par défaut, elle est activée. Élément de configuration : <literal>APT::FTPArchive::Contents</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Select the source override file to use with the <literal>sources</literal> command.  Configuration Item: <literal>APT::FTPArchive::SourceOverride</literal>.
fr: Indique le fichier d'« override » à utiliser avec la commande <literal>sources</literal>. Élément de configuration : <literal>APT::FTPArchive::SourceOverride</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Make the caching databases read only.  Configuration Item: <literal>APT::FTPArchive::ReadOnlyDB</literal>.
fr: N'autoriser que la lecture pour les bases de données de cache. Élément de configuration : <literal>APT::FTPArchive::ReadOnlyDB</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Accept in the <literal>packages</literal> and <literal>contents</literal> commands only package files matching <literal>*_arch.deb</literal> or <literal>*_all.deb</literal> instead of all package files in the given path.  Configuration Item: <literal>APT::FTPArchive::Architecture</literal>.
fr: N'accepte dans les commandes <literal>packages</literal> et <literal>contents</literal> que les fichiers de paquets correspondant à <literal>*_arch.deb</literal> ou <literal>*_all.deb</literal> au lieu de tous les fichiers de paquets du chemin indiqué.Élément de configuration : <literal>APT::FTPArchive::Architecture</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: &apt-ftparchive; caches as much as possible of metadata in a cachedb. If packages are recompiled and/or republished with the same version again, this will lead to problems as the now outdated cached metadata like size and checksums will be used. With this option enabled this will no longer happen as it will be checked if the file was changed.  Note that this option is set to "<literal>false</literal>" by default as it is not recommend to upload multiple versions/builds of a package with the same version number, so in theory nobody will have these problems and therefore all these extra checks are useless.
fr: &apt-ftparchive; met le plus de métadonnées possible en cache dans une base de données. Si les paquets sont recompilés ou republiés avec à nouveau la même version, cela pourra causer des problèmes car, alors, les métadonnées en cache (p. ex. les tailles et les sommes de contrôle) seront utilisées. Si cette option est choisie, cela n'arrivera plus car le fichier sera contrôlé pour vérifier s'il a été modifié. Veuillez noter que cette option n'est pas activée par défaut car il est déconseillé d'envoyer dans les archives des versions identiques. En théorie, donc, ces problème ne devraient pas survenir et l'ensemble de ces contrôles devient inutile.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This configuration option defaults to "<literal>true</literal>" and should only be set to <literal>"false"</literal> if the Archive generated with &apt-ftparchive; also provides <filename>Translation</filename> files. Note that the <filename>Translation-en</filename> master file can only be created in the generate command.
fr: Cette option de configuration a « <literal>true</literal> » comme valeur par défaut et ne devrait être placée sur « <literal>false</literal> » que si l'archive créée avec &apt-ftparchive; fournit également des fichiers <filename>Translation</filename>. Veuillez noter que le fichier maître <filename>Translation-en</filename> ne peut être créé que par la commande generate.

note: type: Content of: <refentry><refsect1><para><programlisting>
en: <command>apt-ftparchive</command> packages <replaceable>directory</replaceable> | <command>gzip</command> > <filename>Packages.gz</filename>
fr: <command>apt-ftparchive</command> packages <replaceable>répertoire</replaceable> | <command>gzip</command> > <filename>Packages.gz</filename>

note: type: Content of: <refentry><refsect1><para>
en: To create a compressed Packages file for a directory containing binary packages (.deb): <placeholder type="programlisting" id="0"/>
fr: Création d'un fichier « Packages » compressé pour un répertoire contenant des paquets binaires (.deb): <placeholder type="programlisting" id="0"/>

note: type: Content of: <refentry><refsect1><para>
en: <command>apt-ftparchive</command> returns zero on normal operation, decimal 100 on error.
fr: <command>apt-ftparchive</command> retourne zéro si tout se passe bien, le nombre 100 en cas d'erreur.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Login configuration file for APT sources and proxies
fr: Fichier de configuration de connexion pour les sources et les mandataires d'APT

note: type: Content of: <refentry><refsect1><para>
en: APT configuration files like &sources-list; or &apt-conf; need to be accessible for everyone using apt tools on the system to have access to all package-related information like the available packages in a repository. Login information needed to connect to a proxy or to download data from a repository on the other hand shouldn't always be accessible by everyone and can hence not be placed in a file with world-readable file permissions.
fr: Les fichiers de configuration d'APT tels que &sources-list; ou &apt-conf; doivent pouvoir être accessibles à tous ceux qui utilisent les outils d'APT sur le système pour accéder à toutes les informations relatives aux paquets telles que les paquets disponibles dans un dépôt. Les informations de connexion nécessaires pour se connecter à un mandataire ou pour télécharger des données à partir d'un dépôt, d'un autre côté, ne devraient pas toujours être accessibles à tous et ne peuvent donc pas être mises dans un fichier doté de droits de lecture universels.

note: type: Content of: <refentry><refsect1><para>
en: The APT auth.conf file <filename>/etc/apt/auth.conf</filename>, and .conf files inside <filename>/etc/apt/auth.conf.d</filename> can be used to store login information in a netrc-like format with restrictive file permissions.
fr: Le fichier auth.conf d'APT <filename>/etc/apt/auth.conf</filename> ainsi que les fichiers .conf dans <filename>/etc/apt/auth.conf.d</filename> peuvent être utilisés pour stocker les informations de connexion dans un format de type netrc avec des droits d'accès restreints.

note: type: Content of: <refentry><refsect1><title>
en: netrc-like format
fr: format de type netrc

note: type: Content of: <refentry><refsect1><para>
en: The format defined here is similar to the format of the <filename>~/.netrc</filename> file used by <citerefentry><refentrytitle><command>ftp</command></refentrytitle><manvolnum>1</manvolnum></citerefentry> and similar programs interacting with servers.  It is a simple token-based format with the following tokens being recognized; Unknown tokens will be ignored. Tokens may be separated by spaces, tabs or newlines.
fr: Le format défini ici est analogue au format du fichier <filename>~/.netrc</filename> utilisé par <citerefentry><refentrytitle><command>ftp</command></refentrytitle><manvolnum>1</manvolnum></citerefentry> et des programmes similaires interagissant avec des serveurs. C'est un format simple basé sur les jetons qui reconnaît les jetons suivants ; les jetons inconnus seront ignorés. Les jetons peuvent être séparés par des espaces, des tabulations ou des changements de ligne.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Entries are looked up by searching for the <emphasis><literal>machine</literal></emphasis> token matching the hostname of the URI apt needs login information for. Extending the netrc-format a portnumber can be specified. If no port is given the token matches for all ports.  Similar the path is optional and only needed and useful if multiple repositories with different login information reside on the same server. A machine token with a path matches if the path in the URI starts with the path given in the token.  Once a match is made, the subsequent tokens are processed, stopping when the end of file is reached or another <emphasis><literal>machine</literal></emphasis> token is encountered.
fr: Les entrées sont trouvées en recherchant le jeton de <emphasis><literal>machine</literal></emphasis> correspondant au nom d'hôte de l'URI qui fournit les informations de connexion dont APT a besoin. Comme extension du format netrc, un numéro de port peut être défini. Si ce n'est pas le cas, le jeton est valide pour tous les ports. De la même manière, le chemin est facultatif et seulement nécessaire et utile si plusieurs dépôts, avec des informations de connexion différentes, sont hébergées sur le même serveur. Un jeton de machine avec un chemin correspond si le chemin dans l'URI débute par le chemin donné dans le jeton. Une fois qu'une correspondance est établie, les jetons suivants sont traités, s'arrêtant lorsque la fin du fichier est atteinte ou qu'un autre jeton de <emphasis><literal>machine</literal></emphasis> est rencontré.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <literal>login</literal> <replaceable>name</replaceable>
fr: <literal>login</literal> <replaceable>nom</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The username to be used.
fr: L'identifiant à utiliser

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <literal>password</literal> <replaceable>string</replaceable>
fr: <literal>password</literal> <replaceable>chaîne</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The password to be used.
fr: Le mot de passe à utiliser.

note: type: Content of: <refentry><refsect1><title>
en: Example
fr: Exemple

note: type: Content of: <refentry><refsect1><para>
en: Supplying login information for a user named <literal>apt</literal> with the password <literal>debian</literal> for the &sources-list; entry <placeholder type="literallayout" id="0"/> could be done in the entry directly: <placeholder type="literallayout" id="1"/> Alternatively an entry like the following in the auth.conf file could be used: <placeholder type="literallayout" id="2"/> Or alternatively within a single line: <placeholder type="literallayout" id="3"/> If you need to be more specific all of these lines will also apply to the example entry: <placeholder type="literallayout" id="4"/> On the other hand neither of the following lines apply: <placeholder type="literallayout" id="5"/>
fr: La fourniture d'informations de connexion pour un utilisateur nommé <literal>apt</literal> avec le mot de passe <literal>debian</literal> pour l'entrée de &sources-list; <placeholder type="literallayout" id="0"/> peut se faire directement dans l'entrée : <placeholder type="literallayout" id="1"/> Autrement, une entrée dans le fichier auth.conf telle que la suivante peut être utilisée : <placeholder type="literallayout" id="2"/> Ou enfin, en une seule ligne : <placeholder type="literallayout" id="3"/>. Si vous avez besoin d'être plus précis, tout le contenu de ces lignes s'appliquera également à l'entrée d'exemple : <placeholder type="literallayout" id="4"/> En revanche, aucune des lignes suivantes ne s'applique : <placeholder type="literallayout" id="5"/>

note: type: Content of: <refentry><refsect1><title>
en: Notes
fr: Remarque

note: type: Content of: <refentry><refsect1><para>
en: Basic support for this feature is present since version 0.7.25, but was undocumented for years. The documentation was added in version 1.5 changing also the implementation slightly. For maximum backward compatibility you should avoid multiple <literal>machine</literal> tokens with the same hostname, but if you need multiple they should all have a path specified in the <literal>machine</literal> token.
fr: Une prise en charge basique de cette fonctionnalité est présente depuis la version 0.7.25, mais n'était pas documentée depuis des années. La documentation a été ajoutée dans la version 1.5, modifiant aussi légèrement l'implémentation. Pour une compatibilité ascendante maximale, vous devriez éviter d'avoir plusieurs jetons de <literal>machine</literal> avec le même nom d'hôte, mais si vous devez en avoir plusieurs, il faudrait qu'un chemin soit précisé dans le jeton de <literal>machine</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Login information for APT sources and proxies in a netrc-like format.  Configuration Item: <literal>Dir::Etc::netrc</literal>.
fr: Informations de connexion pour les sources et les mandataires d'APT dans un format de type netrc. Élément de configuration : <literal>Dir::Etc::netrc</literal>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Login information for APT sources and proxies in a netrc-like format.  Configuration Item: <literal>Dir::Etc::netrcparts</literal>.
fr: Informations de connexion pour les sources et les mandataires d'APT dans un format de type netrc. Élément de configuration : <literal>Dir::Etc::netrcparts</literal>.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: APT transport for downloading via the Hypertext Transfer Protocol (HTTP)
fr: Transport d'APT pour téléchargement par HTTP (protocole de transfert hypertexte)

note: type: Content of: <refentry><refsect1><para>
en: This APT transport allows the use of repositories accessed via the Hypertext Transfer Protocol (HTTP). It is available by default and probably the most used of all transports. Note that a transport is never called directly by a user but used by APT tools based on user configuration.
fr: Ce transport d'APT permet d'utiliser les dépôts auxquels on accède au moyen de HTTP (Hypertext Transfer Protocol). Il est disponible par défaut et il est probablement le transport le plus utilisé de tous. Veuillez noter qu'un transport n'est jamais appelé directement par l'utilisateur, mais utilisé par les outils d'APT s'appuyant sur la configuration de l'utilisateur.

note: type: Content of: <refentry><refsect1><para>
en: HTTP is an unencrypted transport protocol meaning that the whole communication with the remote server (or proxy) can be observed by a sufficiently capable attacker commonly referred to as a "man in the middle" (MITM).  However, such an attacker can <emphasis>not</emphasis> modify the communication to compromise the security of your system, as APT's data security model is independent of the chosen transport method. This is explained in detail in &apt-secure;. An overview of available transport methods is given in &sources-list;.
fr: HTTP est un protocole de transport non chiffré ce qui veut dire que toutes les communications avec le serveur distant (ou le mandataire) peuvent être observées par un attaquant suffisamment compétent appelé couramment « homme du milieu » (MITM). Cependant, un tel attaquant ne peut <emphasis>pas</emphasis> modifier la communication pour compromettre la sécurité du système dans la mesure où le modèle de sécurité des données d'APT est indépendant de la méthode de transport choisie. Cela est expliqué en détail dans &apt-secure;. Un aperçu des méthodes de transport disponibles est donné dans &sources-list;.

note: type: Content of: <refentry><refsect1><para>
en: Various options can be set in an &apt-conf; file to modify its behavior, ranging from proxy configuration to workarounds for specific server limitations.
fr: Diverses options peuvent être réglées dans un fichier &apt-conf; pour modifier son comportement depuis la configuration d'un mandataire à des contournements pour les limites d'un serveur particulier.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Proxy Configuration
fr: Configuration du mandataire

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The environment variable <envar>http_proxy</envar> is supported for system wide configuration.  Proxies specific to APT can be configured via the option <literal>Acquire::http::Proxy</literal>.  Proxies which should be used only for certain hosts can be specified via <literal>Acquire::http::Proxy::<replaceable>host</replaceable></literal>. Even more fine-grained control can be achieved via proxy autodetection, detailed further below.  All these options use the URI format <literal><replaceable>scheme</replaceable>://[[<replaceable>user</replaceable>][:<replaceable>pass</replaceable>]@]<replaceable>host</replaceable>[:<replaceable>port</replaceable>]/</literal>.  Supported URI schemes are <literal>socks5h</literal> (SOCKS5 with remote DNS resolution), <literal>http</literal> and <literal>https</literal>.  Authentication details can be supplied via &apt-authconf; instead of including it in the URI directly.
fr: La variable d'environnement <envar>http_proxy</envar> est prise en charge pour une configuration au niveau du système. Les mandataires particuliers à APT peuvent être configurés grâce à l'option <literal>Acquire::http::Proxy</literal>. Les mandataires qui devraient être utilisés seulement pour certains hôtes peuvent être spécifiés avec <literal>Acquire::http::Proxy::<replaceable>hôte</replaceable></literal>. Un contrôle encore plus fin peut être obtenu avec l'autodétection du mandataire, détaillée ci-dessous. Toutes ces options utilisent le format d'URI <literal><replaceable>schéma</replaceable>://[[<replaceable>utilisateur</replaceable>][:<replaceable>mot_de_passe</replaceable>]@]<replaceable>hôte</replaceable>[:<replaceable>port</replaceable>]/</literal>. Les schémas d'URI pris en charge sont <literal> socks5h</literal> (SOCKS5 avec résolution distante de DNS), <literal>http</literal> et <literal>https</literal>. Les détails d'authentification peuvent être fournis avec &apt-authconf; plutôt que de les inclure directement dans l'URI.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The various APT configuration options support the special value <literal>DIRECT</literal> meaning that no proxy should be used. The environment variable <envar>no_proxy</envar> is also supported for the same purpose.
fr: Les diverses options de configuration d'APT prennent en charge la valeur particulière <literal>DIRECT</literal> signifiant qu'aucun mandataire ne doit être utilisé. La variable d'environnement <envar>no_proxy</envar> est aussi prise en charge dans le même but.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Furthermore, there are three settings provided for cache control with HTTP/1.1 compliant proxy caches: <literal>Acquire::http::No-Cache</literal> tells the proxy not to use its cached response under any circumstances.  <literal>Acquire::http::Max-Age</literal> sets the allowed maximum age (in seconds) of an index file in the cache of the proxy.  <literal>Acquire::http::No-Store</literal> specifies that the proxy should not store the requested archive files in its cache, which can be used to prevent the proxy from polluting its cache with (big) .deb files.
fr: De plus, il y a trois options de configuration fournies pour le contrôle des caches mandataire compatibles avec HTTP/1.1 : <literal>Acquire::http::No-Cache</literal> dit au mandataire de ne jamais utiliser les réponses qu'il a stockées. <literal>Acquire::http::Max-Age</literal> établit l'ancienneté maximale (en secondes) d'un fichier d'index dans le cache du mandataire. <literal>Acquire::http::No-Store</literal> indique que le mandataire ne doit pas mettre en cache les fichiers d'archive, ce qui peut éviter de polluer un cache mandataire avec des fichiers .deb très grands.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Automatic Proxy Configuration
fr: Configuration automatique du mandataire

note: type: Content of: <refentry><refsect1><refsect2><para>
en: <literal>Acquire::http::Proxy-Auto-Detect</literal> can be used to specify an external command to discover the HTTP proxy to use. The first and only parameter is a URI denoting the host to be contacted, to allow for host-specific configuration. APT expects the command to output the proxy on stdout as a single line in the previously specified URI format or the word <literal>DIRECT</literal> if no proxy should be used. No output indicates that the generic proxy settings should be used.
fr: L'option <literal>Acquire::http::Proxy-Auto-Detect</literal> peut être utilisée pour indiquer une commande externe pour découvrir le mandataire HTTP à utiliser. Le premier et seul paramètre est un URI indiquant l'hôte à contacter pour permettre une configuration propre à l'hôte. Apt s'attend à ce que la commande indique le mandataire sur la sortie standard sur une seule ligne dans le format d'URI précédemment défini ou le mot <literal>DIRECT</literal> si aucun mandataire ne doit être utilisé. Aucune sortie indique que le mandataire générique doit être utilisé.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Note that auto-detection will not be used for a host if a host-specific proxy configuration is already set via <literal>Acquire::http::Proxy::<replaceable>host</replaceable></literal>.
fr: Notez que l'auto-détection ne sera pas exécutée si une configuration spécifique de mandataire hôte a déjà été établie par <literal>Acquire::http::Proxy::<replaceable>hôte</replaceable></literal>.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: See the &squid-deb-proxy-client; and &auto-apt-proxy; packages for example implementations.
fr: Voir les paquets &squid-deb-proxy-client; et &auto-apt-proxy; pour des exemples d'implémentation.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: This option takes precedence over the legacy option name <literal>Acquire::http::ProxyAutoDetect</literal>.
fr: Cette option prend le pas sur l'ancien nom d'option <literal>Acquire::http::ProxyAutoDetect</literal>.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Connection Configuration
fr: Configuration de connexion

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The option <literal>Acquire::http::Timeout</literal> sets the timeout timer used by the method; this value applies to the connection as well as the data timeout.
fr: L'option <literal>Acquire::http::Timeout</literal> positionne le compteur d'expiration du délai (timeout) utilisé par la méthode. Cela s'applique aussi bien à la connexion qu'aux données.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The used bandwidth can be limited with <literal>Acquire::http::Dl-Limit</literal> which accepts integer values in kilobytes per second. The default value is 0 which deactivates the limit and tries to use all available bandwidth. Note that this option implicitly disables downloading from multiple servers at the same time.
fr: La bande passante utilisée peut être limitée avec <literal>Acquire::http::Dl-Limit</literal> qui peut prendre une valeur entière, l'unité utilisée étant le kilo-octet par seconde. La valeur par défaut est 0, ce qui correspond à aucune limitation de bande passante. Veuillez noter que cette option désactive implicitement le téléchargement simultané depuis plusieurs serveurs.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The setting <literal>Acquire::http::Pipeline-Depth</literal> can be used to enable HTTP pipelining (RFC 2616 section 8.1.2.2) which can be beneficial e.g. on high-latency connections. It specifies how many requests are sent in a pipeline.  APT tries to detect and work around misbehaving webservers and proxies at runtime, but if you know that yours does not conform to the HTTP/1.1 specification, pipelining can be disabled by setting the value to 0. It is enabled by default with the value 10.
fr: Le réglage <literal>Acquire::http::Pipeline-Depth</literal> permet d'utiliser l'enchaînement HTTP (« HTTP pipelining », RFC 2616 section 8.1.2.2) ce qui peut être utile par exemple avec des connexions à latence élevée. Il indique le nombre de requêtes envoyées dans le tuyau. APT tente de détecter et de contourner les serveurs web et les mandataires qui se comportent mal à l'exécution, mais si vous savez que vos serveurs ne respectent pas la norme HTTP/1.1, l'enchaînement peut être désactivé en définissant cette valeur à 0. Il est activé par défaut avec une valeur de 10.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: <literal>Acquire::http::AllowRedirect</literal> controls whether APT will follow redirects, which is enabled by default.
fr: <literal>Acquire::http::AllowRedirect</literal> contrôle le fait qu'APT suive les redirections. Ce réglage est activé par défaut.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: <literal>Acquire::http::User-Agent</literal> can be used to set a different User-Agent for the http download method as some proxies allow access for clients only if the client uses a known identifier.
fr: L'option <literal>Acquire::http::User-Agent</literal> peut être utilisée pour envoyer une valeur User-Agent modifiée pour les téléchargements HTTP, ce qui peut par exemple être utile avec certains mandataires HTTP qui n'autorisent l'accès qu'aux clients s'identifiant de manière spécifique.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: <literal>Acquire::http::SendAccept</literal> is enabled by default and sends an <literal>Accept: text/*</literal> header field to the server for requests without file extensions to prevent the server from attempting content negotiation.
fr: <literal>Acquire::http::SendAccept</literal> est activé par défaut et envoie un champ d'en-tête <literal>Accept: text/*</literal> au serveur pourles requêtes sans extension de fichier pour éviter que le serveur ne tente une négociation de contenu.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: APT transport for downloading via the HTTP Secure protocol (HTTPS)
fr: Le transport d'APT pour télécharger par HTTPS (protocole de transfert hypertexte sécurisé)

note: type: Content of: <refentry><refsect1><para>
en: This APT transport allows the use of repositories accessed via the HTTP Secure protocol (HTTPS), also referred to as HTTP over TLS. It is available by default since apt 1.5 and was available before that in the package <package>apt-transport-https</package>. Note that a transport is never called directly by a user but used by APT tools based on user configuration.
fr: Ce transport d'APT permet d'utiliser les dépôts auxquels on accède au moyen de HTTPS (protocole HTTP Secure), aussi appelé HTTP sur TLS. Il est disponible par défaut depuis apt 1.5 et était disponible auparavant dans lepaquet <package>apt-transport-https</package>. Veuillez noter qu'un transport n'est jamais appelé directement par l'utilisateur, maisutilisé par les outils d'APT s'appuyant sur la configuration de l'utilisateur.

note: type: Content of: <refentry><refsect1><para>
en: HTTP is by itself an unencrypted transport protocol (compare &apt-transport-http;), which, as indicated by the appended S, is wrapped in an encrypted layer known as Transport Layer Security (TLS) to provide end-to-end encryption.  A sufficiently capable attacker can still observe the communication partners and deeper analysis of the encrypted communication might still reveal important details.  An overview over available alternative transport methods is given in &sources-list;.
fr: HTTP est un protocole de transport non chiffré (comparez avec &apt-transport-http;), qui, comme l'indique le S ajouté, est enveloppé dans une couche chiffrée, connue sous le nom de « Transport Layer Security » (TLS), pour fournir un chiffrement de bout en bout. Un attaquant suffisamment compétent peut encore observer les partenaires de la communication et une analyse approfondie de la communication chiffrée pourrait toujours révéler des détails importants. Un aperçu des méthodes de transport alternatives disponibles est donné dans &sources-list;.

note: type: Content of: <refentry><refsect1><para>
en: The HTTPS protocol is based on the HTTP protocol, so all options supported by &apt-transport-http; are also available via <literal>Acquire::https</literal> and will default to the same values specified for <literal>Acquire::http</literal>. This manpage will only document the options <emphasis>unique to https</emphasis>.
fr: Le protocole HTTPS est basé sur le protocole HTTP, aussi toutes les options prises en charge par &apt-transport-http; sont aussi disponibles au moyen de <literal>Acquire::https</literal> et ont par défaut les même valeurs que celles spécifiées pour <literal>Acquire::http</literal>. Cette page de manuel ne documentera que les options <emphasis>propres à https</emphasis>.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Server credentials
fr: Accréditations du serveur

note: type: Content of: <refentry><refsect1><refsect2><para>
en: By default all certificates trusted by the system (see <package>ca-certificates</package> package) are used for the verification of the server certificate. An alternative certificate authority (CA) can be configured with the <literal>Acquire::https::CAInfo</literal> option and its host-specific option <literal>Acquire::https::CAInfo::<replaceable>host</replaceable></literal>.  The CAInfo option specifies a file made up of CA certificates (in PEM format)  concatenated together to create the chain which APT should use to verify the path from your self-signed root certificate. If the remote server provides the whole chain during the exchange, the file need only contain the root certificate. Otherwise, the whole chain is required. If you need to support multiple authorities, the only way is to concatenate everything.
fr: Par défaut, tous les certificats de confiance du système (voir le paquet <package>ca-certificates</package> sont utilisés pour la vérification du certificat du serveur. Une autre autorité de certification (CA) peut être configurée avec l'option <literal>Acquire::https::CAInfo</literal> et son option spécifique de l'hôte <literal>Acquire::https::CAInfo::<replaceable>hôte</replaceable></literal>. L'option CAInfo spécifie un fichier composé des certificats de CA (au format PEM) concaténés pour créer la chaîne qu'APT peut utiliser pour vérifier le chemin à partir du certificat racine auto-signée. Si le serveur distant fournit toute la chaîne pendant l'échange, le fichier ne doit contenir que le certificat racine. Autrement, toute la chaîne est requise. Si la gestion de plusieurs autorités est nécessaire, le seul moyen est de tout concaténer.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: A custom certificate revocation list (CRL) can be configured with the options <literal>Acquire::https::CRLFile</literal> and <literal>Acquire::https::CRLFile::<replaceable>host</replaceable></literal>.  As with the previous option, a file in PEM format needs to be specified.
fr: Une liste de révocation de certificats (CRL) personnalisée peut être configurée avec l'option <literal>Acquire::https::CRLFile</literal> et <literal>Acquire::https::CRLFile::<replaceable>hôte</replaceable></literal>. Comme avec l'option précédente, il faut spécifier un fichier au format PEM.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Disabling security
fr: Désactiver la sécurité

note: type: Content of: <refentry><refsect1><refsect2><para>
en: During server authentication, if certificate verification fails for some reason (expired, revoked, man in the middle, etc.), the connection fails.  This is obviously what you want in all cases and what the default value (true)  of the option <literal>Acquire::https::Verify-Peer</literal> and its host-specific variant provides. If you know <emphasis>exactly</emphasis> what you are doing, setting this option to "<literal>false</literal>" allows you to skip peer certificate verification and make the exchange succeed. Again, this option is for debugging or testing purposes only as it removes all security provided by the use of HTTPS.
fr: Durant l'authentification du serveur, si la vérification du certificat échoue pour une raison quelconque (expiré, révoqué, homme du milieu, etc.), la connexion échoue. C'est certainement ce que vous souhaitez dans tous les cas et ce que fournit la valeur par défaut (« <literal>true</literal> ») de l'option <literal>Acquire::https::Verify-Peer</literal> et de ses variantes spécifiques à l'hôte. Si vous savez <emphasis>exactement</emphasis> ce que vous faites, la configuration de cette option à « <literal>false</literal> » vous permet d'ignorer la vérification du certificat du pair et de faire réussir l'échange. Une fois de plus, cette option est seulement destinée au test ou au débogage dans la mesure où elle supprime toute la sécurité apportée par l'utilisation de HTTPS.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Similarly the option <literal>Acquire::https::Verify-Host</literal> and its host-specific variant can be used to deactivate a security feature: The certificate provided by the server includes the identity of the server which should match the DNS name used to access it. By default, as requested by RFC 2818, the name of the mirror is checked against the identity found in the certificate. This default behavior is safe and should not be changed, but if you know that the server you are using has a DNS name which does not match the identity in its certificate, you can set the option to "<literal>false</literal>", which will prevent the comparison from being performed.
fr: De la même façon, l'option <literal>Acquire::https::Verify-Host</literal> et sa variante spécifique à l'hôte peuvent être utilisées pour désactiver la fonction de sécurité. Le certificat fourni par le serveur comprend l'identité du serveur qui devrait correspondre au nom de DNS utilisé pour y accéder. Par défaut, comme cela est requis par la RFC 2818, le nom du miroir est vérifié par rapport à l'identité trouvée dans le certificat. Ce comportement par défaut est sûr et ne devrait pas être modifié, mais si vous savez que le serveur que vous utilisez à un nom de DNS qui ne correspond pas à l'identité de son certificat, il est possible de régler l'option à "<literal>false</literal>", ce qui empêchera la réalisation de la comparaison.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Client authentication
fr: Authentification du client

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Besides supporting password-based authentication (see &apt-authconf;) HTTPS also supports authentication based on client certificates via <literal>Acquire::https::SSLCert</literal> and <literal>Acquire::https::SSLKey</literal>. These should be set respectively to the filename of the X.509 client certificate and the associated (unencrypted) private key, both in PEM format.  In practice the use of the host-specific variants of both options is highly recommended.
fr: Outre la gestion de l'authentification basée sur les mots de passe (voir &apt-authconf;) HTTPS prend aussi en charge l'authentification basée sur les certificats du client avec <literal>Acquire::https::SSLCert</literal> et <literal>Acquire::https::SSLKey</literal>. Leurs valeurs doivent être respectivement celle du nom de fichier du certificat X.509 du client et celle de la clé privée (non chiffrée) associée, toutes les deux au format PEM. En pratique, l'utilisation des variantes spécifiques à l'hôte des deux options est fortement recommandée.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: APT transport for more automated mirror selection
fr: Transport d'APT pour une sélection plus automatique du miroir

note: type: Content of: <refentry><refsect1><para>
en: This APT transport isn't implementing a protocol to access local or remote repositories on its own, but acquires a mirrorlist and redirects all requests to the mirror(s) picked from this list, accessing them via other transports like &apt-transport-http;. The basic functionality has been available since apt 0.7.24, but was undocumented until apt 1.6 which contained a complete rework of the transport and its supported features. Note that a transport is never called directly by a user but used by APT tools based on user configuration.
fr: Ce transport d'APT ne met pas en œuvre un protocole pour accéder tout seul à des dépôts locaux ou distants, mais obtenir une liste de miroirs et redirige toutes les requêtes vers le(s) miroir(s) choisi(s) dans cette liste, en y accédant grâce à d'autres transports tels que &apt-transport-http;. La fonctionnalité de base est disponible depuis apt 0.7.24, mais n'a été documentée qu'à partir d'apt 1.6 qui fournit une version totalement retravaillée du transport et des fonctionnalités prises en charge. Veuillez noter qu'un transport n'est jamais appelé directement par l'utilisateur, mais utilisé par les outils d'APT s'appuyant sur la configuration de l'utilisateur.

note: type: Content of: <refentry><refsect1><para>
en: If the acquisition of a file via a mirror fails, the method ensures that another possible mirror from the list is automatically tried until either the file is retrieved or no mirror is left in the list, transparently handling server downtimes and similar problems.
fr: Si la récupération d'un fichier à partir d'un miroir échoue, la méthode assure qu'un autre miroir possible de la liste est automatiquement essayé jusqu'à ce que le fichier soit récupéré ou qu'il ne reste plus de miroir sur la liste, gérant de façon transparente les indisponibilités de serveur ou d'autres problèmes similaires.

note: type: Content of: <refentry><refsect1><para>
en: The security implications of the transport depend on the security considerations associated with the transport used to acquire the mirrorlist and the transports involved in accessing the chosen mirror(s) by the transport.
fr: Les implications de sécurité du transport dépendent des considérations de sécurité, associées au transport, qui ont présidé à l'acquisition de la liste de miroirs et des transports impliqués dans l'accession au(x) miroir(s) choisi(s) par le transport.

note: type: Content of: <refentry><refsect1><para>
en: This transport has no configuration options at present. The mirror selection is based entirely on the mirrors offered in the mirrorlist and the files APT needs to acquire.
fr: Ce transport ne possède pas d'option de configuration pour le moment. La sélection du miroir est basée uniquement sur les miroirs offerts dans la liste de miroirs et des fichiers qu'APT doit se procurer.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Mirrorlist format
fr: Format de la liste de miroirs

note: type: Content of: <refentry><refsect1><refsect2><para>
en: A mirrorlist contains one or more lines each specifying a URI for a mirror.  Empty lines and those starting with a hash character (<literal>#</literal>) are ignored.  A URI always starts with a URI scheme which defines the transport used for this mirror. If for example the URI starts with <literal>http:</literal>, the responsible transport is &apt-transport-http; which might have specific requirements for the format of the remaining part of the URI.
fr: Une liste de miroirs contient une ou plusieurs lignes qui spécifient chacune l'URI d'un miroir. Les lignes vides et celles commençant par un caractère dièse (<literal>#</literal>) sont ignorées. Un URI débute toujours par un schème d'URI qui définit le transport utilisé pour ce miroir. Si, par exemple, l'URI débute par <literal>http:</literal>, le transport responsable est &apt-transport-http; qui pourrait avoir des exigences particulières pour le format du reste de l'URI.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Metadata about a mirror can be given on the same line, separated from the URI by a tab.  Multiple items of metadata can themselves be separated by either tabs or spaces.  (This is an advanced feature only available with apt >= 1.6. Earlier apt versions will fail to parse mirrorlists using this feature.)
fr: Les métadonnées d'un miroir peuvent être placées sur la même ligne, séparées de l'URI par une tabulation. De multiples éléments de métadonnées peuvent être eux-mêmes séparés par des tabulations ou des espaces. (C'est une fonctionnalité avancée seulement disponible avec apt >= 1.6. Les versions d'APT antérieures échoueront à analyser les listes de miroirs utilisant cette fonctionnalité.)

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Since apt 1.6 the use of compressed mirrorlists is also supported.  Note that the filename of the mirrorlist must specify the compression algorithm used; there is no auto-detection based on file contents.
fr: Depuis apt 1.6, l'utilisation de listes de miroirs compressées est aussi gérée. Veuillez noter que le nom de fichier de la liste de miroirs doit spécifier l'algorithme de compression utilisé ; il n'y a pas d'auto-détection basée sur le contenu du fichier.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Mirror selection by metadata
fr: Sélection du miroir par les métadonnées

note: type: Content of: <refentry><refsect1><refsect2><para>
en: As specified in the format, a mirror can have additional metadata attached to prevent a mirror from being selected for acquiring a file not matching this metadata.  This way the mirrorlist can e.g. contain partial mirrors serving only certain architectures and APT will automatically choose a different mirror for files requiring an unlisted architecture. Supported are limits for the architecture (<literal>arch</literal>), codename of the release (<literal>codename</literal>), component of the repository the file is in (<literal>component</literal>), language the file applies to (<literal>lang</literal>), suite name of the release (<literal>suite</literal>) and type of the file (<literal>type</literal>).
fr: Comme cela est spécifié dans le format, un miroir peut avoir des métadonnées supplémentaires attachées pour éviter qu'il soit sélectionné pour la récupération d'un fichier qui ne correspond pas à ces métadonnées. De cette façon, la liste de miroirs peut contenir par exemple des miroirs partiels fournissant seulement certaines architectures et APT choisira automatiquement un autre miroir pour les fichiers requérant une architecture non listée. Sont prises en charge les limites liées à l'architecture (<literal>arch</literal>), au nom de code de la version (<literal>codename</literal>), aux composants du dépôt où se trouve le fichier (<literal>component</literal>), à la langue à laquelle le fichier s'applique (<literal>lang</literal>), au nom de la suite de la version <literal>suite</literal>) et au type du fichier (<literal>type</literal>).

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Fallback order for mirrors
fr: Ordre de repli pour les miroirs

note: type: Content of: <refentry><refsect1><refsect2><para>
en: If no priority is given for a mirror via the metadata key <literal>priority</literal>, the order in which mirrors are contacted is random. If a certain set of mirrors should be tried first before any of another set is tried, a priority can be explicitly set. The mirrors with the lowest number are tried first. Mirrors which have no explicit priority set default to the highest possible number and are therefore tried last. The choice between mirrors with the same priority is again random.
fr: Si aucune priorité n'est donnée à un miroir par la clé de métadonnée <literal>priority</literal>, l'ordre de contact des miroirs est aléatoire. Si un ensemble particulier de miroirs doit être essayé avant que n'importe lequel des autres ensembles ne le soit, une priorité peut être spécifiée explicitement. Les miroirs avec les numéros les plus bas sont essayés en premier. Les miroirs qui n'ont pas de priorité explicite portent par défaut le numéro le plus élevé possible, et donc, sont essayés en dernier. Le choix entre les miroirs de même priorité est aussi aléatoire.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Allowed transports in a mirrorlist
fr: Transports permis dans une liste de miroir

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The availability and choice of transports in a mirrorlist is limited by how the APT client is accessing the mirrorlist. If a local transport like <literal>file</literal> or <literal>copy</literal> is used, the mirrorlist can also include local sources, while a mirrorlist accessed via <literal>http</literal> can not. Additionally, a mirrorlist can not contain a mirrorlist or other wrapping transports (like <package>apt-transport-tor</package>).  See the documentation of these transports on how to use them with the mirror method.
fr: La disponibilité et le choix des transports dans une liste de miroirs sont limités par la manière dont le client APT accède à la liste des miroirs. Si un transport local comme <literal>file</literal> ou <literal>copy</literal> est utilisé, la liste de miroirs peut aussi inclure des sources locales, alors qu'une liste de miroirs atteinte par <literal>http</literal> ne le peut pas. Par ailleurs, une liste de miroirs ne peut pas contenir une liste de miroirs ou d'autres transports enveloppants (comme <package>apt-transport-tor</package>). Voir la documentation sur ces transports pour connaître la manière de les utiliser avec la méthode miroir.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Note that apt versions before 1.6 do not support any other transport than <literal>http</literal>.
fr: Veuillez noter que les versions d'APT antérieures à 1.6 ne prennent pas en charge d'autres transports que <literal>http</literal>.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Basic example
fr: Exemple basique

note: type: Content of: <refentry><refsect1><refsect2><para>
en: A basic mirrorlist example supported by all apt versions with a mirror method (>= 0.7.24) in which the client will pick any of the three mirrors:
fr: Voici un exemple basique de liste de miroirs prise en charge par toutes les versions d'APT avec une méthode de miroir (>= 0.7.24) dans lequel le client choisira n'importe lequel des trois miroirs :

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Assuming a file with this content is stored as <filename>/etc/apt/mirrorlist.txt</filename> on your machine it can be used like this in &sources-list; (since apt 1.6):
fr: Si un fichier avec ce contenu est stocké sur la machine sous le nom de <filename>/etc/apt/mirrorlist.txt</filename>, il peut être utilisé comme cela dans &sources-list; (à partir d'apt 1.6) :

note: type: Content of: <refentry><refsect1><refsect2><para>
en: All versions of the mirror method support a mirrorlist accessible via HTTP, so assuming it is available at <literal>http://apt.example.org/mirror.lst</literal> the sources.list entry from above could instead be written as:
fr: Toutes les versions de la méthode miroir prennent en charge une liste de miroirs accessible par HTTP, aussi, dans la mesure où elle est disponible à l'adresse <literal>http://apt.example.org/mirror.lst</literal>, l'entrée de sources.list ci-dessus peut être écrite plutôt ainsi :

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Note that since apt 1.6 the use of <literal>mirror+http</literal> should be preferred over <literal>mirror</literal> for uniformity. The functionality is the same.
fr: Veuillez noter que depuis apt 1.6, l'utilisation de <literal>mirror+http</literal> est préférable à <literal>mirror</literal> pour uniformiser. La fonctionnalité est la même.

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Example with metadata-enhanced mirror selection
fr: Exemple de sélection du miroir avec des métadonnées améliorées

note: type: Content of: <refentry><refsect1><refsect2><para>
en: As explained in the format definition apt versions before 1.6 do not support this and will fail parsing the mirrorlist. The example mirrorlist is intentionally complicated to show some aspects of the selection. The following setup is assumed: The first mirror is a local mirror accessible via the file method, but potentially incomplete. The second mirror has a great connection, but is a partial mirror insofar as it only contains files related to the architectures <literal>amd64</literal> and <literal>all</literal>. The remaining mirrors are average mirrors which should be contacted only if the earlier ones didn't work.
fr: Comme cela est expliqué dans la définition de format, les versions d'APT antérieures à 1.6 ne prennent pas cela en charge et échoueront à analyser la liste de miroirs. L'exemple de liste de miroirs est complexe intentionnellement pour montrer certains aspects de la sélection. La configuration suivante est supposée : le premier miroir est un miroir local accessible par la méthode « file », mais possiblement incomplet ; le second miroir possède une excellente connexion, c'est un miroir partiel dans la mesure où il ne contient que des fichiers liés aux architectures <literal>amd64</literal> et <literal>all</literal>. Les miroirs restants sont des miroirs ordinaires qui devraient être contactés seulement si les précédents ne fonctionnent pas.

note: type: Content of: <refentry><refsect1><refsect2><para>
en: In this setup with this mirrorlist the first mirror will be used to download all index files assuming the mirrorlist itself is accessed via a local transport like <literal>file</literal>. If it isn't, if the mirror is otherwise inaccessible or if it does not contain the requested file another mirror will be used to acquire the file, chosen depending on the type of the file: An index file will be served by the last mirror in the list, while a package of architecture <literal>amd64</literal> is served by the second and those of e.g. architecture <literal>i386</literal> by one of the last three.
fr: Dans une configuration avec cette liste de miroirs, le premier miroir sera utilisé pour télécharger tous les fichiers d'index en supposant que la liste de miroirs elle-même est atteinte par un transport local comme <literal>file</literal>. Si ce n'est pas le cas, si le miroir est inaccessible ou s'il ne contient pas le fichier requis, un autre miroir sera utilisé pour récupérer le fichier, choisi selon le type du fichier : un fichier d'index sera servi par le dernier miroir de la liste, tandis qu'un paquet de l'architecture <literal>amd64</literal> est servi par le second et ceux, par exemple, de l'architecture <literal>i386</literal> par un des trois derniers.

note: type: Attribute 'lang' of: <book>
en: en
fr: fr

note: type: Content of: <book><title>
en: APT User's Guide
fr: Guide d'utilisation d'APT

note: type: Content of: <book><bookinfo><abstract><para>
en: This document provides an overview of how to use the APT package manager.
fr: Ce document fournit un aperçu des méthode d'utilisation du gestionnaire de paquets APT.

note: type: Content of: <book><bookinfo><legalnotice><title>
en: License Notice
fr: Mention de licence

note: type: Content of: <book><bookinfo><legalnotice><para>
en: "APT" and this document are free software; you can redistribute them and/or modify them under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
fr: APT, ainsi que ce document, sont libres. Vous pouvez les redistribuer et les modifier en respectant les conditions de la licence publique générale GNU telle que publiée par la Free Software Foundation, en version 2 ou ultérieure.

note: type: Content of: <book><bookinfo><legalnotice><para>
en: For more details, on Debian systems, see the file /usr/share/common-licenses/GPL for the full license.
fr: Les détails complets de cette licence sont, sur les systèmes Debian GNU/Linux, consultables dans le fichier usr/share/common-licenses/GPL.

note: type: Content of: <book><chapter><title>
en: General
fr: Généralités

note: type: Content of: <book><chapter><para>
en: The APT package currently contains two sections, the APT <command>dselect</command> method and the <command>apt-get</command> command line user interface. Both provide a way to install and remove packages as well as download new packages from the Internet.
fr: Le paquet APT comporte actuellement deux parties : la méthode APT pour <command>dselect</command> et l'interface en ligne de commande <command>apt-get</command>. Les deux fournissent des méthodes d'installation et de suppression de paquets ainsi que de téléchargement de nouveaux paquets par Internet.

note: type: Content of: <book><chapter><section><title>
en: Anatomy of the Package System
fr: Anatomie du système de gestion des paquets

note: type: Content of: <book><chapter><section><para>
en: The Debian packaging system has a large amount of information associated with each package to help assure that it integrates cleanly and easily into the system. The most prominent of its features is the dependency system.
fr: Le système de gestion de paquets de Debian intègre de nombreuses informations associées à chaque paquet afin de garantir qu'il s'intègre proprement et facilement sur le système. Une des fonctionnalités les plus immédiatement visibles est le système de gestion des dépendances.

note: type: Content of: <book><chapter><section><para>
en: The dependency system allows individual programs to make use of shared elements in the system such as libraries. It simplifies placing infrequently used portions of a program in separate packages to reduce the number of things the average user is required to install. Also, it allows for choices in mail transport agents, X servers and so on.
fr: Le système de gestion des dépendances permet aux programmes de partage des éléments du système, tels que les bibliothèques de fonctions. Il permet d'isoler dans des paquets spécifiques certains parties moins utilisées des programmes afin de limiter le nombre d'éléments que l'utilisateur ordinaire a besoin d'installer. Ce système de gestion des dépendances permet également d'effectuer des choix parmi les divers agents de transport de courrier électronique, les serveurs X et d'autres cxomposants du système.

note: type: Content of: <book><chapter><section><para>
en: The first step to understanding the dependency system is to grasp the concept of a simple dependency. The meaning of a simple dependency is that a package requires another package to be installed at the same time to work properly.
fr: La première étape de compréhension de la gestion de dépendances est d'examiner le fonctionnement d'une dépendance simple. Une dépendance simple est le cas où un paquet donné a besoin qu'un autre paquet soit installé simultanément pour pouvoir fonctionner correctement.

note: type: Content of: <book><chapter><section><para>
en: For instance, mailcrypt is an emacs extension that aids in encrypting email with GPG. Without GPGP installed mailcrypt is useless, so mailcrypt has a simple dependency on GPG. Also, because it is an emacs extension it has a simple dependency on emacs, without emacs it is completely useless.
fr: Par example, mailcrypt est une extension à Emacs qui permet de gérer le courrier électronique chiffré avec GPG. Si GPG n'est pas installé, mailcrypt est inutile. Donc le paquet mailcrypt a une dépendance simple sur GPG. De plus, étant une extension à Emacs sans lequel il est totalement inutile, il a une dépendance simple sur emacs.

note: type: Content of: <book><chapter><section><para>
en: The other important dependency to understand is a conflicting dependency. It means that a package, when installed with another package, will not work and may possibly be extremely harmful to the system. As an example consider a mail transport agent such as sendmail, exim or qmail. It is not possible to have two mail transport agents installed because both need to listen to the network to receive mail. Attempting to install two will seriously damage the system so all mail transport agents have a conflicting dependency with all other mail transport agents.
fr: Un autre type de dépendance importante est la dépendance en conflit. Cela signifie qu'un paquet ne fonctionne pas lorsqu'il est installé en même temps qu'un autre paquet donné, ce qui peut même être dommageable pour le système. Un exemple est par exemple constitué par les agents de transport de courrier tels que sendmail, exim ou qmail. Il n'est pas possible d'installer deux agents de transport de courrier simultanément puisque les deux ont besoin d'être à l'écoute sur le réseau pour recevoir le courrier électronique. Installer deux programmes de ce type sur le même système pourrait conduire à des pertes de données, ce qui explique que tous les agents de transport de courrier électronique soient établis comme étant en conflit les uns avec les autres.

note: type: Content of: <book><chapter><section><para>
en: As an added complication there is the possibility for a package to pretend to be another package. Consider that exim and sendmail for many intents are identical, they both deliver mail and understand a common interface. Hence, the package system has a way for them to declare that they are both mail-transport-agents. So, exim and sendmail both declare that they provide a mail-transport-agent and other packages that need a mail transport agent depend on mail-transport-agent. This can add a great deal of confusion when trying to manually fix packages.
fr: Il existe également la possibilité pour un paquet donné de prétendre être un autre paquet. Par exemple, exim et sendmail sont analogues sur de nombreux aspects ; ils servent tous deux à acheminer le courrier électronique et leur interface d'utilisation est la même. Pour cette raison, le système de gestion des paquets leur fournit la possibilité d'indiquer qu'ils sont chacun un agent de transport de courrier (« mail transport agent ») en indiquant qu'ils fournissent (« Provides ») « mail-transport-agent ». Ainsi, un paquet qui a besoin de cette fonctionnalité peut dépendre simplement d'un paquet « mail-transprot-agent ». Cette fonctionnalité utile peut toutefois rendre la correction de certains défauts des paquets plus complexe.

note: type: Content of: <book><chapter><section><para>
en: At any given time a single dependency may be met by packages that are already installed or it may not be. APT attempts to help resolve dependency issues by providing a number of automatic algorithms that help in selecting packages for installation.
fr: À un instant donné, une dépendance donnée peut être ou pas remplie par des paquets installés ou pas encore installés. APT tente donc de résoudre les problèmes de dépendances par l'intermédiaire d'un certain nombre d'algorithmes automatiques qui simplifient le choix des paquets à installer.

note: type: Content of: <book><chapter><para>
en: <command>apt-get</command> provides a simple way to install packages from the command line. Unlike <command>dpkg</command>, <command>apt-get</command> does not understand .deb files, it works with the package's proper name and can only install .deb archives from a <emphasis>Source</emphasis>.
fr: Le programme <command>apt-get</command> offre une méthode simple pour installer des paquets à la ligne de commande. À la différence de <command>dpkg</command>, <command>apt-get</command> ne gère pas directement les fichiers .deb files. Il travaille avec le nom des paquets et ne peut installer les archives .deb que depuis une <emphasis>Source</emphasis>.

note: type: Content of: <book><chapter><para><footnote><para>
en: If you are using an http proxy server you must set the http_proxy environment variable first, see sources.list(5)
fr: Si vous utilisez un serveur mandataire (« proxy ») HTTP, vous devez d'abord positionner la variable d'environnement http_proxy, voir sources.list(5)

note: type: Content of: <book><chapter><para>
en: The first <placeholder type="footnote" id="0"/> thing that should be done before using <command>apt-get</command> is to fetch the package lists from the <emphasis>Sources</emphasis> so that it knows what packages are available. This is done with <literal>apt-get update</literal>. For instance,
fr: La première action <placeholder type="footnote" id="0"/> à effectuer avant d'utiliser <command>apt-get</command> est de récupérer les listes de paquets depuis les <emphasis>Sources</emphasis> afin que le programme sache quels sont les paquets disponibles. Cela peut être effectué avec la commande <literal>apt-get update</literal>. Par exemple,

note: type: Content of: <book><chapter><screen>
en: # apt-get update
    Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages
    Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages
    Reading Package Lists... Done
    Building Dependency Tree... Done
fr: # apt-get update
    Réception de http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages
    Réception de http://llug.sep.bnl.gov/debian/ testing/contrib Packages
    Lecture des listes de paquets... Fait
    Construction de l'arbre des dépendances... Fait

note: type: Content of: <book><chapter><para>
en: Once updated there are several commands that can be used:
fr: Une fois cette mise à jour effectuée, plusieurs commandes peuvent être utilisées :

note: type: Content of: <book><chapter><variablelist><varlistentry><listitem><para>
en: Upgrade will attempt to gently upgrade the whole system. Upgrade will never install a new package or remove an existing package, nor will it ever upgrade a package that might cause some other package to break. This can be used daily to relatively safely upgrade the system. Upgrade will list all of the packages that it could not upgrade, this usually means that they depend on new packages or conflict with some other package. <command>dselect</command> or <literal>apt-get install</literal> can be used to force these packages to install.
fr: La commande « upgrade » permet de mettre à jour le système de manière non invasive. Cette commande ne provoquera jamais l'installation de nouveaux paquets ou la suppression de paquets existants. Elle ne déclenchera pas non plus la mise à jour d'un paquet si celle-ci casse le fonctionnement d'un autre paquet. Cette commande peut être utilisé par exemple quotidiennement pour mettre à jour le système de manière relativement sûre. Lorsqu'elle est utilisée, la liste des paquets qui ne peuvent être mis à jour sera affichée. Cela est en général du au fait qu'ils dépendent de nouveaux paquets ou qu'ils entrent en conflit avec d'autres paquets. Le programme <command>dselect</command> ou la commande <literal>apt-get install</literal> peuvet être utilisés pour forcer l'installation de tels paquets.

note: type: Content of: <book><chapter><variablelist><varlistentry><listitem><para>
en: Install is used to install packages by name. The package is automatically fetched and installed. This can be useful if you already know the name of the package to install and do not want to go into a GUI to select it. Any number of packages may be passed to install, they will all be fetched. Install automatically attempts to resolve dependency problems with the listed packages and will print a summary and ask for confirmation if anything other than its arguments are changed.
fr: La commande « install » permet d'installer des paquets par nom. Le paquet à installer est automatiquement récupéré et installé. Cela est utile lorsque le nom du paquet à installer est déjà connu et que l'on ne souhaite pas passer par une interface graphique pour le choisir. Un nombre quelconque de paquets peuvent être demandés à être installés ;  ils seront alors tous récupérés. La commande « install » résout automatiquement les problèmes de dépendances pour les paquets concernés, puis affiche un résumé avant de demander une confirmation si des actions autres que ce qui est demandé à la ligne de commande sont nécessaires.

note: type: Content of: <book><chapter><variablelist><varlistentry><listitem><para>
en: Dist-upgrade is a complete upgrader designed to simplify upgrading between releases of Debian. It uses a sophisticated algorithm to determine the best set of packages to install, upgrade and remove to get as much of the system to the newest release. In some situations it may be desired to use dist-upgrade rather than spend the time manually resolving dependencies in <command>dselect</command>. Once dist-upgrade has completed then <command>dselect</command> can be used to install any packages that may have been left out.
fr: La commande « dist-upgrade » est une commande de mise à jour complète d'abord destinés à permettre les mises à jour entre deux versions successives de la distribution. Via un algorithme complexe, le meilleur jeu de paquets à installer, mettre à jour ou supprimer est déterminé dans le but d'amener une majorité du système vers la nouvelle version. Dans certains cas, il peut être judicieux d'utiliser « dist-upgrade » plutôt que de chercher à résoudre manuellement les dépendances avec <command>dselect</command>. Une fois que « dist-upgrade » a été utilisé, <command>dselect</command> peut servir à installer les paquets qui auraient pu être laissés de côté.

note: type: Content of: <book><chapter><variablelist><varlistentry><listitem><para>
en: It is important to closely look at what dist-upgrade is going to do, its decisions may sometimes be quite surprising.
fr: Il est important de regarder de près ce que « dist-upgrade » car ses décisions peuvent parfois apparaître surprenantes.

note: type: Content of: <book><chapter><para>
en: <command>apt-get</command> has several command line options that are detailed in its man page, <citerefentry><refentrytitle>apt-get</refentrytitle><manvolnum>8</manvolnum></citerefentry>. The most useful option is <literal>-d</literal> which does not install the fetched files. If the system has to download a large number of package it would be undesired to start installing them in case something goes wrong. When <literal>-d</literal> is used the downloaded archives can be installed by simply running the command that caused them to be downloaded again without <literal>-d</literal>.
fr: <command>apt-get</command> fournit de nombreuses options de ligne de commande qui sont expliquées en détail dans sa page de manuel, <citerefentry><refentrytitle>apt-get</refentrytitle><manvolnum>8</manvolnum></citerefentry>. Une des plus utiles est l'option <literal>-d</literal> qui récupère sans les installer les fichiers nécessaires. Si le système a besoin de télécharger un grand nombre de paquets, il est par exemple souhaitable de pouvoir simplement les récupérer sans les installer immédiatement, au cas où quelque chose se passe mal. Une fois que <literal>-d</literal> a été utilisé, il est possible d'installer les archives téléchargées en exécutant simplement la commande qui a permis de les récupérer, sans l'option <literal>-d</literal>.

note: type: Content of: <book><chapter><para>
en: The APT <command>dselect</command> method provides the complete APT system with the <command>dselect</command> package selection GUI. <command>dselect</command> is used to select the packages to be installed or removed and APT actually installs them.
fr: La méthode APT de <command>dselect</command> permet d'utiliser le système APT dans son ensemble depuis l'interface graphique de gestion des paquets <command>dselect</command>. L'interface est alors utilisée pour choisir les paquets à installer ou supprimer et c'est APT qui effectue les opérations individuelles d'installation ou suppression.

note: type: Content of: <book><chapter><para>
en: To enable the APT method you need to select [A]ccess in <command>dselect</command> and then choose the APT method. You will be prompted for a set of <emphasis>Sources</emphasis> which are places to fetch archives from. These can be remote Internet sites, local Debian mirrors or CD-ROMs. Each source can provide a fragment of the total Debian archive, APT will automatically combine them to form a complete set of packages. If you have a CD-ROM then it is a good idea to specify it first and then specify a mirror so that you have access to the latest bug fixes. APT will automatically use packages on your CD-ROM before downloading from the Internet.
fr: Pour activer la méthode APT, il est nécessaire de choisir [A]ccéder dans <command>dselect</command> puis utiliser le choix permettant d'activer APT. Des <emphasis>Sources</emphasis> d'installation seront demandées, qui sont les emplacements d'où les paquets seront récupérés. Cela peut être des sites Internet distants, des miroirs locaux ou des CD. Chaque source peut fournir un sous-ensemble de l'archive complète Debian. APT les combinera automatiquement pour créer un jeu complet de paquets. Avec des supports de type CD, il est conseillé de les indiquer en premier puis de les compléter avec un miroir distant qui permettra d'obtenir les versions les plus à jour s'il y en a. APT utilisera alors les paquets disponibles sur les CD avant de les télécharger via l'Internet.

note: type: Content of: <book><chapter><screen>
en:    Set up a list of distribution source locations
    
     Please give the base URL of the debian distribution.
     The access schemes I know about are: http file
    
     For example:
          file:/mnt/debian,
          ftp://ftp.debian.org/debian,
          http://ftp.de.debian.org/debian,
    
    
     URL [http://llug.sep.bnl.gov/debian]:
fr:   Réglage de la liste des emplacements sources de distribution
    
     Veuillez indiquer l'URL de base de la distribution Debian.
     Les schémas d'accès connus sont : http file
    
     Exemple :
          file:/mnt/debian,
          ftp://ftp.debian.org/debian,
          http://ftp.de.debian.org/debian,
    
    
     URL [http://llug.sep.bnl.gov/debian]:

note: type: Content of: <book><chapter><para>
en: The <emphasis>Sources</emphasis> setup starts by asking for the base of the Debian archive, defaulting to an HTTP mirror. Next it asks for the distribution to get.
fr: La configuration des <emphasis>Sources</emphasis> débute par l'indication de la base de l'archive Debian, par défaut un miroir HTTP. Puis la distribution est demandée.

note: type: Content of: <book><chapter><screen>
en:  Please give the distribution tag to get or a path to the
     package file ending in a /. The distribution
     tags are typically something like: stable unstable testing non-US
    
     Distribution [stable]:
fr:  Veuillez indiquer le nom de la distribution à utiliser ou
     le chemin d'accès au fichier des paquets, terminé par un /.
     Les noms de distribution sont en général de la forme suivante :
     stable unstable testing non-US
    
     Distribution [stable] :

note: type: Content of: <book><chapter><para>
en: The distribution refers to the Debian version in the archive, <emphasis>stable</emphasis> refers to the latest released version and <emphasis>unstable</emphasis> refers to the developmental version. <emphasis>non-US</emphasis> is only available on some mirrors and refers to packages that contain encryption technology or other things that cannot be exported from the United States. Importing these packages into the US is legal however.
fr: La distribution fait référence à la version de Debian dans l'archive. <emphasis>stable</emphasis> est la dernière version publiée et <emphasis>unstable</emphasis> la version en développement. <emphasis>non-US</emphasis> n'est disponible que sur certains miroirs et fait référence à des paquets contenant des technologies de chiffrement et d'autres élements dont l'exportation est interdite depuis les États-Unis d'Amérique. Il est toutefois autorisé de les y importer. [Note du traducteur : à la date de cette traduction, 2010, cette notion est totalement obsolète].

note: type: Content of: <book><chapter><screen>
en:  Please give the components to get
     The components are typically something like: main contrib non-free non-free-firmware
    
     Components [main contrib non-free non-free-firmware]:
fr:  Veuillez indiquer les composants à utiliser
     Les composants sont en général de la forme suivante :
     main contrib non-free non-free-firmware
    
     Composants [main contrib non-free non-free-firmware] :

note: type: Content of: <book><chapter><para>
en: The components list refers to the list of sub distributions to fetch. The distribution is split up based on software licenses, main being DFSG free packages while contrib and non-free contain things that have various restrictions placed on their use and distribution.
fr: La liste des composants correspond à la liste des sous-ensemble de la distribution que l'on souhaite utiliser. Les distributions sont en général divisées ainsi pour des raisons de licences. La sous-distribution « main » comporte les paquets libre selon les principes du logiciel libre selon Debian (DFSG) alors que contrib et non-free correspondent à des éléments qui comprennent des restrictions de distribution ou d'utilisation.

note: type: Content of: <book><chapter><para>
en: Any number of sources can be added, the setup script will continue to prompt until you have specified all that you want.
fr: Un nombre quelconque de sources peuvent être ajoutées. Le script de configuration continuera à les demander tant que vous n'indiquerez pas que le processus est terminé.

note: type: Content of: <book><chapter><para>
en: Before starting to use <command>dselect</command> it is necessary to update the available list by selecting [U]pdate from the menu. This is a superset of <literal>apt-get update</literal> that makes the fetched information available to <command>dselect</command>. [U]pdate must be performed even if <literal>apt-get update</literal> has been run before.
fr: Avant d'utiliser <command>dselect</command>, il est nécessaire de mettre à jour la liste de ce qui est disponible en choisissant « [M]ise à jour » depuis le menu. Cette action exécutera la commande « apt-get update », ce qui rendra les informations récupérées disponibles pour <command>dselect</command>. Elle doit être utilisée même si la commande « apt-get » a déjà été utilisée sur ce système.

note: type: Content of: <book><chapter><para>
en: You can then go on and make your selections using [S]elect and then perform the installation using [I]nstall. When using the APT method the [C]onfig and [R]emove commands have no meaning, the [I]nstall command performs both of them together.
fr: Une fois cela effectué, vous pouvez poursuivre et utiliser l'option « [S]électionner » pour choisir les paquets à installer puis « [I]nstaller » pour les installer. Lorsque la méthode APT est utilisée, les options « [C]onfigurer » et « [R]etirer » ne sont pas utilisées, car « [I]nstaller » fait l'ensemble des opérations.

note: type: Content of: <book><chapter><para>
en: By default APT will automatically remove the package (.deb) files once they have been successfully installed. To change this behavior place <literal>Dselect::clean "prompt";</literal> in /etc/apt/apt.conf.
fr: Par défait, APT supprimera automatiquement les fichiers des paquets (fichiers .deb) une fois qu'ils ont été installés correctement. Pour modifier ce comportement, vous pouvez utiliser <literal>Dselect::clean "prompt";</literal> dans /etc/apt/apt.conf.

note: type: Content of: <book><chapter><title>
en: The Interface
fr: L'interface

note: type: Content of: <book><chapter><para><footnote><para>
en: The <command>dselect</command> method actually is a set of wrapper scripts to <command>apt-get</command>. The method actually provides more functionality than is present in <command>apt-get</command> alone.
fr: La méthode <command>dselect</command> consiste en fait en un jeu de scripts qui encapsulent <command>apt-get</command>. Cela approte des fonctionnalités supplémentaires à celles d'<command>apt-get</command> utilisé isolément.

note: type: Content of: <book><chapter><para>
en: Both that APT <command>dselect</command> method and <command>apt-get</command> share the same interface. It is a simple system that generally tells you what it will do and then goes and does it. <placeholder type="footnote" id="0"/> After printing out a summary of what will happen APT then will print out some informative status messages so that you can estimate how far along it is and how much is left to do.
fr: La méthode APT de <command>dselect</command> et le programme <command>apt-get</command> utilisent la même interface. Elle consiste en un système simple qui indique les opérations qui seront effectuées puis les réalise.<placeholder type="footnote" id="0"/> Après avoir indiqué un résumé des opérations qui seront effectuées, APT donnera un certain nombre d'informations permettant d'estimer sa progression, tout au long des actions qu'il effectue.

note: type: Content of: <book><chapter><section><title>
en: Startup
fr: Démarrage

note: type: Content of: <book><chapter><section><para>
en: Before all operations except update, APT performs a number of actions to prepare its internal state. It also does some checks of the system's state. At any time these operations can be performed by running <literal>apt-get check</literal>.
fr: Avant toute opération autre qu'une mise à jour, APT effectue un certain nombre d'actions pour préparer ses mécaismes internes de fonctionnement. Il vérifie également l'état du système. Ces opérations peuvent être effectuées isolément avec la commande  <literal>apt-get check</literal>.

note: type: Content of: <book><chapter><section><screen>
en: # apt-get check
    Reading Package Lists... Done
    Building Dependency Tree... Done
fr: # apt-get check
    Lecture de la liste des paquets... Fait
    Construction de l'arbre des dépendances... Fait

note: type: Content of: <book><chapter><section><para>
en: The first thing it does is read all the package files into memory. APT uses a caching scheme so this operation will be faster the second time it is run. If some of the package files are not found then they will be ignored and a warning will be printed when apt-get exits.
fr: En premier lieu, la liste des paquets est lue et placée en mémoire. APT utilise un mécanisme de cache et cette opération sera plus rapide si elle est effectuée une deuxième fois.Si certains des fichiers de paquets ne sont pas trouvés, ils seront ignorés et une informatique sera affichée quand apt-get se terminera.

note: type: Content of: <book><chapter><section><para>
en: The final operation performs a detailed analysis of the system's dependencies. It checks every dependency of every installed or unpacked package and considers if it is OK. Should this find a problem then a report will be printed out and <command>apt-get</command> will refuse to run.
fr: Ensuite, une analyse détaillée des dépendances du système est réalisée. Les dépendances de chaque paquet installé ou décompressé sont vérifiées. Si un problème est trouvé, il sera affiché et <command>apt-get</command> bloquera des opérations ultérieures.

note: type: Content of: <book><chapter><section><screen>
en: # apt-get check
    Reading Package Lists... Done
    Building Dependency Tree... Done
    You might want to run 'apt --fix-broken install' to correct these.
    Sorry, but the following packages have unmet dependencies:
      9fonts: Depends: xlib6g but it is not installed
      uucp: Depends: mailx but it is not installed
      blast: Depends: xlib6g (&gt;= 3.3-5) but it is not installed
      adduser: Depends: perl-base but it is not installed
      aumix: Depends: libgpmg1 but it is not installed
      debiandoc-sgml: Depends: sgml-base but it is not installed
      bash-builtins: Depends: bash (&gt;= 2.01) but 2.0-3 is installed
      cthugha: Depends: svgalibg1 but it is not installed
               Depends: xlib6g (&gt;= 3.3-5) but it is not installed
      libreadlineg2: Conflicts:libreadline2 (&lt;&lt; 2.1-2.1)
fr: # apt-get check
    Lecture de la liste des paquets... Fait
    Construction de l'arbre des dépendances... Fait
    Vous pouvez lancer « apt --fix-broken install » pour corriger ces problèmes.
    Les paquets suivants contiennent des dépendances non satisfaites :
      9fonts: Depends: xlib6g mais il n'est pas installé
      uucp: Depends: mailx mais il n'est pas installé
      blast: Depends: xlib6g (&gt;= 3.3-5) mais il n'est pas installé
      adduser: Depends: perl-base mais il n'est pas installé
      aumix: Depends: libgpmg1 mais il n'est pas installé
      debiandoc-sgml: Depends: sgml-base mais il n'est pas installé
      bash-builtins: Depends: bash (&gt;= 2.01) mais 2.0-3 est installé
      cthugha: Depends: svgalibg1 mais il n'est pas installé
               Depends: xlib6g (&gt;= 3.3-5) mais il n'est pas installé
      libreadlineg2: Conflicts:libreadline2 (&lt;&lt; 2.1-2.1)

note: type: Content of: <book><chapter><section><para>
en: In this example the system has many problems, including a serious problem with libreadlineg2. For each package that has unmet dependencies a line is printed out indicating the package with the problem and the dependencies that are unmet. A short explanation of why the package has a dependency problem is also included.
fr: Dans cet exemple, le système comporte plusieurs problèmes, notamment un problème sérieux avec libreadline2g. Une ligne est affichée pour chaque paquet dont les dépendances ne sont pas satisfaites, indiquant quel est le problème. Une explication simple du problème est donnée.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: APT however considers all known dependencies and attempts to prevent broken packages
fr: Cependant, APT prend en compte les dépendances connues et s'efforce d'éviter que cette situation ne se produise

note: type: Content of: <book><chapter><section><para>
en: There are two ways a system can get into a broken state like this. The first is caused by <command>dpkg</command> missing some subtle relationships between packages when performing upgrades. <placeholder type="footnote" id="0"/>. The second is if a package installation fails during an operation. In this situation a package may have been unpacked without its dependents being installed.
fr: Il existe deux façons pour le système d'aboutir à cet état. Cela peut d'abord être causé par des subtilités de relations entre les paquets que <command>dpkg</command> aurait manquées lors de mises à jour. <placeholder type="footnote" id="0"/>. Cela peut également être dû à l'échec antérieur d'une installation de paquet. Dans le cas présent, un paquet a pu être décompressé sans que ses dépendances ne soient satisfaites.

note: type: Content of: <book><chapter><section><para>
en: The second situation is much less serious than the first because APT places certain constraints on the order that packages are installed. In both cases supplying the <literal>-f</literal> option to <command>apt-get</command> will cause APT to deduce a possible solution to the problem and then continue on. The APT <command>dselect</command> method always supplies the <literal>-f</literal> option to allow for easy continuation of failed maintainer scripts.
fr: La seconde situation est moins grave que la première car APT met certaines contraintes sur l'ordre d'installation des paquets. Dans les deux cas, l'option <literal>-f</literal> utilisée avec <command>apt-get</command> conduira APT à rechercher une solution possible puis à continuer. La méthode APT de <command>dselect</command> utilise toujours cette option <literal>-f</literal> afin de pouvoir poursuivre plus facilement ses opérations si un script de mainteneur échoue de manière inopinée.

note: type: Content of: <book><chapter><section><para>
en: However, if the <literal>-f</literal> option is used to correct a seriously broken system caused by the first case then it is possible that it will either fail immediately or the installation sequence will fail. In either case it is necessary to manually use dpkg (possibly with forcing options) to correct the situation enough to allow APT to proceed.
fr: Cependant, si l'option <literal>-f</literal> est utilisée pour corriger un système fortement corrompu qui est dans le premier cas, il est possible que l'opération échoue immédiatement ou au cours des diverses tentatives de réparation effectuées. Dans tous les cas, il peut être nécessaire de corriger la situation manuellement avec dpkg (éventuellement en utilisant des options pour forcer certains opérations) avant de pouvoir utiliser à nouveau APT.

note: type: Content of: <book><chapter><section><title>
en: The Status Report
fr: Le rapport d'état

note: type: Content of: <book><chapter><section><para>
en: Before proceeding <command>apt-get</command> will present a report on what will happen. Generally the report reflects the type of operation being performed but there are several common elements. In all cases the lists reflect the final state of things, taking into account the <literal>-f</literal> option and any other relevant activities to the command being executed.
fr: Avant de démarrer ses actions, <command>apt-get</command> en affiche un résumé. En général, ce rapport dépend du type d'opération qui est entreprise, mais de nombreux éléments sont communs aux différents types de rapports. Ainsi, dans tous les cas, les listes reflètent l'état final du système, en tenant compte de l'option <literal>-f</literal> et des autres opérations découlant du type de commande utilisée.

note: type: Content of: <book><chapter><section><section><title>
en: The Extra Package list
fr: La liste des paquets supplémentaires

note: type: Content of: <book><chapter><section><section><screen>
en: The following extra packages will be installed:
      libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl
      mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base
      bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy
      squake pgp-i python-base debmake ldso perl libreadlineg2
      ssh
fr: Les paquets supplémentaires suivants seront installés :
      libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl
      mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base
      bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy
      squake pgp-i python-base debmake ldso perl libreadlineg2
      ssh

note: type: Content of: <book><chapter><section><section><para>
en: The Extra Package list shows all of the packages that will be installed or upgraded in excess of the ones mentioned on the command line. It is only generated for an <literal>install</literal> command. The listed packages are often the result of an Auto Install.
fr: La liste des paquets supplémentaires montre tous les paquets installés ou mis à jour en plus de ceux indiqués à la ligne de commande. Elle n'apparaît qu'avec la commande <literal>install</literal>. Le plus souvent, les paquets concernés sont le résultat d'une installation automatique.

note: type: Content of: <book><chapter><section><section><title>
en: The Packages to Remove
fr: Les paquets à supprimer

note: type: Content of: <book><chapter><section><section><screen>
en: The following packages will be REMOVED:
      xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix
      xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel
      xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid
      nas xpilot xfig
fr: Les paquets suivants seront ENLEVÉS :
      xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix
      xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel
      xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid
      nas xpilot xfig

note: type: Content of: <book><chapter><section><section><para>
en: The Packages to Remove list shows all of the packages that will be removed from the system. It can be shown for any of the operations and should be given a careful inspection to ensure nothing important is to be taken off. The <literal>-f</literal> option is especially good at generating packages to remove so extreme care should be used in that case. The list may contain packages that are going to be removed because they are only partially installed, possibly due to an aborted installation.
fr: La liste des paquets à enlever montre tous les paquets qui seront supprimés du système. Elle peut apparaître pour tout type d'opération. Il est conseillé de l'inspecter en détail afin de vérifier qu'aucun paquet important ne va être supprimé. L'option <literal>-f</literal> provoque notamment souvent des suppressions de paquets et il est déconseillé d'être particulièrement attentif dans ce genre de cas. La liste peut comporter des paquets qui seront supprimés parce qu'ils sont seulement partiellement installés, par exemple après l'interruption d'une opération d'installation.

note: type: Content of: <book><chapter><section><section><title>
en: The New Packages list
fr: La liste des nouveaux paquets

note: type: Content of: <book><chapter><section><section><screen>
en: The following NEW packages will installed:
      zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base
fr: Les NOUVEAUX paquets suivants seront installés :
      zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base

note: type: Content of: <book><chapter><section><section><para>
en: The New Packages list is simply a reminder of what will happen. The packages listed are not presently installed in the system but will be when APT is done.
fr: La liste des nouveaux paquets est un simple rappel des opérations qui vont avoir lieu. Les paquets affichés ne sont pas encore présents sur le système mais le seront une fois qu'APT aura terminé.

note: type: Content of: <book><chapter><section><section><title>
en: The Kept Back list
fr: La liste des paquets conservés

note: type: Content of: <book><chapter><section><section><screen>
en: The following packages have been kept back
      compface man-db tetex-base msql libpaper svgalib1
      gs snmp arena lynx xpat2 groff xscreensaver
fr: Les paquets suivants ont été conservés :
      compface man-db tetex-base msql libpaper svgalib1
      gs snmp arena lynx xpat2 groff xscreensaver

note: type: Content of: <book><chapter><section><section><para>
en: Whenever the whole system is being upgraded there is the possibility that new versions of packages cannot be installed because they require new things or conflict with already installed things. In this case the package will appear in the Kept Back list. The best way to convince packages listed there to install is with <literal>apt-get install</literal> or by using <command>dselect</command> to resolve their problems.
fr: À chaque fois que le système entier est mis à jour, il est possible que de nouvelles versions de paquets ne puissent pas être installées car elles ont besoins ne nouveaux paquets ou qu'elles entrent en conflit avec des paquets existants. Ces paquets apparaîtront alors dans la liste des paquets conservés. Le meilleure méthode pour effectivement installer ces paquets est souvent de le faire explicitement avec la commande <literal>apt-get install</literal> ou avec <command>dselect</command>.

note: type: Content of: <book><chapter><section><section><title>
en: Held Packages warning
fr: L'avertissement pour paquets retenus

note: type: Content of: <book><chapter><section><section><screen>
en: The following held packages will be changed:
      cvs
fr: Les paquets retenus suivants seront changés :
      cvs

note: type: Content of: <book><chapter><section><section><para>
en: Sometimes you can ask APT to install a package that is on hold, in such a case it prints out a warning that the held package is going to be changed. This should only happen during dist-upgrade or install.
fr: Il peut parfois être utile de demander à APT d'installer un paquet retenu (« hold »). Dans ce cas, le programme affichera un avertissement indiquant que le paquet retenu va être modifié. Cela ne se produira que lors de l'utilisation des commandes dist-upgrade ou install.

note: type: Content of: <book><chapter><section><section><title>
en: Final summary
fr: Résumé final

note: type: Content of: <book><chapter><section><section><para>
en: Finally, APT will print out a summary of all the changes that will occur.
fr: Enfin, APT affichera un résumé de toutes les opérations qui prendront place.

note: type: Content of: <book><chapter><section><section><screen>
en: 206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded.
    12 packages not fully installed or removed.
    Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used.
fr: 206 paquets mis à jour, 8 nouvellement installés, 23 à enlever et 51 non mis à jour.
    12 paquets partiellement installés ou enlevés.
    Il est nécessaire de prendre 65,7 Mo/66,7 Mo dans les archives. Après cette opération, 26,5 Mo d'espace disque supplémentaires seront utilisés.

note: type: Content of: <book><chapter><section><section><para>
en: The first line of the summary simply is a reduced version of all of the lists and includes the number of upgrades - that is packages already installed that have new versions available. The second line indicates the number of poorly configured packages, possibly the result of an aborted installation. The final line shows the space requirements that the installation needs. The first pair of numbers refer to the size of the archive files. The first number indicates the number of bytes that must be fetched from remote locations and the second indicates the total size of all the archives required. The next number indicates the size difference between the presently installed packages and the newly installed packages. It is roughly equivalent to the space required in /usr after everything is done. If a large number of packages are being removed then the value may indicate the amount of space that will be freed.
fr: La première ligne de ce résumé est une version simplifiée de l'ensemble des listes et indique le nombre de mises à jour (paquets déjà installés et pour lesquels une nouvelle version est disponible). La deuxième ligne indique le nombre de paquets incorrectement configurés, en raison notamment d'installations interrompues. La dernière ligne indique l'espace disque nécessaire pour effectuer l'installation. Le premier couple de nombre fait référence à la taille des fichiers d'archive. Le premier nombre est le nombre d'octets à récupérer depuis les sites distants et le deuxième la taille totale de tous les fichiers nécessaires. Le nombre suivant représente la différence d'espace occupé entre les paquets installés actuellement et ce qui sera ensuite installé. Il est grossièrement égal à l'espace supplémentaire nécessaire dans /usr après achèvement de toutes les opérations. Si de nombreux paquets sont supprimés, cette valeur peut représenter l'espace qui est alors libéré.

note: type: Content of: <book><chapter><section><section><para>
en: Some other reports can be generated by using the -u option to show packages to upgrade, they are similar to the previous examples.
fr: D'autres rapports peuvent être créés avec l'option -u qui affiche les paquets à mettre à jour. Il sont analogues aux exemples précédents.

note: type: Content of: <book><chapter><section><title>
en: The Status Display
fr: L'affichage d'état

note: type: Content of: <book><chapter><section><para>
en: During the download of archives and package files APT prints out a series of status messages.
fr: Pendant le téléchargement des fichiers des paquets, APT affiche un certain nombre de messages d'avancement.

note: type: Content of: <book><chapter><section><screen>
en: # apt-get update
    Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages
    Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages
    Hit http://llug.sep.bnl.gov/debian/ testing/main Packages
    Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages
    Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages
    11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s
fr: # apt-get update
    Réception de :1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages
    Réception de :2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages
    Atteint http://llug.sep.bnl.gov/debian/ testing/main Packages
    Réception de :4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages
    Réception de :5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages
    11% [5 testing/non-free `Attente du fichier' 0/32.1k 0%] 2203b/s 1m52s

note: type: Content of: <book><chapter><section><para>
en: The lines starting with <emphasis>Get</emphasis> are printed out when APT begins to fetch a file while the last line indicates the progress of the download. The first percent value on the progress line indicates the total percent done of all files. Unfortunately since the size of the Package files is unknown <literal>apt-get update</literal> estimates the percent done which causes some inaccuracies.
fr: Les lignes qui débutent par « Réception de » sont affichées quand APT démarre la récupération d'un fichier alors que la dernière ligne indique la progression du téléchargement. La première valeur de pourcentage de la ligne est le pourcentage de téléchargement déjà effectué, pour l'ensemble des fichiers. Il faut noter que, comme la taille des fichiers de paquets n'est pas connue, <literal>apt-get update</literal> estime le pourcentage effectué ce qui peut conduire à des imprécisions.

note: type: Content of: <book><chapter><section><para>
en: The next section of the status line is repeated once for each download thread and indicates the operation being performed and some useful information about what is happening. Sometimes this section will simply read <emphasis>Forking</emphasis> which means the OS is loading the download module. The first word after the [ is the fetch number as shown on the history lines. The next word is the short form name of the object being downloaded. For archives it will contain the name of the package that is being fetched.
fr: La section suivante de la ligne d'état est répétée pour chaque sous-tâche de téléchargement. Elle indique l'opération effectuée et d'autres informations utiles sur ce qui est en cours. Cette section indiquera parfois <emphasis>Forking</emphasis> ce qui indique que le système charge le module de téléchargement. Le premier mot après le crochet ouvrant ([) est le numéro d'ordre de téléchargement comme indiqué dans les lignes d'historique. Le mot suivant est le nom court de l'objet téléchargé. Pour les archives, il s'agit du nom du paquet en cours de récupération.

note: type: Content of: <book><chapter><section><para>
en: Inside of the single quote is an informative string indicating the progress of the negotiation phase of the download. Typically it progresses from <emphasis>Connecting</emphasis> to <emphasis>Waiting for file</emphasis> to <emphasis>Downloading</emphasis> or <emphasis>Resuming</emphasis>. The final value is the number of bytes downloaded from the remote site. Once the download begins this is represented as <literal>102/10.2k</literal> indicating that 102 bytes have been fetched and 10.2 kilobytes is expected. The total size is always shown in 4 figure notation to preserve space. After the size display is a percent meter for the file itself. The second last element is the instantaneous average speed. This values is updated every 5 seconds and reflects the rate of data transfer for that period. Finally is shown the estimated transfer time. This is updated regularly and reflects the time to complete everything at the shown transfer rate.
fr: À l'intérieur des guillemets, on trouve une information sur la progression de la phase de négociation du téléchargement. Usuellement, elle évolue de <emphasis>Connexion</emphasis> à <emphasis>Attente du fichier</emphasis>, puis <emphasis>Téléchargement</emphasis> ou <emphasis>Reprise</emphasis>. La valeur finale est le nombre d'octets téléchargés depuis le site distant. Une fois le téléchargement commencé, cette indication prend la forme <literal>102/10,2ko</literal>, ce qui indique que 102 octets ont été téléchargés et que 10,2 kilo-octets sont attendus. La taille totale est toujours représentées sur 4 digits pour des raisons de place disponible. Après cet affichage de taille, se trouve une barre de progression pour le téléchargement du fichier lui-même. L'élément suivant est la vitesse instantanée de téléchargement. Elle est mise à jour toutes les 5 secondes et représente la vitesse de transfert pour cette période. Enfin, est affiché la temps de téléchargement restant estimé. Cette information est mise régulièrement à jour et représete la durée estimée de téléchargement de toute ce qui est nécessaire, à la vitesse affichée.

note: type: Content of: <book><chapter><section><para>
en: The status display updates every half second to provide a constant feedback on the download progress while the Get lines scroll back whenever a new file is started. Since the status display is constantly updated it is unsuitable for logging to a file, use the <literal>-q</literal> option to remove the status display.
fr: La ligne d'état est mise à jour chaque demi-seconde afin de fournir un retour régulier sur la progression du téléchargement alors que les lignes « Réception de » reculent d'une unité à chaque fois qu'un nouveau fichier est démarré. Comme l'état est mis à jour régulièrement, il ne peut pas servir pour la journalisation dans un fichier. Il est nécessaire d'utiliser l'option <literal>-q</literal> pour supprimer cet affichage.

note: type: Content of: <book><chapter><section><para>
en: APT uses <command>dpkg</command> for installing the archives and will switch over to the <command>dpkg</command> interface once downloading is completed. <command>dpkg</command> will also ask a number of questions as it processes the packages and the packages themselves may also ask several questions. Before each question there is usually a description of what it is asking and the questions are too varied to discuss completely here.
fr: APT utilise <command>dpkg</command> pour installer les archives et bascule vers l'interface de ce programme une fois le téléchargement terminé. <command>dpkg</command> peut poser un certain nombre de questions pendant le traitement des paquets, qui peuvent eux-même être amener à poser des questions. Chacune de ces questions comporte un description de ce qui est attendu et elles sont trop variables d'un paquet à l'autre pour qu'une description détaillée soit donnée dans ce document.

note: type: Content of: <book><title>
en: Using APT Offline
fr: Utilisation d'APT hors ligne

note: type: Content of: <book><bookinfo><abstract><para>
en: This document describes how to use APT in a non-networked environment, specifically a 'sneaker-net' approach for performing upgrades.
fr: Ce document décrit la méthode d'utilisation d'APT hors connexion à un réseau, et plus particulièrement une approche « sneaker-net » pour les mises à jour.

note: type: Content of: <book><chapter><section><title>
en: Overview
fr: Aperçu

note: type: Content of: <book><chapter><section><para>
en: Normally APT requires direct access to a Debian archive, either from a local media or through a network. Another common complaint is that a Debian machine is on a slow link, such as a modem and another machine has a very fast connection but they are physically distant.
fr: Normalement, APT a besoin d'avoir un accès direct à une archive Debian, soit sur un support local, soit via le réseau. Un autre cas intéressant à traiter est celui d'une machine dotée d'une liaison peu rapide (comme un modem) avec une autre possédant une connexion à haut débit mais située à distance.

note: type: Content of: <book><chapter><section><para>
en: The solution to this is to use large removable media such as a Zip disc or a SuperDisk disc. These discs are not large enough to store the entire Debian archive but can easily fit a subset large enough for most users. The idea is to use APT to generate a list of packages that are required and then fetch them onto the disc using another machine with good connectivity. It is even possible to use another Debian machine with APT or to use a completely different OS and a download tool like wget. Let <emphasis>remote host</emphasis> mean the machine downloading the packages, and <emphasis>target host</emphasis> the one with bad or no connection.
fr: Une solution est d'utiliser un support amovible de grande taille tel qu'un disque Zip ou un disque Superdisk (NdT : ce document est daté..:-)). Bien que ces supports ne disposent pas d'assez de place pour héberger une archive Debian complète, ils peuvent toutefois contenir un sous-ensemble de taille suffisante pour les besoins de nombreux utilisateurs. L'idée est alors d'utiliser APT pour créer une liste de paquets nécessaires, puis de les récupérer avec une machine disposant d'une bonne connectivité. Il est même possible d'utiliser soit une autre machine Debian avec APT soit un autre système d'exploitation et un outil de téléchargement tel que wget. Dans ce qui suit, <emphasis>machine distante</emphasis> désignera la machine qui télécharge les paquets et <emphasis>machine cible</emphasis>, celle qui a une connectivité limitée.

note: type: Content of: <book><chapter><section><para>
en: This is achieved by creatively manipulating the APT configuration file. The essential premise to tell APT to look on a disc for it's archive files. Note that the disc should be formatted with a filesystem that can handle long file names such as ext2, fat32 or vfat.
fr: Il est nécessaire de manipuler le fichier de configuration d'APT de manière intelligente. Le préalable est d'indiquer à APT d'examiner le contenu d'un disque pour y trouver les fichiers d'archive. Ce disque doit utiliser un système de fichier autorisant les noms longs, par exemple ext2, fat32 ou vfat.

note: type: Content of: <book><chapter><title>
en: Using APT on both machines
fr: Utilisation d'APT sur les deux machines

note: type: Content of: <book><chapter><section><para>
en: APT being available on both machines gives the simplest configuration. The basic idea is to place a copy of the status file on the disc and use the remote machine to fetch the latest package files and decide which packages to download. The disk directory structure should look like:
fr: Si APT existe sur les deux machines, le cas est relativement simple. L'idée de base est de mettre une copie du fichier d'état sur le disque et d'utiliser la machine distante pour récupérer la dernière liste de paquets et choisir ceux à télécharger. La structure des répertoires du disque devraient ressembler à :

note: type: Content of: <book><chapter><section><title>
en: The configuration file
fr: Le fichier de configuration

note: type: Content of: <book><chapter><section><para>
en: The configuration file should tell APT to store its files on the disc and to use the configuration files on the disc as well. The sources.list should contain the proper sites that you wish to use from the remote machine, and the status file should be a copy of <emphasis>/var/lib/dpkg/status</emphasis> from the <emphasis>target host</emphasis>. Please note, if you are using a local archive you must use copy URIs, the syntax is identical to file URIs.
fr: Le fichier de configuration indique à APT où conserver ses fichiers sur le disque et d'utiliser également les fichiers de configuration du disque. Le fichier sources.list devrait référencer les sites que vous souhaitez utiliser depuis la machine distante et le fichier d'état doit être une copie de <emphasis>/var/lib/dpkg/status</emphasis> de l'<emphasis>ordinateur cible</emphasis>. Veuillez noter que si sous utilisez une archive locale, les URI doivent en être copiés. La syntaxe est la même que celle des URI fichiers.

note: type: Content of: <book><chapter><section><para>
en: <emphasis>apt.conf</emphasis> must contain the necessary information to make APT use the disc:
fr: <emphasis>apt.conf</emphasis> doit avoir les informations nécessaires pour qu'APT utilise le disque.disc:

note: type: Content of: <book><chapter><section><para>
en: More details can be seen by examining the apt.conf man page and the sample configuration file in <emphasis>/usr/share/doc/apt/examples/apt.conf</emphasis>.
fr: Plus d'informations peuvent être trouvées dans la page de manuel du fichier apt.conf et dans l'exemple de fichier de configuration que l'on peut trouver dans <emphasis>/usr/share/doc/apt/examples/apt.conf</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: On the target machine the first thing to do is mount the disc and copy <emphasis>/var/lib/dpkg/status</emphasis> to it. You will also need to create the directories outlined in the Overview, <emphasis>archives/partial/</emphasis> and <emphasis>lists/partial/</emphasis>. Then take the disc to the remote machine and configure the sources.list. On the remote machine execute the following:
fr: Sur la machine cible, il est d'abord nécessaire de monter le disque et y copier le fichier <emphasis>/var/lib/dpkg/status</emphasis>. Il sera aussi nécessaire de créer les répertoires dans l'aperçu (Overview), <emphasis>archives/partial/</emphasis> and <emphasis>lists/partial/</emphasis>. Connecter ensuite le disque à la machine distante et configurer le fichier sources.list. Sur la machine distante, exécuter la séquence de commandes suivante :

note: type: Content of: <book><chapter><section><screen>
en:  # export APT_CONFIG="/disc/apt.conf"
     # apt-get update
     [ APT fetches the package files ]
     # apt-get dist-upgrade
     [ APT fetches all the packages needed to upgrade the target machine ]
fr:  # export APT_CONFIG="/disc/apt.conf"
     # apt-get update
     [ APT récupère les fichiers des paquets ]
     # apt-get dist-upgrade
     [ APT récupère tous les fichiers nécessaires à la mise à jour de la machine distante ]

note: type: Content of: <book><chapter><section><para>
en: The dist-upgrade command can be replaced with any other standard APT commands, particularly dselect-upgrade. You can even use an APT front end such as <emphasis>dselect</emphasis>. However this presents a problem in communicating your selections back to the local computer.
fr: La commande dist-upgrade peut être remplacée par toute autres commande usuelle d'APT, notamment dselect-upgrade. Il est même possible d'utiliser une interface comme <emphasis>dselect</emphasis>. Cependant, cela complique la communication des choix vers l'ordinateur local.

note: type: Content of: <book><chapter><section><para>
en: Now the disc contains all of the index files and archives needed to upgrade the target machine. Take the disc back and run:
fr: Après cette opération, le disque contiendra tous les fichiers d'index et les archives nécessaires pour mettre à jour la machine cible. Il est alors possible d'y ramener le disque et exécuter :

note: type: Content of: <book><chapter><section><screen>
en:   # export APT_CONFIG="/disc/apt.conf"
      # apt-get check
      [ APT generates a local copy of the cache files ]
      # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade
      [ Or any other APT command ]
fr:   # export APT_CONFIG="/disc/apt.conf"
      # apt-get check
      [ APT crée la copie locale des fichiers de cache ]
      # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade
      [ Ou toute autre commande APT ]

note: type: Content of: <book><chapter><section><para>
en: It is necessary for proper function to re-specify the status file to be the local one. This is very important!
fr: Pour un fonctionnement correct, il est indispensable de ré-indiquer que le fichier d'état est le fichier local. Cela est très important.

note: type: Content of: <book><chapter><section><para>
en: If you are using dselect you can do the very risky operation of copying disc/status to /var/lib/dpkg/status so that any selections you made on the remote machine are updated. I highly recommend that people only make selections on the local machine - but this may not always be possible. DO NOT copy the status file if dpkg or APT have been run in the mean time!!
fr: Si vous utilisez dselect, vous pouvez effectuer l'opération dangereuse consistant à copier disc/status en /var/lib/dpkg/status, afin que les choix effectués sur la machine distante soient mis à jour. Il est recommandé de n'éffectuer les choix que sur la machine locale, mais ce n'est pas toujours possible. NE COPIEZ PAS le fichier d'état si dpkg ou APT ont été exécutés dans l'intervalle.

note: type: Content of: <book><chapter><title>
en: Using APT and wget
fr: Utilisation d'APT et wget

note: type: Content of: <book><chapter><section><para>
en: <emphasis>wget</emphasis> is a popular and portable download tool that can run on nearly any machine. Unlike the method above this requires that the Debian machine already has a list of available packages.
fr: <emphasis>wget</emphasis> est un outil classique de téléchargement qui peut être exécuté sur à peu près tout type de machine. À la différence de la méthode précédente, cela impose que la machine Debian a déjà une liste des paquets disponibles.

note: type: Content of: <book><chapter><section><para>
en: The basic idea is to create a disc that has only the archive files downloaded from the remote site. This is done by using the --print-uris option to apt-get and then preparing a wget script to actually fetch the packages.
fr: L'idée de base est de créer un disque qui ne comporte que les fichiers archive téléchargés depuis le site distant. Cela peut être effectué avec l'option --print-uris d'apt-get puis de la préparation d'un script wget permettant de récupérer les paquets/

note: type: Content of: <book><chapter><section><title>
en: Operation
fr: Fonctionnement

note: type: Content of: <book><chapter><section><para>
en: Unlike the previous technique no special configuration files are required. We merely use the standard APT commands to generate the file list.
fr: À la différence de la méthode précédente, aucun fichier de configuration spécifique n'est nécessaire. Seules les commandes standard d'APT seront utilisées pour créer la liste de ficheirs.

note: type: Content of: <book><chapter><section><screen>
en:  # apt-get dist-upgrade
     [ Press no when prompted, make sure you are happy with the actions ]
     # apt-get -qq --print-uris dist-upgrade &gt; uris
     # awk '{print "wget -O " $2 " " $1}' &lt; uris &gt; /disc/wget-script
fr:  # apt-get dist-upgrade 
     [ Répondre négativement à la question, pour être sûr(e) que les actions vous conviennent ]
     # apt-get -qq --print-uris dist-upgrade &gt; uris
     # awk '{print "wget -O " $2 " " $1}' &lt; uris &gt; /disc/wget-script

note: type: Content of: <book><chapter><section><para>
en: Any command other than dist-upgrade could be used here, including dselect-upgrade.
fr: Toute autre commande que dist-upgrade peut être utilisée, y compris dselect-upgrade.

note: type: Content of: <book><chapter><section><para>
en: The /disc/wget-script file will now contain a list of wget commands to execute in order to fetch the necessary archives. This script should be run with the current directory as the disc's mount point so as to save the output on the disc.
fr: Le fichier /disc/wget-script contiendra alors la liste des commandes wget à exécuter afin de récupérer les fichiers nécessaires. Ce script doit être exécuté depuis le point de montage du disque afin que les fichiers soient écrits sur le disque.

note: type: Content of: <book><chapter><section><para>
en: The remote machine would do something like
fr: Sur la machine distante, il faudra alors exécuter l'équivalent de :

note: type: Content of: <book><chapter><section><screen>
en:   # cd /disc
      # sh -x ./wget-script
      [ wait.. ]
fr:   # cd /disc
      # sh -x ./wget-script
      [ attendre.. ]

note: type: Content of: <book><chapter><section><para>
en: Once the archives are downloaded and the disc returned to the Debian machine installation can proceed using,
fr: Une fois les fichiers téléchargés et le disque reconnecté à la machine Debian, l'installation peut se poursuivre avec :

note: type: Content of: <book><chapter><section><para>
en: Which will use the already fetched archives on the disc.
fr: Cette commande utilisera les fichiers récupérés sur le disque.
