/** @file  ../include/utime.h
@internalComponent
*/

/** @struct utimbuf

The utimbuf structure is used with the utime function to specify new access and modification times for a file. It contains the following members:

@publishedAll
@externallyDefinedApi
*/

/** @var utimbuf::actime
Access time 
*/

/** @var utimbuf::modtime
Modification time 
*/

/** @fn  utime(const char *name, const struct utimbuf *filetimes)
@param name
@param filetimes
@return   errno is set appropriately.

  This interface is obsoleted by utimes.

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.

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.

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.

Examples:
@code
/* Detailed description:  Sample usage of utime system call
 *  Preconditions:  Example.txt file should exist in the working directory
 */
#include <stdio.h>
#include <utime.h>
int main()
{
  struct utimbuf Time ;
  if(utime("Example.txt" , &Time;) < 0 ) 
  {
     printf("Utime call failed") ;
     return -1 ;
  }
  printf("Utime call succeded") ;
  return 0 ;
}

@endcode
 Output
@code
Utime call succeded

@endcode

Limitations:

KErrNotReady of Symbian error code is mapped to ENOENT, which typically means drive
not found or filesystem not mounted on the drive.

@see stat()
@see utimes()



@capability Deferred @ref RFs::SetModified(const TDesC16&, const TTime&)

@publishedAll
@externallyDefinedApi
*/