.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "GFS_UTIMES" "3" "04 December 2003" "Gfarm" ""
.SH NAME
gfs_utimes \- set file access and modification times
.SH SYNOPSIS
.sp
\fB#include <gfarm/gfarm.h>
.sp
char *gfs_utimes (const char * \fIgfarm_url\fB, const struct gfarm_timespec * \fItsp\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBgfs_utimes()\fR sets the access and
modification times of the file pointed to by the
\fIgfarm_url\fR argument to the value of the
\fItsp\fR argument.  The \fItsp\fR
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:

.nf
	struct gfarm_timespec {
		unsigned int tv_sec;	/* seconds */
		unsigned int tv_nsec;	/* nanoseconds */
	};
.fi
.PP
If the \fItsp\fR argument is a null pointer,
the access and modification times of the file are set to the current
time.
.SH "RETURN VALUES"
.TP
\fBNULL\fR
The function terminated successfully.
.TP
\fBGFARM_ERR_GFARM_URL_PREFIX_IS_MISSING\fR
\fIgfarm_url\fR does not start with the gfarm: prefix.
.TP
\fBGFARM_ERR_NO_MEMORY\fR
Insufficient memory was available.
.TP
\fBGFARM_ERR_AUTHENTICATION\fR
User authentication failed when connecting to gfmd(8).
.TP
\fBGFARM_ERR_PERMISSION_DENIED\fR
\fIgfarm_url\fR
points outside your accessible address space.
.TP
\fBGFARM_ERR_NO_SUCH_OBJECT\fR
\fIgfarm_url\fR does not exist.
.TP
\fBOthers\fR
An error except the above occurred.  The reason is shown by its
pointed strings.
.SH "SEE ALSO"
.PP
\fBgfs_stat\fR(3)