aboutsummaryrefslogtreecommitdiff
path: root/gdb
diff options
context:
space:
mode:
authorJohn Baldwin <jhb@FreeBSD.org>2018-09-18 14:05:48 -0700
committerJohn Baldwin <jhb@FreeBSD.org>2018-09-18 14:05:48 -0700
commit8b11311136c0acb5c4d3fbc9c1c92f259feb6beb (patch)
tree5909b0ae4bb89cf3fa52e196435f46a3c053ae63 /gdb
parent7e69672e4dfa532607e4ecef99623680264a87b3 (diff)
downloadgdb-8b11311136c0acb5c4d3fbc9c1c92f259feb6beb.zip
gdb-8b11311136c0acb5c4d3fbc9c1c92f259feb6beb.tar.gz
gdb-8b11311136c0acb5c4d3fbc9c1c92f259feb6beb.tar.bz2
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.
Diffstat (limited to 'gdb')
-rw-r--r--gdb/ChangeLog4
-rw-r--r--gdb/NEWS3
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdb.texinfo30
4 files changed, 42 insertions, 0 deletions
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 <jhb@FreeBSD.org>
+ * NEWS: Mention 'info proc files' command.
+
+2018-09-18 John Baldwin <jhb@FreeBSD.org>
+
* 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 <jhb@FreeBSD.org>
+
+ * gdb.texinfo (Process Information): Document "info proc files"
+ command.
+
2018-09-17 Tom Tromey <tom@tromey.com>
* 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