Manpages

Manpage of UTIME

UTIME

Section: Linux Programmer's Manual (2)
Updated: 1995-06-10
Index
Return to Main Contents
 

NAME

utime, utimes - change access and/or modification times of an inode  

SYNOPSIS

#include <sys/types.h>
#include <utime.h>

int utime(const char *filename, struct utimbuf *buf);

#include <sys/time.h>

int utimes(char *filename, struct timeval *tvp);  

DESCRIPTION

utime changes the access and modification times of the inode specified by filename to the actime and modtime fields of buf respectively. If buf is NULL, then the access and modification times of the file are set to the current time. The utimbuf structure is:

struct utimbuf {
        time_t actime;  /* access time */
        time_t modtime; /* modification time */
};

In the Linux DLL 4.4.1 libraries, utimes is just a wrapper for utime: tvp[0].tv_sec is actime, and tvp[1].tv_sec is modtime. The timeval structure is:

struct timeval {
        long    tv_sec;         /* seconds */
        long    tv_usec;        /* microseconds */
};
 

RETURN VALUE

On success, zero is returned. On error, -1 is returned, and errno is set appropriately.  

ERRORS

Other errors may occur.

EACCES
Permission to write the file is denied.
ENOENT
filename does not exist.
 

CONFORMING TO

utime: SVr4, SVID, POSIX. SVr4 documents additional error conditions EFAULT, EINTR, ELOOP, EMULTIHOP, ENAMETOOLONG, ENOLINK, ENOTDIR, ENOLINK, ENOTDIR, EPERM, EROFS.
utimes: BSD 4.3  

SEE ALSO

stat(2)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
CONFORMING TO
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 06:54:08 GMT, March 29, 2024