Movatterモバイル変換

utime(2) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ERRORS \|STANDARDS \|HISTORY \|NOTES \|SEE ALSO \|COLOPHON

utime(2)                   System Calls Manualutime(2)

NAME top

       utime, utimes - change file last access and modification times

LIBRARY top

       Standard C library (libc,-lc)

SYNOPSIS top

#include <utime.h>int utime(const char *path,const struct utimbuf *_Nullabletimes);#include <sys/time.h>int utimes(const char *path,const struct timevaltimes[_Nullable 2]);

DESCRIPTION top

Note:modern applications may prefer to use the interfaces       described inutimensat(2).       Theutime() system call changes the access and modification times       of the inode specified bypath to theactime andmodtime fields oftimes respectively.  The status change time (ctime) will be set to       the current time, even if the other time stamps don't actually       change.       Iftimes is NULL, then the access and modification times of the       file are set to the current time.       Changing timestamps is permitted when: either the process has       appropriate privileges, or the effective user ID equals the user       ID of the file, ortimes is NULL and the process has write       permission for the file.       Theutimbuf structure is:           struct utimbuf {               time_t actime;       /* access time */               time_t modtime;      /* modification time */           };       Theutime() system call allows specification of timestamps with a       resolution of 1 second.       Theutimes() system call is similar, but thetimes argument refers       to an array rather than a structure.  The elements of this array       aretimeval structures, which allow a precision of 1 microsecond       for specifying timestamps.  Thetimeval structure is:           struct timeval {               long tv_sec;        /* seconds */               long tv_usec;       /* microseconds */           };times[0] specifies the new access time, andtimes[1] specifies the       new modification time.  Iftimes is NULL, then analogously toutime(), the access and modification times of the file are set to       the current time.

RETURN VALUE top

       On success, zero is returned.  On error, -1 is returned, anderrno       is set to indicate the error.

ERRORS top

EACCESSearch permission is denied for one of the directories in              the path prefix ofpath (see alsopath_resolution(7)).EACCEStimes is NULL, the caller's effective user ID does not              match the owner of the file, the caller does not have write              access to the file, and the caller is not privileged              (Linux: does not have either theCAP_DAC_OVERRIDEor theCAP_FOWNERcapability).EFAULTpath points to an invalid address.ENOENTpath does not exist.EPERMtimes is not NULL, the caller's effective UID does not              match the owner of the file, and the caller is not              privileged (Linux: does not have theCAP_FOWNER              capability).EROFSpath resides on a read-only filesystem.

STANDARDS top

       POSIX.1-2008.

HISTORY top

utime()              SVr4, POSIX.1-2001.  POSIX.1-2008 marks it as obsolete.utimes()              4.3BSD, POSIX.1-2001.

NOTES top

       Linux does not allow changing the timestamps on an immutable file,       or setting the timestamps to something other than the current time       on an append-only file.

COLOPHON top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-05-17utime(2)

Pages that refer to this page:indent(1), F_NOTIFY(2const), futimesat(2), stat(2), statx(2), syscalls(2), utimensat(2), ctime(3), futimes(3), timeval(3type), capabilities(7), inode(7), landlock(7), signal-safety(7), time(7), mount(8)