OSDN Git Service

(split) LDP: Update releases to LDP v3.40.
[linuxjm/LDP_man-pages.git] / release / man3 / futimes.3
index f068b77..0972508 100644 (file)
 .\" 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 Akihiro MOTOKI all rights reserved.
-.\" Translated 2006-07-31, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2008-08-07, Akihiro MOTOKI, LDP v3.05
+.\"*******************************************************************
 .\"
-.\"WORD:       access time             ¥¢¥¯¥»¥¹»þ¹ï
-.\"WORD:       modification time       ½¤Àµ»þ¹ï
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH FUTIMES 3 2008-04-07 "Linux" "Linux Programmer's Manual"
-.SH Ì¾Á°
-futimes, lutimes \- ¥Õ¥¡¥¤¥ë¤Î¥¿¥¤¥à¥¹¥¿¥ó¥×¤òÊѹ¹¤¹¤ë
-.SH ½ñ¼°
+.\"*******************************************************************
+.TH FUTIMES 3 2008\-04\-07 Linux "Linux Programmer's Manual"
+.SH 名前
+futimes, lutimes \- ファイルのタイムスタンプを変更する
+.SH 書式
 .nf
-.B #include <sys/time.h>
+\fB#include <sys/time.h>\fP
 
-.BI "int futimes(int " fd ", const struct timeval " tv [2]);
+\fBint futimes(int \fP\fIfd\fP\fB, const struct timeval \fP\fItv\fP\fB[2]);\fP
 
-.BI "int lutimes(const char *" filename ", const struct timeval " tv [2]);
+\fBint lutimes(const char *\fP\fIfilename\fP\fB, const struct timeval \fP\fItv\fP\fB[2]);\fP
 .fi
 .sp
 .in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
-.BR futimes (),
-.BR lutimes ():
-_BSD_SOURCE
-.SH ÀâÌÀ
-.BR futimes ()
-¤Ï
-.BR utimes (2)
-¤ÈƱ¤¸ÊýË¡¤Ç¥Õ¥¡¥¤¥ë¤Î¥¢¥¯¥»¥¹»þ¹ï¤È½¤Àµ»þ¹ï¤òÊѹ¹¤¹¤ë¡£
-°ã¤¤¤Ï¡¢¥¿¥¤¥à¥¹¥¿¥ó¥×¤òÊѹ¹¤¹¤ë¥Õ¥¡¥¤¥ë¤ò¡¢
-¥Ñ¥¹Ì¾¤Ç¤Ï¤Ê¤¯¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I fd
-¤òÍѤ¤¤Æ»ØÄꤹ¤ëÅÀ¤Ç¤¢¤ë¡£
+\fBfutimes\fP(), \fBlutimes\fP(): _BSD_SOURCE
+.SH 説明
+\fBfutimes\fP()  は \fButimes\fP(2)  と同じ方法でファイルのアクセス時刻と修正時刻を変更する。
+違いは、タイムスタンプを変更するファイルを、 パス名ではなく、ファイルディスクリプタ \fIfd\fP を用いて指定する点である。
 
-.BR lutimes ()
-¤Ï
-.BR utimes (2)
-¤ÈƱ¤¸ÊýË¡¤Ç¥Õ¥¡¥¤¥ë¤Î¥¢¥¯¥»¥¹»þ¹ï¤È½¤Àµ»þ¹ï¤òÊѹ¹¤¹¤ë¡£
-°ã¤¤¤Ï¡¢
-.I filename
-¤¬¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤ò»²¾È¤·¤Æ¤¤¤ë¾ì¹ç¤Ë¡¢¥ê¥ó¥¯¤ÎŸ³«¤ò¹Ô¤ï¤º¡¢
-Âå¤ï¤ê¤Ë¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤Î¥¿¥¤¥à¥¹¥¿¥ó¥×¤òÊѹ¹¤¹¤ë¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤¹¤ë¤È 0 ¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·¡¢
-.I errno
-¤òŬÀÚ¤ËÀßÄꤹ¤ë¡£
-.SH ¥¨¥é¡¼
-¥¨¥é¡¼¤Ï
-.BR utimes (2)
-¤ÈƱ¤¸¤À¤¬¡¢
-.BR futimes ()
-¤Ç¤Ï°Ê²¼¤Î¥¨¥é¡¼¤¬ÄɲäˤʤäƤ¤¤ë:
-.TP
-.B EBADF
-.I fd
-¤¬Í­¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
-.TP
-.B ENOSYS
-.I /proc
-¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Ë¥¢¥¯¥»¥¹¤Ç¤­¤Ê¤«¤Ã¤¿¡£
-.SH ¥Ð¡¼¥¸¥ç¥ó
-.BR futimes ()
-¤Ï glibc 2.3 °Ê¹ß¤ÇÍøÍѲÄǽ¤Ç¤¢¤ë¡£
-.BR lutimes ()
-¤Ï glibc 2.6 °Ê¹ß¤ÇÍøÍѲÄǽ¤Ç¤¢¤ê¡¢
-.BR utimensat (2)
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò»È¤Ã¤Æ¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¡£
-.BR utimensat (2)
-¤Ï¥«¡¼¥Í¥ë 2.6.22 °Ê¹ß¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë¡£
-.SH ½àµò
-¤³¤ì¤é¤Î´Ø¿ô¤Ï¤É¤Îɸ½à¤Ç¤âµ¬Äꤵ¤ì¤Æ¤¤¤Ê¤¤¡£
-Linux °Ê³°¤Ç¤Ï¡¢¤³¤ì¤é¤Ï BSD ¤Ç¤Î¤ßÍøÍѲÄǽ¤Ç¤¢¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR utime (2),
-.BR utimensat (2),
-.BR symlink (7)
+\fBlutimes\fP()  は \fButimes\fP(2)  と同じ方法でファイルのアクセス時刻と修正時刻を変更する。 違いは、 \fIfilename\fP
+がシンボリック・リンクを参照している場合に、リンクの展開を行わず、 代わりにシンボリック・リンクのタイムスタンプを変更する。
+.SH 返り値
+成功した場合は 0 が返される。エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。
+.SH エラー
+エラーは \fButimes\fP(2)  と同じだが、 \fBfutimes\fP()  では以下のエラーが追加になっている:
+.TP 
+\fBEBADF\fP
+\fIfd\fP が有効なファイルディスクリプタでない。
+.TP 
+\fBENOSYS\fP
+\fI/proc\fP ファイルシステムにアクセスできなかった。
+.SH バージョン
+\fBfutimes\fP()  は glibc 2.3 以降で利用可能である。 \fBlutimes\fP()  は glibc 2.6 以降で利用可能であり、
+\fButimensat\fP(2)  システムコールを使って実装されている。 \fButimensat\fP(2)  はカーネル 2.6.22
+以降でサポートされている。
+.SH 準拠
+これらの関数はどの標準でも規定されていない。 Linux 以外では、これらは BSD でのみ利用可能である。
+.SH 関連項目
+\fButime\fP(2), \fButimensat\fP(2), \fBsymlink\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。