gfs_stat

## Name

gfs_stat — ファイル属性取得

## Synopsis

    #include <gfarm/gfarm.h>

`gfarm_error_t gfs_stat(` | gfarm_url, |
| status`)`; |

`const char * gfarm_url`;
`struct gfs_stat * status`;

## DESCRIPTION

引数 `gfarm_url` のファイル属性を `status` の指す先に取得します。 `status` には、動的に確保されたメモリへのポインタが含まれるので、この後、 gfs_stat_free(3) を使ってそのメモリを解放する必要があります。

## RETURN VALUES

`GFARM_ERR_NO_ERROR`

  正常終了を示します。

`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)