Man page - futimes(3)

Packages contains this manual

Available languages:

en fr ja ru ro

Manual

FUTIMES

名 前
書 式
説 明
返 り 値
エ ラ ー
バ ー ジ ョ ン
属 性
準 拠
関 連 項 目
こ の 文 書 に つ い て

名 前

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 ():
Since glibc 2.19:
_DEFAULT_SOURCE
Glibc 2.19 and earlier:
_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 以 降 で サ ポ ー ト さ れ て い る 。

属 性

こ の 節 で 使 用 さ れ て い る 用 語 の 説 明 に つ い て は 、 attributes (7) を 参 照 。

Image grohtml-29783-1.png

準 拠

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

関 連 項 目

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

こ の 文 書 に つ い て

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