UTIMES

索引

名称

索引

ライブラリ

索引

書式

索引

解説

Fa times が NULL である場合、アクセス時刻と更新時刻は現在の時刻に設定されます。 呼び出し側はファイルの所有者でファイルの書込み権があるか、 スーパユーザである必要があります。

Fa times が NULL 以外である場合、 Fa times は 2 つの timeval 構造体の配列を指していることが前提となります。 アクセス時刻は最初の要素に、更新時刻は次の要素に 設定します。 ( UFS2 のように) ファイルの誕生 (生成) 時刻をサポートしている ファイルシステムでは、2 番目の要素が現在設定されている誕生時刻よりも 前であれば、誕生時刻は 2 番目の要素の値で設定されます。 誕生時刻と更新時刻の両方を設定する場合は、2 回の呼び出しが必要です。 最初に誕生時刻を設定し、次に (より新しいであろう) 更新時刻を設定します。 理想的には、一度に 3 つの時刻すべてを設定できるシステムコールが 追加されるでしょう。 呼び出し側はファイルの所有者であるかスーパユーザである必要があります。

どちらの場合でも、ファイルの inode 変更時刻は現在の時刻に設定されます。

Fn lutimes システムコールは指定したファイルがシンボリックリンク以外では Fn utimes と同じです。 シンボリックリンクの場合 Fn lutimes はリンクのアクセス時刻と更新時刻を変更するのに対し、 Fn utimes はリンクが参照するファイルの時刻を変更します。  

索引

戻り値

索引

エラー

Bq Er EACCES

指定されたパスには、検索が許可されていないディレクトリが含まれています。 あるいは Fa times 引数が NULL で、プロセスの実効ユーザ ID がファイルの所有者と一致せず、 しかもスーパユーザでもなく、書込みアクセスが拒否されました。

Bq Er EFAULT

Fa path 引数または Fa times 引数は、プロセスに割り当てられたアドレス空間の範囲外を指しています。

Bq Er EIO

変更される inode の読み書きの間に入出力エラーが発生しました。

Bq Er ELOOP

パス名を変換するときに検出されたシンボリックリンクが多すぎます。

Bq Er ENAMETOOLONG

パス名の構成要素が NAME_MAX 文字を越えているか、またはパス名全体 PATH_MAX 文字を越えています。

Bq Er ENOENT

指定したファイルが存在しません。

Bq Er ENOTDIR

パスの構成要素中にディレクトリ以外のものが含まれています。

Bq Er EPERM

Fa times 引数が NULL ではなく、呼び出し側プロセスの実効ユーザ ID が、 ファイルの所有者と一致せず、しかもスーパユーザではありません。

Bq Er EROFS

そのファイルを含むファイルシステムが、 読取り専用でマウントされています。

Fn futimes システムコールは、以下の場合にエラーとなります:

Bq Er EBADF

Fa fd 引数が、有効な記述子を参照していません。

すべてのシステムコールは、以下の場合にエラーとなります。

Bq Er EACCES

Fa times 引数が NULL であり、プロセスの実効ユーザ ID がファイルの所有者と一致せず、 しかもスーパユーザでもなく、書込みアクセスが拒否されました。

Bq Er EFAULT

Fa times 引数は、プロセスに割り当てられたアドレス空間の範囲外を指しています。

Bq Er EIO

変更される inode の読み書き中に入出力エラーが発生しました。

Bq Er EPERM

Fa times 引数が NULL ではなく、呼び出し側プロセスの実効ユーザ ID が、 ファイルの所有者と一致せず、しかもスーパユーザでもありません。

Bq Er EROFS

そのファイルを含むファイルシステムが読取り専用でマウントされています。

索引

関連項目

索引

歴史

索引

Index

名称

ライブラリ

書式

解説

戻り値

エラー

関連項目

歴史