ОБЗОР
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. Она
полагается на регистрацию драйвером ядра маркёра для элементов каталога.
Возвращаемый путь может заканчиваться строкой « (deleted)», если элемент каталога был удалён.
