Linux программирование в примерах

Оставшаяся часть программы заполнена функцией factorial:

 1 #include <stdio.h>
 2 #include "dbug.h"
 3
 4 int factorial (value)
 5 register int value;
 6 {
 7 DBUG_ENTER("factorial");
 8 DBUG_PRINT("find", ("find %d factorial", value));
 9 if (value > 1) {
 10 value *= factorial(value — 1);
 11 }
 12 DBUG_PRINT("result", ("result is %d", value));
 13 DBUG_RETURN(value);
 14 }

Когда программа откомпилирована и скомпонована вместе с библиотекой dbug, ее можно запустить обычным способом. По умолчанию, программа не создает вывод отладки. Но со включенной отладкой доступны различные виды вывода:

 $ factorial 1 2 3 /* Обычный запуск, без отладки */
 1
 2
 6
 $ factorial -#t 1 2 3/* Вывести трассировку вызовов функций, обратите внимание на вложенность */
 | >factorial
 | <factorial
 1 /* Обычный вывод в stdout */
 | >factorial
 | | >factorial
 | | <factorial /* Вывод отладки в stderr */
 | <factorial
 2
 | >factorial
 | | >factorial
 | | | >factorial
 | | | <factorial
 | | <factorial
 | <factorial
 6
 <?func?
 $ factorial -#d 1 2/* Показать отладочные сообщения 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 в конечной сборке, мы смогли построить готовую версию без других изменений исходного кода.

177

Хотя нам следовало бы усвоить свой урок после первой компании, мы перешли ко второй. С тех пор, как мы это выяснили, мы обычно избегаем начинающие компании. Ваша выгода, конечно, может меняться — Примеч. автора.