GFS_RENAME(3)

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 は既存のファイルです。

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