.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "GFS_RENAME" "3" "21 February 2005" "Gfarm" ""
.SH NAME
gfs_rename \- ファイルを改名する
.SH SYNOPSIS
.sp
\fB#include <gfarm/gfarm.h>
.sp
char *gfs_rename (char * \fIgfarm_url_from\fB, char * \fIgfarm_url_to\fB);
\fR
.SH "DESCRIPTION"
.PP
ファイルまたはディレクトリ
\fIgfarm_url_from\fR
を
\fIgfarm_url_to\fR
に改名します。
.PP
\fIgfarm_url_to\fR
が既存の場合は削除されます。このとき
\fIgfarm_url_from\fR
がファイルならば
\fIgfarm_url_to\fR
もファイル、
\fIgfarm_url_from\fR
がディレクトリならば
\fIgfarm_url_to\fR
もディレクトリで、しかも空でなければなりません。
.PP
ディレクトリ
\fIgfarm_url_from\fR
をそのサブディレクトリに改名することはできません。
.SH "RETURN VALUES"
.TP
\fBNULL\fR
正常終了を示します。
.TP
\fBGFARM_ERR_NO_MEMORY\fR
メモリ不足のため処理を中止しました。
.TP
\fBGFARM_ERR_AUTHENTICATION\fR
gfmd(8) に対するユーザー認証が失敗しました。
.TP
\fBGFARM_ERR_PERMISSION_DENIED\fR
親ディレクトリへ書き込みアクセスする権限がありません。
.TP
\fBGFARM_ERR_INVALID_ARGUMENT\fR
ディレクトリ
\fIgfarm_url_from\fR
を、それ自身のサブディレクトリに変更しようとしました。
.TP
\fBGFARM_ERR_NO_SUCH_OBJECT\fR
指定されたパス
\fIgfarm_url_from\fR
が存在しません。
.TP
\fBGFARM_ERR_IS_A_DIRECTORY\fR
\fIgfarm_url_from\fR
がファイルであるのに、
\fIgfarm_url_to\fR
は既存のディレクトリです。
.TP
\fBGFARM_NOT_IS_A_DIRECTORY\fR
\fIgfarm_url_from\fR
がディレクトリであるのに、
\fIgfarm_url_to\fR
は既存のファイルです。
.TP
\fBその他\fR
上記以外のエラーが生じたことを示します。