futimesat() - Unix、Linux 系统调用

名称

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() 中

标签	描述
EBADF	dirfd 不是有效的文件描述符。
ENOTDIR	pathname 是相对路径，并且 dirfd 是一个指向除目录以外的文件的文件描述符。

此系统调用是非标准的，但建议将其包含在 POSIX.1 的未来修订版中。Solaris 上存在类似的系统调用。

如果 path 参数为 NULL，则 glibc futimes() 包装函数会更新 dirfd 所指的文件的时间。

futimesat() 在 Linux 内核 2.6.16 中添加。

打印页面