NOM
devscripts - Scripts pour faciliter le travail des développeurs Debian
DESCRIPTION
Le paquet devscripts fournit un ensemble de scripts qui peuvent être utiles aux développeurs Debian et à tous ceux qui souhaitent construire des paquets Debian. Pour un résumé des différents scripts disponibles, veuillez consulter /usr/share/doc/devscripts/README.gz, et pour plus de détails, veuillez consulter les pages de manuel individuelles. Ils ont été développés par un certain nombre de développeurs, la liste des auteurs se trouve dans le code et les pages de manuel.
Le répertoire /usr/share/doc/devscripts/examples contient également un exemple de script pour exim permettant de trier les messages arrivant aux listes de diffusion Debian.
ENVIRONNEMENT
Plusieurs
scripts de l’ensemble devscripts utilisent les
variables d’environnement suivantes. Vérifiez
les pages de manuel de chaque script pour obtenir plus de
précisions sur la façon dont ces variables
sont utilisées.
DEBEMAIL
Adresse électronique de la personne agissant sur un paquet Debian donné avec devscripts.
DEBFULLNAME
Nom complet (prénom et nom) de la personne agissant sur un paquet Debian donné avec devscripts.
SCRIPTS
Voici la liste
complète des outils devscripts disponibles. Consultez
leurs pages de manuel pour une documentation plus
complète.
annotate-output(1)
exécuter une commande et ajouter le temps et le type de sortie (O pour la sortie standard et E pour la sortie d’erreur standard) au début de chaque ligne affichée.
Affiche les noms de paquet arch (tla/Bazaar). Supporte également le calcul des noms de paquet pour les autres branches. [tla]
|
Outil en ligne de commande pour manipuler le BTS, à la fois pour envoyer des courriels à control [AT] bts.org et accéder aux pages web et à l’interface SOAP du BTS. [www-browser, libauthen-sasl-perl, libnet-smtps-perl, libsoap-lite-perl, liburi-perl, libwww-perl, bsd-mailx | mailx] |
Rechercher tous les paquets qui dépendent du paquet indiqué pour leur construction. [dctrl-tools, dose-extra, libdpkg-perl]
outil pour jouer facilement avec différentes distributions. [dctrl-tools]
rechercher des constructions spécifiques à bash dans un script /bin/sh.
envoyer un paquet source Debian à un hôte cowbuilder et construire le paquet. Le paquet résultant peut également être signé et envoyé dans une file d’attente. [ssh-client]
cvs-debi, cvs-debc(1)
encapsulations ("wrappers") respectivement de debi et debc (voir plus bas) pouvant être appelées depuis un répertoire de travail CVS. [cvs-buildpackage]
encapsulation de debrelease pouvant être appelée depuis un répertoire de travail CVS. [cvs-buildpackage, dupload | dput, ssh-client]
Encapsulation de debuild pour construire les paquets avec cvs-buildpackage. [cvs-buildpackage, fakeroot, lintian, gnupg | gnupg2]
exécuter une commande donnée en remplaçant le nom d’un fichier .changes ou .dsc par chaque fichier référencé. *
ordonner joliment une liste de paquets par responsable. *
examine snapshot.debian.org pour savoir quel changement dans l’archive a introduit un certain problème. [mmdebstrap, python3-debian]
Liste le contenu du paquet courant. Le faire après la réussite de "debuild" pour voir si le paquet semble correct.
debchange (abréviation dch)(1)
Modifie debian/changelog et gère les numéros de version. Il augmentera la version ou ajoutera une entrée dans l’actuelle suivant les options données en paramètre. [libdistro-info-perl, libsoap-lite-perl]*
récupérer le contenu du dépôt d’un paquet Debian. *
Nettoie un répertoire source Debian. debclean nettoie tous les répertoires source Debian présents dans le répertoire courant et, si demandé, efface aussi les fichiers générés depuis ces répertoires (c’est à dire les fichiers .deb, .dsc et .changes). Il conserve en revanche les fichiers originaux et .diffs, permettant ainsi la reconstruction. [fakeroot]*
Soumettre les changements vers CVS, Darcs, Subversion, SVK, GNU Arch, Bazaar, Git ou Mercurial en basant le message de modification sur le journal de modifications. [cvs | darcs | subversion | svk | tla | bzr | git | mercurial, libtimedate-perl]
Programme qui examine deux fichiers .deb et reporte toutes les différences trouvées dans leurs listes de fichiers. Patique pour s’assurer qu’aucu fichier n’a été perdu entre deux versions. Peut également examiner deux fichiers .dsc et montrer les changements entre les versions source. Pour une comparaison plus profonde, on peut utiliser le paquet diffoscope. [wdiff, patchutils]*
Applique les différentiels unifiés de deux paquets source Debian, tels ceux générés par debdiff, à un paquet source Debian cible. Toute modification apportée à debian / changelog est traitée spécialement afin d’éviter les conflits générés par les différences de changelog lorsqu’il est appliqué naïvement. Peut être utilisé pour vérifier que les anciens correctifs s’appliquent toujours aux versions les plus récentes de ces packages. [python3-debian, python3-unidiff, quilt]
Installe le paquet actuel en utilisant le script setuid-root debpkg décrit ci-dessous. Il suppose que le paquet actuel vient d’être construit (par exemple, par debuild) et que le fichier .deb se trouve dans le répertoire parent et qu’il exécutera effectivement dpkg -i sur le fichier .deb. La possibilité d’installer le package à l’aide d’une commande très courte est très utile lors du dépannage de packages.
Combine debootstrap and snapshot.debian.org pour créer un chroot contenant exactement la sélection de paquets demandés. Ceci peut être utilisé pour recréer un chroot passé, par exemple pour reproduire un bogue. Cet outil est également utilisé par debrebuild pour construire un paquet dont les dépendances de construction sont les mêmes que celles enregistrées dans le fichier buildinfo. [apt-utils, dpkg-dev, equivs, mmdebstrap, python3-pycurl]
Un wrapper pour dpkg utilisé par debi pour permettre de tester facilement les paquets. Pour que debpkg fonctionne, il doit être positionné setuid root, ce qui doit être effectué par l’administrateur système - il n’est pas installé par défaut avec le setuid root. (Notez que le fait de pouvoir exécuter un debpkg avec le setuid root équivaut en réalité à avoir un accès root au système, il faut donc le faire avec prudence). Avoir debpkg en tant que wrapper pour dpkg peut être unu bonne chose, car ça peut réduire les risques de dommages résultant d’une mauvaise utilisation accidentelle des commandes en mode superutilisateur (par exemple, un rm -rf * par inadvertance dans le mauvais répertoire est désastreux, comme beaucoup peuvent en témoigner).
Un wrapper autour de dupload ou dput qui détermine quelle version télécharger, puis appelle dupload ou dput pour effectuer le téléchargement. [dupload | dput, ssh-client]
Un script qui fournit un fichier .buildinfo expose les instructions pour reproduire la construction à l’identique. [sbuild | mmdebstrap, python3-pycurl, libdpkg-perl]
Script qui teste la reproductibilité d’un paquet Debian. Il construit deux fois un répertoire source donné, avec un ensemble de variations entre la première et la deuxième construction, et compare les paquets binaires produits. Si diffoscope est installé, il est utilisé pour comparer les binaires qui diffèrent. Si disorderfs est installé, il est utilisé lors de la construction pour injecter du non-déterminisme dans les opérations de liste du système de fichiers. [faketime, diffoscope, disorderfs]
Transfère une paire de fichiers à signer .changes et .dsc et lance debsign sur la machine distante au travers d’une connection SSH. [gnupg | gnupg2, debian-keyring, ssh-client]
Utilisez GNU Privacy Guard pour signer les fichiers de changements (et éventuellement dsc) créés en exécutant dpkg-buildpackage avec les options sans signature. Utile si vous construisez un paquet sur une machine distante et souhaitez le signer sur un ordinateur local. Ce script est capable de télécharger automatiquement les fichiers .changes et .dsc à partir d’un ordinateur distant. [gnupg | gnupg2, debian-keyring, ssh-client] *
récupérer des paquets de https://snapshot.debian.org [libwww-perl, libjson-perl]
Un wrapper pour construire un paquet (c’est-à-dire, dpkg-buildpackage) afin d’éviter les problèmes des permissions insuffisantes, des chemins incorrects, etc… Debuild configure l’environnement approprié pour la construction d’un paquet. Debuild utilise le programme fakeroot pour construire le paquet par défaut, mais peut être invité à utiliser toute autre commande gain-root, ou peut même être installé setuid root. Debuild peut également être utilisé pour exécuter diverses opérations du fichier debian/rules avec la même procédure de gain root. Debuild exécute également lintian pour vérifier que le paquet ne comporte pas de violation majeure de la politique. [fakeroot, lintian, gnupg | gnupg2] *
client ligne de commande pour interagir avec Debian-Janitor.
augmente le numéro de version d’un paquet binaire et reconstruit le paquet, pratique pour les porteurs et autres.
affiche la raison pour laquelle le paquet a été supprimé. [libdpkg-perl]
préparer une entrée du journal de modifications à partir de l’en-tête d’un correctif compatible DEP3.
à partir d’un fichier desktop freedesktop.org, produire un corps de fichier menu. [libfile-desktopentry-perl]
Télécharge les paquets source et binaires Debian. Pointe sur un fichier .changes ou .dsc pour télécharger tous les fichiers de référence. Indiquer un nom de paquet pour le télécharger depuis le référentiel apt configuré. [wget | curl]
extrait les correctifs d’un fichier .diff.gz en les plaçant dans debian/, ou debian/patches s’il existe. [patchutils]
dpkg-depcheck, dpkg-genbuilddeps(1)
Exécute une commande spécifiée (telle que debian/rules build) ou dpkg-buildpackage, respectivement, pour déterminer les paquets utilisés lors du processus de construction. Ces informations peuvent être utiles lorsque vous essayez de déterminer les paquets nécessaires dans les lignes Build-Depends etc. du fichier debian/control. [build-essential, strace]
extraire un seul fichier d’un paquet source Debian. [patchutils]
vérifie la signature et les sommes MD5 d’un fichier dsc par rapport au dernier fichier de clés Debian de votre système. [gnupg | gnupg2, debian-keyring]
ajouter et éditer un correctif pour un paquet source et envoyer les modifications. [quilt | dpatch | cdbs]
télécharger les journaux de construction de paquet des serveurs Debian de construction automatique. [wget]
essayer de produire orig.tar de Debian avec git-archive(1). [libdpkg-perl, libgit-wrapper-perl, liblist-compare-perl, libstring-shellquote-perl, libtry-tiny-perl]
rechercher vos paquets dans les fichiers excuses de britney. [libdbd-pg-perl, libterm-size-perl, libyaml-syck-perl, wget, w3m]
rapporter les caractéristiques de sécurisation d’un ensemble de binaires.
recherche les paquets marqués UNRELEASED dans leur changelog.
ltnu (Long Time No Upload)(1)
Afficher la liste de tous les envois de paquets d’un uploader ou d’un responsable, et les afficher à partir du dernier envoi.
trouver des programmes sans page de manuel. [man-db]
soumettre en masse des rapports de bogue. [bsd-mailx | mailx]
fusionner les fichiers .changes d’une même version mais construits sur plusieurs architectures.
À partir d’un nom de paquet ou d’un fichier "control", créer un paquet binaire qui peut être installé pour satisfaire les dépendances de construction d’un paquet. [equivs]
Renommer l’archive amont, en modifiant éventuellement la compression et en supprimant les fichiers non désirés. [libfile-which-perl, unzip, xz-utils, file]
Vérifier la disponibilité des noms de projet.
prépare un différentiel de cette version (présumée NMU) et de la précédente (d’après de changelog) et l’envoie vers le BTS. [patchutils, mutt]
récupérer l’archive amont d’un paquet Debian depuis divers sources, et la dépaqueter. [pristine-tar, pristine-lfs]
afficher sous forme graphique les données d’un fichier changelog en utilisant gnuplot. [libtimedate-perl, gnuplot]
s’abonner au PTS (Package Tracking System) pour un temps limité. [bsd-mailx | mailx, at]
afficher la liste des paquets installés ayant des bogues empêchant leur intégration dans la prochaine distribution. [wget | curl]
rapporter l’état "reproductible" des paquets installés. Pour en savoir plus, voir <https://reproducible-builds.org>;.
interroger à distance la base de données de l’archive Debian. [liburi-perl, wget | curl]
exécuter des tests DEP-8. [python3-debian, autodep8]
manipule les dépôts de salsa.debian.org et les utilisateurs [libgitlab-api-v4-perl]
afficher une liste de fichiers qui ne sont pas des fichiers source usuels. [python3-magic]
Imprime le chemin d’accès au référentiel Subversion d’une extraction Subversion. Prend également en charge le calcul des chemins des branches et des balises de manière indépendante du référentiel. Utilisé par debcommit pour générer des tags svn. [subversion]
exécuter depuis une arborescence source Debian et placer l’étiquette "pending" sur tous les bogues à fermer dans le dernier groupe d’entrée du changelog. [libsoap-lite-perl]
Vérifier si l’un des paquets source listés est impliqué dans une transition pour laquelle les envois sont bloqués actuellement. [libwww-perl, libyaml-syck-perl]
Analyse et télécharge automatiquement les mises à jour en amont. Uscan peut également appeler un programme tel que uupdate pour tenter de mettre à jour la version Debianisée en fonction de la nouvelle mise à jour. Bien que uscan puisse être utilisé pour publier automatiquement la version mise à jour, il est probablement préférable de ne pas le faire sans tests. Uscan peut également vérifier les signatures OpenPGP détachées si la clé de signature en amont est connue. [file, gpgv | gpgv2, gnupg | gnupg2, libfile-dirlist-perl, libfile-touch-perl, libfile-which-perl, liblwp-protocol-https-perl, libmoo-perl, libwww-perl, unzip, xz-utils]*
Mets à jour le paquet avec une archive ou des correctifs d’un auteur amont. Cela vous aidera si vous devez mettre à jour votre paquet. Il essaie d’appliquer les dernières différences à votre paquet et vous reporte son résultat. [patch]
déterminer le système de correctifs, s’il existe, utilisé par un paquet source. [patchutils]
vérifier quels paquets (et responsables) dépendent d’un autre paquet.
Récupérer des renseignements sur les listes de contrôle d’accès de mainteneurs Debian. [gnupg | gnupg2, libencode-locale-perl, libwww-perl, debian-keyring]
identifier les dernières personnes ayant envoyé un paquet donné vers l’archive Debian. [gnupg | gnupg2, debian-keyring, debian-maintainers, wget]
afficher la liste des paquets installés offerts à l’adoption ou orphelins. [wget | curl]
vérifier si un bogue du type paquet demandé (RFP) ou paquet en cours de travail (ITP) est ouvert pour un paquet. [wget | curl]
couper les lignes longues et trier les items des fichiers d’empaquetage. [python3-debian]
TRADUCTION
Ce document est une traduction, maintenue à l’aide de l’outil po4a <https://po4a.org/> par l’équipe de traduction francophone du projet Debian.
Nicolas François, Guillaume Delacour, Cyril Brulebois, Thomas Huriaux et David Prévot ont réalisé cette traduction.
L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french [AT] lists.org> ou par un rapport de bogue sur le paquet devscripts.
La version anglaise la plus à jour de ce document est toujours consultable en ajoutant l’option « -L C » à la commande man.