# gfs_utimes

## Name

gfs_utimes -- ファイルアクセス時刻/修正時刻変更

## Synopsis

    #include <gfarm/gfarm.h>

```char *gfs_utimes``(const char * `gfarm_url`, const struct gfarm_timespec * `tsp`);`

## DESCRIPTION

引数 `gfarm_url` のファイルアクセス時刻/修正時刻を `tsp` の値に変更します。 `tsp`[0] の値をアクセス時刻に、 `tsp`[1] の値を修正時刻に使用します。 構造体 gfarm_timespec は以下のようになっています。

    	struct gfarm_timespec {
    		unsigned int tv_sec;	/* seconds */
    		unsigned int tv_nsec;	/* nanoseconds */
    	};

`tsp` が NULL の場合、現在の時刻を設定します。

## RETURN VALUES

`NULL`

  正常終了を示します。

`GFARM_ERR_GFARM_URL_PREFIX_IS_MISSING`

  ファイル名に Gfarm URL の gfarm: がありません。

`GFARM_ERR_NO_MEMORY`

  メモリ不足のため処理を中止しました。

`GFARM_ERR_AUTHENTICATION`

  gfmd(8) に対するユーザー認証が失敗しました。

`GFARM_ERR_PERMISSION_DENIED`

  指定されたパスへアクセスする権限が、ありません。

`GFARM_ERR_NO_SUCH_OBJECT`

  指定されたパス名が存在しません。

その他

  上記以外のエラーが生じたことを示します。

## SEE ALSO

gfs_stat(3)