Provided by: debhelper_13.14.1ubuntu5_all bug

NOM

       dh_dwz - Optimiser l'information de débogage DWARF dans les binaires ELF grâce à dwz

SYNOPSIS

       dh_dwz [options_de_debhelper] [-Xitem] [-- paramètres]

DESCRIPTION

       dh_dwz est un programme de la suite debhelper qui optimise la taille (non compressée) des informations
       DWARF de débogage dans les binaires ELF. Cela est effectué en exécutant dwz(1) sur tous les binaires ELF
       du paquet.

OPTIONS

       --dwz-multifile, --no-dwz-multifile
           Détermine si dwz(1) doit créer un objet multifile à partir des binaires ELF d'un même paquet. Si oui,
           dans  un paquet qui fournit au moins deux binaires ELF, dh_dwz demandera à dwz(1) de générer un objet
           multifile pour le paquet.

           Par défaut, dh_dwz tentera de créer un objet multifile mais continuera sans si dwz(1) n'en  crée  pas
           un  (mais  se termine néanmoins avec succès). Cela arrive généralement quand les fichiers de débogage
           ne contiennent pas de symboles de débogage (par exemple, en absence de -g passé  au  compilateur)  ou
           quand  les  symboles de débogage sont compressés (voir le bogue Debian n° 931891). Si --dwz-multifile
           est passé, alors dh_dwz s’interrompra avec une erreur si dwz(1) ne crée pas un multifile.

           Cette option pourrait ne pas fonctionner si un paquet contient plus de binaires ELF que  ne  peut  en
           contenir  une seule ligne de commande. Si cela devenait un problème, utilisez --no-dwz-multifile pour
           le contourner.

           Le multifile créé sera compressé avec objcopy --compress-debug-sections.

           Note pour les paquets udeb : dh_dwz ne générera  jamais  de  multifile  pour  les  paquets  udeb.  Il
           utilisera toutefois dwz pour réduire la taille des fichiers de débogage s'il en trouve.

       -Xélément, --exclude=élément
           Exclut  du traitement les fichiers qui comportent élément n'importe où dans leur nom. Il est possible
           d'utiliser cette option à plusieurs reprises pour établir une liste des éléments à exclure.

       -- paramètres
           Passe les paramètres à dwz(1) lors du traitement des binaires ELF. Cela est surtout  utile  pour  les
           paramètres liés à la mémoire (comme -l et -L).

REMARQUES

       Si la variable d'environnement DEB_BUILD_OPTIONS contient nostrip, rien ne sera dépouillé, conformément à
       la Charte Debian (section 10.1 « Binaries »).

       Bien  que  cet  outil  ne supprime pas les informations de débogage des binaires, il est quand même évité
       lorsque DEB_BUILD_OPTIONS contient nostrip, car nostrip est souvent utilisé pour optimiser  la  durée  de
       construction (comme dans les cycles « build and test ») plutôt que pour optimiser la taille.

VOIR AUSSI

       debhelper(7)

       Ce programme fait partie de debhelper.

AUTEUR

       Niels Thykier <niels@thykier.net>

TRADUCTION

       Cette traduction est maintenue à l'aide de l'outil po4a <URL:http://po4a.alioth.debian.org/> par l'équipe
       francophone de traduction de Debian.

       Veuillez  signaler  toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
       un rapport de bogue sur le paquet debhelper.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».

13.14.1ubuntu5                                     2024-03-01                                          DH_DWZ(1)