FUTIMES

Section: Linux Programmer's Manual (3)
Updated: 2008-04-07
Index JM Home Page roff page

名前

futimes, lutimes - ファイルのタイムスタンプを変更する

書式

#include <sys/time.h>

int futimes(int fd, const struct timeval tv[2]);

int lutimes(const char *filename, const struct timeval tv[2]);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

futimes(), lutimes(): _BSD_SOURCE

説明

futimes() は utimes(2) と同じ方法でファイルのアクセス時刻と修正時刻を変更する。違いは、タイムスタンプを変更するファイルを、パス名ではなく、ファイルディスクリプタ fd を用いて指定する点である。

lutimes() は utimes(2) と同じ方法でファイルのアクセス時刻と修正時刻を変更する。違いは、 filename がシンボリック・リンクを参照している場合に、リンクの展開を行わず、代わりにシンボリック・リンクのタイムスタンプを変更する。

返り値

成功すると 0 を返す。エラーの場合 -1 を返し、 errno を適切に設定する。

エラー

エラーは utimes(2) と同じだが、 futimes() では以下のエラーが追加になっている:

EBADF: fd が有効なファイルディスクリプタでない。
ENOSYS: /proc ファイルシステムにアクセスできなかった。

バージョン

futimes() は glibc 2.3 以降で利用可能である。 lutimes() は glibc 2.6 以降で利用可能であり、 utimensat(2) システムコールを使って実装されている。 utimensat(2) はカーネル 2.6.22 以降でサポートされている。

準拠

これらの関数はどの標準でも規定されていない。 Linux 以外では、これらは BSD でのみ利用可能である。

This document was created by man2html, using the manual pages.
Time: 03:26:42 GMT, April 25, 2010

FUTIMES

名前

書式

説明

返り値

エラー

バージョン

準拠

関連項目

Index