# gfs_stat

## Name

gfs_stat -- ファイル属性取得

## Synopsis

    #include <gfarm/gfarm.h>

```char *gfs_stat``(const char * `gfarm_url`, struct gfs_stat * `status`);`

## DESCRIPTION

引数 `gfarm_url` のファイル属性を `status` の指す先に取得します。 `status`

には、動的に確保されたメモリへのポインタが含まれるので、 この後、gfs_stat_free(3) を使ってそのメモリを解放する必要が あります。

## RETURN VALUES

`NULL`

  正常終了を示します。

`GFARM_ERR_NO_MEMORY`

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

`GFARM_ERR_AUTHENTICATION`

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

`GFARM_ERR_PERMISSION_DENIED`

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

`GFARM_ERR_NO_SUCH_OBJECT`

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

`GFARM_ERR_NOT_A_DIRECTORY`

  指定したパス名の親ディレクトリが、実際にはディレクトリでなかったことを 示します。

その他

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

## SEE ALSO

gfs_stat_free(3)