UTIME(3) | Library Functions Manual | UTIME(3) |
utime
— set file
times
#include
<sys/types.h>
#include <utime.h>
int
utime
(const
char *file, const struct
utimbuf *timep);
The
utime
()
function sets the access and modification times of the named file.
If timep is NULL
,
the access and modification times are set to the current time. The calling
process must be the owner of the file or have permission to write the
file.
If timep is non-null, it specifies a pointer
to a utimbuf
structure, as defined in
<utime.h>
:
struct utimbuf { time_t actime; /* Access time */ time_t modtime; /* Modification time */ };
The access time is set to the value of the actime member, and the modification time is set to the value of the modtime member. The times are measured in seconds since 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated Universal Time (UTC). The calling process must be the owner of the file or be the superuser.
In either case, the inode change-time of the file is set to the current time.
Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.
utime
() will fail if:
EACCES
]NULL
and
the effective user ID of the process does not match the owner of the file,
the effective user ID is not that of the superuser, and write access is
denied.EFAULT
]EINVAL
]EIO
]ELOOP
]ENAMETOOLONG
]NAME_MAX
characters, or an entire pathname (including the terminating NUL) exceeded
PATH_MAX
bytes.ENOENT
]ENOTDIR
]EPERM
]NULL
and the calling process's effective user ID
does not match the owner of the file and is not the superuser.EROFS
]The utime
() function conforms to
IEEE Std 1003.1-1988 (“POSIX.1”).
A utime
() function appeared in
Version 7 AT&T UNIX.
January 29, 2015 | OpenBSD-7.0 |