From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id /TQWHJPmsWLgBgQAWB0awg (envelope-from ) for ; Tue, 21 Jun 2022 11:41:07 -0400 Received: by simark.ca (Postfix, from userid 112) id 612D51E225; Tue, 21 Jun 2022 11:41:07 -0400 (EDT) Authentication-Results: simark.ca; dkim=pass (1024-bit key; secure) header.d=sourceware.org header.i=@sourceware.org header.a=rsa-sha256 header.s=default header.b=e4BSiP4m; dkim-atps=neutral X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-2.0 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI,RDNS_DYNAMIC,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 Received: from sourceware.org (ip-8-43-85-97.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id EDD601E15C for ; Tue, 21 Jun 2022 11:41:06 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 2E789385627C for ; Tue, 21 Jun 2022 15:41:06 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 2E789385627C DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1655826066; bh=Q259hnD6hEbf9CXMy1BAI8UD380rOV3ZFIJk8IoJANs=; h=Date:To:Subject:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To: From; b=e4BSiP4mi+7a1l0StfKRFBSqzEV/334RahQ2vlWPnwAMFIAbvaXK+ruUTIEqZ+xpI hwE07y8tphZCl+MeO8yKWo5rXHg+OsuLkPDncyrO7Puy4QmGxtRG4Xqg3oys8Dip0E 6hllhz8mCChg7jIoY0NRTUxasBniEcaF5PP/Kr+Q= Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTPS id 24D993858C74 for ; Tue, 21 Jun 2022 15:40:47 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 24D993858C74 Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-637-mXZkV1VCPxm4W6_6OMlWbg-1; Tue, 21 Jun 2022 11:40:45 -0400 X-MC-Unique: mXZkV1VCPxm4W6_6OMlWbg-1 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.rdu2.redhat.com [10.11.54.3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 2D212801756; Tue, 21 Jun 2022 15:40:45 +0000 (UTC) Received: from f35-zws-1 (unknown [10.2.16.89]) by smtp.corp.redhat.com (Postfix) with ESMTPS id DEF771121314; Tue, 21 Jun 2022 15:40:44 +0000 (UTC) Date: Tue, 21 Jun 2022 08:40:43 -0700 To: gdb-patches@sourceware.org Subject: Re: [PATCH v2] Document how GDB searches for files when using -s, -e, and -se options Message-ID: <20220621084043.49043b1d@f35-zws-1> In-Reply-To: <20220603170443.192296-1-kevinb@redhat.com> References: <20220603170443.192296-1-kevinb@redhat.com> Organization: Red Hat MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.78 on 10.11.54.3 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , From: Kevin Buettner via Gdb-patches Reply-To: Kevin Buettner Errors-To: gdb-patches-bounces+public-inbox=simark.ca@sourceware.org Sender: "Gdb-patches" Ping. On Fri, 3 Jun 2022 10:04:43 -0700 Kevin Buettner wrote: > GDB's documentation of the 'file' command says: > > If you do not specify a directory and the file is not found in the > GDB working directory, GDB uses the environment variable PATH as a > list of directories to search, just as the shell does when looking > for a program to run. > > The same is true for files specified via commandline options -s, -e, > and -se. > > This commit adds a cross reference to the file command for these options. > --- > gdb/doc/gdb.texinfo | 5 +++++ > 1 file changed, 5 insertions(+) > > diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo > index 5f09f3a1433..aad7c79c248 100644 > --- a/gdb/doc/gdb.texinfo > +++ b/gdb/doc/gdb.texinfo > @@ -962,6 +962,11 @@ If @value{GDBN} has not been configured to included core file support, > such as for most embedded targets, then it will complain about a second > argument and ignore it. > > +For the @samp{-s}, @samp{-e}, and @samp{-se} options, and their long > +form equivalents, the method used to search the file system for the > +symbol and/or executable file is the same as that used by the > +@code{file} command. @xref{Files, ,file}. > + > Many options have both long and short forms; both are shown in the > following list. @value{GDBN} also recognizes the long forms if you truncate > them, so long as enough of the option is present to be unambiguous. > -- > 2.35.3 >