From patchwork Tue Sep 18 18:54:43 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: John Baldwin X-Patchwork-Id: 29442 Received: (qmail 101289 invoked by alias); 18 Sep 2018 18:55:19 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Delivered-To: mailing list gdb-patches@sourceware.org Received: (qmail 100996 invoked by uid 89); 18 Sep 2018 18:55:17 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-25.2 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, SPF_HELO_PASS, SPF_SOFTFAIL autolearn=ham version=3.3.2 spammy=connections X-HELO: mail.baldwin.cx Received: from bigwig.baldwin.cx (HELO mail.baldwin.cx) (96.47.65.170) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 18 Sep 2018 18:55:15 +0000 Received: from ralph.com (ralph.baldwin.cx [66.234.199.215]) by mail.baldwin.cx (Postfix) with ESMTPSA id 40D4510B709 for ; Tue, 18 Sep 2018 14:55:13 -0400 (EDT) From: John Baldwin To: gdb-patches@sourceware.org Subject: [PATCH v3 7/8] Document the 'info proc files' command. Date: Tue, 18 Sep 2018 11:54:43 -0700 Message-Id: <20180918185444.89533-8-jhb@FreeBSD.org> In-Reply-To: <20180918185444.89533-1-jhb@FreeBSD.org> References: <20180918185444.89533-1-jhb@FreeBSD.org> X-IsSubscribed: yes gdb/ChangeLog: * NEWS: Mention 'info proc files' command. gdb/doc/ChangeLog: * gdb.texinfo (Process Information): Document "info proc files" command. --- gdb/ChangeLog | 4 ++++ gdb/NEWS | 3 +++ gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 30 ++++++++++++++++++++++++++++++ 4 files changed, 42 insertions(+) diff --git a/gdb/ChangeLog b/gdb/ChangeLog index 0649464fba..5ae5a2dbee 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,3 +1,7 @@ +2018-09-17 John Baldwin + + * NEWS: Mention 'info proc files' command. + 2018-09-17 John Baldwin * fbsd-nat.c (fbsd_nat_target::info_proc): List open file diff --git a/gdb/NEWS b/gdb/NEWS index 2a89569bdb..a1936ca1cc 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -56,6 +56,9 @@ maint set dwarf unwinders (on|off) maint show dwarf unwinders Control whether DWARF unwinders can be used. +info proc files + Display a list of open files for a process. + * Changed commands thread apply [all | COUNT | -COUNT] [FLAG]... COMMAND diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index dc8f39293f..2128923515 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2018-09-17 John Baldwin + + * gdb.texinfo (Process Information): Document "info proc files" + command. + 2018-09-17 Tom Tromey * gdb.texinfo (Index Files): Update for cache directory change on diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 96fa77d9ab..233af61405 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -22248,6 +22248,36 @@ supported on @sc{gnu}/Linux and FreeBSD. Show the name of executable of the process. This command is supported on @sc{gnu}/Linux and FreeBSD. +@item info proc files +@cindex info proc files +Show the file descriptors open by the process. For each open file +descriptor, @value{GDBN} shows its number, type (file, directory, +character device, socket), file pointer offset, and the name of the +resource open on the descriptor. The resource name can be a file name +(for files, directories, and devices) or a protocol followed by socket +address (for network connections). This command is supported on +FreeBSD. + +This example shows the open file descriptors for a process using a +tty for standard input and output as well as two network sockets: + +@smallexample +(gdb) info proc files 22136 +process 22136 +Open files: + + FD Type Offset Flags Name + text file - r-------- /usr/bin/ssh + ctty chr - rw------- /dev/pts/20 + cwd dir - r-------- /usr/home/john + root dir - r-------- / + 0 chr 0x32933a4 rw------- /dev/pts/20 + 1 chr 0x32933a4 rw------- /dev/pts/20 + 2 chr 0x32933a4 rw------- /dev/pts/20 + 3 socket 0x0 rw----n-- tcp4 10.0.1.2:53014 -> 10.0.1.10:22 + 4 socket 0x0 rw------- unix stream:/tmp/ssh-FIt89oAzOn5f/agent.2456 +@end smallexample + @item info proc mappings @cindex memory address space mappings Report the memory address space ranges accessible in the program. On