Manpages

名 前

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 フ ァ イ ル シ ス テ ム に ア ク セ ス で き な か っ た 。

lutimes() で は 以 下 の エ ラ ー が 追 加 に な っ て い る :

ENOSYS カ ー ネ ル が こ の 関 数 を サ ポ ー ト し て い な い 。

Linux 2.6.22 以 降 が 必 要

で あ る 。

バ ー ジ ョ ン

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

属 性

マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 ) 関 数 futimes() と lutimes() は ス レ ッ ド セ ー フ で あ る 。

準 拠

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

関 連 項 目

utime(2), utimensat(2), symlink(7)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。