.\" 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 \- ファイルアクセス時刻/修正時刻変更
.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
引数
\fIgfarm_url\fR
のファイルアクセス時刻/修正時刻を
\fItsp\fR
の値に変更します。
\fItsp\fR[0] の値をアクセス時刻に、
\fItsp\fR[1] の値を修正時刻に使用します。
構造体
gfarm_timespec
は以下のようになっています。

.nf
	struct gfarm_timespec {
		unsigned int tv_sec;	/* seconds */
		unsigned int tv_nsec;	/* nanoseconds */
	};
.fi
.PP
\fItsp\fR
が NULL の場合、現在の時刻を設定します。
.SH "RETURN VALUES"
.TP
\fBNULL\fR
正常終了を示します。
.TP
\fBGFARM_ERR_GFARM_URL_PREFIX_IS_MISSING\fR
ファイル名に Gfarm URL の gfarm: がありません。
.TP
\fBGFARM_ERR_NO_MEMORY\fR
メモリ不足のため処理を中止しました。
.TP
\fBGFARM_ERR_AUTHENTICATION\fR
gfmd(8) に対するユーザー認証が失敗しました。
.TP
\fBGFARM_ERR_PERMISSION_DENIED\fR
指定されたパスへアクセスする権限が、ありません。
.TP
\fBGFARM_ERR_NO_SUCH_OBJECT\fR
指定されたパス名が存在しません。
.TP
\fBその他\fR
上記以外のエラーが生じたことを示します。
.SH "SEE ALSO"
.PP
\fBgfs_stat\fR(3)