utime

名前

ライブラリ

書式

#include <utime.h>

int utime(const char *path,
          const struct utimbuf *_Nullable times);

#include <sys/time.h>

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

説明

The utime() システムコールは、path で指定された iノードのアクセス時刻と修正時刻を、それぞれ times の actime フィールドと modtime フィールドに変更します。ステータス変更時刻(ctime)は、他のタイムスタンプが実際に変更されない場合でも、現在の時刻に設定されます。

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

タイムスタンプの変更は以下のいずれかの場合に許可されます。プロセスに適切な特権がある場合、 実効 (effective) ユーザー ID がファイルのユーザー ID と等しい場合、 times が NULL かつ、プロセスがファイルへの書き込み許可を持っている場合。

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

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

utime() システムコールは 1 秒の分解能でタイムスタンプを指定することができます。

utimes() は utime() と同様ですが、 times 引数が構造体ではなく配列を参照します。この配列の要素は timeval 構造体で、タイムスタンプの指定を 1 マイクロ秒の分解能で行うことができます。 構造体 timeval は以下に示す通りです:

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

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

返り値

エラー

EACCES

path を構成する何れかのディレクトリに検索許可がありません (path_resolution(7) も参照)。

EACCES

times が NULL です。または、呼び出し元の実効ユーザー ID がファイルの所有者と一致しません。または、呼び出し元がそのファイルへの書き込み許可を持たず、 特権も持っていません (Linux の場合、ケーパビリティ CAP_DAC_OVERRIDE も CAP_FOWNER も持っていません)。または、

EFAULT

path に無効なアドレスが指定されました。

ENOENT

path が存在しません。

EPERM

times が NULL でなく、かつ呼び出し元の実効 UID がファイルの所有者と一致せず、 かつ呼び出し元が特権を持っていません (Linux の場合、ケーパビリティ CAP_FOWNER を持っていません)。

EROFS

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

標準

utime()

なし。

utimes()

POSIX.1-2024.

履歴

utime()

SVr4, POSIX.1-2001. Obsoleted in POSIX.1-2008. Removed in POSIX.1-2024.

utimes()

4.3BSD, POSIX.1-2001.

注意

関連項目

関連キーワード

Linux マニュアル 一覧

関連するコマンド・関数

Index

名前

ライブラリ

書式

説明

返り値

エラー

標準

履歴

注意

関連項目