Вы можете сокращать команды GDB по нескольким первым символам имени команды, если это сокращение однозначно; и вы можете повторять определенные команды GDB простым нажатием RET. Вы также можете использовать клавишу TAB для того, чтобы GDB сам дополнил остаток слова в команде (или показал вам возможные альтернативы, если существует несколько вариантов).
Команда GDB представляет собой одну строку ввода. Никаких
ограничений на ее длину нет. Она начинается именем команды, за которым
следуют параметры, значение которых определяется ее названием.
Например, команда step
допускает в качестве параметра число
шагов, как в `step 5'. Вы также можете использовать команду
step
и без параметров. Некоторые команды не допускают
никаких параметров.
Названия команд GDB всегда могут быть сокращены, если это
сокращение однозначно. Другие возможные сокращения команд перечислены в
документации по отдельным командам. В некоторых случаях, допускаются
даже неоднозначные сокращения; напрмер, s
специально определено
как эквивалент step
, даже если существуют другие команды, чьи
названия начинаются на s
. Вы можете проверить сокращения,
задавая их как параметр для команды help
.
Введенная пустая строка (просто нажатие RET), означает повтор
предыдущей команды. Определенные команды (например, run
)
не повторяются таким способом; это те команды, непреднамеренное
повторение которых может вызвать проблемы и которые вы вряд ли захотите
повторять.
Команды list
и x
, при их повторе нажатием RET,
вместо точного повтора создают новые параметры. Это позволяет легко
просматривать исходный текст или память.
GDB может также использовать RET по-другому: для
разделения длинного вывода, аналогично обычной утилите more
(see section Размер экрана). Так как в такой ситуации легко
нажать RET слишком много раз, GDB блокирует повтор после
любой команды, генерирующей такой тип вывода.
Любой текст, расположенный от # до конца строки является комментарием; он ничего не делает. В основном, это полезно в командных файлах (see section Командные файлы).
GDB может дополнить за вас окончание слова в команде, если существует только один вариант; он также может в любой момент показать, какие завершения возможны для следующего слова в команде. Это работает для команд и подкоманд GDB, а также для имен символов в вашей программе.
Нажмите TAB в любой момент, когда захотите, чтобы
GDB дополнил оставшуюся часть слова. Если существует только
одна возможность, GDB дополняет слово и ждет, пока вы закончите
команду (или нажмете RET, чтобы ввести ее). Например, если вы
введете
(gdb) info bre TAB
GDB дополнит остаток слова `breakpoints', так как у
команды info
есть единственная подкоманда, начинающаяся с `bre':
(gdb) info breakpoints
Теперь вы можете нажать либо RET, чтобы выполнить команду
info breakpoints
, либо удалить часть символов и ввести что-то другое,
если `breakpoints' не является той командой, которую вы ожидали.
(Если вы с самого начала были уверены, что хотите info breakpoints
,
вы также могли просто нажать RET, сразу после `info bre',
использовав сокращение команды вместо завершения).
Если при нажатии TAB существует несколько вариантов для следующего
слова, GDB издает звук. Вы можете либо ввести больше символов
и попробовать снова, либо нажать TAB второй раз; GDB
выведет все возможные завершения для этого слова. Например, вы можете
захотеть установить точку останова на подпрограмме, чье имя начинается с
`make_', но когда вы вводите b make_TAB, GDB
лишь издает звук. Повторное нажатие TAB отображает все имена
функций в вашей программе, начинающиеся с этих символов. Например:
(gdb) b make_ TAB
GDB издает звук; нажав TAB еще раз, видим:
make_a_section_from_file make_environ
make_abs_section make_function_type
make_blockvector make_pointer_type
make_cleanup make_reference_type
make_command make_symbol_completion_list
(gdb) b make_
После отображения возможных вариантов, GDB копирует ваш частичный ввод (`b make_' в этом примере), так что вы можете закончить команду.
Если вы сначала хотите только увидеть список альтернатив, вы можете нажать M-?, а не нажимать TAB дважды. M-? означает META ?. Вы можете ввести это либо удерживая клавишу, обозначенную на вашей клавиатуре как META (если такая есть), и нажать ?, или как ESC, за которой следует ?.
Иногда нужная вам строка, являясь логически "словом", может содержать
скобки или другие символы, которые GDB обычно исключает из
своего понятия о слове. Чтобы позволить завершению слов работать в
такой ситуации, вы можете заключить слова в командах GDB в
'
(знаки одинарных кавычек).
Наиболее вероятная ситуация, где вам это может потребоваться, это при
вводе имени функции в Си++. Это происходит потому, что Си++ допускает
перегрузку функций (множественные определения одной и той же функции,
различающиеся типом параметров). Например, когда вы хотите установить
точку останова, вам может потребоваться различать, имеете вы в виду
версию name
с параметром целого типа, name(int)
, или же
версию с параметром вещественного типа, name(float)
. Для
использования возможностей завершения слов в такой ситуации, введите
одинарную кавычку '
в начале имени функции. Это предупреждает
GDB, что ему может потребоваться принять во внимание больше
информации, чем обычно, когда вы нажимаете TAB или M-? для
запроса завершения слова:
(gdb) b 'bubble( M-?
bubble(double,double) bubble(int,int)
(gdb) b 'bubble(
В некоторых случаях, GDB может сам определить, что завершение
имени требует использования кавычек. Когда это происходит, GDB
вставляет кавычку за вас (выполняя завершение на столько, на сколько это
возможно), если вы не ввели ее в первой позиции:
(gdb) b bub TAB
GDB изменяет вашу строку ввода на следующую, и издает звук:
(gdb) b 'bubble(
Вообще, GDB может определить, что кавычка нужна (и вставляет ее), если вы запрашиваете завершение перегруженного символа до того, как начали вводить список параметров.
Для большей информации о перегруженных функциях, смотрите section Выражения Си++. Вы можете использовать команду set
overload-resolution off
для отключения распознавания перегруженных
символов; смотрите section Возможности GDB для Си++.
Используя команду help
, вы всегда можете запросить информацию о
командах у самого GDB.
help
h
help
(сокращенно h
) без параметров,
для отображения короткого списка именованных классов команд:
(gdb) help
List of classes of commands:
aliases -- Aliases of other commands
breakpoints -- Making program stop at certain points
data -- Examining data
files -- Specifying and examining files
internals -- Maintenance commands
obscure -- Obscure features
running -- Running the program
stack -- Examining the stack
status -- Status inquiries
support -- Support facilities
tracepoints -- Tracing of program execution without
stopping the program
user-defined -- User-defined commands
Type "help" followed by a class name for a list of
commands in that class.
Type "help" followed by command name for full
documentation.
Command name abbreviations are allowed if unambiguous.
(gdb)
help класс
status
:
(gdb) help status
Status inquiries.
List of commands:
info -- Generic command for showing things
about the program being debugged
show -- Generic command for showing things
about the debugger
Type "help" followed by command name for full
documentation.
Command name abbreviations are allowed if unambiguous.
(gdb)
help команда
help
, GDB
выведет короткую справку о том, как ей пользоваться.
apropos арг
apropos арг
производит поиск по регулярному
выражению, заданному в арг, во всех командах GDB и их
документации. Она выводит все найденные совпадения. Например:
apropos reload
приводит к:
set symbol-reloading -- Set dynamic symbol table reloading
multiple times in one run
show symbol-reloading -- Show dynamic symbol table reloading
multiple times in one run
complete арг
complete арг
перечисляет все возможные завершения для
начала команды. Используйте арг для задания начала команды,
которую вы хотите завершить. Например,
complete i
приводит к:
if
ignore
info
inspect
Это предназначено для использования GNU Emacs.
В дополнение к help
, вы можете использовать команды GDB
info
и show
для получения информации о состоянии вашей программы,
или о состоянии самого GDB. Каждая команда поддерживает много
тем запросов; это руководство описывает каждую тему в соответствующем месте.
Списки в разделах info
и show
в Алфавитном указателе
указывают на все подкоманды. See section Алфавитный указатель.
info
i
) предназначена для описания состояния
вашей программы. Например, вы можете с помощью info args
просмотреть аргументы, переданные вашей программе, с помощью info
registers
перечислить используемые в настоящий момент регистры, или
используя info breakpoints
вывести установленные вами точки
останова. Вы можете получить полный список подкоманд команды
info
с помощью help info
.
set
set
. Например, вы можете установить приглашение GDB в
знак $ используя set prompt $
.
show
info
, команда show
предназначена для описания
состояния самого GDB. Вы можете изменить почти все, что
показывает show
, используя соответствующую команду set
.
Например, командой set radix
вы можете задать, какую систему
счисления использовать для вывода, или просто узнать, какая система
используется в данный момент с помощью команды show radix
.
Для отображения всех устанавливаемых параметров и их текущих значений,
вы можете использовать show
без аргументов; также можно
использовать info set
. Обе команды приводят к одинаковому
результату.
Вот три разнообразные подкоманды show
, которые не имеют
соответствующих set
-команд:
show version
show copying
show warranty
Go to the first, previous, next, last section, table of contents.