pathfind(), pathfind_r()

Искать файл по списку директорий

Прототип:

#include <libgen.h>
char * pathfind( const char *path,
const char *name,
const char *mode );
char * pathfind_r( const char *path,
const char *name,
const char *mode,
char *buff,
size_t buff_size );

Аргументы:

path
Строка, определяющая список каталогов, в которых будет осуществлен поиск. Каталоги, имена которых указаны в path, разделяются двоеточиями.
name
Имя искомого файла. Если имя начинается с косой черты, имя обрабатывается как абсолютный путь, а путь path игнорируется.
mode
Строка опций, состоящая из символов:
r
Доступный для чтения.
w
Доступный для записи
x
Доступный для исполнения.
f
Обычный файл
b
Специальный блок.
c
Специальный символ.
d
Каталог.
p
Канал (FIFO, pipe).
u
Бит идентификатора пользователя.
g
Бит идентификатора группы.
k
Sticky бит.
s
Размер ненулевой.
buff
(только для pathfind_r()) Указатель на буфер, где pathfind_r() может хранить путь к найденному файлу.
buff_size
(только для pathfind_r()) Размер буфера, на который указывает buff.

Библиотека:

libc

Описание:

Функция pathfind() ищет в каталогах, указанных в path, файл с именем name. Функция pathfind_r() является потоко-безопасной версией pathfind().

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

Если файл name со всеми характеристиками, заданными в переменной mode, найден в любом из каталогов, указанных в path, то эти функции возвращают указатель на строку, содержащую компонент переменной пути path, за которым следует косая черта (/), за которым следует имя name.

Пустой компонент пути рассматривается как текущий каталог. Если имя найдено в текущем каталоге, косая черта к нему не добавляется; возвращается только имя.

Функции pathfind_r() также следует передать буфер buff и его размер buff_size. Этот буфер используется для хранения пути к найденному файлу.

Возвращаемое значение:

Найденный путь или NULL, если файл не может быть найден.

Примеры:

Найти команду ls, используя переменную среды PATH:

pathfind( getenv( "PATH" ), "ls", "rx" );

Классификация:

Unix

pathfind()

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Нет

pathfind_r()

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Предостережения:

Строка, на которую указывает возвращенный указатель, сохраняется в области, которая повторно используется при последующих вызывах pathfind(). Не освобождайте эту строку с помощью free().

Используйте pathfind_r() в многопоточных приложениях.

Тематические ссылки:

access(), getenv(), mknod(), stat()

sh в Справочнике по утилитам




Предыдущий раздел: Описание API системной библиотеки