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 un exemple de script pour
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]
-
bts(1)
- Outil en ligne de commande pour manipuler le BTS, à
la fois pour envoyer des courriels à [email protected] et
accéder aux pages web et à l'interface SOAP du BTS.
[www-browser, libauthen-sasl-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.
-
debootsnap(1)
- 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]
-
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, python3-pycurl, libdpkg-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-janitor(1)
- client ligne de commande pour interagir avec
Debian-Janitor.
-
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.
-
desktop2menu(1)
- à 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]
-
dscextract(1)
- 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,
pristine-lfs]
-
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,
autodep8]
-
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.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 à <
[email protected]> 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.