Linux and UNIX Man Pages

Test Your Knowledge in Computers #339
Difficulty: Easy
sftp is less secure than ftp for transferring files between computers.
True or False?
Linux & Unix Commands - Search Man Pages

utime(2) [opensolaris man page]

utime(2)							   System Calls 							  utime(2)

NAME
utime - set file access and modification times SYNOPSIS
#include <sys/types.h> #include <utime.h> int utime(const char *path, const struct utimbuf *times); DESCRIPTION
The utime() function sets the access and modification times of the file pointed to by path, and causes the time of the last file status change (st_ctime) to be updated. 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 utime() in this manner. If times is not NULL, times is interpreted as a pointer to a utimbuf structure (defined in <utime.h>) and the access and modification times are set to the values contained in the designated structure. Only the owner of the file or a process that has the {PRIV_FILE_OWNER} privi- lege asserted in its effective set can use utime() in this manner. The utimbuf structure contains the following members: time_t actime; /* access time */ time_t modtime; /* modification time */ The times contained in the members of the utimbuf structure are measured in seconds since 00:00:00 UTC, January 1, 1970. RETURN VALUES
Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno is set to indicate the error. ERRORS
The utime() function will fail if: EACCES Search permission is denied by a component of the path prefix. EACCES The process does not have appropriate privileges and is not the owner of the file, write permission is denied for the file, and times is NULL. EFAULT The path argument points to an illegal address. EINTR A signal was caught during the execution of the utime() function. EIO An I/O error occurred while reading from or writing to the file system. ELOOP Too many symbolic links were encountered in translating path. ENAMETOOLONG The length of the path argument exceeds PATH_MAX, or the length of a path component exceeds NAME_MAX while _POSIX_NO_TRUNC is in effect. ENOENT The named file does not exist or is a null pathname. ENOLINK The path argument points to a remote machine and the link to that machine is no longer active. ENOTDIR A component of the path prefix is not a directory. EPERM The effective user of the calling process is not the owner of the file, {PRIV_FILE_OWNER} is not asserted in the effective set of the calling process, and times is not NULL. EROFS The file system containing the file is mounted read-only. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |Async-Signal-Safe | +-----------------------------+-----------------------------+ SEE ALSO
stat(2), utimes(2), attributes(5), privileges(5), standards(5) SunOS 5.11 19 Apr 2004 utime(2)

Check Out this Related Man Page

utime(2)							System Calls Manual							  utime(2)

NAME
utime, utimes - Sets file access and modification times SYNOPSIS
#include <sys/time.h> #include <utime.h> #include <sys/types.h> int utime ( const char *path, const struct utimbuf *times ); int utimes ( const char *path, const struct timeval times[2]; The following definition of the utime() function does not conform to current standards and is supported only for backward compatibility (see standards(5)): int utime ( const char *path, struct utimbuf *times ); int utimes ( const char *path, struct timeval times[2]; STANDARDS
Interfaces documented on this reference page conform to industry standards as follows: utime(), utimes(): XSH5.0 Refer to the standards(5) reference page for more information about industry standards and associated tags. PARAMETERS
Points to the file. If the final component of the path parameter names a symbolic link, the link will be traversed and pathname resolution will continue. Points to a utimbuf structure for the utime() function, or to an array of timeval structures for the utimes() function. DESCRIPTION
The utimes() function sets the access and modification times of the file pointed to by the path parameter to the value of the times parame- ter. The utimes() function allows time specifications accurate to the microsecond. The utime() function also sets file access and modification times; however, each time is contained in a single integer and is accurate only to the nearest second. For utime(), the times parameter is a pointer to a utimbuf structure, defined in the utime.h header file. The first structure member repre- sents the date and time of last access, and the second member represents the date and time of last modification. The times in the utimbuf structure are measured in seconds since the epoch (00:00:00, January 1, 1970, Coordinated Universal Time (CUT)). For utimes(), the times parameter is an array of timeval structures, as defined in the sys/time.h header file. The first array element represents the date and time of last access, and the second element represents the date and time of last modification. The times in the timeval structure are measured in seconds and microseconds since the epoch, although rounding toward the nearest second may occur. If the times parameter is null, the access and modification times of the file are set to the current time. If the file is a remote file, the current time at the remote node, rather than the local node, is used. The effective user ID of the process must be the same as the owner of the file, or must have write access to the file or superuser privilege in order to use the call in this manner. If the times parameter is not null, the access and modification times are set to the values contained in the designated structure, regard- less of whether those times correlate with the current time. Only the owner of the file or a user with superuser privilege can use the call this way. Upon successful completion, the utime() and utimes() functions mark the time of the last file status change, st_ctime, for update. RETURN VALUES
Upon successful completion, a value of 0 (zero) is returned. Otherwise, a value of -1 is returned, errno is set to indicate the error, and the file times will not be affected. ERRORS
If the utimes() or utime() function fails, errno may be set to one of the following values: Search permission is denied by a component of the path prefix; or the times parameter is null and effective user ID is neither the owner of the file nor has appropriate system privi- lege, and write access is denied. The path parameter is an invalid address, or (for utimes()) either the path or times parameter is an invalid address. The file is not a regular file. Too many links were encountered in translating path. The length of the path parameter exceeds PATH_MAX or a pathname component is longer than NAME_MAX. The named file does not exist or the path parameter points to an empty string. A component of the path prefix is not a directory. The times parameter is not the null value and the calling process has write access to the file but neither owns the file nor has the appropriate system privilege. The file system that contains the file is mounted read-only. The process' root or current directory is located in a virtual file system that has been unmounted. The utimes() function can also fail if additional errors occur. RELATED INFORMATION
Functions: stat(2) Standards: standards(5) delim off utime(2)