Читаем Linux API. Исчерпывающее руководство полностью

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

Функция remove() была введена в стандартную библиотеку С, которая реализована как в системах UNIX, так и в других. В большинстве систем, отличных от UNIX, не поддерживаются жесткие ссылки, и поэтому удаление файлов с помощью функции unlink() не имело бы смысла.

18.8. Чтение каталогов: функции opendir() и readdir()

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

Библиотечные функции для чтения каталогов основаны на системном вызове getdents() (не являющемся частью стандарта SUSv3), однако обеспечивают интерфейс, более удобный в использовании. В Linux есть также системный вызов readdir(2) (в отличие от библиотечной функции readdir(3), описанной здесь), который выполняет ту же задачу, что и getdents(), но является устаревшим.

Функция opendir() открывает каталог и возвращает описатель, который можно применять для ссылки на каталог в последующих вызовах.

#include

DIR *opendir(const char *dirpath);

Возвращает описатель потока каталога или NULL при ошибке

Функция opendir() открывает каталог, указанный в аргументе dirpath, и возвращает указатель на структуру типа DIR. Эта структура представляет собой так называемый поток каталога; вызывающий процесс передает данный описатель другим функциям, рассмотренным ниже. После получения результата функции opendir() поток каталога размещается в первой записи списка каталога.

Функция fdopendir() подобна функции opendir(), за исключением того, что каталог, для которого следует создать поток, указывается с помощью открытого файлового дескриптора fd.

#include

DIR *fdopendir(int fd);

Возвращает описатель потока каталога или NULL при ошибке

Функция fdopendir() предназначена для того, чтобы приложения могли избежать режима соперничества, описанного в разделе 18.11.

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

Функция fdopendir() определена в стандарте SUSv4 (но не в стандарте SUSv3).

Функция readdir() считывает последовательные записи из потока каталога.

#include

struct dirent *readdir(DIR *dirp);

Возвращает указатель на статически выделенную структуру, описывающую следующую запись каталога, или NULL при достижении конца каталога или при ошибке

При каждом вызове функции readdir() происходит считывание следующего каталога из потока каталога, на который указывает аргумент dirp, и возвращается указатель на статически выделенную структуру типа dirent, содержащую следующую информацию о записи:

struct dirent {

ino_t d_ino; /* Номер индексного дескриптора файла */

char d_name[]; /* Имя файла с завершающим нулем */

};

Данная структура перезаписывается при каждом вызове функции readdir().

Я опустил в приведенном выше определении разные нестандартные поля структуры dirent для Linux, поскольку их использование делает приложение непортируемым. Наиболее интересным из этих нестандартных полей является поле d_type, которое присутствует также в BSD-ветках, но не в других UNIX-реализациях. Данное поле содержит значение, указывающее на тип файла, названного в аргументе d_name: DT_REG (обычный файл), DT_DIR (каталог), DT_LNK (символическая ссылка) либо DT_FIFO (очередь FIFO). (Приведенные имена аналогичны макроопределениям в табл. 15.1.) Применение информации из этого поля избавляет от необходимости совершать вызов lstat(), чтобы выяснить тип файла. Необходимо отметить, однако, что на момент написания книги это поле полностью поддерживается только в файловых системах Btrfs, ext2, ext3 и ext4.

Дальнейшую информацию о файле, на который указывает аргумент d_name, можно получить благодаря системному вызову stat() для имени пути, составленному с помощью аргумента dirpath, указанного для функции opendir(), сцепленного (с помощью слеша, /) со значением, возвращаемым в поле d_name.

Имена файлов, возвращаемые функцией readdir(), располагаются не в порядке сортировки, а в порядке появления в каталоге. (Это зависит от того порядка, в каком файловая система добавляет файлы в данный каталог и как она заполняет пустоты в списке каталога после удаления файлов.) (Команда ls — f перечисляет файлы в таком же неупорядоченном списке, какой был бы отображен функцией readdir().)

Можно использовать функцию scandir(3) для извлечения упорядоченного списка файлов, который удовлетворяет критериям, задаваемым программистом; см. подробности на страницах руководства. И хотя функция scandir() не описана в стандарте SUSv3, она присутствует во многих реализациях UNIX.