lookup_dcookie() - Unix，Linux系統呼叫

名稱

lookup_dcookie - 返回目錄項的路徑

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

查詢由cookie值指定的目錄項的完整路徑。cookie是一個不透明的識別符號，唯一地標識特定的目錄項。給定的緩衝區將填充目錄項的完整路徑。

為了使lookup_dcookie()成功返回，核心必須仍然持有對目錄項的cookie引用。

lookup_dcookie()是一個專用系統呼叫，目前僅由oprofile分析器使用。它依賴於核心驅動程式來註冊目錄項的cookie。

如果目錄項已被刪除，則返回的路徑可能以字串“ (deleted)”結尾。

成功時，lookup_dcookie()返回複製到緩衝區的路徑字串的長度。出錯時，返回-1，並適當地設定errno。

標籤	描述
EFAULT	緩衝區無效。
EINVAL	查詢時核心沒有註冊cookie/目錄項對映，或者cookie不引用有效的目錄項。
ENAMETOOLONG
	名稱無法放入緩衝區。
ENOMEM	核心無法為儲存路徑的臨時緩衝區分配記憶體。
EPERM	程序不具備查詢cookie值所需的CAP_SYS_ADMIN許可權。
ERANGE	緩衝區不足以容納目錄項的路徑。

lookup_dcookie()是Linux特有的。

從Linux 2.5.43開始。ENAMETOOLONG錯誤返回在2.5.70中新增。

列印頁面