From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1028) id 85A623858C51; Tue, 21 Jun 2022 16:47:58 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 85A623858C51 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: Kevin Buettner To: gdb-cvs@sourceware.org Subject: [binutils-gdb] Document how GDB searches for files when using -s, -e, and -se options X-Act-Checkin: binutils-gdb X-Git-Author: Kevin Buettner X-Git-Refname: refs/heads/master X-Git-Oldrev: ec41dd75c866599fc03c390c6afb5736c159c0ff X-Git-Newrev: bfda149dc1b0376f8cb4c423790246794c7ee873 Message-Id: <20220621164758.85A623858C51@sourceware.org> Date: Tue, 21 Jun 2022 16:47:58 +0000 (GMT) X-BeenThere: gdb-cvs@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Jun 2022 16:47:58 -0000 https://sourceware.org/git/gitweb.cgi?p=3Dbinutils-gdb.git;h=3Dbfda149dc1b0= 376f8cb4c423790246794c7ee873 commit bfda149dc1b0376f8cb4c423790246794c7ee873 Author: Kevin Buettner Date: Thu Jun 2 15:26:38 2022 -0700 Document how GDB searches for files when using -s, -e, and -se options =20 GDB's documentation of the 'file' command says: =20 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. =20 The same is true for files specified via commandline options -s, -e, and -se. =20 This commit adds a cross reference to the file command for these option= s. Diff: --- gdb/doc/gdb.texinfo | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index b3e995f166b..38ae249f62d 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -962,6 +962,11 @@ If @value{GDBN} has not been configured to included co= re file support, such as for most embedded targets, then it will complain about a second argument and ignore it. =20 +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 trunca= te them, so long as enough of the option is present to be unambiguous.