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

名称

utime，utimes-更改文件的上次访问和修改时间

语法

#include <sys/types.h>
#include <utime.h>

int utime(const char *filename, const struct utimbuf *times);

#include <sys/time.h>

int utimes(const char *filename, const struct timeval times[2]);

说明

注意：现代应用程序可能更喜欢使用utimensat(2)中描述的接口。

utime()系统调用将文件名指定的索引节点的访问和修改时间分别更改为actime和modtime的时间字段。

如果times为NULL，则文件的访问和修改时间将设置为当前时间。

在以下情况下允许更改时间戳：进程具有适当的特权，或者有效的用户ID等于文件的用户ID，或者时间为NULL，并且进程具有文件的写许可权。

utimbuf结构为：

struct utimbuf {
    time_t actime;       /* access time */
    time_t modtime;      /* modification time */
};

utime()系统调用允许以1秒的分辨率指定时间戳。

utimes()系统调用与此类似，但是times参数引用的是数组而不是结构。此数组的元素是timeval结构，用于指定时间戳的精度为1微秒。时间结构为：

struct timeval {
    long tv_sec;        /* seconds */
    long tv_usec;       /* microseconds */
};

times [0]指定新的访问时间，times [1]指定新的修改时间。如果times为NULL，则类似于utime()，文件的访问和修改时间设置为当前时间。

返回值

成功时，返回零。如果出错，则返回-1，并正确设置errno。

错误说明

EACCES

对path路径前缀中的目录之一的搜索许可被拒绝(另请参见path_resolution(7))。

EACCES

times为NULL，调用者的有效用户ID与文件的所有者不匹配，调用者没有对该文件的写访问权，并且该调用者没有特权(Linux：既不具有CAP_DAC_OVERRIDE也不具有CAP_FOWNER功能)。

ENOENT

文件名不存在。

EPERM

times不为NULL，则调用者的有效UID与文件的所有者不匹配，并且调用者没有特权(Linux：不具有CAP_FOWNER功能)。

EROFS

路径驻留在只读文件系统上。

遵循规范

utime()：SVr4，POSIX.1-2001。 POSIX.1-2008将utime()标记为过时。

utimes()：4.3BSD，POSIX.1-2001。

备注

Linux不允许更改不可变文件上的时间戳，或在仅追加文件上将时间戳设置为当前时间以外的时间戳。

另外参见

chattr(1)，touch(1)，futimesat(2)，stat(2)，utimensat(2)，futimens(3)，futimes(3)，inode(7)

出版信息

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