UTIME

名前

書式

#include <sys/types.h>


#include <utime.h>

int utime(const char *filename, const struct utimbuf *buf);

#include <sys/time.h>

int utimes(const char *filename, const struct timeval times[2]);

説明

buf が NULL の場合、ファイルのアクセス時刻と修正時刻は現在の時刻に設定される。

タイムスタンプの変更は以下の場合に許可される: プロセスに適切な特権がある (Linux では CAP_FOWNER ケーパビリティ (capability) がある)。 または実効 (effective) ユーザ ID が、ファイルのユーザ ID と等しい。 または buf が NULL で、かつプロセスがファイルへの書き込み許可を持っている。

構造体 utimbuf は以下に示すようになっている。

struct utimbuf {
    time_t actime;       /* アクセス時刻 */
    time_t modtime;      /* 修正時刻 */
};

関数 utime() は 1 秒の分解能でタイムスタンプを指定することができる。  

utimes()

struct timeval {
    long tv_sec;        /* 秒 */
    long tv_usec;       /* マイクロ秒 */
};

times[0] は新しいアクセス時刻を、 times[1] は新しい修正時刻を規定する。 times が NULL の場合、 utime() 同様、ファイルのアクセス時刻と修正時刻は現在の時刻に設定される。  

返り値

エラー

EACCES

path を構成する何れかのディレクトリに検索許可がない (path_resolution(7) も参照すること)。 または buf が NULL で、かつプロセスにタイムスタンプの変更許可がない (上記を参照すること)。

ENOENT

filename が存在しない。

EPERM

buf が NULL でなく、かつプロセスにタイムスタンプの変更許可がない。

EROFS

path が読み込み専用のファイルシステム上にある。

準拠

注意

libc4 と libc5 では、 utimes() は単に utime() のラッパー (wrapper) である。 そのため秒以下を指定することはできない。

POSIX.1-2001 では utimes() は過去の名残であるとされているが、不思議なことに utimes() は utime() よりも高機能である。  

バグ

関連項目

Index

名前

書式

説明

utimes()

返り値

エラー

準拠

注意

バグ

関連項目