ИМЯ

lookup_dcookie - возвращает путь элемента каталога

ОБЗОР

int lookup_dcookie(u64 cookie, char *buffer, size_t len);

ОПИСАНИЕ

Ищет полный путь элемента каталога, указанного в параметре cookie. Маркёр (cookie)
представляет собой простейший идентификатор, уникально определяющий отдельный
элемент каталога. Указанный буфер заполняется полным путём элемента каталога.

Для успешного выполнения lookup_dcookie() ядро должно удерживать ссылку маркёра
на элемент каталога.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении lookup_dcookie() возвращается длина строки пути,
скопированного в буфер. В случае ошибки возвращается -1, а errno устанавливается в
соответствующее значение.

ОШИБКИ

EFAULT Неверный буфер.

EINVAL При поиске в ядре не было зарегистрированных отображённых элементов
маркёра/каталога или маркёр ссылается на некорректный элемент каталога.

ENAMETOOLONG
Имя не помещается в буфере.

ENOMEM Ядро не может выделить память для временного буфера для пути.

EPERM Процесс не имеет мандата CAP_SYS_ADMIN для поиска значений маркёра.

ERANGE Буфер не был достаточно велик для хранения пути элемента каталога.

ВЕРСИИ

Доступен, начиная с Linux 2.5.43. В версии 2.5.70 добавлено возвращение ошибки
ENAMETOOLONG.

СООТВЕТСТВИЕ СТАНДАРТАМ

Вызов lookup_dcookie() есть только в Linux.

ЗАМЕЧАНИЯ

Вызов lookup_dcookie() является специальным системным вызовом, в данный момент
используется только программой профилирования oprofile(1). Она полагается на
регистрацию драйвером ядра маркёра для элементов каталога.

Возвращаемый путь может заканчиваться строкой « (deleted)», если элемент каталога
был удалён.

СМОТРИТЕ ТАКЖЕ

oprofile(1)