[v2,5/6] Document the 'info proc files' command.
Commit Message
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(+)
Comments
> From: John Baldwin <jhb@FreeBSD.org>
> Date: Wed, 12 Sep 2018 16:37:06 -0700
>
> gdb/ChangeLog:
>
> * NEWS: Mention 'info proc files' command.
>
> gdb/doc/ChangeLog:
>
> * gdb.texinfo (Process Information): Document "info proc files"
> command.
Thanks, this is OK.
@@ -1,3 +1,7 @@
+2018-09-12 John Baldwin <jhb@FreeBSD.org>
+
+ * NEWS: Mention 'info proc files' command.
+
2018-09-12 John Baldwin <jhb@FreeBSD.org>
* fbsd-nat.c (fbsd_nat_target::info_proc): List open file
@@ -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
@@ -1,3 +1,8 @@
+2018-09-12 John Baldwin <jhb@FreeBSD.org>
+
+ * gdb.texinfo (Process Information): Document "info proc files"
+ command.
+
2018-09-12 Simon Marchi <simon.marchi@ericsson.com>
* gdb.texinfo (Skipping Over Functions and Files): Document
@@ -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