Poster of Linux kernelThe best gift for a Linux geek
GFS_UTIMES

GFS_UTIMES

Section: (3) Updated: 04 December 2003
Local index Up
 

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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:46:49 GMT, April 16, 2011