From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from gnu.wildebeest.org (wildebeest.demon.nl [212.238.236.112]) by sourceware.org (Postfix) with ESMTPS id 4F1E43890420 for ; Thu, 18 Feb 2021 13:50:54 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 4F1E43890420 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=klomp.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mark@klomp.org Received: from tarox.wildebeest.org (tarox.wildebeest.org [172.31.17.39]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by gnu.wildebeest.org (Postfix) with ESMTPSA id 2618530005B3 for ; Thu, 18 Feb 2021 14:50:52 +0100 (CET) Received: by tarox.wildebeest.org (Postfix, from userid 1000) id 8C79740422D7; Thu, 18 Feb 2021 14:50:52 +0100 (CET) Message-ID: <63740d1abe2bc5c72b7d5d4352425275d773e133.camel@klomp.org> Subject: Re: [PATCH] PR27402 Document DWARF5 support From: Mark Wielaard To: dwz@sourceware.org Date: Thu, 18 Feb 2021 14:50:52 +0100 In-Reply-To: <20210212131448.14373-1-mark@klomp.org> References: <20210212131448.14373-1-mark@klomp.org> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Mailer: Evolution 3.28.5 (3.28.5-10.el7) Mime-Version: 1.0 X-Spam-Status: No, score=-11.3 required=5.0 tests=BAYES_00, GIT_PATCH_0, JMQ_SPF_NEUTRAL, KAM_DMARC_STATUS, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: dwz@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Dwz mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 18 Feb 2021 13:50:55 -0000 On Fri, 2021-02-12 at 14:14 +0100, Mark Wielaard wrote: > * dwz.1: Explain what subset of DWARF5 is supported, update date, > authors and add a reference to the dwz home page and mailinglist. I pushed this. > dwz.1 | 35 ++++++++++++++++++++++++++++++----- > 1 file changed, 30 insertions(+), 5 deletions(-) >=20 > diff --git a/dwz.1 b/dwz.1 > index 709506c..23ed8c1 100644 > --- a/dwz.1 > +++ b/dwz.1 > @@ -1,4 +1,4 @@ > -.TH dwz 1 "15 June 2012" > +.TH dwz 1 "15 Feb 2021" > .SH NAME > dwz \- DWARF optimization and duplicate removal tool > .SH SYNOPSIS > @@ -15,9 +15,26 @@ compilation units (CUs) for duplicated information and= using > \fIDW_TAG_imported_unit\fR > to import it into each CU that needs it. > =20 > -The tool handles DWARF 32-bit format debugging sections of versions > -2, 3 and 4 and GNU extensions on top of those, though using DWARF 4 > -or worst case DWARF 3 is strongly recommended. > +The tool handles DWARF 32-bit format debugging sections of versions 2, > +3, 4, most of version 5 and GNU extensions on top of those. It is > +strongly recommended to use at least DWARF 3, but using DWARF 4 or > +higher will work much better. > + > +While most of DWARF 5 is supported dwz doesn't yet generate spec > +compliant DWARF Supplementary Object Files (DWARF 5, section > +7.3.6). Instead of a \fI.debug_sup\fR section it will generate a > +\fI.gnu_debugaltlink\fR section. And it will use the > +\fIDW_FORM_GNU_strp_alt\fR and \fIDW_FORM_GNU_reg_alt\fR, instead of > +\fIDW_FORM_strp_sup\fR and \fIDW_FORM_ref_sup\fR to keep compatibility > +with existing DWARF consumers. > + > +DWARF 4 \fI.debug_types\fR are supported, but DWARF 5 \fIDW_UT_type\fR > +units are not. Likewise \fI.gdb_index\fR is supported, but the DWARF 5 > +\fI.debug_names\fR is not. Also some forms and sections that are only > +emitted by GCC when generating Split DWARF, \fIDW_FORM_strx\fR and > +\fI.debug_str_offsets\fR, \fIDW_FORM_addrx\fR and \fI.debug_addr\fR, > +\fIDW_FORM_rnglistx\fR and \fIDW_FORM_loclistsx\fR, are not supported > +yet. > =20 > The tool has two main modes of operation, without the > \fI-m\fR option it attempts to optimize DWARF debugging information in e= ach > @@ -155,6 +172,14 @@ is equivalent to \fIdwz a.out\fR command. > .SH SEE ALSO > .BR http://dwarfstd.org/doc/DWARF4.pdf > , > +.BR http://dwarfstd.org/doc/DWARF5.pdf > +, > .BR gdb (1). > .SH AUTHORS > -Jakub Jelinek . > +Jakub Jelinek , > +Tom de Vries , > +Mark Wielaard > +.SH BUGS > +Use the Bugzilla link of the project web page or our mailing list. > +.nh > +.BR https://sourceware.org/dwz/ ", " .