名 前
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/ に 書 か れ て い る 。