LOOKUP_DCOOKIE(2) Linux Programmer’s Manual LOOKUP_DCOOKIE(2) 名前 lookup_dcookie - ディレクトリ・エントリのパス名を返す 書式 int lookup_dcookie(u64 cookie, char *buffer, size_t len); 説明 cookie 値 で 指定されたディレクトリ・エントリのフルパス名を検索する。 cookie は、個々のディレクトリ・エントリを区別する内部 識 別 子 (opaque identifier) である。引き数で指定されたバッファに、ディレクトリ・エント リのフルパス名が格納される。 lookup_dcookie() が正常に値を返すためには、カーネルがディレクトリ・エン トリへの cookie 参照を保持していなければならない。 返り値 成 功した場合、 lookup_dcookie() はバッファにコピーしたパス文字列の長さ を返す。エラーの場合は -1 を返し、 errno に適切な値を設定する。 エラー EFAULT バッファが有効でなかった。 EINVAL 検索が行われた時、cookie とディレクトリ・エントリのマッピング が カーネルに登録されていなかったか、または cookie が有効なディレク トリ・エントリを参照していない。 ENAMETOOLONG 名前がバッファに入り切らなかった。 ENOMEM カーネルが、パス名を保持する一時バッファ用のメモリを割り当てるこ とができなかった。 EPERM プ ロ セ ス が cookie 値 を 検索するのに必要なケーパビリティ CAP_SYS_ADMIN を持っていない。 ERANGE バッファが、ディレクトリ・エントリのパス名を収容するのに十分な大 きさではなかった。 バージョン Linux 2.5.43 以降で利用できる。エラー ENAMETOOLONG を返す仕様は 2.5.70 で追加された。 準拠 lookup_dcookie() は Linux 独自の関数である。 注意 lookup_dcookie() は特殊な用途に使われるシステムコールで、現在のと こ ろ oprofile profiler で使われているだけである。 指 定されたディレクトリ・エントリが削除されていた場合、返されるパス名の 最後に " (deleted)" という文字列が付加されることがある。 Linux 2004-06-17 LOOKUP_DCOOKIE(2)
LOOKUP_DCOOKIE(2) Linux Programmer’s Manual LOOKUP_DCOOKIE(2) NAME lookup_dcookie - return a directory entry’s path SYNOPSIS int lookup_dcookie(u64 cookie, char *buffer, size_t len); DESCRIPTION Look up the full path of the directory entry specified by the value cookie The cookie is an opaque identifier uniquely identifying a par- ticular directory entry. The buffer given is filled in with the full path of the directory entry. For lookup_dcookie() to return successfully, the kernel must still hold a cookie reference to the directory entry. RETURN VALUE On success, lookup_dcookie() returns the length of the path string copied into the buffer. On error, -1 is returned, and errno is set appropriately. ERRORS EFAULT The buffer was not valid. EINVAL 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. ENAMETOOLONG The name could not fit in the buffer. ENOMEM The kernel could not allocate memory for the temporary buffer holding the path. EPERM The process does not have the capability CAP_SYS_ADMIN required to look up cookie values. ERANGE The buffer was not large enough to hold the path of the direc- tory entry. VERSIONS Available since Linux 2.5.43. The ENAMETOOLONG error return was added in 2.5.70. CONFORMING TO lookup_dcookie() is Linux-specific. NOTES lookup_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. The path returned may be suffixed by the string " (deleted)" if the directory entry has been removed. COLOPHON This 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/. Linux 2004-06-17 LOOKUP_DCOOKIE(2)
コロナウイルスの日ごとの感染者数・死者数をグラフ化してみました。どの国が増加傾向にあり、どの国が終息に向かっているかを視覚化しています。
Copyright(C) linux-cmd.com All Rights Reserved. Author Takayuki Yukawa