Re: [PATCH] dev-manual/common-task.rst: Added documentation for debuginfod support

Armin Kuster


Thanks for the patch. Documentation has its own mailing list.

Please resend to that list.


On 3/1/21 6:45 AM, Dorinda wrote:
Added documentation on running debuginfod server and using it on the target.

Signed-off-by: Dorinda Bassey <dorindabassey@...>
documentation/dev-manual/common-tasks.rst | 46 ++++++++++++++++++++++-
1 file changed, 45 insertions(+), 1 deletion(-)

diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst
index 65db4aed33..d4a2b2f28d 100644
--- a/documentation/dev-manual/common-tasks.rst
+++ b/documentation/dev-manual/common-tasks.rst
@@ -10023,7 +10023,51 @@ before starting the debugging process. These extra computations place
more load on the target system and can alter the characteristics of the
program being debugged.

-To help get past the previously mentioned constraints, you can use
+To help get past the previously mentioned constraints, they're two
+methods you can use: running a debuginfod server and using gdbserver.
+Using the debuginfod server Method
+debuginfod from elfutils is a way to distribute debuginfo files.
+running a debuginfod server makes debug symbols readily available,
+which means you don't need to download debugging information
+and the binaries of the process being debugged. you can just fetch
+debug symbols from the server.
+1. To run a debuginfod server, you need to do the following:
+- Ensure that this variable is set in your ``local.conf`` file:
+ ::
+ PACKAGECONFIG_pn-elfutils-native = "debuginfod libdebuginfod"
+ This PACKAGECONFIG option enables debuginfod and libdebuginfod for
+ elfutils-native.
+- Run the following commands to set up the debuginfod server:
+ ::
+ $ oe-debuginfod
+2. To use debuginfod on the target, you need the following:
+- Ensure that these variable is set in your ``local.conf`` file:
+ ::
+ DEBUGINFOD_URLS = "http://localhost:port"
+ This option does the client configuration by setting DEBUGINFOD_URLS
+ to point at the server running debuginfod. Such that for every lookup,
+ the debuginfod client will query the server and return the requested information.
+ ::
+ PACKAGECONFIG_pn-gdb = "debuginfod"
+ This PACKAGECONFIG option enables debuginfod for gdb.
+Using the gdbserver Method
gdbserver, which runs on the remote target and does not load any
debugging information from the debugged process. Instead, a GDB instance
processes the debugging information that is run on a remote computer -

Join { to automatically receive all group messages.