.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "DH_DWZ 1" .TH DH_DWZ 1 2024-03-27 13.15.3 Debhelper .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NOM .IX Header "NOM" dh_dwz \- Optimiser l'information de débogage DWARF dans les binaires ELF grâce à dwz .SH SYNOPSIS .IX Header "SYNOPSIS" \&\fBdh_dwz\fR [\fIoptions_de_debhelper\fR] [\fB\-X\fR\fIitem\fR] [\fB\-\-\fR\ \fIparamètres\fR] .SH DESCRIPTION .IX Header "DESCRIPTION" \&\fBdh_dwz\fR 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 \fBdwz\fR\|(1) sur tous les binaires ELF du paquet. .SH OPTIONS .IX Header "OPTIONS" .IP "\fB\-\-dwz\-multifile\fR, \fB\-\-no\-dwz\-multifile\fR" 4 .IX Item "--dwz-multifile, --no-dwz-multifile" Détermine si \fBdwz\fR\|(1) doit créer un objet \fImultifile\fR à partir des binaires ELF d'un même paquet. Si oui, dans un paquet qui fournit au moins deux binaires ELF, \fBdh_dwz\fR demandera à \fBdwz\fR\|(1) de générer un objet \fImultifile\fR pour le paquet. .Sp Par défaut, \fBdh_dwz\fR tentera de créer un objet \fImultifile\fR mais continuera sans si \fBdwz\fR\|(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 \fB\-\-dwz\-multifile\fR est passé, alors \fBdh_dwz\fR s’interrompra avec une erreur si \fBdwz\fR\|(1) ne crée pas un \fImultifile\fR. .Sp 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 \fB\-\-no\-dwz\-multifile\fR pour le contourner. .Sp Le \fImultifile\fR créé sera compressé avec \fBobjcopy \-\-compress\-debug\-sections\fR. .Sp Note pour les paquets \fBudeb\fR\ : \fBdh_dwz\fR ne générera jamais de \fImultifile\fR pour les paquets \fBudeb\fR. Il utilisera toutefois \fBdwz\fR pour réduire la taille des fichiers de débogage s'il en trouve. .IP "\fB\-X\fR\fIélément\fR, \fB\-\-exclude=\fR\fIélément\fR" 4 .IX Item "-Xélément, --exclude=élément" Exclut du traitement les fichiers qui comportent \fIélément\fR n'importe où dans leur nom. Il est possible d'utiliser cette option à plusieurs reprises pour établir une liste des éléments à exclure. .IP "\fB\-\-\fR \fIparamètres\fR" 4 .IX Item "-- paramètres" Passe les \fIparamètres\fR à \fBdwz\fR\|(1) lors du traitement des binaires ELF. Cela est surtout utile pour les paramètres liés à la mémoire (comme \fB\-l\fR et \fB\-L\fR). .SH REMARQUES .IX Header "REMARQUES" Si la variable d'environnement \fBDEB_BUILD_OPTIONS\fR contient \fBnostrip\fR, rien ne sera dépouillé, conformément à la Charte\ Debian (section\ 10.1 «\ Binaries\ »). .PP Bien que cet outil ne supprime pas les informations de débogage des binaires, il est quand même évité lorsque \fBDEB_BUILD_OPTIONS\fR contient \fBnostrip\fR, car \fBnostrip\fR est souvent utilisé pour optimiser la durée de construction (comme dans les cycles «\ build and test\ ») plutôt que pour optimiser la taille. .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBdebhelper\fR\|(7) .PP Ce programme fait partie de debhelper. .SH AUTEUR .IX Header "AUTEUR" Niels Thykier .SH TRADUCTION .IX Header "TRADUCTION" Cette traduction est maintenue à l'aide de l'outil po4a par l'équipe francophone de traduction de Debian. .PP Veuillez signaler toute erreur de traduction en écrivant à ou par un rapport de bogue sur le paquet debhelper. .PP Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande «\ man \-L C
\ ».