.de Sh " Subsection heading .if t .Sp .ne 5

$1


Nom

.IX Header "NOM" debarchiver - Outil de gestion des paquets Debian.

Résumé

.IX Header "SYNOPSIS" debarchiver [options]

Description

.IX Header "DESCRIPTION" L'archiveur Debian (debarchiver) est un outil qui installe les paquets Debian dans une structure de fichiers exploitable par apt-get, dselect et d'autres outils semblables, utilisés pour la mise à jour des systèmes Debian. Il est destiné à être employé par des administrateurs locaux qui ont besoin de paquets spéciaux, ou de versions particulières, afin d'en faciliter la gestion.

La structure de fichiers est basée sur celle de potato et ne reconnaît pas la structure de paquets en « pools » (NdT : Structure utilisée à partir de woody). Ceci pourra être réalisé plus tard, mais ce n'est pas une priorité.

Options

.IX Header "OPTIONS"
"--debug-level | --dl niveau" 4

.IX Item "--debug-level | --dl niveau" Niveau des informations qui seront affichées. 1=critique, 2=erreur, 3=normal, 4=message, 5=débogage, 6=débogage détaillé (modules).

"--quit-level niveau" 4

.IX Item "--quit-level niveau" Niveau d'information qui produira l'arrêt de l'exécution, selon la classification ci-dessus.

"-v | --version" 4

.IX Item "-v | --version" Affiche le numéro de version.

"--help" 4

.IX Item "--help" Affiche ce fichier d'aide (NdT : Affiche l'original en anglais).

"--copycmd" 4

.IX Item "--copycmd" Commande à utiliser pour l'installation. Par défaut « f(CW$copycmd ». Les paquets ainsi que les fichiers indiqués dans « .changes » seront installés grâce à cette commande.

"--movecmd" 4

.IX Item "--movecmd" Commande à utiliser pour déplacer des fichiers (actuellement parfaitement inutile).

"--rmcmd" 4

.IX Item "--rmcmd" Commande à utiliser pour la suppression. Par défaut « f(CW$rmcmd ». Cette commande peut être utilisée pour déplacer les anciens paquets à un autre emplacement.

"--instcmd" 4

.IX Item "--instcmd" Obsolète !

"-d | --dest | --destdir répertoire" 4

.IX Item "-d | --dest | --destdir répertoire" Répertoire de destination. Répertoire de base où sont situés tous les paquets de la distribution. En cas de besoin, l'arborescence « f(CW$distrib/$major/$arch/$section » sera créée. Par défaut le chemin relatif « f(CW$destdir » sera utilisé.

"--scandetect | -s" 4

.IX Item "--scandetect | -s" Choisit automatiquement d'utiliser, soit « apt-ftparchive », soit « dpkg-scan* », selon ce qui est installé sur le système. C'est la méthode recommandée. N'utilisez « --index » ou « --autoscan » que si vous savez parfaitement ce que vous faites.

"-x | --index" 4

.IX Item "-x | --index" Exécute automatiquement « apt-ftparchive » après l'installation de tous les nouveaux paquets. config doit être un chemin absolu vers le fichier de configuration à employer pour qu'apt-ftparchive fonctionne. Voir les pages du manuel d'apt-ftparchive pour plus d'informations. Utilisez cette option *ou* l'option « --autoscan », mais pas les deux ensemble.

"-i | --input | --indir | --inputdir répertoire" 4

.IX Item "-i | --input | --indir | --inputdir répertoire" Répertoire où tous les paquets, ainsi que les fichiers « *.changes » correspondants, devront être installés dans le répertoire « --dest ». La valeur par défaut est « f(CW$instdir ».

"--cachedir répertoire" 4

.IX Item "--cachedir répertoire" Répertoire de cache utilisé par apt-ftparchive (si « --index » est utilisé). La valeur par défaut est « f(CW$cachedir ».

"--lockfile fichier" 4

.IX Item "--lockfile fichier" Fichier de verrouillage à utiliser. La valeur par défaut est « f(CW$lockfile ».

"--cinstall répertoire" 4

.IX Item "--cinstall répertoire" Répertoire où le fichier « .changes » sera installé. Une chaîne vide permet de le supprimer. La valeur par défaut est « f(CW$cinstall ».

"--configfile fichier" 4

.IX Item "--configfile fichier" Indique un fichier de configuration supplémentaire. Il sera lu après le fichier de configuration du répertoire /etc/ et celui du répertoire de l'utilisateur.

"--distinputcriteria" 4

.IX Item "--distinputcriteria" Critères indiquant quels paquets binaires devront être installés, même en l'absence de fichier « .changes ». Par défaut « f(CW$distinputcriteria ».

"-o | --addoverride" 4

.IX Item "-o | --addoverride" Ajoute automatiquement de nouveaux paquets au fichier des exclusions (override).

"--autoscanpackages" 4

.IX Item "--autoscanpackages" Démarre automatiquement « dpkg-scanpackages » après l'installation de tous les nouveaux paquets.

"--autoscansources" 4

.IX Item "--autoscansources" Lance automatiquement « dpkg-scansources » après l'installation de tous les nouveaux paquets.

"-b | --bzip" 4

.IX Item "-b | --bzip" Crée les fichiers « Packages.bz2 » et « Sources.bz2 » comprimés avec bzip2.

"-a | --autoscan" 4

.IX Item "-a | --autoscan" Exécute « --autoscanpackages » et « --autoscansources ».

"--scanall" 4

.IX Item "--scanall" Explore toutes les distributions, sections, etc.

"--autoscanall" 4

.IX Item "--autoscanall" Identique à « --scanall --autoscan ».

"--gpgkey" 4

.IX Item "--gpgkey" Clé GnuPG à utiliser pour signer l'archive.

"--gpgpassfile" 4

.IX Item "--gpgpassfile" Fichier qui fournit le mot de passe à GnuPG.

"--nosort" 4

.IX Item "--nosort" Ne trie pas les paquets.

"--nostructurefix" 4

.IX Item "--nostructurefix" Ne crée pas les répertoires et actualise (touch) les fichiers « Package ».

"--scanonly" 4

.IX Item "--scanonly" Identique à « --nosort --nostructurefix ».

Fichier de configuration

.IX Header "FICHIER DE CONFIGURATION" Vous pouvez également utiliser des fichiers de configuration portant les noms suivants : « /etc/debarchiver.conf », « ~/.debarchiver.conf » et « input.conf » (chemin relatif) qui seront lus et exploités dans cet ordre. Les arguments de la commande auront priorité sur ces fichiers de configuration. Ces fichiers permettent de modifier les variables suivantes :
"$destdir" 4

.IX Item "$destdir" Répertoire de destination (voir « --destdir » ci-dessus).

"$inputdir" 4

.IX Item "$inputdir" Répertoire d'entrée (sans effet dans « f(CW$inputconfigfile »).

"$cachedir" 4

.IX Item "$cachedir" Répertoire de cache pour apt-ftparchive, utilisé si « --index » est précisé.

"$copycmd" 4

.IX Item "$copycmd" Commande d'installation (voir « --copycmd » ci-dessus).

"$movecmd" 4

.IX Item "$movecmd" Commande de déplacement (voir « --movecmd » ci-dessus).

"$rmcmd" 4

.IX Item "$rmcmd" Commande de suppression (voir « --rmcmd » ci-dessus).

"$cinstall" 4

.IX Item "$cinstall" Emplacement où les fichiers «.changes » sont installés (voir « --cinstall » ci-dessus).

"$bzip" 4

.IX Item "$bzip" Si cette variable est positionnée à 0, aucun fichier bzip2 ne sera créé. Si elle est positionnée à 1 les fichiers bzip2 seront créés.

"$distinputcriteria" 4

.IX Item "$distinputcriteria" Critères permettant de déterminer les paquets qui devront être installés même en l'absence de fichier « .changes ». Par défaut « f(CW$distinputcriteria ».

"%distinputdirs" 4

.IX Item "%distinputdirs" Répertoires (distribution => répertoire) où sont cherchés les paquets binaires qui n'ont pas besoin de fichier « .changes » pour être installés mais qui correspondent à « f(CW$distinputcriteria ». Généralement ce sont les paquets du noyau, produits par « make-kpkg », qui ne génèrent pas de fichier « .changes ». En plus, les paquets binaires avec un fichier « .changes » correct passeront outre la distribution par défaut et seront placés dans le répertoire de la file d'attente actuelle. Cela produira la remontée vers une file d'attente spécifique pour placer le paquet directement dans cette distribution.

"$verifysignatures" 4

.IX Item "$verifysignatures" Permet d'activer (1) ou de désactiver (0) la vérification de la signature des paquets remontés vers « f(CW$inputdir » (pas ceux vers « f(CW%distinputdirs »).

"$verifysignaturesdistinput" 4

.IX Item "$verifysignaturesdistinput" Permet d'activer (1) ou de désactiver (0) la vérification de la signature des paquets remontés vers « f(CW%distinputdirs ». Cette option fonctionne indépendamment de « f(CW$verifysignatures ».

"$lockfile" 4

.IX Item "$lockfile" Fichier de verrouillage à utiliser. La valeur par défaut est « f(CW$lockfile ».

"@mailtos" 4

.IX Item "@mailtos" Tableau de chaînes indiquant les destinataires de courriel. Si la chaîne contient une adresse mail, celle-ci sera utilisée. Si elle contient une adresse mail incomplète, par exemple « f(CW@nom_hôte », le nom de l'utilisateur propriétaire du fichier sera utilisé en combinaison avec le « f(CW@nom_hôte » indiqué. Si aucun caractère « @ » n'est trouvé dans la chaîne, on considérera qu'il s'agit d'un champ dans le fichier « .changes ». Un tel champ peut par exemple être « Maintainer » ou « Uploaders ».

"%release" 4

.IX Item "%release" Information complémentaire à ajouter au fichier « Release ». Les mots-clés supportés sont : « origin », « label », et « description ».

"$gpgkey" 4

.IX Item "$gpgkey" Clé GnuPG utilisée pour signer l'archive. Si cette variable est renseignée, le fichier « Release » de chaque partie modifiée de l'archive sera signé par GnuPG en utilisant « f(CW$gpgkey » comme clé d'identification. A moins d'utiliser une clé sans mot de passe ou de se servir de la variable « f(CW$gpgpassfile », il est nécessaire d'exécuter debarchiver de manière interactive afin de pouvoir fournir le mot de passe si cette option est utilisée.

"$gpgpassfile" 4

.IX Item "$gpgpassfile" Nom du fichier qui contient le mot de passe de la clé GnuPG. Voir « f(CW$gpgkey » pour plus d'informations.

Indexation des paquets

.IX Header "INDEXATION DES PAQUETS" Il y a deux manières de produire des index exploitables par apt-get :

On peut utiliser --autoscanpackages, --autoscansources, ou -- autoscan ce qui emploiera dpkg-scanpackages et dpkg-scansources. Ceci produira les paquets et les fichiers source mais ne générera pas les fichiers « Contents » et risque d'être lent avec un référentiel de grande taille.

En revanche, l'option --index config utilisera apt-ftparchive pour indexer l'arbre des paquets. apt-ftparchive peut également produire des fichiers « Contents » (destinés à apt-file), et il peut, éventuellement, employer un cache afin d'accélérer des exécutions multiples. Le fichier de configuration apt-ftparchive sera produit automatiquement. Ceci n'a cependant pas été complètement testé.

Vous devez employer soit --autoscanpackages et --autoscansources soit &--index, mais pas les deux, puisqu'ils font la même chose.

L'action par défaut (et celle qui est recommandée) est --scandetect qui analyse les logiciels déjà installés et choisit efficacement entre « --index » et « --autoscan » suivant ce que vous avez implanté sur votre système.

Fichiers

.IX Header "FICHIERS" &/etc/debarchiver.conf

Voir aussi

.IX Header "VOIR AUSSI" &apt-ftparchive(1)

Auteur

.IX Header "AUTEUR" Ola Lundqvist <opal@debian.org>

Traduction

.IX Header "TRADUCTION" Valéry Perrin <valery.perrin.debian@free.fr> le 23 février 2005. Dernière mise à jour le 14 janvier 2006.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité.

La version anglaise la plus à jour de ce document est toujours consultable via la commande « man -L en debarchiver ».

N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.