FUTIMESAT - Linux手册页

时间:2019-08-20 17:58:46  来源:igfitidea点击:

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/