.\" 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"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O lookup_dcookie \- return a directory entry's path
-lookup_dcookie \- ¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Î¥Ñ¥¹Ì¾¤òÊÖ¤¹
+lookup_dcookie \- ディレクトリ・エントリのパス名を返す
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.BI "int lookup_dcookie(u64 " cookie ", char *" buffer ", size_t " len );
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O Look up the full path of the directory entry specified by the value
.\"O .IR cookie .
.\"O The cookie is an opaque identifier uniquely identifying a particular
.\"O directory entry.
.\"O The buffer given is filled in with the full path of the directory entry.
.I cookie
-ÃͤǻØÄꤵ¤ì¤¿¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Î¥Õ¥ë¥Ñ¥¹Ì¾¤ò¸¡º÷¤¹¤ë¡£
-cookie ¤Ï¡¢¸Ä¡¹¤Î¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤ò¶èÊ̤¹¤ëÆâÉô¼±ÊÌ»Ò (opaque
-identifier) ¤Ç¤¢¤ë¡£°ú¤¿ô¤Ç»ØÄꤵ¤ì¤¿¥Ð¥Ã¥Õ¥¡¤Ë¡¢¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Î
-¥Õ¥ë¥Ñ¥¹Ì¾¤¬³ÊǼ¤µ¤ì¤ë¡£
+値で指定されたディレクトリ・エントリのフルパス名を検索する。
+cookie は、個々のディレクトリ・エントリを区別する内部識別子 (opaque
+identifier) である。引き数で指定されたバッファに、ディレクトリ・エントリの
+フルパス名が格納される。
.\"O For
.\"O .BR lookup_dcookie ()
.\"O to return successfully,
.\"O the kernel must still hold a cookie reference to the directory entry.
.BR lookup_dcookie ()
-¤¬Àµ¾ï¤ËÃͤòÊÖ¤¹¤¿¤á¤Ë¤Ï¡¢¥«¡¼¥Í¥ë¤¬¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Ø¤Î cookie »²¾È¤ò
-ÊÝ»ý¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+が正常に値を返すためには、カーネルがディレクトリ・エントリへの cookie 参照を
+保持していなければならない。
.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O On success,
.\"O .BR lookup_dcookie ()
.\"O returns the length of the path string copied into the buffer.
.\"O On error, \-1 is returned, and
.\"O .I errno
.\"O is set appropriately.
-À®¸ù¤·¤¿¾ì¹ç¡¢
+成功した場合、
.BR lookup_dcookie ()
-¤Ï¥Ð¥Ã¥Õ¥¡¤Ë¥³¥Ô¡¼¤·¤¿¥Ñ¥¹Ê¸»úÎó¤ÎŤµ¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤òÊÖ¤·¡¢
+はバッファにコピーしたパス文字列の長さを返す。
+エラーの場合は \-1 を返し、
.I errno
-¤ËŬÀÚ¤ÊÃͤòÀßÄꤹ¤ë¡£
+に適切な値を設定する。
.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
+.SH ã\82¨ã\83©ã\83¼
.TP
.B EFAULT
.\"O The buffer was not valid.
-¥Ð¥Ã¥Õ¥¡¤¬Í¸ú¤Ç¤Ê¤«¤Ã¤¿¡£
+バッファが有効でなかった。
.TP
.B EINVAL
.\"O The kernel has no registered cookie/directory entry mappings at the
.\"O time of lookup, or the cookie does not refer to a valid directory entry.
-¸¡º÷¤¬¹Ô¤ï¤ì¤¿»þ¡¢cookie ¤È¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Î¥Þ¥Ã¥Ô¥ó¥°¤¬¥«¡¼¥Í¥ë¤Ë
-ÅÐÏ¿¤µ¤ì¤Æ¤¤¤Ê¤«¤Ã¤¿¤«¡¢¤Þ¤¿¤Ï cookie ¤¬Í¸ú¤Ê¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤ò
-»²¾È¤·¤Æ¤¤¤Ê¤¤¡£
+検索が行われた時、cookie とディレクトリ・エントリのマッピングがカーネルに
+登録されていなかったか、または cookie が有効なディレクトリ・エントリを
+参照していない。
.TP
.B ENAMETOOLONG
.\"O The name could not fit in the buffer.
-̾Á°¤¬¥Ð¥Ã¥Õ¥¡¤ËÆþ¤êÀÚ¤é¤Ê¤«¤Ã¤¿¡£
+名前がバッファに入り切らなかった。
.TP
.B ENOMEM
.\"O The kernel could not allocate memory for the temporary buffer holding
.\"O the path.
-¥«¡¼¥Í¥ë¤¬¡¢¥Ñ¥¹Ì¾¤òÊÝ»ý¤¹¤ë°ì»þ¥Ð¥Ã¥Õ¥¡ÍѤΥá¥â¥ê¤ò³ä¤êÅö¤Æ¤ë¤³¤È¤¬
-¤Ç¤¤Ê¤«¤Ã¤¿¡£
+カーネルが、パス名を保持する一時バッファ用のメモリを割り当てることが
+できなかった。
.TP
.B EPERM
.\"O The process does not have the capability
.\"O .B CAP_SYS_ADMIN
.\"O required to look up cookie values.
-¥×¥í¥»¥¹¤¬ 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
.\"O The buffer was not large enough to hold the path of the directory entry.
-¥Ð¥Ã¥Õ¥¡¤¬¡¢¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤Î¥Ñ¥¹Ì¾¤ò¼ýÍƤ¹¤ë¤Î¤Ë
-½½Ê¬¤ÊÂ礤µ¤Ç¤Ï¤Ê¤«¤Ã¤¿¡£
+バッファが、ディレクトリ・エントリのパス名を収容するのに
+十分な大きさではなかった。
.\"O .SH VERSIONS
.\"O Since Linux 2.5.43.
.\"O The
.\"O .B ENAMETOOLONG
.\"O error return was added in 2.5.70.
-.SH ¥Ð¡¼¥¸¥ç¥ó
-Linux 2.5.43 °Ê¹ß¤ÇÍøÍѤǤ¤ë¡£
-¥¨¥é¡¼
+.SH バージョン
+Linux 2.5.43 以降で利用できる。
+ã\82¨ã\83©ã\83¼
.B ENAMETOOLONG
-¤òÊÖ¤¹»ÅÍÍ¤Ï 2.5.70 ¤ÇÄɲ䵤줿¡£
+を返す仕様は 2.5.70 で追加された。
.\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 準拠
.\"O .BR lookup_dcookie ()
.\"O is Linux-specific.
.BR lookup_dcookie ()
-¤Ï Linux Æȼ«¤Î´Ø¿ô¤Ç¤¢¤ë¡£
+は Linux 独自の関数である。
.\"O .SH "NOTES"
-.SH Ãí°Õ
+.SH 注意
.\"O .BR lookup_dcookie ()
.\"O is a special-purpose system call, currently used only by the oprofile profiler.
.\"O It relies on a kernel driver to register cookies for directory entries.
.BR lookup_dcookie ()
-¤ÏÆüì¤ÊÍÑÅӤ˻Ȥï¤ì¤ë¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ç¡¢¸½ºß¤Î¤È¤³¤í oprofile profiler ¤Ç
-»È¤ï¤ì¤Æ¤¤¤ë¤À¤±¤Ç¤¢¤ë¡£
+は特殊な用途に使われるシステムコールで、現在のところ oprofile profiler で
+使われているだけである。
.\"O The path returned may be suffixed by the string " (deleted)" if the directory
.\"O entry has been removed.
-»ØÄꤵ¤ì¤¿¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤¬ºï½ü¤µ¤ì¤Æ¤¤¤¿¾ì¹ç¡¢ÊÖ¤µ¤ì¤ë¥Ñ¥¹Ì¾¤ÎºÇ¸å¤Ë
+指定されたディレクトリ・エントリが削除されていた場合、返されるパス名の最後に
" (deleted)"
-¤È¤¤¤¦Ê¸»úÎó¤¬Éղ䵤ì¤ë¤³¤È¤¬¤¢¤ë¡£
+という文字列が付加されることがある。
OSDN Git Service
