UTIMES(2) — NEWS-OS Programmer’s Manual

名称

utimes − ファイルの日時をセットする

#include <sys/time.h>

utimes(file, tvp)
char ∗file;
struct timeval tvp[2];

utimes コールは、 tvp ベクトルから “accessed” および “updated” 日時をその順序で使用して、 file のために記録される日時をそれぞれセットします。

呼び出しユーザは、そのファイルの所有者またはスーパーユーザでなければなりません。そのファイルの “inode-changed” 日時は、現在の日時にセットされます。

正常終了した場合には、値 0 が返されます。そうでない場合には、値 −1 が返され、 errno がエラーを示すようにセットされます。

次の項目のうち、1 つ以上が真である場合には、 utimes は失敗します。

[ENOTDIR] パスプレフィックスの構成要素がディレクトリではないものがある。

[EINVAL] パス名に最上位ビットのセットされたキャラクタが含まれている。 (NEWS-OS ではおこらない。)

[ENAMETOOLONG]
パス名の 1 構成要素が 255 バイトを超えている、またはパス名全体が 1023 バイトを超えている。

[ENOENT] 指定されたファイルが存在していない。

[ELOOP] パス名の処理で遭遇したシンボリックリンクの数が多すぎる。

[EPERM] そのプロセスがスーパーユーザではなく、そのファイルの所有者でもない。

[EACCES] パスプレフィックスの構成要素についてサーチパーミッションが否定されているものがある。

[EROFS] そのファイルが収められているファイルシステムが読み取り専用でマウントされている。

[EFAULT] file または tvp が、そのプロセスの割り当てアドレススペースの外を指している。

[EIO] 影響される i ノードの読み取りまたは書き込み中に、入出力エラーが発生した。