X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=draft%2Fman3%2Ffutimes.3;h=9b63aa104b2a9928918f2dae95e684976b30f9cb;hb=c1dfa2f6ab1bbed84992d3c59ee9925f4d453668;hp=e290cb5c7b5b83209865fa47ba2702f61c33c372;hpb=633a2252e0be3c867dce264a180a89ce8181d36f;p=linuxjm%2FLDP_man-pages.git diff --git a/draft/man3/futimes.3 b/draft/man3/futimes.3 index e290cb5c..9b63aa10 100644 --- a/draft/man3/futimes.3 +++ b/draft/man3/futimes.3 @@ -1,7 +1,6 @@ -.\" Hey Emacs! This file is -*- nroff -*- source. -.\" .\" Copyright (c) 2006, 2008, Michael Kerrisk .\" +.\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. @@ -21,130 +20,60 @@ .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END .\" -.\" Japanese Version Copyright (c) 2006 Akihiro MOTOKI all rights reserved. -.\" Translated 2006-07-31, Akihiro MOTOKI -.\" 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" -.\"O .SH NAME -.SH ̾Á° -.\"O futimes, lutimes \- change file timestamps -futimes, lutimes \- ¥Õ¥¡¥¤¥ë¤Î¥¿¥¤¥à¥¹¥¿¥ó¥×¤òÊѹ¹¤¹¤ë -.\"O .SH SYNOPSIS -.SH ½ñ¼° +.\"******************************************************************* +.TH FUTIMES 3 2013\-03\-15 Linux "Linux Programmer's Manual" +.SH 名前 +futimes, lutimes \- ファイルのタイムスタンプを変更する +.SH 書式 .nf -.B #include +\fB#include \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 -.\"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 futimes (), -.BR lutimes (): -_BSD_SOURCE -.\"O .SH DESCRIPTION -.SH ÀâÌÀ -.\"O .BR futimes () -.\"O changes the access and modification times of a file in the same way as -.\"O .BR utimes (2), -.\"O with the difference that the file whose timestamps are to be changed -.\"O is specified via a file descriptor, -.\"O .IR fd , -.\"O rather than via a pathname. -.BR futimes () -¤Ï -.BR utimes (2) -¤ÈƱ¤¸ÊýË¡¤Ç¥Õ¥¡¥¤¥ë¤Î¥¢¥¯¥»¥¹»þ¹ï¤È½¤Àµ»þ¹ï¤òÊѹ¹¤¹¤ë¡£ -°ã¤¤¤Ï¡¢¥¿¥¤¥à¥¹¥¿¥ó¥×¤òÊѹ¹¤¹¤ë¥Õ¥¡¥¤¥ë¤ò¡¢ -¥Ñ¥¹Ì¾¤Ç¤Ï¤Ê¤¯¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿ -.I fd -¤òÍѤ¤¤Æ»ØÄꤹ¤ëÅÀ¤Ç¤¢¤ë¡£ +\fBfutimes\fP(), \fBlutimes\fP(): _BSD_SOURCE +.SH 説明 +\fBfutimes\fP() は \fButimes\fP(2) と同じ方法でファイルのアクセス時刻と修正時刻を変更する。 +違いは、タイムスタンプを変更するファイルを、 パス名ではなく、ファイルディスクリプタ \fIfd\fP を用いて指定する点である。 -.\"O .BR lutimes () -.\"O changes the access and modification times of a file in the same way as -.\"O .BR utimes (2), -.\"O with the difference that if -.\"O .I filename -.\"O refers to a symbolic link, then the link is not dereferenced: -.\"O instead, the timestamps of the symbolic link are changed. -.BR lutimes () -¤Ï -.BR utimes (2) -¤ÈƱ¤¸ÊýË¡¤Ç¥Õ¥¡¥¤¥ë¤Î¥¢¥¯¥»¥¹»þ¹ï¤È½¤Àµ»þ¹ï¤òÊѹ¹¤¹¤ë¡£ -°ã¤¤¤Ï¡¢ -.I filename -¤¬¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤ò»²¾È¤·¤Æ¤¤¤ë¾ì¹ç¤Ë¡¢¥ê¥ó¥¯¤ÎŸ³«¤ò¹Ô¤ï¤º¡¢ -Âå¤ï¤ê¤Ë¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤Î¥¿¥¤¥à¥¹¥¿¥ó¥×¤òÊѹ¹¤¹¤ë¡£ -.\"O .SH "RETURN VALUE" -.SH ÊÖ¤êÃÍ -.\"O On success, zero is returned. -.\"O On error, \-1 is returned, and -.\"O .I errno -.\"O is set appropriately. -À®¸ù¤¹¤ë¤È 0 ¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·¡¢ -.I errno -¤òŬÀÚ¤ËÀßÄꤹ¤ë¡£ -.\"O .SH ERRORS -.SH ¥¨¥é¡¼ -.\"O Errors are as for -.\"O .BR utimes (2), -.\"O with the following additions for -.\"O .BR futimes (): -¥¨¥é¡¼¤Ï -.BR utimes (2) -¤ÈƱ¤¸¤À¤¬¡¢ -.BR futimes () -¤Ç¤Ï°Ê²¼¤Î¥¨¥é¡¼¤¬ÄɲäˤʤäƤ¤¤ë: -.TP -.B EBADF -.\"O .I fd -.\"O is not a valid file descriptor. -.I fd -¤¬Í­¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£ -.TP -.B ENOSYS -.\"O The -.\"O .I /proc -.\"O file system could not be accessed. -.I /proc -¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Ë¥¢¥¯¥»¥¹¤Ç¤­¤Ê¤«¤Ã¤¿¡£ -.\"O .SH VERSIONS -.SH ¥Ð¡¼¥¸¥ç¥ó -.\"O .BR futimes () -.\"O is available since glibc 2.3. -.BR futimes () -¤Ï glibc 2.3 °Ê¹ß¤ÇÍøÍѲÄǽ¤Ç¤¢¤ë¡£ -.\"O .BR lutimes () -.\"O is available since glibc 2.6, and is implemented using the -.\"O .BR utimensat (2) -.\"O system call, which is supported since kernel 2.6.22. -.BR lutimes () -¤Ï glibc 2.6 °Ê¹ß¤ÇÍøÍѲÄǽ¤Ç¤¢¤ê¡¢ -.BR utimensat (2) -¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò»È¤Ã¤Æ¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¡£ -.BR utimensat (2) -¤Ï¥«¡¼¥Í¥ë 2.6.22 °Ê¹ß¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë¡£ -.\"O .SH "CONFORMING TO" -.SH ½àµò -.\"O These functions are not specified in any standard. -.\"O Other than Linux, they are only available on the BSDs. -¤³¤ì¤é¤Î´Ø¿ô¤Ï¤É¤Îɸ½à¤Ç¤âµ¬Äꤵ¤ì¤Æ¤¤¤Ê¤¤¡£ -Linux °Ê³°¤Ç¤Ï¡¢¤³¤ì¤é¤Ï BSD ¤Ç¤Î¤ßÍøÍѲÄǽ¤Ç¤¢¤ë¡£ -.\"O .SH "SEE ALSO" -.SH ´ØÏ¢¹àÌÜ -.BR utimensat (2), -.BR utime (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 ファイルシステムにアクセスできなかった。 +.PP +\fBlutimes\fP() では以下のエラーが追加になっている: +.TP +\fBENOSYS\fP +カーネルがこの関数をサポートしていない。 Linux 2.6.22 以降が必要である。 +.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.53 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。