NAME

futimes-ディレクトリファイル記述子に関連するファイルのタイムスタンプを変更する

概要

#include <fcntl.h> int futimesat(int dirfd, const char* path, const struct timeval times[2]);

*futimesat* （）システムコールは、このマニュアルページで説明されている違いを除き、 *utimes* （2）とまったく同じ方法で動作します。

_pathname_で指定されたパス名が相対である場合、ファイル記述子_dirfd_によって参照されるディレクトリを基準に解釈されます（呼び出しプロセスの現在の作業ディレクトリに相対するのではなく、 utimes （2）によって行われます）相対パス名）。

_pathname_で指定されたパス名が相対であり、_dirfd_が特別な値 AT_FDCWD である場合、_pathname_は呼び出しプロセスの現在の作業ディレクトリを基準にして解釈されます（ utimes （2）など）。

_pathname_で指定されたパス名が絶対の場合、_dirfd_は無視されます。

成功すると、 futimesat （）は0を返します。エラーの場合、-1が返され、_errno_がエラーを示すように設定されます。

*utimes* （2）で発生する同じエラーは、 *futimesat* （）でも発生する可能性があります。 *futimesat* （）に対して次の追加エラーが発生する可能性があります。

Tag	Description
EBADF	dirfd is not a valid file descriptor.
ENOTDIR	pathname is a relative path and dirfd is a file descriptor referring to a file other than a directory.

このシステムコールは非標準ですが、POSIX.1の将来のリビジョンに含めることを提案しています。 Solarisにも同様のシステムコールが存在します。

_path_引数がNULLの場合、glibc* futimes *（）ラッパー関数は、_dirfd_によって参照されるファイルの時刻を更新します。

*futimesat* （）はカーネル2.6.16でLinuxに追加されました。