utime(3) [ultrix man page]
utime(3) Library Functions Manual utime(3) Name utime - set file times Syntax #include <sys/types.h> int utime (path, times) char *path; struct utimbuf *times; Description The path points to a pathname naming a file. The function sets the access and modification times of the named file. If times is NULL, the access and modification times of the file are set to the current time. A process must be the owner of the file or have write permission to use in this manner. If times is not NULL, times is interpreted as a pointer to a utimbuf structure and the access and modification times are set to the values contained in the designated structure. Only the owner of the file or the super-user can use this way. The function causes the time of the last file status change(st_ctime) to be updated with the current time. The times in the following structure are measured in seconds since 00:00:00 GMT, January 1, 1970. struct utimbuf { time_t actime; /* access time */ time_t modtime; /* modification time */ }; Return Values Upon successful completion, a value of zero (0) is returned. Otherwise, a value of -1 is returned, and errno is set to indicate the error. Diagnostics The function fails, if any of the following is true: [EACCES] Search permission is denied by a component of the path prefix. [EACCES] The effective user ID is not super-user, not the owner of the file, times is NULL, and write access is denied. [EFAULT] The times is not NULL and points outside the process's allocated address space. [EFAULT] The path points outside the process's allocated address space. [ENOENT] The named file does not exist or path points to an empty string and the environment defined is POSIX or SYSTEM_FIVE. [ENOTDIR] A component of the path prefix is not a directory. [EPERM] The effective user ID is not a super-user, not the owner of the file, and times is not NULL. [EROFS] The file system containing the file is mounted read-only. [ETIMEDOUT] A connect request or remote file operation failed, because the connected party did not respond after a period of time deter- mined by the communications protocol. See Also stat(2) utime(3)
Check Out this Related Man Page
utime(2) System Calls Manual utime(2) NAME
utime() - set file access and modification times SYNOPSIS
DESCRIPTION
The system call sets the access and modification times of the file to which the path argument refers. If times is a NULL pointer, the access and modification times of the file are set to the current time. A process must be the owner of the file or have write permission on the file to use in this manner. The following times in the structure defined in are measured in seconds since 00:00:00 UTC (Coordinated Universal Time), January 1, 1970. time_t actime; /* access time */ time_t modtime; /* modification time */ Security Restrictions If times is not a NULL pointer, times is interpreted as a pointer to a utimbuf structure, and the access and modification times are set to the values contained in the designated structure. Only the owner of the file or a user with the privilege can use this way. See privileges(5) for more information about privileged access on systems that support fine-grained privileges. RETURN VALUE
returns the following values: Successful completion. Failure. is set to indicate the error. ERRORS
If fails, is set to one of the following values. Search permission is denied by a component of the path prefix. The effective user ID is not a user with the privilege, and not the owner of the file, times is a NULL pointer, and write access is denied. times is not a NULL pointer, and it points outside the process's allocated address space. The reliable detection of this error is implementation-dependent. path points outside the process's allocated address space. The reliable detection of this error is implementation-depen- dent. times is not a NULL pointer, and access time or modification time or both are negative. The length of the specified path name exceeds bytes, or the length of a component of the path name exceeds bytes while is in effect. The named file does not exist. A component of the path prefix is not a directory. The effective user ID is not a user with the privilege, and not the owner of the file, and times is not a NULL pointer. The file system containing the file is mounted read-only. DEPENDENCIES
NFS may return when invoked on a remote file owned by a superuser, or users with and privileges, even if the invoking user has write permission on the file. See privileges(5) for more information about privileged access on systems that support fine-grained privileges. SEE ALSO
touch(1), stat(2), privileges(5). STANDARDS CONFORMANCE
utime(2)