Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for utime (redhat section 2)

UTIME(2)			    Linux Programmer's Manual				 UTIME(2)

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  modi-
       fication 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)

Linux					    1995-06-10					 UTIME(2)


All times are GMT -4. The time now is 10:57 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password