OSDN Git Service

Convert release and draft pages to UTF-8.
[linuxjm/jm.git] / manual / LDP_man-pages / release / man2 / lookup_dcookie.2
index 0bbe22f..abb977d 100644 (file)
 .\" 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)"
-¤È¤¤¤¦Ê¸»úÎó¤¬Éղ䵤ì¤ë¤³¤È¤¬¤¢¤ë¡£
+という文字列が付加されることがある。