.\" 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-09-30 by Yuichi SATO <ysato444@yahoo.co.jp>, LDP v2.39
.\"
-.TH FUTIMESAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH FUTIMESAT 2 2012\-03\-25 Linux "Linux Programmer's Manual"
.SH 名前
futimesat \- ディレクトリファイルディスクリプタから相対的な位置にあるファイルのタイムスタンプを変更する
.SH 書式
.nf
-.B #include <fcntl.h> /* AT_* 定数の定義 */
+\fB#include <fcntl.h> /* AT_* 定数の定義 */\fP
+\fB#include <sys/time.h>\fP
.sp
-.BI "int futimesat(int " dirfd ", const char *" pathname ,
-.BI " const struct timeval " times [2]);
+\fBint futimesat(int \fP\fIdirfd\fP\fB, const char *\fP\fIpathname\fP\fB,\fP
+\fB const struct timeval \fP\fItimes\fP\fB[2]);\fP
.fi
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.BR futimesat ():
-.PD 0
-.ad l
-.RS 4
-.TP 4
-glibc 2.10 以降:
-_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
-.TP
-glibc 2.10 より前:
-_ATFILE_SOURCE
-.RE
-.ad
-.PD
+\fBfutimesat\fP(): _GNU_SOURCE
.SH 説明
-このシステムコールは廃止予定である。
-代わりに
-.BR utimensat (2)
-を使用すること。
+このシステムコールは廃止予定である。 代わりに \fButimensat\fP(2) を使用すること。
-.BR futimesat ()
-システムコールは、この man ページで説明している違いがある以外は、
-.BR utimes (2)
+\fBfutimesat\fP() システムコールは、この man ページで説明している違いがある以外は、 \fButimes\fP(2)
と全く同じように動作する。
-.I pathname
-で指定されるパス名が相対パス名である場合、
-ファイルディスクリプタ
-.I dirfd
-で参照されるディレクトリからの相対パス名として解釈される
-.RB ( utimes (2)
-では、相対パスは呼び出し元プロセスの
+\fIpathname\fP で指定されるパス名が相対パス名である場合、 ファイルディスクリプタ \fIdirfd\fP
+で参照されるディレクトリからの相対パス名として解釈される (\fButimes\fP(2) では、相対パスは呼び出し元プロセスの
カレントワーキングディレクトリからの相対パスとなる)。
-.I pathname
-が相対パスであり、かつ
-.I dirfd
-が特別な値
-.B AT_FDCWD
-である場合、
-.I pathname
-は
-.RB ( utimes (2)
-と同じように) 呼び出し元プロセスの
-カレントワーキングディレクトリからの相対パス名として解釈される。
+\fIpathname\fP が相対パスであり、かつ \fIdirfd\fP が特別な値 \fBAT_FDCWD\fP である場合、 \fIpathname\fP は
+(\fButimes\fP(2) と同じように) 呼び出し元プロセスの カレントワーキングディレクトリからの相対パス名として解釈される。
-.I pathname
-が絶対パスである場合、
-.I dirfd
-は無視される。
+\fIpathname\fP が絶対パスである場合、 \fIdirfd\fP は無視される。
.SH 返り値
-成功した場合、
-.BR futimesat ()
-は 0 を返す。
-エラーの場合、\-1 が返されて、
-.I errno
-にはエラーを示す値が設定される。
+成功した場合、 \fBfutimesat\fP() は 0 を返す。 エラーの場合、\-1 が返されて、 \fIerrno\fP にはエラーを示す値が設定される。
.SH エラー
-.BR utimes (2)
-と同じエラーが
-.BR futimesat ()
-でも起こる。
-.BR futimesat ()
+\fButimes\fP(2) と同じエラーが \fBfutimesat\fP() でも起こる。 \fBfutimesat\fP()
では、その他に以下のエラーが起こる:
-.TP
-.B EBADF
-.I dirfd
-が有効なファイルディスクリプタでない。
-.TP
-.B ENOTDIR
-.I pathname
-が相対パスで、かつ
-.I dirfd
-がディレクトリ以外のファイルを参照するファイルディスクリプタである。
+.TP
+\fBEBADF\fP
+\fIdirfd\fP が有効なファイルディスクリプタでない。
+.TP
+\fBENOTDIR\fP
+\fIpathname\fP が相対パスで、かつ \fIdirfd\fP がディレクトリ以外のファイルを参照するファイルディスクリプタである。
.SH バージョン
-.BR futimesat ()
-は Linux カーネル 2.6.16 で追加された。
+\fBfutimesat\fP() は Linux カーネル 2.6.16 で追加された。
.SH 準拠
-このシステムコールは標準的ではない。
-POSIX.1 で提案されていた仕様に由来して実装されたが、
-その仕様は
-.BR utimensat (2)
+このシステムコールは標準的ではない。 POSIX.1 で提案されていた仕様に由来して実装されたが、 その仕様は \fButimensat\fP(2)
で置き換えられた。
Solaris には、これと同じようなシステムコールが存在する。
.SH 注意
-.SS GLIBC についての注意
-.I pathname
-が NULL の場合、glibc の
-.BR futimesat ()
-ラッパー関数は
-.I dirfd
-で参照されるファイルの時刻を更新する。
+.SS "glibc についての注意"
.\" The Solaris futimesat() also has this strangeness.
+\fIpathname\fP が NULL の場合、glibc の \fBfutimesat\fP() ラッパー関数は \fIdirfd\fP
+で参照されるファイルの時刻を更新する。
.SH 関連項目
-.BR stat (2),
-.BR utimensat (2),
-.BR utimes (2),
-.BR futimes (3),
-.BR path_resolution (7)
+\fBstat\fP(2), \fButimensat\fP(2), \fButimes\fP(2), \fBfutimes\fP(3),
+\fBpath_resolution\fP(7)
OSDN Git Service
