futimesat

Section: System Calls (2)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

futimesat - ディレクトリファイルディスクリプターに対する相対パスのファイルのタイムスタンプを変更する  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <fcntl.h>            /* AT_* 定数の定義 */
#include <sys/time.h>

[[deprecated]] int futimesat(int dirfd, const char *path,
                             const struct timeval times[2]);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

futimesat():

    _GNU_SOURCE
 

説明

このシステムコールは廃止予定です。代わりに utimensat を使用すること。

futimesat() システムコールは utimes() と全く同様に動作するが、このマニュアルページで説明する点が異なります。

path で渡されたパス名が相対パスの場合、 パス名はファイルディスクリプタ dirfd が参照するディレクトリに対する相対パスと解釈されます (相対パスの場合に utimes(2) で行われるように、呼び出したプロセスのカレントワーキングディレクトリに対する相対パスと解釈されるわけではありません)。

path が相対パスで dirfd が特別な値 AT_FDCWD の場合、 path は (utimes(2) 同様) 呼び出したプロセスのカレントワーキングディレクトリに対する相対パスと解釈されます。

path が絶対パスの場合、dirfd は無視されます(dirfd 引数が有用な理由については openat(2) を参照)。  

返り値

成功すると、 futimesat() は 0 を返します。 エラーの場合、-1 を返し、 errno にエラーを示す値をセットします。  

エラー

utimes(2) で発生する可能性があるエラーのいくつかは futimesat() でも起こること可能性があります。また、 以下のエラーも futimesat() では発生することがあります。
EBADF
path が相対パスですが、 dirfd が AT_FDCWD でも有効なファイルディスクリプターでもありません。
ENOTDIR
path が相対パスで、 dirfd がディレクトリ以外のファイルを参照するファイルディスクリプタです。
 

バージョン

 

glibc

path が NULL の場合、 glibc の futimesat() のラッパー関数は dirfd が参照するファイルの時刻情報を更新します。  

標準規格

なし。  

歴史

Linux 2.6.16, glibc 2.4.

これは POSIX.1 に提案された仕様に基づいて実装されましたが、その仕様は utimensat(2) で置き換えれました。

同様のシステムコールが Solaris に存在します。  

注意

 

関連項目

stat(2), utimensat(2), utimes(2), futimes(3), path_resolution(7)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
バージョン
glibc
標準規格
歴史
注意
関連項目

This document was created by man2html, using the manual pages.