Manpages

名 前

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)" と い う 文 字 列 が 付 加 さ れ る こ と が あ る 。

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。