From patchwork Wed Sep 12 23:37:06 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: John Baldwin X-Patchwork-Id: 29348 Received: (qmail 54459 invoked by alias); 12 Sep 2018 23:37:36 -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 54353 invoked by uid 89); 12 Sep 2018 23:37:35 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-25.1 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=socket, 569 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; Wed, 12 Sep 2018 23:37:34 +0000 Received: from ralph.com (ralph.baldwin.cx [66.234.199.215]) by mail.baldwin.cx (Postfix) with ESMTPSA id ED74A10B681 for ; Wed, 12 Sep 2018 19:37:31 -0400 (EDT) From: John Baldwin To: gdb-patches@sourceware.org Subject: [PATCH v2 5/6] Document the 'info proc files' command. Date: Wed, 12 Sep 2018 16:37:06 -0700 Message-Id: <20180912233707.43492-6-jhb@FreeBSD.org> In-Reply-To: <20180912233707.43492-1-jhb@FreeBSD.org> References: <20180912233707.43492-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 997c079218..fe515b2d0e 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,3 +1,7 @@ +2018-09-12 John Baldwin + + * NEWS: Mention 'info proc files' command. + 2018-09-12 John Baldwin * fbsd-nat.c (fbsd_nat_target::info_proc): List open file diff --git a/gdb/NEWS b/gdb/NEWS index 4e4f12d8d1..8efaafa1e1 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 f04dca4283..e327480af0 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2018-09-12 John Baldwin + + * gdb.texinfo (Process Information): Document "info proc files" + command. + 2018-09-12 Simon Marchi * gdb.texinfo (Skipping Over Functions and Files): Document diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index efbec3debf..e0e1379abd 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -22244,6 +22244,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