1 /* debuginfod utilities for GDB.
2 Copyright (C) 2020-2022 Free Software Foundation, Inc.
4 This file is part of GDB.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>. */
21 #include "gdbsupport/scoped_fd.h"
22 #include "debuginfod-support.h"
23 #include "gdbsupport/gdb_optional.h"
24 #include "cli/cli-cmds.h"
25 #include "cli/cli-style.h"
28 /* Set/show debuginfod commands. */
29 static cmd_list_element
*set_debuginfod_prefix_list
;
30 static cmd_list_element
*show_debuginfod_prefix_list
;
32 static const char debuginfod_on
[] = "on";
33 static const char debuginfod_off
[] = "off";
34 static const char debuginfod_ask
[] = "ask";
36 static const char *debuginfod_enabled_enum
[] =
44 static const char *debuginfod_enabled
=
45 #if defined(HAVE_LIBDEBUGINFOD)
51 static unsigned int debuginfod_verbose
= 1;
53 #ifndef HAVE_LIBDEBUGINFOD
55 debuginfod_source_query (const unsigned char *build_id
,
58 gdb::unique_xmalloc_ptr
<char> *destname
)
60 return scoped_fd (-ENOSYS
);
64 debuginfod_debuginfo_query (const unsigned char *build_id
,
67 gdb::unique_xmalloc_ptr
<char> *destname
)
69 return scoped_fd (-ENOSYS
);
73 debuginfod_exec_query (const unsigned char *build_id
,
76 gdb::unique_xmalloc_ptr
<char> *destname
)
78 return scoped_fd (-ENOSYS
);
81 #define NO_IMPL _("Support for debuginfod is not compiled into GDB.")
84 #include <elfutils/debuginfod.h>
88 user_data (const char *desc
, const char *fname
)
89 : desc (desc
), fname (fname
), has_printed (false)
92 const char * const desc
;
93 const char * const fname
;
97 /* Deleter for a debuginfod_client. */
99 struct debuginfod_client_deleter
101 void operator() (debuginfod_client
*c
)
107 using debuginfod_client_up
108 = std::unique_ptr
<debuginfod_client
, debuginfod_client_deleter
>;
111 progressfn (debuginfod_client
*c
, long cur
, long total
)
113 user_data
*data
= static_cast<user_data
*> (debuginfod_get_user_data (c
));
114 gdb_assert (data
!= nullptr);
116 if (check_quit_flag ())
118 gdb_printf ("Cancelling download of %s %ps...\n",
120 styled_string (file_name_style
.style (), data
->fname
));
124 if (!data
->has_printed
)
126 /* Include the transfer size, if available. */
129 float size
= 1.0f
* total
/ 1024;
130 const char *unit
= "KB";
132 /* If size is greater than 0.01 MB, set unit to MB. */
139 gdb_printf ("Downloading %.2f %s %s %ps...\n",
140 size
, unit
, data
->desc
,
141 styled_string (file_name_style
.style (),
145 gdb_printf ("Downloading %s %ps...\n", data
->desc
,
146 styled_string (file_name_style
.style (), data
->fname
));
148 data
->has_printed
= true;
154 static debuginfod_client
*
155 get_debuginfod_client ()
157 static debuginfod_client_up global_client
;
159 if (global_client
== nullptr)
161 global_client
.reset (debuginfod_begin ());
163 if (global_client
!= nullptr)
164 debuginfod_set_progressfn (global_client
.get (), progressfn
);
167 return global_client
.get ();
170 /* Check if debuginfod is enabled. If configured to do so, ask the user
171 whether to enable debuginfod. */
174 debuginfod_is_enabled ()
176 const char *urls
= getenv (DEBUGINFOD_URLS_ENV_VAR
);
178 if (urls
== nullptr || urls
[0] == '\0'
179 || debuginfod_enabled
== debuginfod_off
)
182 if (debuginfod_enabled
== debuginfod_ask
)
184 gdb_printf (_("\nThis GDB supports auto-downloading debuginfo " \
185 "from the following URLs:\n"));
187 gdb::string_view
url_view (urls
);
190 size_t off
= url_view
.find_first_not_of (' ');
191 if (off
== gdb::string_view::npos
)
193 url_view
= url_view
.substr (off
);
194 off
= url_view
.find_first_of (' ');
197 styled_string (file_name_style
.style (),
198 gdb::to_string (url_view
.substr (0,
200 if (off
== gdb::string_view::npos
)
202 url_view
= url_view
.substr (off
);
205 int resp
= nquery (_("Enable debuginfod for this session? "));
208 gdb_printf (_("Debuginfod has been disabled.\nTo make this " \
209 "setting permanent, add \'set debuginfod " \
210 "enabled off\' to .gdbinit.\n"));
211 debuginfod_enabled
= debuginfod_off
;
215 gdb_printf (_("Debuginfod has been enabled.\nTo make this " \
216 "setting permanent, add \'set debuginfod enabled " \
217 "on\' to .gdbinit.\n"));
218 debuginfod_enabled
= debuginfod_on
;
224 /* See debuginfod-support.h */
227 debuginfod_source_query (const unsigned char *build_id
,
230 gdb::unique_xmalloc_ptr
<char> *destname
)
232 if (!debuginfod_is_enabled ())
233 return scoped_fd (-ENOSYS
);
235 debuginfod_client
*c
= get_debuginfod_client ();
238 return scoped_fd (-ENOMEM
);
240 char *dname
= nullptr;
241 user_data
data ("source file", srcpath
);
243 debuginfod_set_user_data (c
, &data
);
244 gdb::optional
<target_terminal::scoped_restore_terminal_state
> term_state
;
245 if (target_supports_terminal_ours ())
247 term_state
.emplace ();
248 target_terminal::ours ();
251 scoped_fd
fd (debuginfod_find_source (c
,
256 debuginfod_set_user_data (c
, nullptr);
258 if (fd
.get () < 0 && fd
.get () != -ENOENT
)
259 gdb_printf (_("Download failed: %s. Continuing without source file %ps.\n"),
260 safe_strerror (-fd
.get ()),
261 styled_string (file_name_style
.style (), srcpath
));
264 destname
->reset (dname
);
269 /* See debuginfod-support.h */
272 debuginfod_debuginfo_query (const unsigned char *build_id
,
274 const char *filename
,
275 gdb::unique_xmalloc_ptr
<char> *destname
)
277 if (!debuginfod_is_enabled ())
278 return scoped_fd (-ENOSYS
);
280 debuginfod_client
*c
= get_debuginfod_client ();
283 return scoped_fd (-ENOMEM
);
285 char *dname
= nullptr;
286 user_data
data ("separate debug info for", filename
);
288 debuginfod_set_user_data (c
, &data
);
289 gdb::optional
<target_terminal::scoped_restore_terminal_state
> term_state
;
290 if (target_supports_terminal_ours ())
292 term_state
.emplace ();
293 target_terminal::ours ();
296 scoped_fd
fd (debuginfod_find_debuginfo (c
, build_id
, build_id_len
,
298 debuginfod_set_user_data (c
, nullptr);
300 if (fd
.get () < 0 && fd
.get () != -ENOENT
)
301 gdb_printf (_("Download failed: %s. Continuing without debug info for %ps.\n"),
302 safe_strerror (-fd
.get ()),
303 styled_string (file_name_style
.style (), filename
));
306 destname
->reset (dname
);
311 /* See debuginfod-support.h */
314 debuginfod_exec_query (const unsigned char *build_id
,
316 const char *filename
,
317 gdb::unique_xmalloc_ptr
<char> *destname
)
319 if (!debuginfod_is_enabled ())
320 return scoped_fd (-ENOSYS
);
322 debuginfod_client
*c
= get_debuginfod_client ();
325 return scoped_fd (-ENOMEM
);
327 char *dname
= nullptr;
328 user_data
data ("executable for", filename
);
330 debuginfod_set_user_data (c
, &data
);
331 gdb::optional
<target_terminal::scoped_restore_terminal_state
> term_state
;
332 if (target_supports_terminal_ours ())
334 term_state
.emplace ();
335 target_terminal::ours ();
338 scoped_fd
fd (debuginfod_find_executable (c
, build_id
, build_id_len
, &dname
));
339 debuginfod_set_user_data (c
, nullptr);
341 if (fd
.get () < 0 && fd
.get () != -ENOENT
)
342 gdb_printf (_("Download failed: %s. " \
343 "Continuing without executable for %ps.\n"),
344 safe_strerror (-fd
.get ()),
345 styled_string (file_name_style
.style (), filename
));
348 destname
->reset (dname
);
354 /* Set callback for "set debuginfod enabled". */
357 set_debuginfod_enabled (const char *value
)
359 #if defined(HAVE_LIBDEBUGINFOD)
360 debuginfod_enabled
= value
;
366 /* Get callback for "set debuginfod enabled". */
369 get_debuginfod_enabled ()
371 return debuginfod_enabled
;
374 /* Show callback for "set debuginfod enabled". */
377 show_debuginfod_enabled (ui_file
*file
, int from_tty
, cmd_list_element
*cmd
,
381 _("Debuginfod functionality is currently set to "
382 "\"%s\".\n"), debuginfod_enabled
);
385 /* Set callback for "set debuginfod urls". */
388 set_debuginfod_urls (const std::string
&urls
)
390 #if defined(HAVE_LIBDEBUGINFOD)
391 if (setenv (DEBUGINFOD_URLS_ENV_VAR
, urls
.c_str (), 1) != 0)
392 warning (_("Unable to set debuginfod URLs: %s"), safe_strerror (errno
));
398 /* Get callback for "set debuginfod urls". */
400 static const std::string
&
401 get_debuginfod_urls ()
403 static std::string urls
;
404 #if defined(HAVE_LIBDEBUGINFOD)
405 const char *envvar
= getenv (DEBUGINFOD_URLS_ENV_VAR
);
407 if (envvar
!= nullptr)
416 /* Show callback for "set debuginfod urls". */
419 show_debuginfod_urls (ui_file
*file
, int from_tty
, cmd_list_element
*cmd
,
422 if (value
[0] == '\0')
423 gdb_printf (file
, _("Debuginfod URLs have not been set.\n"));
425 gdb_printf (file
, _("Debuginfod URLs are currently set to:\n%s\n"),
429 /* Show callback for "set debuginfod verbose". */
432 show_debuginfod_verbose_command (ui_file
*file
, int from_tty
,
433 cmd_list_element
*cmd
, const char *value
)
435 gdb_printf (file
, _("Debuginfod verbose output is set to %s.\n"),
439 /* Register debuginfod commands. */
441 void _initialize_debuginfod ();
443 _initialize_debuginfod ()
445 /* set/show debuginfod */
446 add_setshow_prefix_cmd ("debuginfod", class_run
,
447 _("Set debuginfod options."),
448 _("Show debuginfod options."),
449 &set_debuginfod_prefix_list
,
450 &show_debuginfod_prefix_list
,
451 &setlist
, &showlist
);
453 add_setshow_enum_cmd ("enabled", class_run
, debuginfod_enabled_enum
,
454 _("Set whether to use debuginfod."),
455 _("Show whether to use debuginfod."),
457 When on, enable the use of debuginfod to download missing debug info and\n\
459 set_debuginfod_enabled
,
460 get_debuginfod_enabled
,
461 show_debuginfod_enabled
,
462 &set_debuginfod_prefix_list
,
463 &show_debuginfod_prefix_list
);
465 /* set/show debuginfod urls */
466 add_setshow_string_noescape_cmd ("urls", class_run
, _("\
467 Set the list of debuginfod server URLs."), _("\
468 Show the list of debuginfod server URLs."), _("\
469 Manage the space-separated list of debuginfod server URLs that GDB will query \
470 when missing debuginfo, executables or source files.\nThe default value is \
471 copied from the DEBUGINFOD_URLS environment variable."),
474 show_debuginfod_urls
,
475 &set_debuginfod_prefix_list
,
476 &show_debuginfod_prefix_list
);
478 /* set/show debuginfod verbose */
479 add_setshow_zuinteger_cmd ("verbose", class_support
,
480 &debuginfod_verbose
, _("\
481 Set verbosity of debuginfod output."), _("\
482 Show debuginfod debugging."), _("\
483 When set to a non-zero value, display verbose output for each debuginfod \
484 query.\nTo disable, set to zero. Verbose output is displayed by default."),
486 show_debuginfod_verbose_command
,
487 &set_debuginfod_prefix_list
,
488 &show_debuginfod_prefix_list
);