/* debuginfod utilities for GDB. Copyright (C) 2020-2021 Free Software Foundation, Inc. This file is part of GDB. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ #include "defs.h" #include #include "gdbsupport/scoped_fd.h" #include "debuginfod-support.h" #include "gdbsupport/gdb_optional.h" #include "cli/cli-cmds.h" #include "cli/cli-style.h" /* Set/show debuginfod commands. */ static cmd_list_element *set_debuginfod_prefix_list; static cmd_list_element *show_debuginfod_prefix_list; static const char debuginfod_on[] = "on"; static const char debuginfod_off[] = "off"; static const char debuginfod_ask[] = "ask"; static const char *debuginfod_enable = debuginfod_ask; static unsigned debuginfod_verbose = 1; #ifndef HAVE_LIBDEBUGINFOD scoped_fd debuginfod_source_query (const unsigned char *build_id, int build_id_len, const char *srcpath, gdb::unique_xmalloc_ptr *destname) { return scoped_fd (-ENOSYS); } scoped_fd debuginfod_debuginfo_query (const unsigned char *build_id, int build_id_len, const char *filename, gdb::unique_xmalloc_ptr *destname) { return scoped_fd (-ENOSYS); } #define NO_IMPL _("Support for debuginfod is not compiled into GDB.") /* Stub set/show commands that indicate debuginfod is not supported. */ static void set_debuginfod_on_command (const char *args, int from_tty) { error (NO_IMPL); debuginfod_enable = debuginfod_off; } static void set_debuginfod_off_command (const char *args, int from_tty) { error (NO_IMPL); debuginfod_enable = debuginfod_off; } static void set_debuginfod_ask_command (const char *args, int from_tty) { error (NO_IMPL); debuginfod_enable = debuginfod_off; } static void show_debuginfod_status_command (const char *args, int from_tty) { error (NO_IMPL); } static void set_debuginfod_urls_command (const std::string& urls) { error (NO_IMPL); } static const std::string& get_debuginfod_urls_command () { static std::string empty; return empty; } static void show_debuginfod_urls_command (struct ui_file *file, int from_tty, struct cmd_list_element *cmd, const char *value) { error (NO_IMPL); } static void set_debuginfod_verbose_command (const char *args, int from_tty, struct cmd_list_element *c) { error (NO_IMPL); debuginfod_verbose = 0; } static void show_debuginfod_verbose_command (struct ui_file *file, int from_tty, struct cmd_list_element *cmd, const char *value) { error (NO_IMPL); } #else #include struct user_data { user_data (const char *desc, const char *fname) : desc (desc), fname (fname) { } const char * const desc; const char * const fname; gdb::optional meter; }; /* Deleter for a debuginfod_client. */ struct debuginfod_client_deleter { void operator() (debuginfod_client *c) { debuginfod_end (c); } }; using debuginfod_client_up = std::unique_ptr; /* Enable debuginfod. */ static void set_debuginfod_on_command (const char *args, int from_tty) { debuginfod_enable = debuginfod_on; } /* Disable debuginfod. */ static void set_debuginfod_off_command (const char *args, int from_tty) { debuginfod_enable = debuginfod_off; } /* Before next query, ask user whether to enable debuginfod. */ static void set_debuginfod_ask_command (const char *args, int from_tty) { debuginfod_enable = debuginfod_ask; } /* Show whether debuginfod is enabled. */ static void show_debuginfod_status_command (const char *args, int from_tty) { printf_unfiltered (_("Debuginfod functionality is currently set to " \ "\"%s\".\n"), debuginfod_enable); } /* Set the URLs that debuginfod will query. */ static void set_debuginfod_urls_command (const std::string& urls) { if (setenv ("DEBUGINFOD_URLS", urls.c_str (), 1) != 0) warning (_("Unable to set debuginfod URLs: %s"), safe_strerror (errno)); } /* Get current debuginfod URLs. */ static const std::string& get_debuginfod_urls_command () { static std::string urls; const char *envvar = getenv (DEBUGINFOD_URLS_ENV_VAR); if (envvar != nullptr) urls = envvar; else urls.clear (); return urls; } /* Show the URLs that debuginfod will query. */ static void show_debuginfod_urls_command (struct ui_file *file, int from_tty, struct cmd_list_element *cmd, const char *value) { if (value == nullptr || value[0] == '\0') fprintf_unfiltered (file, _("Debuginfod URLs have not been set.\n")); else fprintf_filtered (file, _("Debuginfod URLs are currently set to:\n%s\n"), value); } /* No-op setter used for compatibility when gdb is built without debuginfod. */ static void set_debuginfod_verbose_command (const char *args, int from_tty, struct cmd_list_element *c) { return; } /* Show verbosity. */ static void show_debuginfod_verbose_command (struct ui_file *file, int from_tty, struct cmd_list_element *cmd, const char *value) { fprintf_filtered (file, _("Debuginfod verbose output is set to %s.\n"), value); } static int progressfn (debuginfod_client *c, long cur, long total) { user_data *data = static_cast (debuginfod_get_user_data (c)); gdb_assert (data != nullptr); if (check_quit_flag ()) { printf_filtered ("Cancelling download of %s %ps...\n", data->desc, styled_string (file_name_style.style (), data->fname)); return 1; } if (total == 0) return 0; if (!data->meter.has_value ()) { float size_in_mb = 1.0f * total / (1024 * 1024); string_file styled_filename (current_uiout->can_emit_style_escape ()); fprintf_styled (&styled_filename, file_name_style.style (), "%s", data->fname); std::string message = string_printf ("Downloading %.2f MB %s %s", size_in_mb, data->desc, styled_filename.c_str()); data->meter.emplace (current_uiout, message, 1); } current_uiout->progress ((double)cur / (double)total); return 0; } static debuginfod_client * get_debuginfod_client () { static debuginfod_client_up global_client; if (global_client == nullptr) { global_client.reset (debuginfod_begin ()); if (global_client != nullptr) debuginfod_set_progressfn (global_client.get (), progressfn); } return global_client.get (); } /* Check if debuginfod is enabled. If configured to do so, ask the user whether to enable debuginfod. */ static bool debuginfod_enabled () { const char *urls = getenv (DEBUGINFOD_URLS_ENV_VAR); if (urls == nullptr || urls[0] == '\0' || debuginfod_enable == debuginfod_off) return false; if (debuginfod_enable == debuginfod_ask) { int resp = nquery (_("\nThis GDB supports auto-downloading debuginfo " \ "from the following URLs:\n%s\nEnable debuginfod " \ "for this session? "), urls); if (!resp) { printf_filtered (_("Debuginfod has been disabled.\nTo make this " \ "setting permanent, add \'set debuginfod off\' " \ "to .gdbinit.\n")); debuginfod_enable = debuginfod_off; return false; } printf_filtered (_("Debuginfod has been enabled.\nTo make this " \ "setting permanent, add \'set debuginfod on\' " \ "to .gdbinit.\n")); debuginfod_enable = debuginfod_on; } return true; } /* See debuginfod-support.h */ scoped_fd debuginfod_source_query (const unsigned char *build_id, int build_id_len, const char *srcpath, gdb::unique_xmalloc_ptr *destname) { if (!debuginfod_enabled ()) return scoped_fd (-ENOSYS); debuginfod_client *c = get_debuginfod_client (); if (c == nullptr) return scoped_fd (-ENOMEM); user_data data ("source file", srcpath); debuginfod_set_user_data (c, &data); scoped_fd fd (debuginfod_find_source (c, build_id, build_id_len, srcpath, nullptr)); debuginfod_set_user_data (c, nullptr); if (debuginfod_verbose > 0 && fd.get () < 0 && fd.get () != -ENOENT) printf_filtered (_("Download failed: %s. Continuing without source file %ps.\n"), safe_strerror (-fd.get ()), styled_string (file_name_style.style (), srcpath)); if (fd.get () >= 0) *destname = make_unique_xstrdup (srcpath); return fd; } /* See debuginfod-support.h */ scoped_fd debuginfod_debuginfo_query (const unsigned char *build_id, int build_id_len, const char *filename, gdb::unique_xmalloc_ptr *destname) { if (!debuginfod_enabled ()) return scoped_fd (-ENOSYS); debuginfod_client *c = get_debuginfod_client (); if (c == nullptr) return scoped_fd (-ENOMEM); char *dname = nullptr; user_data data ("separate debug info for", filename); debuginfod_set_user_data (c, &data); scoped_fd fd (debuginfod_find_debuginfo (c, build_id, build_id_len, &dname)); debuginfod_set_user_data (c, nullptr); if (debuginfod_verbose > 0 && fd.get () < 0 && fd.get () != -ENOENT) printf_filtered (_("Download failed: %s. Continuing without debug info for %ps.\n"), safe_strerror (-fd.get ()), styled_string (file_name_style.style (), filename)); if (fd.get () >= 0) destname->reset (dname); return fd; } #endif /* Register debuginfod commands. */ void _initialize_debuginfod (); void _initialize_debuginfod () { /* set/show debuginfod */ add_setshow_prefix_cmd ("debuginfod", class_run, _("Set debuginfod options."), _("Show debuginfod options."), &set_debuginfod_prefix_list, &show_debuginfod_prefix_list, &setlist, &showlist); /* set debuginfod on */ add_cmd ("on", class_run, set_debuginfod_on_command, _("Enable debuginfod."), &set_debuginfod_prefix_list); /* set debuginfod off */ add_cmd ("off", class_run, set_debuginfod_off_command, _("Disable debuginfod."), &set_debuginfod_prefix_list); /* set debuginfod ask */ add_cmd ("ask", class_run, set_debuginfod_ask_command, _("\ Ask the user whether to enable debuginfod before performing the next query."), &set_debuginfod_prefix_list); /* show debuginfod status */ add_cmd ("status", class_run, show_debuginfod_status_command, _("Show whether debuginfod is set to \"on\", \"off\" or \"ask\"."), &show_debuginfod_prefix_list); /* set/show debuginfod urls */ add_setshow_string_noescape_cmd ("urls", class_run, _("\ Set the list of debuginfod server URLs."), _("\ Show the list of debuginfod server URLs."), _("\ Manage the space-separated list of debuginfod server URLs that GDB will query \ when missing debuginfo, executables or source files.\nThe default value is \ copied from the DEBUGINFOD_URLS environment variable."), set_debuginfod_urls_command, get_debuginfod_urls_command, show_debuginfod_urls_command, &set_debuginfod_prefix_list, &show_debuginfod_prefix_list); /* set/show debuginfod verbose */ add_setshow_zuinteger_cmd ("verbose", class_support, &debuginfod_verbose, _("\ Set verbosity of debuginfod output."), _("\ Show debuginfod debugging."), _("\ When set to a non-zero value, display verbose output for each debuginfod \ query.\nTo disable, set to zero. Verbose output is displayed by default."), set_debuginfod_verbose_command, show_debuginfod_verbose_command, &set_debuginfod_prefix_list, &show_debuginfod_prefix_list); }