diff -r 000000000000 -r bde4ae8d615e os/ossrv/genericopenlibs/openenvcore/include/utime.dosc --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/os/ossrv/genericopenlibs/openenvcore/include/utime.dosc Fri Jun 15 03:10:57 2012 +0200 @@ -0,0 +1,74 @@ +/** @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 +#include +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 +*/