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

 26 optimal_bufsize(fd, stb)
 27 int fd;
 28 struct stat *stb;
 29 {
 30 char *val;
 31 static size_t env_val = 0;
 32 static short first = TRUE;
 33 static short exact = FALSE;
 34
 35 /* обнулить все члены, на случай, если ОС их не использует. */
 36 memset(stb, '\0', sizeof(struct stat));
 37
38 /* всегда использовать stat на случай, если stb используется кодом более высокого уровня */
 39 if (fstat(fd, stb) == -1)
 40 fatal("can't stat fd %d (%s)", fd, strerror(errno));
 41
 42 if (first) {
 43 first = FALSE;
 44
 45 if ((val = getenv("AWKBUFSIZE")) != NULL) {
 46 if (strcmp(val, "exact") == 0)
 47 exact = TRUE;
 48 else if (ISDIGIT(*val)) {
 49 for (; *val && ISDIGIT(*val); val++)
 50 env_val = (env_val * 10) + *val - '0';
 51
 52 return env_val;
 53 }
 54 }
 55 } else if (!exact && env_val > 0)
 56 return env_val;
 57 /* else
 58 обрабатывать дальше */
 59
 60 /*
 61 * System V.n, n < 4, не имеет в структуре stat размера системного
 62 * блока файла. Поэтому нам нужно осуществить разумную догадку.
 63 * Мы используем BUFSIZ из stdio, поскольку именно это имелось
 64 * в виду прежде всего.
 65 */
 66 #ifdef HAVE_ST_BLKSIZE
 67 #define DEFBLKSIZE (stb->st_blksize > 0 ? stb->st_blksize : BUFSIZ)
 68 #else
 69 #define DEFBLKSIZE BUFSIZ
 70 #endif
 71
 72 if (S_ISREG(stb->st_mode) /* обычный файл */
 73 && 0 < stb->st_size /* ненулевой размер */
 74 && (stb->st_size < DEFBLKSIZE /* маленький файл */
 75 || exact)) /* или отладка */
 76 return stb->st_size; /* использовать размер файла*/
 77
 78 return DEFBLKSIZE;
 79 }

Комментарий в строках 3–23 объясняет алгоритм. Поскольку поиск переменных окружения может быть затратным и его нужно осуществить лишь однажды, функция использует для сбора соответствующих сведений в первый раз несколько статических переменных.

Строки 42–54 выполняются лишь при первом вызове функции. Строка 43 обеспечивает это условие, устанавливая в first значение false. Строки 45–54 обрабатывают переменную окружения, разыскивая либо строку "exact", либо число. В последнем случае оно преобразуется из строкового значения в десятичное, сохраняясь в env_val. (Возможно, нам следовало бы использовать здесь strtoul; в свое время это не пришло нам на ум.)

Строка 55 выполняется каждый раз, кроме первого. Если было представлено числовое значение, условие будет истинным, и возвращается это значение (строка 56). В противном случае, исполнение переходит к оставшейся части функции.

Строки 60–70 определяют DEFBLKSIZE; эта часть не изменилась. Наконец, строки 72–76 возвращают размер файла, если это приемлемо. Если нет (строка 78), возвращается DEGBLKSIZE.

Мы действительно устранили проблему [174] , но между тем оставили на месте новую версию optimal_bufsize, чтобы можно было убедиться, что проблема не возникнет вновь.

174

Переписав код управления буфером! — Примеч. автора.

Незначительное увеличение размера кода и его сложности более чем компенсируется возросшей гибкостью, которая есть теперь у нас для тестирования. Более того, поскольку это код изделия, пользователь в полевых условиях может с легкостью использовать эту особенность для тестирования, чтобы определить, не появилась ли сходная проблема. (До сих пор нам не приходилось просить проделать этот тест, но приятно осознавать, что мы могли бы это сделать, если бы пришлось.)

15.4.2.3. Добавьте код журналирования

Часто бывает так, что программа вашего приложения работает на системе, на которой вы не можете использовать отладчик (как в случае сайта клиента). В таком случае вашей целью является возможность проверки внутреннего состояния программы, но извне. Единственным способом сделать это является заставить саму программу предоставить для вас эту информацию. Для этого существует множество способов.

• Всегда записывайте сведения в специфический файл. Это простейший способ: программа всегда записывает регистрационную информацию. Затем вы можете при возможности просмотреть файл.

Недостаток в том, что в какой-то момент регистрационный файл займет все дисковое пространство. Следовательно, у вас должны быть несколько файлов журналов, причем программа периодически должна переключаться между ними. Брайан Керниган рекомендует называть файлы журнала по дням недели: myapp.log.sun, myapp.log.mon и т.д. Преимуществом здесь является то, что вам не придется вручную удалять старые файлы; вы бесплатно получаете недельную стоимость файлов журналов.

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

• Используйте для сообщений фиксированный формат, который можно легко анализировать с помощью языков сценариев, таких, как awk или Perl, для создания сводок и отчетов.

• В качестве альтернативы можно создать какую-нибудь разновидность XML, который является самоописывающимся и допускающим преобразование в другие форматы. (Мы не являемся большими поклонниками XML, но вас это не должно останавливать).

• Для журналирования используйте syslog; конечное расположение сообщений журналирования может контролироваться системным администратором, (syslog является довольно продвинутым интерфейсом; см. справочную страницу syslog(3)).