Company Innovation Man pages Tech News Developer Mirrors Search
 
UTIME   (2) manpage
UTIME
2
1995-06-10
Linux
Linux Programmer's Manual
  • 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 , const 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
Current Users: 39 © 1999-2006 Linux.com.hk PenguinSoft
All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.