6
$ <b>factorial -#t 1 2 3</b>/* Вывести трассировку вызовов функций, обратите внимание на вложенность */
| >factorial
| <factorial
1 /* Обычный вывод в stdout */
| >factorial
| | >factorial
| | <factorial /* Вывод отладки в stderr */
| <factorial
2
| >factorial
| | >factorial
| | | >factorial
| | | <factorial
| | <factorial
| <factorial
6
<?func?
$ <b>factorial -#d 1 2</b>/* Показать отладочные сообщения DBUG_PRINT() */
?func?: args: argv[2] = 1
factorial: find: find 1 factorial
factorial: result: result is 1
1
?func?: args: argv[3] = 2
factorial: find: find 2 factorial
factorial: find: find 1 factorial
factorial: result: result is 1
factorial: result: result is 2
2
Опция
-#
управляет библиотекой
dbug
. Она «особая» в том смысле, что
DBUG_PUSH()
будет принимать всю строку, игнорируя ведущие символы '
-#
', хотя вы могли бы использовать при желании другую опцию, передав
DBUG_PUSH()
лишь строку аргументов опций (если вы используете
getopt()
, это
optarg
).
Управляющая строка состоит из набора опций и аргументов. Каждая группа опций и аргументов отделяется от других символом двоеточия. Каждая опция представлена одной буквой, а аргументы этой опции отделяются от нее запятыми. Например:
$ myprog -#d,mem,ipc:f,check_salary,check_start_date -f infile -o outfile
Опция
d
включает вывод
DBUG_PRINT()
, но лишь если первая строка аргумента является "
mem
" или "
ipc
". (Если аргументов нет, выводятся все сообщения
DBUG_PRINT()
.) Сходным образом опция
f
ограничивает трассировку вызовов функций лишь указанными функциями,
check_salary()
и
check_start_date()
.
Следующий список опций и аргументов воспроизведен из руководства библиотеки
dbug
. Квадратные скобки заключают необязательные аргументы. Мы включаем здесь лишь те, которые находим полезными; полный список см. в документации.
d [,ключевые слова]
Разрешает вывод от макросов с указанными ключевыми словами. Пустой список ключевых слов предполагает, что выбраны все ключевые слова.
F
Помечает каждую строку вывода отладки именем исходного файла, содержащего макрос, осуществляющий вывод.
i
Идентифицирует процесс, выводящий каждую отладочную или трассировочную строку номером ID для этого процесса.
L
Помечает каждую строку вывода отладчика номером строки исходного файла, в котором находится осуществляющий вывод макрос.
о[,файл]
Перенаправляет поток вывода отладчика в указанный файл. Потоком вывода по умолчанию является
stderr
. Пустой список аргументов перенаправляет вывод в
stdout
.
t[,N]
Включает трассировку потока управления функций. Максимальная глубина вложения определяется
N
, по умолчанию используется 200.
Для завершения нашего обсуждения вот остальные макросы, определенные библиотекой
dbug
.
DBUG_EXECUTE(строка, код)
Этот макрос похож на
DBUG_PRINT()
: первый аргумент является строкой, выбранной с помощью опции
d
, а второй — код для исполнения:
DBUG_EXECUTE("abort", abort());
DBUG_FILE
Это значение типа
FILE*
для использования с процедурами
<stdio.h>
. Оно позволяет осуществлять собственный вывод в поток файла отладки.
DBUG_LONGJMP(jmp_buf env, int val)
Этот макрос заключает в оболочку вызов
longjmp()
, принимая те же самые аргументы, так что библиотека
dbug
будет знать, когда вы сделали нелокальный переход.
DBUG_POP()
Этот макрос выталкивает из стека один уровень сохраненного состояния отладки, созданный макросом
DBUG_PUSH()
. Он довольно эзотерический; вы скорее всего не будете его использовать.
DBUG_SETJMP(jmp_buf env)
Этот макрос заключает в оболочку вызов
setjmp()
, принимая те же самые аргументы. Он позволяет библиотеке
dbug
обрабатывать нелокальные переходы.
В другом воплощении, в первой начинающей компании, для которой мы работали[177], мы использовали в своем продукте библиотеку
dbug
. Она была неоценимой при разработке, а опустив
-DDBUG
в конечной сборке, мы смогли построить готовую версию без других изменений исходного кода.
Чтобы извлечь максимальную выгоду от библиотеки
dbug
, нужно использовать ее последовательно, по всей программе. Это проще, если вы используете ее с начала проекта, но в качестве эксперимента мы обнаружили, что с помощью простого сценария
awk
мы смогли включить библиотеку в программу с 30 000 строк кода за несколько часов работы. Если вы можете позволить себе накладные расходы, лучше всего оставить ее в конечной сборке вашей программы, чтобы можно было ее отлаживать без необходимости предварительной перекомпиляции.
