gfs_utimes3
Set file access and modification times
Usage
#include <gfarm/gfarm.h>
char *gfs_utimes (const char * gfarm_url, const struct gfarm_timespec * tsp);
Overview
gfs_utimes() sets the access and modification times of the file pointed to by the gfarm_url argument to the value of the tsp argument. The tsp argument is an array of gfarm_timespec structures. The first array member represents the access time, and the second member represents the modification time. The gfarm_timespec structure is:
struct gfarm_timespec {
unsigned int tv_sec; /* seconds */
unsigned int tv_nsec; /* nanoseconds */
};
If the tsp argument is a null pointer, the access and modification times of the file are set to the current time.
Return values
NULL
|
The function terminated successfully. |
|---|---|
|
gfarm_url does not start with the gfarm: prefix. |
|
Insufficient memory was available. |
|
User authentication failed when connecting to gfmd(8). |
|
gfarm_url points outside your accessible address space. |
|
gfarm_url does not exist. |
|
An error except the above occurred. The reason is shown by its pointed strings. |
Releases
Unchanged in 2 releases since Debian 6.0 (Squeeze).