This is the GNU debugger. Usage:
gdb [options] [executable-file [core-file or process-id]]
gdb [options] --args executable-file [inferior-arguments ...]
Selection of debuggee and its files:
--args Arguments after executable-file are passed to inferior.
--no-escape-args Like --args, but arguments are not escaped.
--core=COREFILE Analyze the core dump COREFILE.
--exec=EXECFILE Use EXECFILE as the executable.
--pid=PID Attach to running process PID.
--directory=DIR Search for source files in DIR.
--se=FILE Use FILE as symbol file and executable file.
--symbols=SYMFILE Read symbols from SYMFILE.
--readnow Fully read symbol files on first access.
--readnever Do not read symbol files.
--write Set writing into executable and core files.
Initial commands and command files:
--command=FILE, -x Execute GDB commands from FILE.
--init-command=FILE, -ix
Like -x but execute commands before loading inferior.
--eval-command=COMMAND, -ex
Execute a single GDB command.
May be used multiple times and in conjunction
with --command.
--init-eval-command=COMMAND, -iex
Like -ex but before loading inferior.
--nh Do not read ~/.gdbinit.
--nx Do not read any .gdbinit files in any directory.
Output and user interface control:
--fullname Output information used by emacs-GDB interface.
--interpreter=INTERP
Select a specific interpreter / user interface.
--tty=TTY Use TTY for input/output by the program being debugged.
-w Use the GUI interface.
--nw Do not use the GUI interface.
--tui Use a terminal user interface.
-q, --quiet, --silent
Do not print version number on startup.
Operating modes:
--batch Exit after processing options.
--batch-silent Like --batch, but suppress all gdb stdout output.
--return-child-result
GDB exit code will be the child's exit code.
--configuration Print details about GDB configuration and then exit.
--help Print this message and then exit.
--version Print version information and then exit.
Remote debugging options:
-b BAUDRATE Set serial port baud rate used for remote debugging.
-l TIMEOUT Set timeout in seconds for remote debugging.
Other options:
--cd=DIR Change current directory to DIR.
--data-directory=DIR, -D
Set GDB's data-directory to DIR.
At startup, GDB reads the following early init files and executes their
commands:
None found.
At startup, GDB reads the following init files and executes their commands:
None found.
For more information, type "help" from within GDB, or consult the
GDB manual (available as on-line info or a printed manual).
Report bugs to <https://www.gnu.org/software/gdb/bugs/>.
You can ask GDB-related questions on the GDB users mailing list
(gdb@sourceware.org) or on GDB's IRC channel (#gdb on Libera.Chat).
Options (42)
| Option | Description | Source |
|---|---|---|
--args | Arguments after executable-file are passed to inferior. | help |
--no-escape-args | Like --args, but arguments are not escaped. | help |
--core COREFILE | Analyze the core dump COREFILE. | help + man |
--exec EXECFILE | Use EXECFILE as the executable. | help + man |
--pid PID | Attach GDB to an already running program, with the PID pid. | help + man |
--directory DIR | Search for source files in DIR. | help + man |
--se FILE | Read symbol table from file and use it as the executable file. | help + man |
--symbols SYMFILE | Read symbols from SYMFILE. | help + man |
--readnow | Read all symbols from the given symfile on the first access. | help + man |
--readnever | Do not read symbol files. | help + man |
--write | Enable writing into executable and core files. | help + man |
--init-command, -ix FILE | Like -x but execute commands before loading inferior. | help |
--eval-command, -ex COMMAND | Execute a single GDB command. | help + man + man |
--init-eval-command, -iex COMMAND | Execute GDB command before loading the inferior. | help + man + man |
--nh | Do not execute commands from ~/.config/gdb/gdbinit, ~/.gdbinit, ~/.config/gdb/gdbearlyinit, or ~/.gdbearlyinit | help + man |
--nx | Do not read any .gdbinit files in any directory. | help + man |
--fullname | Output information used by emacs-GDB interface. | help + man |
--interpreter INTERP | Select a specific interpreter / user interface. | help |
--tty TTY | Run using device for your program's standard input and output. | help + man |
-w | Use the GUI interface. | help |
--nw | Do not use the GUI interface. | help |
--tui | Open the terminal user interface. | help + man |
-q, --quiet, --silent | Do not print version number on startup. | help + man + man + man |
--batch | Exit after processing options. | help + man |
--batch-silent | Run in batch mode, just like --batch, but totally silent. | help + man |
--return-child-result | GDB's exit code will be the same as the child's exit code. | help + man |
--configuration | Print details about GDB configuration and then exit. | help + man |
--help | Print this message and then exit. | help + man |
--version | Print version information and then exit. | help + man |
-b BAUDRATE | Set the line speed (baud rate or bits per second) of any serial interface used by GDB for remote debugging. | help + man |
-l TIMEOUT | Set timeout, in seconds, for remote debugging. | help + man |
--cd DIR | Run GDB using directory as its working directory, instead of the current directory. | help + man |
--data-directory, -D DIR | Run GDB using directory as its data directory. | help + man + man |
-h | List all options, with brief explanations. (in the manual page but not in --help) | man |
-s file | Read symbol table from file. (in the manual page but not in --help) | man |
-e file | Use file as the executable file to execute when appropriate, and for examining pure data in conjunction with a core dump. (in the manual page but not in --help) | man |
-c file | Use file as a core dump to examine. (in the manual page but not in --help) | man |
--command file | (in the manual page but not in --help) | man |
-x file | Execute GDB commands from file. (in the manual page but not in --help) | man |
-d directory | Add directory to the path to search for source files. (in the manual page but not in --help) | man |
-n | Do not execute commands from any .gdbinit or .gdbearlyinit initialization files. (in the manual page but not in --help) | man |
-f | Emacs sets this option when it runs GDB as a subprocess. (in the manual page but not in --help) | man |