Go to the first, previous, next, last section, table of contents.


Команды GDB

Вы можете сокращать команды 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
Показывает, какая версия GDB запущена. Вам следует включать эту информацию в отчеты об ошибках в GDB. Если вы используете несколько версий GDB, вам может потребоваться определить, какая из них запущена; по мере развития отладчика появляются новые команды, а старые могут исчезнуть. Кроме того, многие распространители операционных систем поставляют модифицированные версии GDB, также существуют модифицированные версии GDB в GNU/Linux. Номер версии---это номер, появляющийся при старте.
show copying
Выводит информацию о правах на распространение GDB.
show warranty
Отображает заявление GNU об отсутствии гарантий, или гарантии, если ваша версия GDB поставляется с гарантиями.


Go to the first, previous, next, last section, table of contents.