日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
UTIMES(2) FreeBSD システムコールマニュアル UTIMES(2)
名称
utimes, lutimes, futimes, futimesat -- ファイルアクセス時刻と更新時刻を設
定する
ライブラリ
標準 C ライブラリ (libc, -lc)
書式
#include <sys/time.h>
int
utimes(const char *path, const struct timeval *times);
int
lutimes(const char *path, const struct timeval *times);
int
futimes(int fd, const struct timeval *times);
int
futimesat(int fd, const char *path, const struct timeval times[2]);
解説
これらのインタフェースは、ナノ秒単位で正確ではないので、futimens(2) と
utimensat(2) によって時代遅れになっています。
path によって指定されるか、または fd によって参照されるファイルのアクセス
時刻と更新時刻は、引数 times によって指定されたかのように、変更されます。
times が NULL であるなら、アクセス時刻と更新時刻は、現在の時刻に設定され
ます。呼び出し側は、ファイルの所有者か、ファイルに書き込みパーミッション
があるか、またはスーパユーザでなければなりません。
times が NULL でないなら、それは、2 つの timeval 構造体の配列を指すと仮定
されます。アクセス時刻は、最初の要素の値に設定され、更新時刻は、2 番目の
要素の値に設定されます。(UFS2 のような) ファイルの誕生 (作成) 時刻サポー
トするファイルシステムについて、2 番目の要素が現在設定されている誕生時刻
より古いなら、誕生時刻は、2 番目の要素の値に設定されます。誕生時刻とと更
新時刻の両方を設定するために、次の 2 つの呼び出しが要求されます。最初に、
誕生時刻を設定し、2 番目に (より新しいと推測される) 更新時刻を設定しま
す。理想的に、新しいシステムコールは、一度にすべての 3 つの時刻の設定を許
可するように追加されるでしょう。呼び出し側は、ファイルの所有者か、または
スーパユーザでなければなりません。
いずれの場合も、ファイルの inode 変更時刻は、現在の時刻に設定されます。
lutimes() システムコールは、指定されたファイルがシンボリックリンクである
場合を除いて、utimes() に似ています、その場合に、lutimes() は、リンクのア
クセス時刻と更新時刻を変更し、一方、utimes() は、リンクが参照するファイル
の時刻を変更します。
futimesat() システムコールは、path が相対パスを指定する場合を除いて、
utimes() と同等です。この場合に、アクセス時刻と更新時刻は、現在の作業ディ
レクトリの代わりにファイル記述子 fd に関連しているディレクトリに相対的な
ファイルのそれに設定されます。futimesat() が fd パラメータの特別の値
AT_FDCWD を渡されるなら、現在の作業ディレクトリが、使用され、振る舞いは、
utimes() への呼び出しと同一となります。
戻り値
成功して終了したときには値 0 を返します。そうでない場合、値 -1 が返され、
グローバル変数 errno にエラーを示す値が設定されます。
エラー
すべてのシステムコールは、次の場合に失敗します:
[EACCES] 検索パーミッションがパス接頭時の構成要素に対して拒否さ
れています。
[EACCES] times 引数が NULL で、プロセスの実効ユーザ ID がファイ
ルの所有者と一致せず、スーパユーザでなく、書き込みアク
セスが拒否されています。
[EFAULT] path または times 引数が、プロセスの割り付けられたアド
レス空間の外側を指しています。
[EFAULT] times 引数が、プロセスの割り付けられたアドレス空間の外
側を指しています。
[EINVAL] times 引数によって指定された値の少なくとも 1 つの
tv_usec 構成要素には、0 未満、または 999999 を超える値
があります。
[EIO] 影響される inode の読み込みまたは書き込みの間に I/O エ
ラーが起こりました。
[ELOOP] パス名の変換で、あまりに多くのシンボリックリンクに遭遇
しました。
[ENAMETOOLONG] パス名の構成要素が NAME_MAX 文字を越えているか、または
全体のパス名が PATH_MAX 文字を越えています。
[ENOENT] 指定したファイルが存在しません。
[ENOTDIR] パスの接頭辞の構成要素が、ディレクトリではありません。
[EPERM] times 引数が NULL ではなく、呼び出しているプロセスの実
効ユーザ ID が、ファイルの所有者と一致せず、スーパユー
ザではありません。
[EPERM] 指定されたファイルには、不変、または追加専用のフラグ設
定があります。詳細については、chflags(2) マニュアル
ページを参照してください。
[EROFS] ファイルを含んでいるファイルシステムが、読み込み専用で
マウントされています。
futimes() システムコールは、次の場合に失敗します:
[EBADF] fd 引数が、有効な記述子を参照していません。
utimes() によって返されたエラーに加えて、futimesat() は、次の場合に失敗し
ます:
[EBADF] path 引数が、絶対パスを指定していなくて、fd 引数が、
AT_FDCWD でもなく検索のためにオープンされた有効なファ
イル記述子でもありません。
[ENOTDIR] path 引数が、絶対パスではなく、fd が、AT_FDCWD でもな
くディレクトリに関連しているファイル記述子でもありませ
ん。
関連項目
chflags(2), stat(2), utimensat(2), utime(3)
規格
utimes() 関数は、X/Open Portability Guide Issue 4, Version 2 (``XPG4.2'')
に適合するはずです。futimesat() システムコールは、The Open Group Extended
API Set 2 仕様に従っていますが、IEEE Std 1003.1-2008 (``POSIX.1'') の
utimensat() によって置き換えられました。
歴史
utimes() システムコールは、4.2BSD で登場しました。futimes() と lutimes()
システムコールは、FreeBSD 3.0 ではじめて登場しました。futimesat() システ
ムコールは、FreeBSD 8.0 で登場しました。
FreeBSD 11.2 June 9, 2016 FreeBSD 11.2