From 8b11311136c0acb5c4d3fbc9c1c92f259feb6beb Mon Sep 17 00:00:00 2001 From: John Baldwin Date: Tue, 18 Sep 2018 14:05:48 -0700 Subject: [PATCH] Document the 'info proc files' command. 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 88406c7..6779276 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,5 +1,9 @@ 2018-09-18 John Baldwin + * NEWS: Mention 'info proc files' command. + +2018-09-18 John Baldwin + * fbsd-nat.c (fbsd_nat_target::info_proc): List open file descriptors for IP_FILES and IP_ALL. diff --git a/gdb/NEWS b/gdb/NEWS index 2a89569..a1936ca 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 dc8f392..f416fc3 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2018-09-18 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 96fa77d..233af61 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 -- 2.7.4