.\" Translated 2006-09-27 by Yuichi SATO <ysato444@yahoo.co.jp>, LDP v2.39
.\"
.TH READLINKAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
-.SH ̾Á°
-readlinkat \- ¥Ç¥£¥ì¥¯¥È¥ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤«¤éÁêÂÐŪ¤Ê°ÌÃ֤ˤ¢¤ë
-¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤ÎÃͤòÆɤà
-.SH ½ñ¼°
+.SH 名前
+readlinkat \- ディレクトリファイルディスクリプタから相対的な位置にある
+シンボリックリンクの値を読む
+.SH 書式
.nf
-.B #include <fcntl.h> /* AT_* Äê¿ô¤ÎÄêµÁ */
+.B #include <fcntl.h> /* AT_* 定数の定義 */
.B #include <unistd.h>
.sp
.BI "int readlinkat(int " dirfd ", const char *" pathname ,
.fi
.sp
.in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
+glibc 向けの機能検査マクロの要件
.RB ( feature_test_macros (7)
-»²¾È):
+参照):
.in
.sp
.BR readlinkat ():
.ad l
.RS 4
.TP 4
-glibc 2.10 °Ê¹ß:
+glibc 2.10 以降:
_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
.TP
-glibc 2.10 ¤è¤êÁ°:
+glibc 2.10 より前:
_ATFILE_SOURCE
.RE
.ad
.PD
-.SH ÀâÌÀ
+.SH 説明
.BR readlinkat ()
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢¤³¤Î man ¥Ú¡¼¥¸¤ÇÀâÌÀ¤·¤Æ¤¤¤ë°ã¤¤¤¬¤¢¤ë°Ê³°¤Ï¡¢
+システムコールは、この man ページで説明している違いがある以外は、
.BR readlink (2)
-¤ÈÁ´¤¯Æ±¤¸¤è¤¦¤ËÆ°ºî¤¹¤ë¡£
+と全く同じように動作する。
.I pathname
-¤Ç»ØÄꤵ¤ì¤ë¥Ñ¥¹Ì¾¤¬ÁêÂХѥ¹¤Ç¤¢¤ë¾ì¹ç¡¢
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
+で指定されるパス名が相対パスである場合、
+ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿
.I dirfd
-¤Ç»²¾È¤µ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹Ì¾¤È¤·¤Æ²ò¼á¤µ¤ì¤ë
+で参照されるディレクトリからの相対パス名として解釈される
.RB ( readlink (2)
-¤Ç¤Ï¡¢ÁêÂХѥ¹¤Ï¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î
-¥«¥ì¥ó¥È¥ï¡¼¥¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹¤È¤Ê¤ë)¡£
+では、相対パスは呼び出し元プロセスの
+カレントワーキングディレクトリからの相対パスとなる)。
.I pathname
-¤¬ÁêÂХѥ¹¤Ç¤¢¤ê¡¢¤«¤Ä
+が相対パスであり、かつ
.I dirfd
-¤¬ÆÃÊ̤ÊÃÍ
+が特別な値
.B AT_FDCWD
-¤Ç¤¢¤ë¾ì¹ç¡¢
+である場合、
.I pathname
-¤Ï
+は
.RB ( readlink (2)
-¤ÈƱ¤¸¤è¤¦¤Ë) ¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î
-¥«¥ì¥ó¥È¥ï¡¼¥¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹Ì¾¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¡£
+と同じように) 呼び出し元プロセスの
+カレントワーキングディレクトリからの相対パス名として解釈される。
.I pathname
-¤¬ÀäÂХѥ¹¤Ç¤¢¤ë¾ì¹ç¡¢
+が絶対パスである場合、
.I dirfd
-¤Ï̵»ë¤µ¤ì¤ë¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤·¤¿¾ì¹ç¡¢
+は無視される。
+.SH 返り値
+成功した場合、
.BR readlinkat ()
-¤Ï
+は
.I buf
-¤Ë³ÊǼ¤µ¤ì¤¿¥Ð¥¤¥È¿ô¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤¬ÊÖ¤µ¤ì¤Æ¡¢
+に格納されたバイト数を返す。
+エラーの場合、\-1 が返されて、
.I errno
-¤Ë¤Ï¥¨¥é¡¼¤ò¼¨¤¹Ãͤ¬ÀßÄꤵ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
+にはエラーを示す値が設定される。
+.SH ã\82¨ã\83©ã\83¼
.BR readlink (2)
-¤ÈƱ¤¸¥¨¥é¡¼¤¬
+と同じエラーが
.BR readlinkat ()
-¤Ç¤âµ¯¤³¤ë¡£
+でも起こる。
.BR readlinkat ()
-¤Ç¤Ï¡¢¤½¤Î¾¤Ë°Ê²¼¤Î¥¨¥é¡¼¤¬µ¯¤³¤ë:
+では、その他に以下のエラーが起こる:
.TP
.B EBADF
.I dirfd
-¤¬Í¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
+が有効なファイルディスクリプタでない。
.TP
.B ENOTDIR
.I pathname
-¤¬ÁêÂХѥ¹¤Ç¡¢¤«¤Ä
+が相対パスで、かつ
.I dirfd
-¤¬¥Ç¥£¥ì¥¯¥È¥ê°Ê³°¤Î¥Õ¥¡¥¤¥ë¤ò»²¾È¤¹¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤¢¤ë¡£
-.SH ¥Ð¡¼¥¸¥ç¥ó
+がディレクトリ以外のファイルを参照するファイルディスクリプタである。
+.SH バージョン
.BR readlinkat ()
-¤Ï Linux ¥«¡¼¥Í¥ë 2.6.16 ¤ÇÄɲ䵤줿¡£
-.SH ½àµò
+は Linux カーネル 2.6.16 で追加された。
+.SH 準拠
POSIX.1-2008.
-.SH Ãí°Õ
+.SH 注意
.BR readlinkat ()
-¤¬É¬ÍפÊÍýͳ¤Ë¤Ä¤¤¤Æ¤Ï¡¢
+が必要な理由については、
.BR openat (2)
-¤ò»²¾È¤¹¤ë¤³¤È¡£
-.SH ´ØÏ¢¹àÌÜ
+を参照すること。
+.SH 関連項目
.BR openat (2),
.BR readlink (2),
.BR path_resolution (7)