.\" Updated 2003-09-30, Akihiro MOTOKI
.\" Updated 2005-02-10, Akihiro MOTOKI
.\"
-.\"WORD: opaque identifier ÆâÉô¼±ÊÌ»Ò
-.\"WORD: Linux specific Linux Æȼ«
-.\"WORD: capability ¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£
+.\"WORD: opaque identifier 内部識別子
+.\"WORD: Linux specific Linux 独自
+.\"WORD: capability ã\82±ã\83¼ã\83\91ã\83\93ã\83ªã\83\86ã\82£
.\"
.TH LOOKUP_DCOOKIE 2 2004-06-17 "Linux" "Linux Programmer's Manual"
-.SH ̾Á°
-lookup_dcookie \- ¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Î¥Ñ¥¹Ì¾¤òÊÖ¤¹
-.SH ½ñ¼°
+.SH 名前
+lookup_dcookie \- ディレクトリ・エントリのパス名を返す
+.SH 書式
.BI "int lookup_dcookie(u64 " cookie ", char *" buffer ", size_t " len );
-.SH ÀâÌÀ
+.SH 説明
.I cookie
-ÃͤǻØÄꤵ¤ì¤¿¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Î¥Õ¥ë¥Ñ¥¹Ì¾¤ò¸¡º÷¤¹¤ë¡£
-cookie ¤Ï¡¢¸Ä¡¹¤Î¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤ò¶èÊ̤¹¤ëÆâÉô¼±ÊÌ»Ò (opaque
-identifier) ¤Ç¤¢¤ë¡£°ú¤¿ô¤Ç»ØÄꤵ¤ì¤¿¥Ð¥Ã¥Õ¥¡¤Ë¡¢¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Î
-¥Õ¥ë¥Ñ¥¹Ì¾¤¬³ÊǼ¤µ¤ì¤ë¡£
+値で指定されたディレクトリ・エントリのフルパス名を検索する。
+cookie は、個々のディレクトリ・エントリを区別する内部識別子 (opaque
+identifier) である。引き数で指定されたバッファに、ディレクトリ・エントリの
+フルパス名が格納される。
.BR lookup_dcookie ()
-¤¬Àµ¾ï¤ËÃͤòÊÖ¤¹¤¿¤á¤Ë¤Ï¡¢¥«¡¼¥Í¥ë¤¬¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Ø¤Î cookie »²¾È¤ò
-ÊÝ»ý¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤·¤¿¾ì¹ç¡¢
+が正常に値を返すためには、カーネルがディレクトリ・エントリへの cookie 参照を
+保持していなければならない。
+.SH 返り値
+成功した場合、
.BR lookup_dcookie ()
-¤Ï¥Ð¥Ã¥Õ¥¡¤Ë¥³¥Ô¡¼¤·¤¿¥Ñ¥¹Ê¸»úÎó¤ÎŤµ¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤òÊÖ¤·¡¢
+はバッファにコピーしたパス文字列の長さを返す。
+エラーの場合は \-1 を返し、
.I errno
-¤ËŬÀÚ¤ÊÃͤòÀßÄꤹ¤ë¡£
-.SH ¥¨¥é¡¼
+に適切な値を設定する。
+.SH ã\82¨ã\83©ã\83¼
.TP
.B EFAULT
-¥Ð¥Ã¥Õ¥¡¤¬Í¸ú¤Ç¤Ê¤«¤Ã¤¿¡£
+バッファが有効でなかった。
.TP
.B EINVAL
-¸¡º÷¤¬¹Ô¤ï¤ì¤¿»þ¡¢cookie ¤È¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Î¥Þ¥Ã¥Ô¥ó¥°¤¬¥«¡¼¥Í¥ë¤Ë
-ÅÐÏ¿¤µ¤ì¤Æ¤¤¤Ê¤«¤Ã¤¿¤«¡¢¤Þ¤¿¤Ï cookie ¤¬Í¸ú¤Ê¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤ò
-»²¾È¤·¤Æ¤¤¤Ê¤¤¡£
+検索が行われた時、cookie とディレクトリ・エントリのマッピングがカーネルに
+登録されていなかったか、または cookie が有効なディレクトリ・エントリを
+参照していない。
.TP
.B ENAMETOOLONG
-̾Á°¤¬¥Ð¥Ã¥Õ¥¡¤ËÆþ¤êÀÚ¤é¤Ê¤«¤Ã¤¿¡£
+名前がバッファに入り切らなかった。
.TP
.B ENOMEM
-¥«¡¼¥Í¥ë¤¬¡¢¥Ñ¥¹Ì¾¤òÊÝ»ý¤¹¤ë°ì»þ¥Ð¥Ã¥Õ¥¡ÍѤΥá¥â¥ê¤ò³ä¤êÅö¤Æ¤ë¤³¤È¤¬
-¤Ç¤¤Ê¤«¤Ã¤¿¡£
+カーネルが、パス名を保持する一時バッファ用のメモリを割り当てることが
+できなかった。
.TP
.B EPERM
-¥×¥í¥»¥¹¤¬ cookie Ãͤò¸¡º÷¤¹¤ë¤Î¤ËɬÍפʥ±¡¼¥Ñ¥Ó¥ê¥Æ¥£
+ã\83\97ã\83ã\82»ã\82¹ã\81\8c cookie å\80¤ã\82\92æ¤\9cç´¢ã\81\99ã\82\8bã\81®ã\81«å¿\85è¦\81ã\81ªã\82±ã\83¼ã\83\91ã\83\93ã\83ªã\83\86ã\82£
.B CAP_SYS_ADMIN
-¤ò»ý¤Ã¤Æ¤¤¤Ê¤¤¡£
+を持っていない。
.TP
.B ERANGE
-¥Ð¥Ã¥Õ¥¡¤¬¡¢¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Î¥Ñ¥¹Ì¾¤ò¼ýÍƤ¹¤ë¤Î¤Ë
-½½Ê¬¤ÊÂ礤µ¤Ç¤Ï¤Ê¤«¤Ã¤¿¡£
-.SH ¥Ð¡¼¥¸¥ç¥ó
-Linux 2.5.43 °Ê¹ß¤ÇÍøÍѤǤ¤ë¡£
-¥¨¥é¡¼
+バッファが、ディレクトリ・エントリのパス名を収容するのに
+十分な大きさではなかった。
+.SH バージョン
+Linux 2.5.43 以降で利用できる。
+ã\82¨ã\83©ã\83¼
.B ENAMETOOLONG
-¤òÊÖ¤¹»ÅÍÍ¤Ï 2.5.70 ¤ÇÄɲ䵤줿¡£
-.SH ½àµò
+を返す仕様は 2.5.70 で追加された。
+.SH 準拠
.BR lookup_dcookie ()
-¤Ï Linux Æȼ«¤Î´Ø¿ô¤Ç¤¢¤ë¡£
-.SH Ãí°Õ
+は Linux 独自の関数である。
+.SH 注意
.BR lookup_dcookie ()
-¤ÏÆüì¤ÊÍÑÅӤ˻Ȥï¤ì¤ë¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ç¡¢¸½ºß¤Î¤È¤³¤í oprofile profiler ¤Ç
-»È¤ï¤ì¤Æ¤¤¤ë¤À¤±¤Ç¤¢¤ë¡£
+は特殊な用途に使われるシステムコールで、現在のところ oprofile profiler で
+使われているだけである。
-»ØÄꤵ¤ì¤¿¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤¬ºï½ü¤µ¤ì¤Æ¤¤¤¿¾ì¹ç¡¢ÊÖ¤µ¤ì¤ë¥Ñ¥¹Ì¾¤ÎºÇ¸å¤Ë
+指定されたディレクトリ・エントリが削除されていた場合、返されるパス名の最後に
" (deleted)"
-¤È¤¤¤¦Ê¸»úÎó¤¬Éղ䵤ì¤ë¤³¤È¤¬¤¢¤ë¡£
+という文字列が付加されることがある。