LOOKUP_DCOOKIESection: Linux Programmer's Manual (2)
Index Return to Main Contents
NAMElookup_dcookie - return a directory entry's path
SYNOPSISint lookup_dcookie(u64 cookie, char *buffer, size_t len);
DESCRIPTIONLook up the full path of the directory entry specified by the value cookie The cookie is an opaque identifier uniquely identifying a particular directory entry. The buffer given is filled in with the full path of the directory entry.
RETURN VALUEOn success, lookup_dcookie() returns the length of the path string copied into the buffer. On error, -1 is returned, and errno is set appropriately.
- The buffer was not valid.
- The kernel has no registered cookie/directory entry mappings at the time of lookup, or the cookie does not refer to a valid directory entry.
- The name could not fit in the buffer.
- The kernel could not allocate memory for the temporary buffer holding the path.
- The process does not have the capability CAP_SYS_ADMIN required to look up cookie values.
- The buffer was not large enough to hold the path of the directory entry.
VERSIONSAvailable since Linux 2.5.43. The ENAMETOOLONG error return was added in 2.5.70.
CONFORMING TOlookup_dcookie() is Linux-specific.
NOTESlookup_dcookie() is a special-purpose system call, currently used only by the oprofile profiler. It relies on a kernel driver to register cookies for directory entries.
COLOPHONThis page is part of release 3.22 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.
This document was created by man2html, using the manual pages.
Time: 05:33:04 GMT, December 24, 2015