предоставляет большую эффективность; при обработке глубоких иерархий файлов ядру не приходится обрабатывать снова и снова полные пути имен при осуществлении или открытии каталога. Экономия времени для больших иерархий может быть вполне ощутимой. [85]

может быть, а может и не быть тем, что вам нужно; для некоторых приложений это безусловно справедливо. Рассмотрите ''. Эта команда удаляет права чтения и исполнения для владельца для всех файлов и подкаталогов в текущем каталоге. Если это изменение прав доступа применено к каталогу до того, как оно применено к содержимому каталога, любые последующие попытки обработки содержимого потерпят неудачу! Поэтому команда должна применяться к каталогу после обработки его содержимого. [86] Справочная страница GNU/Linux nftw(3) отмечает для , что «это то, что вам нужно». Это позволяет вам обрабатывать сами символические ссылки, что обычно бывает нужно (Рассмотрите , она должна подсчитывать занимаемое ссылками пространство отдельно от связанных с ними файлов.)

После запуска

она вызывает функцию, указатель для которой предоставляете вы. (Такие функции называются функциями обратного вызова (callback functions), поскольку они «вызываются обратно» из библиотечного кода.) Функция обратного вызова получает четыре аргумента:

Имя текущего обрабатываемого файла (каталога, символической ссылки и т.д.).

Указатель на

для файла.

Одно из нескольких значений флагов (описанных ниже), указывающих, какой это вид файла или была ли ошибка для объекта.

Эта структура предоставляет две отдельные части информации:

Параметр

имеет одно из перечисленных в табл. 8.4 значений.

Таблица 8.4. Значения флагов для функции обратного вызова

Флаг	Значение
FTW_F	Объект является обычным файлом
FTW_D	Объект является каталогом
FTW_DNR	Объект является каталогом, который нельзя прочесть
FTW_SL	Объект является символической ссылкой
FTW_NS	Объект не является символической ссылкой, а stat потерпела неудачу
FTW_DP	Объект является каталогом, элементы которого были уже обработаны. Это может случиться, лишь когда в вызове nftw использовался FTW_DEPTH
FTW_SLN	Объект является символической ссылкой, указывающей на несуществующий файл. Это может случиться, лишь когда в вызове nftw не используется FTW_PHYS

предоставляет дополнительную информацию, которая может быть полезной. e действует в качестве индекса в ; является полным путем обрабатываемого объекта (относительно точки отсчета), '' указывает на первый символ компонента имени файла.

указывает текущую глубину иерархии; считается, что первоначальная точка отсчета находится на уровне 0.

Функция обратного вызова должна вернуть 0, если все нормально. Любое ненулевое возвращенное значение заставляет

прекратить свою обработку и вернуть то самое ненулевое значение. Справочная страница отмечает, что функция обратного вызова должна останавливать обработку только путем возвращаемого значения, чтобы у был шанс произвести очистку: т.е. освободить динамически выделенную память, закрыть открытые дескрипторы файлов и т.д. Функции обратного вызова не следует использовать , если только программа не завершается немедленно, ( является продвинутой функцией, которую мы опишем в разделе 12.5 «Нелокальные goto».) Рекомендуемой методикой обработки ошибок является установка глобальной переменной, указывающей на наличие проблем, возвращение 0 из функции обратного вызова и обработка ошибок после завершения перемещения по иерархии файлов. (GNU это делает, как мы вскоре увидим.)

Давайте свяжем все это воедино в примере программы.

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

Вот сама программа: