From: John Baldwin Date: Tue, 18 Sep 2018 21:05:48 +0000 (-0700) Subject: Document the 'info proc files' command. X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=8b11311136c0acb5c4d3fbc9c1c92f259feb6beb;p=binutils-gdb.git 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. --- diff --git a/gdb/ChangeLog b/gdb/ChangeLog index 88406c7bef7..6779276dfd3 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,3 +1,7 @@ +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 diff --git a/gdb/NEWS b/gdb/NEWS index 2a89569bdbc..a1936ca1ccb 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 dc8f39293f4..f416fc3abf1 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 96fa77d9abc..233af614058 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