devscripts - Scripts pour faciliter le travail des
développeurs Debian
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 des exemples de scripts pour procmail et
exim permettant de trier les messages arrivant aux listes de
diffusion Debian.
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.
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.
- archpath(1)
- Affiche les noms de paquet arch (tla/Bazaar). Supporte également le
calcul des noms de paquet pour les autres branches. [tla | bazaar]
- bts(1)
- Outil en ligne de commande pour manipuler le BTS, à la fois pour
envoyer des courriels à control@bts.debian.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]
- build-rdeps(1)
- Rechercher tous les paquets qui dépendent du paquet indiqué
pour leur construction. [dctrl-tools, dose-extra, libdpkg-perl]
- chdist(1)
- outil pour jouer facilement avec différentes distributions.
[dctrl-tools]
- checkbashisms(1)
- rechercher des constructions spécifiques à bash dans un
script /bin/sh.
- cowpoke(1)
- 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]
- cvs-debrelease(1)
- encapsulation de debrelease pouvant être appelée depuis un
répertoire de travail CVS. [cvs-buildpackage, dupload | dput,
ssh-client]
- cvs-debuild(1)
- Encapsulation de debuild pour construire les paquets avec
cvs-buildpackage. [cvs-buildpackage, fakeroot, lintian, gnupg |
gnupg2]
- dcmd(1)
- exécuter une commande donnée en remplaçant le nom
d'un fichier .changes ou .dsc par chaque fichier
référencé. *
- dd-list(1)
- ordonner joliment une liste de paquets par responsable. *
- debbisect(1)
- examine snapshot.debian.org pour savoir quel changement dans l'archive a
introduit un certain problème. [mmdebstrap, python3-debian]
- debc(1)
- 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]*
- debcheckout(1)
- récupérer le contenu du dépôt d'un paquet
Debian. *
- debclean(1)
- 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]*
- debcommit(1)
- 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]
- debdiff(1)
- 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]*
- debdiff-apply(1)
- 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]
- debi(1)
- 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.
- debpkg(1)
- 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).
- debrelease(1)
- 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]
- debrebuild(1)
- Un script qui fournit un fichier .buildinfo expose les instructions pour
reproduire la construction à l'identique. [sbuild | mmdebstrap,
libdistro-info-perl]
- debrepro(1)
- 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]
- debrsign(1)
- 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]
- debsign(1)
- 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] *
- debsnap(1)
- récupérer des paquets de https://snapshot.debian.org
[libwww-perl, libjson-perl]
- debuild(1)
- 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] *
- deb-reversion(1)
- augmente le numéro de version d'un paquet binaire et reconstruit le
paquet, pratique pour les porteurs et autres.
- deb-why-removed(1)
- affiche la raison pour laquelle le paquet a été
supprimé. [libdpkg-perl]
- dep3changelog(1)
- 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]
- dget(1)
- 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]
- diff2patches(1)
- 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]
- dscverify(1)
- 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]
- edit-patch(1)
- ajouter et éditer un correctif pour un paquet source et envoyer les
modifications. [quilt | dpatch | cdbs]
- getbuildlog(1)
- télécharger les journaux de construction de paquet des
serveurs Debian de construction automatique. [wget]
- git-deborig(1)
- 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]
- grep-excuses(1)
- rechercher vos paquets dans les fichiers excuses de britney.
[libdbd-pg-perl, libterm-size-perl, libyaml-syck-perl, wget, w3m]
- hardening-check(1)
- rapporter les caractéristiques de sécurisation d'un ensemble
de binaires.
- list-unreleased(1)
- 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.
- manpage-alert(1)
- trouver des programmes sans page de manuel. [man-db]
- mass-bug(1)
- soumettre en masse des rapports de bogue. [bsd-mailx | mailx]
- mergechanges(1)
- fusionner les fichiers .changes d'une même version mais construits
sur plusieurs architectures.
- mk-build-deps(1)
- À 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]
- mk-origtargz(1)
- 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]
- namecheck(1)
- Vérifier la disponibilité des noms de projet.
- nmudiff(1)
- 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]
- origtargz(1)
- récupérer l'archive amont d'un paquet Debian depuis divers
sources, et la dépaqueter. [pristine-tar]
- plotchangelog(1)
- afficher sous forme graphique les données d'un fichier changelog en
utilisant gnuplot. [libtimedate-perl, gnuplot]
- pts-subscribe(1)
- s'abonner au PTS (Package Tracking System) pour un temps limité.
[bsd-mailx | mailx, at]
- rc-alert(1)
- afficher la liste des paquets installés ayant des bogues
empêchant leur intégration dans la prochaine distribution.
[wget | curl]
- reproducible-check(1)
- rapporter l'état « reproductible » des
paquets installés. Pour en savoir plus, voir
<https://reproducible-builds.org>.
- rmadison(1)
- interroger à distance la base de données de l'archive
Debian. [liburi-perl, wget | curl]
- sadt(1)
- exécuter des tests DEP-8. [python3-debian]
- salsa(1)
- manipule les dépôts de salsa.debian.org et les utilisateurs
[libgitlab-api-v4-perl]
- suspicious-source(1)
- afficher une liste de fichiers qui ne sont pas des fichiers source usuels.
[python3-magic]
- svnpath(1)
- 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]
- tagpending(1)
- 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]
- transition-check(1)
- 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]
- uscan(1)
- 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]*
- uupdate(1)
- 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]
- what-patch(1)
- déterminer le système de correctifs, s'il existe,
utilisé par un paquet source. [patchutils]
- whodepends(1)
- vérifier quels paquets (et responsables) dépendent d'un
autre paquet.
- who-permits-upload(1)
- 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]
- who-uploads(1)
- identifier les dernières personnes ayant envoyé un paquet
donné vers l'archive Debian. [gnupg | gnupg2, debian-keyring,
debian-maintainers, wget]
- wnpp-alert(1)
- afficher la liste des paquets installés offerts à l'adoption
ou orphelins. [wget | curl]
- wnpp-check(1)
- vérifier si un bogue du type paquet demandé (RFP) ou paquet
en cours de travail (ITP) est ouvert pour un paquet. [wget | curl]
- wrap-and-sort(1)
- couper les lignes longues et trier les items des fichiers d'empaquetage.
[python3-debian]
Ce document est une traduction, maintenue à l'aide de
l'outil po4a <https://po4a.alioth.debian.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@lists.debian.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.