From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by sourceware.org (Postfix) with ESMTPS id D442F3858C2F for ; Thu, 27 Jul 2023 12:04:13 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org D442F3858C2F Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1690459453; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=fzirWfQmzgvPAt/4osx5AodcYkILWTg6puhYXLEexxE=; b=S8+RTPTIZ/WohST76LEHT/yKvCUrb1iBOGaVuA4JS8o1K7QdkCSBi6F8XKlSuGe28M3FIC VwiWvo7606/mVi6ff9qpQai7x4qexJb3FcTNh5K8PEt5vBmgJ5OOMGJkjVgCBOsXY+7UzZ FuqgsNtz1mziEFHTWwTWIFQj98+ILH8= Received: from mail-wr1-f72.google.com (mail-wr1-f72.google.com [209.85.221.72]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-448-P-_GYt5kNRGi7mqAr18m7w-1; Thu, 27 Jul 2023 08:04:12 -0400 X-MC-Unique: P-_GYt5kNRGi7mqAr18m7w-1 Received: by mail-wr1-f72.google.com with SMTP id ffacd0b85a97d-314326f6e23so460914f8f.2 for ; Thu, 27 Jul 2023 05:04:11 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1690459451; x=1691064251; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=fzirWfQmzgvPAt/4osx5AodcYkILWTg6puhYXLEexxE=; b=bkQ9yFhigEn/Ra7z6IdOGZDUVKoQkYnt9BmE2Y9qSQAGeF/yxL1Tyv0G6n0lFtx2Dw iweMtZ5OZ3cxDc9aaA9UuacFkBxbXE3ySEd41mOW0EUa/gX5pTO6V/MP48mGPCeXjD58 tYTheK3uCvKr/79G//DnyP8Ho+p0P45DVeMOJI9tNGBRU0dgfd1euZkD/UNs4+9lN+Fq ND1kygyHWLSPGsmvv2FcKyz5JXzgz/GujGHYomb2TpOEMhHYTJaZ3SfML8l5NClykFZs f7u33lDOScJWGl1y7rL375FLNs3a/xB/jnKKwrGdOgwPEHJU7X2SD5aPrXi3Jdfwzw3d bF6g== X-Gm-Message-State: ABy/qLZhmiHUTbFEuVJ/OjvXIxRAxjisf176eLltA4UibwFEvpQNFhXN Cef3P9R8mf6cH/4RPrtyqxJrIZ5mqCTO+gjG4IJQn4kfPzXK1zrWtSLCTYm65+C3i4thmwCPBxa Hkyvfd4DuvouhmJj9Q+s9Dg== X-Received: by 2002:a5d:4dc5:0:b0:315:8f4f:81b1 with SMTP id f5-20020a5d4dc5000000b003158f4f81b1mr1424099wru.50.1690459450803; Thu, 27 Jul 2023 05:04:10 -0700 (PDT) X-Google-Smtp-Source: APBJJlFdraoDAOq25s0OZua8QeQwflWfP/DvjCFYR/AuABhz+j461BDRus3u32Rz5135CZ5wL1lCIA== X-Received: by 2002:a5d:4dc5:0:b0:315:8f4f:81b1 with SMTP id f5-20020a5d4dc5000000b003158f4f81b1mr1424067wru.50.1690459450135; Thu, 27 Jul 2023 05:04:10 -0700 (PDT) Received: from localhost (93.72.115.87.dyn.plus.net. [87.115.72.93]) by smtp.gmail.com with ESMTPSA id y23-20020a05600c365700b003fa8158135esm4559088wmq.11.2023.07.27.05.04.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 27 Jul 2023 05:04:09 -0700 (PDT) From: Andrew Burgess To: Aaron Merey , gdb-patches@sourceware.org Cc: Aaron Merey Subject: Re: [PATCH 2/6 v2] gdb: Add command 'maint set/show debuginfod download-sections' In-Reply-To: <20230601014347.3367489-3-amerey@redhat.com> References: <20230601014347.3367489-1-amerey@redhat.com> <20230601014347.3367489-3-amerey@redhat.com> Date: Thu, 27 Jul 2023 13:04:08 +0100 Message-ID: <877cqlftmv.fsf@redhat.com> MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain X-Spam-Status: No, score=-10.2 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,GIT_PATCH_0,RCVD_IN_BARRACUDACENTRAL,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H4,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE,TXREP,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: Aaron Merey writes: > v1: https://sourceware.org/pipermail/gdb-patches/2023-February/197461.html > > v2 removes 'set debuginfod enabled lazy' and replaces it with > 'maint set debuginfod download-sections'. > > Commit message: > > This setting controls whether GDB may attempt to download ELF/DWARF > sections from debuginfod servers. > > This setting is enabled by default if gdb is built with debuginfod > section download support (requires libdebuginfod 0.188). > > Also update debuginfod command help text and gdb.texinfo with > information on section downloading and the new command. > --- > gdb/debuginfod-support.c | 66 ++++++++++++++++++++++++++++++++++++++-- > gdb/doc/gdb.texinfo | 16 ++++++++-- > 2 files changed, 77 insertions(+), 5 deletions(-) > > diff --git a/gdb/debuginfod-support.c b/gdb/debuginfod-support.c > index 8be43a91dcc..6d0521b64e2 100644 > --- a/gdb/debuginfod-support.c > +++ b/gdb/debuginfod-support.c > @@ -31,6 +31,10 @@ > static cmd_list_element *set_debuginfod_prefix_list; > static cmd_list_element *show_debuginfod_prefix_list; > > +/* maint set/show debuginfod commands. */ > +static cmd_list_element *maint_set_debuginfod_cmdlist; > +static cmd_list_element *maint_show_debuginfod_cmdlist; > + > static const char debuginfod_on[] = "on"; > static const char debuginfod_off[] = "off"; > static const char debuginfod_ask[] = "ask"; > @@ -50,6 +54,13 @@ static const char *debuginfod_enabled = > debuginfod_off; > #endif > > +static bool debuginfod_download_sections = > +#if defined(HAVE_LIBDEBUGINFOD_FIND_SECTION) > + true; > +#else > + false; > +#endif > + > static unsigned int debuginfod_verbose = 1; > > #ifndef HAVE_LIBDEBUGINFOD > @@ -424,7 +435,7 @@ debuginfod_section_query (const unsigned char *build_id, > return scoped_fd (-ENOSYS); > #else > > - if (!debuginfod_is_enabled ()) > + if (!debuginfod_download_sections || !debuginfod_is_enabled ()) > return scoped_fd (-ENOSYS); > > debuginfod_client *c = get_debuginfod_client (); > @@ -550,6 +561,31 @@ show_debuginfod_verbose_command (ui_file *file, int from_tty, > value); > } > > +/* Set callback for "maint set debuginfod download-sections". */ > + > +static void > +maint_set_debuginfod_download_sections (bool value) > +{ > +#if !defined(HAVE_LIBDEBUGINFOD_FIND_SECTION) > + if (value) > + { > + error (_("Support for section downloading is not compiled into GDB. " \ > +"Defaulting to \"off\".")); > + return; > + } > +#endif > + > + debuginfod_download_sections = value; > +} > + > +/* Get callback for "maint set debuginfod download-sections". */ > + > +static bool > +maint_get_debuginfod_download_sections () > +{ > + return debuginfod_download_sections; > +} > + > /* Register debuginfod commands. */ > > void _initialize_debuginfod (); > @@ -568,8 +604,11 @@ _initialize_debuginfod () > _("Set whether to use debuginfod."), > _("Show whether to use debuginfod."), > _("\ > -When on, enable the use of debuginfod to download missing debug info and\n\ > -source files."), > +When set to \"on\", enable the use of debuginfod to download missing\n\ > +debug info and source files. GDB may also download components of debug\n\ > +info instead of entire files. \"off\" disables the use of debuginfod.\n\ > +When set to \"ask\", a prompt may ask whether to enable or disable\n\ > +debuginfod." ), > set_debuginfod_enabled, > get_debuginfod_enabled, > show_debuginfod_enabled, > @@ -600,4 +639,25 @@ query.\nTo disable, set to zero. Verbose output is displayed by default."), > show_debuginfod_verbose_command, > &set_debuginfod_prefix_list, > &show_debuginfod_prefix_list); > + > + /* maint set/show debuginfod */ > + add_setshow_prefix_cmd ("debuginfod", class_maintenance, > + _("Set debuginfod specific variables."), > + _("Show debuginfod specific variables."), > + &maint_set_debuginfod_cmdlist, > + &maint_show_debuginfod_cmdlist, > + &maintenance_set_cmdlist, &maintenance_show_cmdlist); > + > + /* maint set/show debuginfod download-sections */ > + add_setshow_boolean_cmd ("download-sections", class_maintenance, _("\ > +Set whether debuginfod may download individual ELF/DWARF sections."), _("\ > +Show whether debuginfod may download individual ELF/DWARF sections."), _("\ > +When enabled, debuginfod may attempt to download individual ELF/DWARF \ > +sections from debug info files.\nIf disabled, only whole debug info files \ > +may be downloaded."), > + maint_set_debuginfod_download_sections, > + maint_get_debuginfod_download_sections, > + nullptr, > + &maint_set_debuginfod_cmdlist, > + &maint_show_debuginfod_cmdlist); > } > diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo > index fc55c4e7b43..91da9777fd6 100644 > --- a/gdb/doc/gdb.texinfo > +++ b/gdb/doc/gdb.texinfo > @@ -40872,6 +40872,16 @@ Create a core file? (y or n) @kbd{n} > (@value{GDBP}) > @end smallexample > > +@kindex maint set debuginfod > +@kindex maint show debuginfod I think these should be: @kindex maint set debuginfod download-sections @kindex maint show debuginfod download-sections Other places in the manual where we have multi "level" commands like this, all levels seem to be included in the @kindex entry. Thanks, Andrew > +@item maint set debuginfod download-sections > +@itemx maint set debuginfod download-sections @r{[}on|off@r{]} > +@itemx maint show debuginfod download-sections > +Controls whether @value{GDBN} will attempt to download individual > +ELF/DWARF sections from @code{debuginfod}. If disabled, only > +whole debug info files will be downloaded. This could result > +in @value{GDBN} downloading larger amounts of data. > + > @cindex @value{GDBN} internal error > @cindex internal errors, control of @value{GDBN} behavior > @cindex demangler crashes > @@ -49382,8 +49392,10 @@ regarding @code{debuginfod}. > @item set debuginfod enabled > @itemx set debuginfod enabled on > @cindex enable debuginfod > -@value{GDBN} will attempt to query @code{debuginfod} servers when missing debug > -info or source files. > +@value{GDBN} will attempt to query @code{debuginfod} servers for missing debug > +info or source files. @value{GDBN} may attempt to download individual ELF/DWARF > +sections such as @code{.gdb_index} to help reduce the total amount of data > +downloaded from debuginfod servers. > > @item set debuginfod enabled off > @value{GDBN} will not attempt to query @code{debuginfod} servers when missing > -- > 2.40.1