Linux程序员手册 第2部分
更新日期： 2017-09-15

名称

futimesat-相对于目录文件描述符更改文件的时间戳

语法

#include <fcntl.h>           /* Definition of AT_* constants */
#include <sys/time.h>

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

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

futimesat()：_GNU_SOURCE

说明

该系统调用已过时。请改用utimensat(2)。

除了本手册页中所述的区别之外，futimesat()系统调用的操作与utimes(2)完全相同。

如果在路径名中给定的路径名​​是相对路径名，则将其相对于文件描述符dirfd所引用的目录进行解释(而不是相对于调用进程的当前工作目录，如utimes(2)对相对路径名所做的那样) )。

如果路径名是相对的并且dirfd是特殊值AT_FDCWD，则路径名将相对于调用进程的当前工作目录进行解释(如utimes(2))。

如果路径名是绝对的，则dirfd被忽略。

返回值

成功时，futimesat()返回0。错误时，返回-1，并将errno设置为指示错误。

错误说明

utimes(2)中发生的相同错误也可能发生在futimesat()中。 futimesat()可能会发生以下其他错误：

EBADF

dirfd不是有效的文件描述符。

ENOTDIR

pathname是相对的，dirfd是引用目录以外的文件的文件描述符。

版本

futimesat()在内核2.6.16中添加到Linux；库支持已添加到版本2.4中的glibc。

遵循规范

此系统调用是非标准的。它是从为POSIX.1提出的规范中实现的，但是该规范被utimensat(2)的规范所代替。

Solaris上存在类似的系统调用。

备注

Glibc notes

如果路径名是NULL，则glibc futimesat()包装器函数将更新dirfd引用的文件的时间。

另外参见

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

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。