sl@0: /** @file  ../include/utime.h
sl@0: @internalComponent
sl@0: */
sl@0: 
sl@0: /** @struct utimbuf
sl@0: 
sl@0: The utimbuf structure is used with the utime function to specify new access and modification times for a file. It contains the following members:
sl@0: 
sl@0: @publishedAll
sl@0: @externallyDefinedApi
sl@0: */
sl@0: 
sl@0: /** @var utimbuf::actime
sl@0: Access time 
sl@0: */
sl@0: 
sl@0: /** @var utimbuf::modtime
sl@0: Modification time 
sl@0: */
sl@0: 
sl@0: /** @fn  utime(const char *name, const struct utimbuf *filetimes)
sl@0: @param name
sl@0: @param filetimes
sl@0: @return   errno is set appropriately.
sl@0: 
sl@0:   This interface is obsoleted by utimes.
sl@0: 
sl@0: The utime function sets the access and modification times of the named file from the actime and modtime fields of the struct utimbuf pointed at by filetimes.
sl@0: 
sl@0: If the times are specified (the timep argument is non- NULL) the caller must be the owner of the file or be the super-user.
sl@0: 
sl@0: If the times are not specified (the timep argument is NULL) the caller must be the owner of the file, have permission to write the file, or be the super-user.
sl@0: 
sl@0: Examples:
sl@0: @code
sl@0: /* Detailed description:  Sample usage of utime system call
sl@0:  *  Preconditions:  Example.txt file should exist in the working directory
sl@0:  */
sl@0: #include <stdio.h>
sl@0: #include <utime.h>
sl@0: int main()
sl@0: {
sl@0:   struct utimbuf Time ;
sl@0:   if(utime("Example.txt" , &Time;) < 0 ) 
sl@0:   {
sl@0:      printf("Utime call failed") ;
sl@0:      return -1 ;
sl@0:   }
sl@0:   printf("Utime call succeded") ;
sl@0:   return 0 ;
sl@0: }
sl@0: 
sl@0: @endcode
sl@0:  Output
sl@0: @code
sl@0: Utime call succeded
sl@0: 
sl@0: @endcode
sl@0: 
sl@0: Limitations:
sl@0: 
sl@0: KErrNotReady of Symbian error code is mapped to ENOENT, which typically means drive
sl@0: not found or filesystem not mounted on the drive.
sl@0: 
sl@0: @see stat()
sl@0: @see utimes()
sl@0: 
sl@0: 
sl@0: 
sl@0: @capability Deferred @ref RFs::SetModified(const TDesC16&, const TTime&)
sl@0: 
sl@0: @publishedAll
sl@0: @externallyDefinedApi
sl@0: */