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.

SEE ALSO

       gfs_stat(3)

Gfarm                                           04 December 2003                                   GFS_UTIMES(3)