Next: DJGPP Native, Previous: BSD libkvm Interface, Up: Native [Contents][Index]
Some operating systems provide interfaces to fetch additional
information about running processes beyond memory and per-thread
register state. If GDB is configured for an operating system
with a supported interface, the command info proc is available
to report information about the process running your program, or about
any process running on your system.
One supported interface is a facility called ‘/proc’ that can be used to examine the image of a running process using file-system subroutines. This facility is supported on GNU/Linux and Solaris systems.
On FreeBSD and NetBSD systems, system control nodes are used to query process information.
In addition, some systems may provide additional process information in core files. Note that a core file may include a subset of the information available from a live process. Process information is currently available from cores created on GNU/Linux and FreeBSD systems.
info procinfo proc process-idSummarize available information about a process. If a process ID is specified by process-id, display information about that process; otherwise display information about the program being debugged. The summary includes the debugged process ID, the command line used to invoke it, its current working directory, and its executable file’s absolute file name.
On some systems, process-id can be of the form ‘[pid]/tid’ which specifies a certain thread ID within a process. If the optional pid part is missing, it means a thread from the process being debugged (the leading ‘/’ still needs to be present, or else GDB will interpret the number as a process ID rather than a thread ID).
info proc cmdlineShow the original command line of the process. This command is supported on GNU/Linux, FreeBSD and NetBSD.
info proc cwdShow the current working directory of the process. This command is supported on GNU/Linux, FreeBSD and NetBSD.
info proc exeShow the name of executable of the process. This command is supported on GNU/Linux, FreeBSD and NetBSD.
info proc filesShow the file descriptors open by the process. For each open file descriptor, GDB 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:
(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
info proc mappingsReport the memory address space ranges accessible in a process. On Solaris, FreeBSD and NetBSD systems, each memory range includes information on whether the process has read, write, or execute access rights to each range. On GNU/Linux, FreeBSD and NetBSD systems, each memory range includes the object file which is mapped to that range.
info proc statinfo proc statusShow additional process-related information, including the user ID and group ID; virtual memory usage; the signals that are pending, blocked, and ignored; its TTY; its consumption of system and user time; its stack size; its ‘nice’ value; etc. These commands are supported on GNU/Linux, FreeBSD and NetBSD.
For GNU/Linux systems, see the ‘proc’ man page for more information (type man 5 proc from your shell prompt).
For FreeBSD and NetBSD systems, info proc stat is an alias for
info proc status.
info proc allShow all the information about the process described under all of the
above info proc subcommands.
set procfs-traceThis command enables and disables tracing of procfs API calls.
show procfs-traceShow the current state of procfs API call tracing.
set procfs-file fileTell GDB to write procfs API trace to the named
file. GDB appends the trace info to the previous
contents of the file. The default is to display the trace on the
standard output.
show procfs-fileShow the file to which procfs API trace is written.
proc-trace-entryproc-trace-exitproc-untrace-entryproc-untrace-exitThese commands enable and disable tracing of entries into and exits
from the syscall interface.
info pidlistFor QNX Neutrino only, this command displays the list of all the processes and all the threads within each process.
info meminfoFor QNX Neutrino only, this command displays the list of all mapinfos.
Next: DJGPP Native, Previous: BSD libkvm Interface, Up: Native [Contents][Index]