.\" Translated 2006-09-30 by Yuichi SATO <ysato444@yahoo.co.jp>, LDP v2.39
.\"
.TH FUTIMESAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
-.SH ̾Á°
-futimesat \- ¥Ç¥£¥ì¥¯¥È¥ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤«¤éÁêÂÐŪ¤Ê°ÌÃ֤ˤ¢¤ë¥Õ¥¡¥¤¥ë¤Î¥¿¥¤¥à¥¹¥¿¥ó¥×¤òÊѹ¹¤¹¤ë
-.SH ½ñ¼°
+.SH 名前
+futimesat \- ディレクトリファイルディスクリプタから相対的な位置にあるファイルのタイムスタンプを変更する
+.SH 書式
.nf
-.B #include <fcntl.h> /* AT_* Äê¿ô¤ÎÄêµÁ */
+.B #include <fcntl.h> /* AT_* 定数の定義 */
.sp
.BI "int futimesat(int " dirfd ", const char *" pathname ,
.BI " const struct timeval " times [2]);
.fi
.sp
.in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
+glibc 向けの機能検査マクロの要件
.RB ( feature_test_macros (7)
-»²¾È):
+参照):
.in
.sp
.BR futimesat ():
.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 utimensat (2)
-¤ò»ÈÍѤ¹¤ë¤³¤È¡£
+を使用すること。
.BR futimesat ()
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢¤³¤Î man ¥Ú¡¼¥¸¤ÇÀâÌÀ¤·¤Æ¤¤¤ë°ã¤¤¤¬¤¢¤ë°Ê³°¤Ï¡¢
+システムコールは、この man ページで説明している違いがある以外は、
.BR utimes (2)
-¤ÈÁ´¤¯Æ±¤¸¤è¤¦¤ËÆ°ºî¤¹¤ë¡£
+と全く同じように動作する。
.I pathname
-¤Ç»ØÄꤵ¤ì¤ë¥Ñ¥¹Ì¾¤¬ÁêÂХѥ¹Ì¾¤Ç¤¢¤ë¾ì¹ç¡¢
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
+で指定されるパス名が相対パス名である場合、
+ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿
.I dirfd
-¤Ç»²¾È¤µ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹Ì¾¤È¤·¤Æ²ò¼á¤µ¤ì¤ë
+で参照されるディレクトリからの相対パス名として解釈される
.RB ( utimes (2)
-¤Ç¤Ï¡¢ÁêÂХѥ¹¤Ï¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î
-¥«¥ì¥ó¥È¥ï¡¼¥¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹¤È¤Ê¤ë)¡£
+では、相対パスは呼び出し元プロセスの
+カレントワーキングディレクトリからの相対パスとなる)。
.I pathname
-¤¬ÁêÂХѥ¹¤Ç¤¢¤ê¡¢¤«¤Ä
+が相対パスであり、かつ
.I dirfd
-¤¬ÆÃÊ̤ÊÃÍ
+が特別な値
.B AT_FDCWD
-¤Ç¤¢¤ë¾ì¹ç¡¢
+である場合、
.I pathname
-¤Ï
+は
.RB ( utimes (2)
-¤ÈƱ¤¸¤è¤¦¤Ë) ¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î
-¥«¥ì¥ó¥È¥ï¡¼¥¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹Ì¾¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¡£
+と同じように) 呼び出し元プロセスの
+カレントワーキングディレクトリからの相対パス名として解釈される。
.I pathname
-¤¬ÀäÂХѥ¹¤Ç¤¢¤ë¾ì¹ç¡¢
+が絶対パスである場合、
.I dirfd
-¤Ï̵»ë¤µ¤ì¤ë¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤·¤¿¾ì¹ç¡¢
+は無視される。
+.SH 返り値
+成功した場合、
.BR futimesat ()
-¤Ï 0 ¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤¬ÊÖ¤µ¤ì¤Æ¡¢
+は 0 を返す。
+エラーの場合、\-1 が返されて、
.I errno
-¤Ë¤Ï¥¨¥é¡¼¤ò¼¨¤¹Ãͤ¬ÀßÄꤵ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
+にはエラーを示す値が設定される。
+.SH ã\82¨ã\83©ã\83¼
.BR utimes (2)
-¤ÈƱ¤¸¥¨¥é¡¼¤¬
+と同じエラーが
.BR futimesat ()
-¤Ç¤âµ¯¤³¤ë¡£
+でも起こる。
.BR futimesat ()
-¤Ç¤Ï¡¢¤½¤Î¾¤Ë°Ê²¼¤Î¥¨¥é¡¼¤¬µ¯¤³¤ë:
+では、その他に以下のエラーが起こる:
.TP
.B EBADF
.I dirfd
-¤¬Í¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
+が有効なファイルディスクリプタでない。
.TP
.B ENOTDIR
.I pathname
-¤¬ÁêÂХѥ¹¤Ç¡¢¤«¤Ä
+が相対パスで、かつ
.I dirfd
-¤¬¥Ç¥£¥ì¥¯¥È¥ê°Ê³°¤Î¥Õ¥¡¥¤¥ë¤ò»²¾È¤¹¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤¢¤ë¡£
-.SH ¥Ð¡¼¥¸¥ç¥ó
+がディレクトリ以外のファイルを参照するファイルディスクリプタである。
+.SH バージョン
.BR futimesat ()
-¤Ï Linux ¥«¡¼¥Í¥ë 2.6.16 ¤ÇÄɲ䵤줿¡£
-.SH ½àµò
-¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ïɸ½àŪ¤Ç¤Ï¤Ê¤¤¡£
-POSIX.1 ¤ÇÄó°Æ¤µ¤ì¤Æ¤¤¤¿»ÅÍͤËͳÍ褷¤Æ¼ÂÁõ¤µ¤ì¤¿¤¬¡¢
-¤½¤Î»ÅÍͤÏ
+は Linux カーネル 2.6.16 で追加された。
+.SH 準拠
+このシステムコールは標準的ではない。
+POSIX.1 で提案されていた仕様に由来して実装されたが、
+その仕様は
.BR utimensat (2)
-¤ÇÃÖ¤´¹¤¨¤é¤ì¤¿¡£
+で置き換えられた。
-Solaris ¤Ë¤Ï¡¢¤³¤ì¤ÈƱ¤¸¤è¤¦¤Ê¥·¥¹¥Æ¥à¥³¡¼¥ë¤¬Â¸ºß¤¹¤ë¡£
-.SH Ãí°Õ
-.SS GLIBC ¤Ë¤Ä¤¤¤Æ¤ÎÃí°Õ
+Solaris には、これと同じようなシステムコールが存在する。
+.SH 注意
+.SS GLIBC についての注意
.I pathname
-¤¬ NULL ¤Î¾ì¹ç¡¢glibc ¤Î
+が NULL の場合、glibc の
.BR futimesat ()
-¥é¥Ã¥Ñ¡¼´Ø¿ô¤Ï
+ラッパー関数は
.I dirfd
-¤Ç»²¾È¤µ¤ì¤ë¥Õ¥¡¥¤¥ë¤Î»þ¹ï¤ò¹¹¿·¤¹¤ë¡£
+で参照されるファイルの時刻を更新する。
.\" The Solaris futimesat() also has this strangeness.
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR stat (2),
.BR utimensat (2),
.BR utimes (2),