From: Etienne Cordonnier <ecordonnier@snap.com>
To: ecordonnier@snap.com
Cc: docs@lists.yoctoproject.org
Subject: Re: [docs][PATCH v2] manuals: document minidebuginfo
Date: Thu, 7 Dec 2023 15:09:48 +0100 [thread overview]
Message-ID: <CAHUKmYYiR=CyJXSDAgT6BNr7LMCiQr=24nD5NNgH=xPRvT0OhA@mail.gmail.com> (raw)
In-Reply-To: <179E91E4E2B2BCFA.29440@lists.yoctoproject.org>
[-- Attachment #1: Type: text/plain, Size: 4126 bytes --]
Patch v2: Fixed grammar according to Ulrich's feedback:
s/of 5 to 10%/by 5 to 10%/
Etienne
On Thu, Dec 7, 2023 at 3:08 PM Etienne Cordonnier via lists.yoctoproject.org
<ecordonnier=snap.com@lists.yoctoproject.org> wrote:
> From: Etienne Cordonnier <ecordonnier@snap.com>
>
> Signed-off-by: Etienne Cordonnier <ecordonnier@snap.com>
> ---
> documentation/dev-manual/debugging.rst | 15 +++++++++++++++
> documentation/ref-manual/features.rst | 3 +++
> 2 files changed, 18 insertions(+)
>
> diff --git a/documentation/dev-manual/debugging.rst
> b/documentation/dev-manual/debugging.rst
> index fea2cb30a..12694b01b 100644
> --- a/documentation/dev-manual/debugging.rst
> +++ b/documentation/dev-manual/debugging.rst
> @@ -1173,6 +1173,21 @@ To support this kind of debugging, you need do the
> following:
> Consider that this will reduce the application's performance and is
> recommended only for debugging purposes.
>
> +Enabling Minidebuginfo
> +======================
> +
> +Enabling the DISTRO_FEATURES minidebuginfo adds a compressed ELF section
> ".gnu_debugdata"
> +to all binary files, containing only function names, and thus increasing
> the size of the
> +binaries only by 5 to 10%. For comparison, full debug symbols can be 10
> times as big as
> +a stripped binary, and it is thus not always possible to deploy full
> debug symbols.
> +Minidebuginfo data allows, on the one side, to retrieve a call-stack using
> +gdb (command backtrace) without deploying full debug-symbols to the
> target. It also
> +allows to retrieve a symbolicated call-stack when using systemd-coredump
> to manage
> +coredumps (commands "coredumpctl list" and "coredumpctl info").
> +
> +This feature was created by Fedora, see
> https://urldefense.proofpoint.com/v2/url?u=https-3A__fedoraproject.org_wiki_Features_MiniDebugInfo&d=DwIDAg&c=ncDTmphkJTvjIDPh0hpF_4vCHvabgGkICC2epckfdiw&r=AhkbNonVuMIGRfPx_Qj9TsRih1DULJTKUkSGa66m67E&m=YXeDmFamWpT6qC-yFNYvNIC8dcQgCpj0yktlGvqpuJU1lflqnaJCc47hrcxEtbdf&s=nLuMgeFeJNMlIMiWN8PUROk-3ig9Cm7VHE0J-vVeP2A&e=
> for
> +more details.
> +
> Other Debugging Tips
> ====================
>
> diff --git a/documentation/ref-manual/features.rst
> b/documentation/ref-manual/features.rst
> index dd14339bc..1320c3a58 100644
> --- a/documentation/ref-manual/features.rst
> +++ b/documentation/ref-manual/features.rst
> @@ -161,6 +161,9 @@ metadata, as extra layers can define their own:
> - *keyboard:* Include keyboard support (e.g. keymaps will be loaded
> during boot).
>
> +- *minidebuginfo:* Add minimal debug symbols
> :ref:`(minidebuginfo)<dev-manual/debugging:enabling minidebuginfo>`
> + to binary files containing, allowing coredumpctl and gdb to show
> symbolicated stack traces.
> +
> - *multiarch:* Enable building applications with multiple architecture
> support.
>
> --
> 2.36.1.vfs.0.0
>
>
> -=-=-=-=-=-=-=-=-=-=-=-
> Links: You receive all messages sent to this group.
> View/Reply Online (#4666):
> https://urldefense.proofpoint.com/v2/url?u=https-3A__lists.yoctoproject.org_g_docs_message_4666&d=DwIFaQ&c=ncDTmphkJTvjIDPh0hpF_4vCHvabgGkICC2epckfdiw&r=AhkbNonVuMIGRfPx_Qj9TsRih1DULJTKUkSGa66m67E&m=YXeDmFamWpT6qC-yFNYvNIC8dcQgCpj0yktlGvqpuJU1lflqnaJCc47hrcxEtbdf&s=7PlaS4qaGHb1v_X9vINbttbEvcXYCom5eXEQCwKZLDA&e=
> Mute This Topic:
> https://urldefense.proofpoint.com/v2/url?u=https-3A__lists.yoctoproject.org_mt_103034540_7048771&d=DwIFaQ&c=ncDTmphkJTvjIDPh0hpF_4vCHvabgGkICC2epckfdiw&r=AhkbNonVuMIGRfPx_Qj9TsRih1DULJTKUkSGa66m67E&m=YXeDmFamWpT6qC-yFNYvNIC8dcQgCpj0yktlGvqpuJU1lflqnaJCc47hrcxEtbdf&s=-s69Se9_govdXJfABjAcyjYfch1dRtFTX3-t-DsOAfU&e=
> Group Owner: docs+owner@lists.yoctoproject.org
> Unsubscribe:
> https://urldefense.proofpoint.com/v2/url?u=https-3A__lists.yoctoproject.org_g_docs_unsub&d=DwIFaQ&c=ncDTmphkJTvjIDPh0hpF_4vCHvabgGkICC2epckfdiw&r=AhkbNonVuMIGRfPx_Qj9TsRih1DULJTKUkSGa66m67E&m=YXeDmFamWpT6qC-yFNYvNIC8dcQgCpj0yktlGvqpuJU1lflqnaJCc47hrcxEtbdf&s=WPXYi_eDq2Maud3rxLAD1r5pjG3pCDifwZaOYRBJMeM&e=
> [ecordonnier@snap.com]
> -=-=-=-=-=-=-=-=-=-=-=-
>
>
[-- Attachment #2: Type: text/html, Size: 6498 bytes --]
next parent reply other threads:[~2023-12-07 14:10 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <179E91E4E2B2BCFA.29440@lists.yoctoproject.org>
2023-12-07 14:09 ` Etienne Cordonnier [this message]
2023-12-07 14:08 [docs][PATCH v2] manuals: document minidebuginfo ecordonnier
2023-12-08 8:19 ` Michael Opdenacker
2023-12-11 10:08 ` Etienne Cordonnier
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CAHUKmYYiR=CyJXSDAgT6BNr7LMCiQr=24nD5NNgH=xPRvT0OhA@mail.gmail.com' \
--to=ecordonnier@snap.com \
--cc=docs@lists.yoctoproject.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).