.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
-.\" Japanese Version Copyright (c) 2006 Yuichi SATO
-.\" all rights reserved.
-.\" Translated 2006-10-13 by Yuichi SATO <ysato444@yahoo.co.jp>, LDP v2.39
+.\"*******************************************************************
.\"
-.TH FSTATAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH ̾Á°
-.\"O fstatat \- get file status relative to a directory file descriptor
-fstatat \- ¥Ç¥£¥ì¥¯¥È¥ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤«¤éÁêÂÐŪ¤Ê°ÌÃ֤ˤ¢¤ë¥Õ¥¡¥¤¥ë¤Î¾õÂÖ¤ò¼èÆÀ¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH FSTATAT 2 2011\-09\-19 Linux "Linux Programmer's Manual"
+.SH 名前
+fstatat \- ディレクトリファイルディスクリプタから相対的な位置にあるファイルの状態を取得する
+.SH 書式
.nf
-.\"O .B #include <fcntl.h> /* Definition of AT_* constants */
-.B #include <fcntl.h> /* AT_* Äê¿ô¤ÎÄêµÁ */
-.B #include <sys/stat.h>
+\fB#include <fcntl.h> /* AT_* 定数の定義 */\fP
+\fB#include <sys/stat.h>\fP
.sp
-.BI "int fstatat(int " dirfd ", const char *" pathname ", struct stat *" \
-buf ,
-.BI " int " flags );
+\fBint fstatat(int \fP\fIdirfd\fP\fB, const char *\fP\fIpathname\fP\fB, struct stat *\fP\fIbuf\fP\fB,\fP
+\fB int \fP\fIflags\fP\fB);\fP
.fi
.sp
.in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.BR fstatat ():
-.br
-.\"O Since glibc 2.10: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
-glibc 2.10 °Ê¹ß: _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
-.br
-.\"O Before glibc 2.10:
-glibc 2.10 ¤è¤êÁ°:
+\fBfstatat\fP():
+.PD 0
+.ad l
+.RS 4
+.TP 4
+glibc 2.10 以降:
+_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
+.TP
+glibc 2.10 より前:
_ATFILE_SOURCE
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The
-.\"O .BR fstatat ()
-.\"O system call operates in exactly the same way as
-.\"O .BR stat (2),
-.\"O except for the differences described in this manual page.
-.BR fstatat ()
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢¤³¤Î man ¥Ú¡¼¥¸¤ÇÀâÌÀ¤·¤Æ¤¤¤ë°ã¤¤¤¬¤¢¤ë°Ê³°¤Ï¡¢
-.BR stat (2)
-¤ÈÁ´¤¯Æ±¤¸¤è¤¦¤ËÆ°ºî¤¹¤ë¡£
+.RE
+.ad
+.PD
+.SH 説明
+\fBfstatat\fP() システムコールは、この man ページで説明している違いがある以外は、 \fBstat\fP(2) と全く同じように動作する。
+
+\fIpathname\fP で指定されるパス名が相対パスである場合、 ファイルディスクリプタ \fIdirfd\fP
+で参照されるディレクトリからの相対パス名として解釈される (\fBstat\fP(2)
+では、相対パスは呼び出し元プロセスのカレントワーキングディレクトリからの 相対パスとなる)。
-.\"O If the pathname given in
-.\"O .I pathname
-.\"O is relative, then it is interpreted relative to the directory
-.\"O referred to by the file descriptor
-.\"O .I dirfd
-.\"O (rather than relative to the current working directory of
-.\"O the calling process, as is done by
-.\"O .BR stat (2)
-.\"O for a relative pathname).
-.I pathname
-¤Ç»ØÄꤵ¤ì¤ë¥Ñ¥¹Ì¾¤¬ÁêÂХѥ¹¤Ç¤¢¤ë¾ì¹ç¡¢
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I dirfd
-¤Ç»²¾È¤µ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹Ì¾¤È¤·¤Æ²ò¼á¤µ¤ì¤ë
-.RB ( stat (2)
-¤Ç¤Ï¡¢ÁêÂХѥ¹¤Ï¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î¥«¥ì¥ó¥È¥ï¡¼¥¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤Î
-ÁêÂХѥ¹¤È¤Ê¤ë)¡£
+\fIpathname\fP が相対パスであり、かつ \fIdirfd\fP が特別な値 \fBAT_FDCWD\fP である場合、 \fIpathname\fP は
+(\fBstat\fP(2) と同じように) 呼び出し元プロセスの カレントワーキングディレクトリからの相対パス名として解釈される。
-.\"O If
-.\"O .I pathname
-.\"O is relative and
-.\"O .I dirfd
-.\"O is the special value
-.\"O .BR AT_FDCWD ,
-.\"O then
-.\"O .I pathname
-.\"O is interpreted relative to the current working
-.\"O directory of the calling process (like
-.\"O .BR stat (2)).
-.I pathname
-¤¬ÁêÂХѥ¹¤Ç¤¢¤ê¡¢¤«¤Ä
-.I dirfd
-¤¬ÆÃÊ̤ÊÃÍ
-.B AT_FDCWD
-¤Ç¤¢¤ë¾ì¹ç¡¢
-.I pathname
-¤Ï
-.RB ( stat (2)
-¤ÈƱ¤¸¤è¤¦¤Ë) ¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î
-¥«¥ì¥ó¥È¥ï¡¼¥¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹Ì¾¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¡£
+\fIpathname\fP が絶対パスである場合、 \fIdirfd\fP は無視される。
-.\"O If
-.\"O .I pathname
-.\"O is absolute, then
-.\"O .I dirfd
-.\"O is ignored.
-.I pathname
-¤¬ÀäÂХѥ¹¤Ç¤¢¤ë¾ì¹ç¡¢
-.I dirfd
-¤Ï̵»ë¤µ¤ì¤ë¡£
+\fIflags\fP には 0 または以下のフラグの 1 つ以上を論理和 (OR) で指定する。
+.TP
+\fBAT_NO_AUTOMOUNT\fP (Linux 2.6.38 以降)
+Don't automount the terminal ("basename") component of \fIpathname\fP if it is
+a directory that is an automount point. This allows the caller to gather
+attributes of an automount point (rather than the location it would mount).
+This flag can be used in tools that scan directories to prevent
+mass\-automounting of a directory of automount points. The
+\fBAT_NO_AUTOMOUNT\fP flag has no effect if the mount point has already been
+mounted over.
+.TP
+\fBAT_SYMLINK_NOFOLLOW\fP
+\fIpathname\fP がシンボリックリンクの場合は、それを辿るのではなく、 \fBlstat\fP(2) と同様にリンク自身についての情報を返す
+(デフォルトでは、 \fBfstatat\fP() は \fBstat\fP(2) と同様にシンボリックリンクを辿る)。
+.SH 返り値
+成功した場合、 \fBfstatat\fP() は 0 を返す。 エラーの場合、\-1 が返されて、 \fIerrno\fP にはエラーを示す値が設定される。
+.SH エラー
+\fBstat\fP(2) と同じエラーが \fBfstatat\fP() でも起こる。 \fBfstatat\fP() では、その他に以下のエラーが起こる:
+.TP
+\fBEBADF\fP
+\fIdirfd\fP が有効なファイルディスクリプタでない。
+.TP
+\fBEINVAL\fP
+\fIflags\fP に不正なフラグ値が指定された。
+.TP
+\fBENOTDIR\fP
+\fIpathname\fP が相対パスで、かつ \fIdirfd\fP がディレクトリ以外のファイルを参照するファイルディスクリプタである。
+.SH バージョン
+\fBfstatat\fP() は Linux カーネル 2.6.16 で追加された。
+.SH 準拠
+POSIX.1\-2008. Solaris には、これと同じようなシステムコールが存在する。
+.SH 注意
+\fBfstatat\fP() が必要な理由については、 \fBopenat\fP(2) を参照すること。
-.\"O .I flags
-.\"O can either be 0, or include the following flag:
-.I flags
-¤Ï 0 ¤Þ¤¿¤Ï°Ê²¼¤Î¥Õ¥é¥°¤Ç¤¢¤ë¡£
-.TP
-.B AT_SYMLINK_NOFOLLOW
-.\"O If
-.\"O .I pathname
-.\"O is a symbolic link, do not dereference it:
-.\"O instead return information about the link itself, like
-.\"O .BR lstat (2).
-.\"O (By default,
-.\"O .BR fstatat ()
-.\"O dereferences symbolic links, like
-.\"O .BR stat (2).)
-.I pathname
-¤¬¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Î¾ì¹ç¤Ï¡¢¤½¤ì¤òé¤ë¤Î¤Ç¤Ï¤Ê¤¯¡¢
-.BR lstat (2)
-¤ÈƱÍͤ˥ê¥ó¥¯¼«¿È¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤òÊÖ¤¹
-(¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï¡¢
-.BR fstatat ()
-¤Ï
-.BR stat (2)
-¤ÈƱÍͤ˥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤òé¤ë)¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O On success,
-.\"O .BR fstatat ()
-.\"O returns 0.
-À®¸ù¤·¤¿¾ì¹ç¡¢
-.BR fstatat ()
-¤Ï 0 ¤òÊÖ¤¹¡£
-.\"O On error, \-1 is returned and
-.\"O .I errno
-.\"O is set to indicate the error.
-¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤¬ÊÖ¤µ¤ì¤Æ¡¢
-.I errno
-¤Ë¤Ï¥¨¥é¡¼¤ò¼¨¤¹Ãͤ¬ÀßÄꤵ¤ì¤ë¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.\"O The same errors that occur for
-.\"O .BR stat (2)
-.\"O can also occur for
-.\"O .BR fstatat ().
-.BR stat (2)
-¤ÈƱ¤¸¥¨¥é¡¼¤¬
-.BR fstatat ()
-¤Ç¤âµ¯¤³¤ë¡£
-.\"O The following additional errors can occur for
-.\"O .BR fstatat ():
-.BR fstatat ()
-¤Ç¤Ï¡¢¤½¤Î¾¤Ë°Ê²¼¤Î¥¨¥é¡¼¤¬µ¯¤³¤ë:
-.TP
-.B EBADF
-.\"O .I dirfd
-.\"O is not a valid file descriptor.
-.I dirfd
-¤¬Í¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
-.TP
-.B EINVAL
-.\"O Invalid flag specified in
-.\"O .IR flags .
-.I flags
-¤ËÉÔÀµ¤Ê¥Õ¥é¥°Ãͤ¬»ØÄꤵ¤ì¤¿¡£
-.TP
-.B ENOTDIR
-.\"O .I pathname
-.\"O is relative and
-.\"O .I dirfd
-.\"O is a file descriptor referring to a file other than a directory.
-.I pathname
-¤¬ÁêÂХѥ¹¤Ç¡¢¤«¤Ä
-.I dirfd
-¤¬¥Ç¥£¥ì¥¯¥È¥ê°Ê³°¤Î¥Õ¥¡¥¤¥ë¤ò»²¾È¤¹¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤¢¤ë¡£
-.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
-.\"O .BR fstatat ()
-.\"O was added to Linux in kernel 2.6.16.
-.BR fstatat ()
-¤Ï Linux ¥«¡¼¥Í¥ë 2.6.16 ¤ÇÄɲ䵤줿¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-POSIX.1-2008.
-.\"O A similar system call exists on Solaris.
-Solaris ¤Ë¤Ï¡¢¤³¤ì¤ÈƱ¤¸¤è¤¦¤Ê¥·¥¹¥Æ¥à¥³¡¼¥ë¤¬Â¸ºß¤¹¤ë¡£
-.\"O .SH NOTES
-.SH Ãí°Õ
-.\"O See
-.\"O .BR openat (2)
-.\"O for an explanation of the need for
-.\"O .BR fstatat ().
-.BR fstatat ()
-¤¬É¬ÍפÊÍýͳ¤Ë¤Ä¤¤¤Æ¤Ï¡¢
-.BR openat (2)
-¤ò»²¾È¤¹¤ë¤³¤È¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR openat (2),
-.BR stat (2),
-.BR path_resolution (7),
-.BR symlink (7),
+glibc の \fBfstatat\fP() のラッパー関数が利用するシステムコールとしては、
+実際には \fBfstatat64\fP() が呼び出される。
+.SH 関連項目
+\fBopenat\fP(2), \fBstat\fP(2), \fBpath_resolution\fP(7), \fBsymlink\fP(7),
OSDN Git Service
