OSDN Git Service

(split) LDP: draft snapshot generated from latest ja.po files.
[linuxjm/LDP_man-pages.git] / draft / man2 / lookup_dcookie.2
index 2e23bd3..f75de8b 100644 (file)
 .\"
 .\" Modified 2004-06-17 Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
-.\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
-.\"         all rights reserved.
-.\" Translated 2003-06-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2003-09-30, Akihiro MOTOKI
-.\" Updated 2005-02-10, Akihiro MOTOKI
+.\"*******************************************************************
 .\"
-.\"WORD:       opaque identifier       内部識別子
-.\"WORD:       Linux specific          Linux 独自
-.\"WORD:       capability              ケーパビリティ
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH LOOKUP_DCOOKIE 2 2004-06-17 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
+.\"*******************************************************************
+.TH LOOKUP_DCOOKIE 2 2004\-06\-17 Linux "Linux Programmer's Manual"
 .SH 名前
-.\"O lookup_dcookie \- return a directory entry's path
 lookup_dcookie \- ディレクトリ・エントリのパス名を返す
-.\"O .SH SYNOPSIS
 .SH 書式
-.BI "int lookup_dcookie(u64 " cookie ", char *" buffer ", size_t " len );
-.\"O .SH DESCRIPTION
+\fBint lookup_dcookie(u64 \fP\fIcookie\fP\fB, char *\fP\fIbuffer\fP\fB, size_t
+\fP\fIlen\fP\fB);\fP
 .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) である。引き数で指定されたバッファに、ディレクトリ・エントリの
-フルパス名が格納される。
+\fIcookie\fP 値で指定されたディレクトリ・エントリのフルパス名を検索する。 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 参照を
+\fBlookup_dcookie\fP()  が正常に値を返すためには、カーネルがディレクトリ・エントリへの cookie 参照を
 保持していなければならない。
-.\"O .SH "RETURN VALUE"
 .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 を返し、
-.I errno
-に適切な値を設定する。
-.\"O .SH ERRORS
+成功した場合、 \fBlookup_dcookie\fP()  はバッファにコピーしたパス文字列の長さを返す。 エラーの場合は \-1 を返し、
+\fIerrno\fP に適切な値を設定する。
 .SH エラー
-.TP
-.B EFAULT
-.\"O The buffer was not valid.
+.TP 
+\fBEFAULT\fP
 バッファが有効でなかった。
-.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 が有効なディレクトリ・エントリを
-参照していない。
-.TP
-.B ENAMETOOLONG
-.\"O The name could not fit in the buffer.
+.TP 
+\fBEINVAL\fP
+検索が行われた時、cookie とディレクトリ・エントリのマッピングがカーネルに 登録されていなかったか、または cookie
+が有効なディレクトリ・エントリを 参照していない。
+.TP 
+\fBENAMETOOLONG\fP
 名前がバッファに入り切らなかった。
-.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 値を検索するのに必要なケーパビリティ
-.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.
+.TP 
+\fBENOMEM\fP
+カーネルが、パス名を保持する一時バッファ用のメモリを割り当てることが できなかった。
+.TP 
+\fBEPERM\fP
+プロセスが cookie 値を検索するのに必要なケーパビリティ \fBCAP_SYS_ADMIN\fP を持っていない。
+.TP 
+\fBERANGE\fP
+バッファが、ディレクトリ・エントリのパス名を収容するのに 十分な大きさではなかった。
 .SH バージョン
-Linux 2.5.43 以降で利用できる。
-エラー
-.B ENAMETOOLONG
-を返す仕様は 2.5.70 で追加された。
-.\"O .SH "CONFORMING TO"
+Linux 2.5.43 以降で利用できる。 エラー \fBENAMETOOLONG\fP を返す仕様は 2.5.70 で追加された。
 .SH 準拠
-.\"O .BR lookup_dcookie ()
-.\"O is Linux-specific.
-.BR lookup_dcookie ()
-は Linux 独自の関数である。
-.\"O .SH "NOTES"
+\fBlookup_dcookie\fP()  は Linux 独自の関数である。
 .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 で
+\fBlookup_dcookie\fP()  は特殊な用途に使われるシステムコールで、現在のところ oprofile profiler で
 使われているだけである。
 
-.\"O The path returned may be suffixed by the string " (deleted)" if the directory
-.\"O entry has been removed.
-指定されたディレクトリ・エントリが削除されていた場合、返されるパス名の最後に
-" (deleted)"
-という文字列が付加されることがある。
+指定されたディレクトリ・エントリが削除されていた場合、返されるパス名の最後に " (deleted)" という文字列が付加されることがある。