Command-Line Syntax
GDB is invoked as follows:
gdb [options
] [executable
[corefile-or-PID
]] gdb [options
] --argsexecutable
[program args
...]
The gdbtui
command is equivalent to gdb --tui
; it invokes GDB with the Text User Interface (TUI). The TUI is described in the later section "The GDB Text User Interface.”
GDB has both traditional short options and GNU-style long options. Long options may start with either one or two hyphens. The command-line options are as follows.
--args
Pass on arguments after executable to the program being debugged.
--async
,--noasync
Enable/disable the asynchronous version of the command-line interface.
-b
baudrate
,--baud
baudrate
Set the serial port baud rate used for remote debugging.
--batch
Process options and then exit.
--cd
dir
Change current directory to dir.
-c
file
,--core
file
Analyze the core dump file.
-d
dir
,--directory
dir
Search for source files in dir.
-e
file
,--exec
file
Use file as the executable.
-f
,--fullname
Output information used by the Emacs-GDB interface.
--help
Print a usage and option summary and then exit.
--interpreter
interp
Select a specific interpreter/user interface. The command-line interface is the default, although there are other interfaces for use by frontend programs.
-m
,--mapped
Use mapped symbol files if supported on this system.
-n
,--nx
Do not read the .gdbinit file.
-nw
,--nowindows
Force the use of the command-line interface, even if a windows interface is available.
-p
pidnum
,-c
pidnum
,--pid
pidnum
Attach to running process pidnum ...
Get GDB Pocket Reference now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.