lookup_dcookie - возвращает путь элемента каталога
СИНТАКСИС
int lookup_dcookie(u64 cookie, char * buffer, size_t len);
ОПИСАНИЕ
Поиск полного пути элемента каталога, указанного значением
cookie.
Элемент cookie является непрозрачным идентификатором, уникально
определяющем отдельный элемент каталога. Заданный буфер заполняется
полным путем элементы каталога.
Для того, чтобы
lookup_dcookie
нормально возвращало значения,
ядро должно держать ссылку cookie на элемент каталога.
ЗАМЕЧАНИЯ
lookup_dcookie
является системным вызовом особого назначения, в данный момент используемого
только профайлером oprofile. Она основывается на регистрации драйвером ядра
cookies для элементов каталога.
Возвращаемый путь может заканчиваться дополнительной строкой " (deleted)",
если элемент каталога был удален.
ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
При нормальном завершении работы
lookup_dcookie
возвращает длину строки полного пути, скопированной в буфер.
При ошибках возвращается -1 и переменная
errno
устанавливается соответствующим образом.
НАЙДЕННЫЕ ОШИБКИ
EPERM
Процесс не имеет возможности осуществить поиск значения cookie.
EINVAL
Ядро не имеет зарегистрированных распределений элементов cookie/каталог
во время поиска, или cookie не ссылается на корректный элемент каталога.
ENOMEM
Ядро не может выделить память для временного буфера, содержащего путь.
ERANGE
Буфер не был достаточно велик для содержания пути или элемента каталога.
ENAMETOOLONG
Имя (название) не может поместиться в буфере.
EFAULT
Буфер некорректен.
СООТВЕТСТВИЕ СТАНДАРТАМ
lookup_dcookie
является специфичным для Linux.
ДОСТУПНОСТЬ
Доступен, начиная с Linux 2.5.43.
Возврат ошибки ENAMETOOLONG добавлен начиная с версии 2.5.70.
