NAME¶
gfs_rename -
ファイルを改名する
SYNOPSIS¶
#include <gfarm/gfarm.h>
char *gfs_rename (char *
gfarm_url_from, char *
gfarm_url_to );
DESCRIPTION¶
ファイルまたはディレクトリ
gfarm_url_from を
gfarm_url_to
に改名します。
gfarm_url_to
が既存の場合は削除されます。このとき
gfarm_url_from
がファイルならば
gfarm_url_to もファイル、
gfarm_url_from
がディレクトリならば
gfarm_url_to
もディレクトリで、しかも空でなければなりません。
ディレクトリ
gfarm_url_from
をそのサブディレクトリに改名することはできません。
RETURN VALUES¶
- NULL
- 正常終了を示します。
- GFARM_ERR_NO_MEMORY
- メモリ不足のため処理を中止しました。
- GFARM_ERR_AUTHENTICATION
- gfmd(8)
に対するユーザー認証が失敗しました。
- GFARM_ERR_PERMISSION_DENIED
- 親ディレクトリへ書き込みアクセスする権限がありません。
- GFARM_ERR_INVALID_ARGUMENT
- ディレクトリ
gfarm_url_from
を、それ自身のサブディレクトリに変更しようとしました。
- GFARM_ERR_NO_SUCH_OBJECT
- 指定されたパス
gfarm_url_from
が存在しません。
- GFARM_ERR_IS_A_DIRECTORY
- gfarm_url_from
がファイルであるのに、
gfarm_url_to
は既存のディレクトリです。
- GFARM_NOT_IS_A_DIRECTORY
- gfarm_url_from
がディレクトリであるのに、
gfarm_url_to
は既存のファイルです。
- その他
- 上記以外のエラーが生じたことを示します。