GFS_UTIMES(3)
NAME
gfs_utimes - set file access and modification times
SYNOPSIS
#include <gfarm/gfarm.h> char *gfs_utimes (const char * gfarm_url, const struct gfarm_timespec * tsp);
DESCRIPTION
- 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_ERR_GFARM_URL_PREFIX_IS_MISSING
- gfarm_url does not start with the gfarm: prefix.
- GFARM_ERR_NO_MEMORY
- Insufficient memory was available.
- GFARM_ERR_AUTHENTICATION
- User authentication failed when connecting to gfmd(8).
- GFARM_ERR_PERMISSION_DENIED
- gfarm_url points outside your accessible address space.
- GFARM_ERR_NO_SUCH_OBJECT
- gfarm_url does not exist.
- Others An error except the above occurred. The reason is shown by its
- pointed strings.