119 lines
2.3 KiB
Groff
119 lines
2.3 KiB
Groff
|
||
|
||
UTIME(2) Minix Programmer's Manual UTIME(2)
|
||
|
||
|
||
NAME
|
||
utime - set file times
|
||
|
||
SYNOPSIS
|
||
#include <sys/types.h>
|
||
#include <utime.h>
|
||
|
||
int utime(const char *file, struct utimbuf *times)
|
||
|
||
DESCRIPTION
|
||
The utime call uses the "accessed" and "updated" times from the utimbuf
|
||
structure pointed to by times to set the corresponding recorded times for
|
||
file.
|
||
|
||
Struct utimbuf is defined in <utime.h> as follows:
|
||
|
||
struct utimbuf {
|
||
time_t actime; /* access time */
|
||
time_t modtime; /* modification time */
|
||
};
|
||
|
||
The caller must be the owner of the file or the super-user. The "inode-
|
||
changed" time of the file is set to the current time.
|
||
|
||
RETURN VALUE
|
||
Upon successful completion, a value of 0 is returned. Otherwise, a value
|
||
of -1 is returned and errno is set to indicate the error.
|
||
|
||
ERRORS
|
||
Utime will fail if one or more of the following are true:
|
||
|
||
[ENOTDIR] A component of the path prefix is not a directory.
|
||
|
||
[EINVAL] The pathname contains a character with the high-order bit
|
||
set.
|
||
|
||
[ENAMETOOLONG] The path name exceeds PATH_MAX characters.
|
||
|
||
[ENOENT] The named file does not exist.
|
||
|
||
[ELOOP] Too many symbolic links were encountered in translating
|
||
the pathname. (Minix-vmd)
|
||
|
||
[EPERM] The process is not super-user and not the owner of the
|
||
file.
|
||
|
||
[EACCES] Search permission is denied for a component of the path
|
||
prefix.
|
||
|
||
|
||
|
||
|
||
4BSD August 26, 1985 1
|
||
|
||
|
||
|
||
UTIME(2) Minix Programmer's Manual UTIME(2)
|
||
|
||
|
||
[EROFS] The file system containing the file is mounted read-only.
|
||
|
||
[EFAULT] File or times points outside the process's allocated
|
||
address space.
|
||
|
||
[EIO] An I/O error occurred while reading or writing the
|
||
affected inode.
|
||
|
||
SEE ALSO
|
||
stat(2).
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
4BSD August 26, 1985 2
|
||
|