Linux程序员手册 第2部分
更新日期： 2017-09-15

名称

lookup_dcookie-返回目录条目的路径

语法

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

说明

查找值cookie指定的目录条目的完整路径。 cookie是唯一标识特定目录条目的不透明标识符。给定的缓冲区填充有目录条目的完整路径。

为了使lookup_dcookie()成功返回，内核必须仍然保留对目录条目的cookie引用。

返回值

成功后，lookup_dcookie()返回复制到缓冲区中的路径字符串的长度。如果出错，则返回-1，并正确设置errno。

错误说明

EFAULT

缓冲区无效。

EINVAL

在查找时，内核没有注册的cookie /目录条目映射，或者cookie没有引用有效的目录条目。

ENAMETOOLONG

该名称不适合缓冲区。

ENOMEM

内核无法为保存路径的临时缓冲区分配内存。

EPERM

该进程不具有查找cookie值所需的功能CAP_SYS_ADMIN。

ERANGE

缓冲区的大小不足以容纳目录条目的路径。

版本

自Linux 2.5.43起可用。在2.5.70中添加了ENAMETOOLONG错误返回。

遵循规范

lookup_dcookie()是特定于Linux的。

备注

lookup_dcookie()是专用系统调用，当前仅由oprofile(1)探查器使用。它依靠内核驱动程序来注册目录条目的cookie。

如果目录条目已删除，则返回的路径可以用字符串"(已删除)"作为后缀。

另外参见

oprofile(1)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。