gfs_rename(3) [debian man page]

GFS_RENAME(3)															     GFS_RENAME(3)

NAME

       gfs_rename - change the name or location of a file

SYNOPSIS

       #include <gfarm/gfarm.h>

       char *gfs_rename (char * gfarm_url_from, char * gfarm_url_to);

DESCRIPTION

       gfs_rename renames a file or directory gfarm_url_from to gfarm_url_to.

       If  gfarm_url_to  already  exists, it will be replaced.	In this case, when gfarm_url_from is a file gfarm_url_to also must be a file, when
       gfarm_url_from is a directory, gfarm_url_to must be a empty directory.

       Gfs_rename() can't rename a directory to a subdirectory of itself.

RETURN VALUES

       NULL   The function terminated successfully.

       GFARM_ERR_NO_MEMORY
	      Insufficient memory was available.

       GFARM_ERR_AUTHENTICATION
	      User authentication failed when connecting to gfmd(8).

       GFARM_ERR_PERMISSION_DENIED
	      The parent directory of gfarm_url_from or gfarm_url_to did not allow write permission.

       GFARM_ERR_INVALID_ARGUMENT
	      A attempt was made to rename the directory gfarm_url_from to a subdirectory of itself.

       GFARM_ERR_NO_SUCH_OBJECT
	      gfarm_url_from does not exist.

       GFARM_ERR_IS_A_DIRECTORY
	      gfarm_url_to is a existing directory, though gfarm_url_from is not a directory.

       GFARM_NOT_IS_A_DIRECTORY
	      gfarm_url_to is not a directory.	though gfarm_url_from is a directory.

       Others An error except the above occurred.  The reason is shown by its pointed strings.

Gfarm								 13 November 2006						     GFS_RENAME(3)

GFS_CHMOD(3)															      GFS_CHMOD(3)

NAME

       gfs_chmod - change permissions of a file

SYNOPSIS

       #include <gfarm/gfarm.h>

       char *gfs_chmod (char * gfarm_url, mode_t mode);

DESCRIPTION

       gfs_chmod()  changes  the  mode	of  the  file  given  by gfarm_url.  Permission bit masks of mode are similar to ones of mode parameter to
       chmod(2), though only the least 9 bit are effective.

       An executable file cannot be changed to a non-executable file and vice versa, unless the number of fragment of the file is  only  one.	In
       detail,	a file has multiple fragments with any execution bit should not be changed to that with no execution bit.  It is necessary to have
       at least one execution bit.  Similarly, a file has multiple fragments with no execution bit should not be changed to that with  any  execu-
       tion bit.

RETURN VALUES

       NULL   The function terminated successfully.

       GFARM_ERR_NO_MEMORY
	      Insufficient memory was available.

       GFARM_ERR_AUTHENTICATION
	      User authentication failed when connecting to gfmd(8) or gfsd(8).

       GFARM_ERR_PERMISSION_DENIED
	      The parent directory of gfarm_url did not allow write permission.

       GFARM_ERR_OPERATION_NOT_PERMITTED
	      The  effective  UID does not match the owner of the file, and is not zero.  Or an attempt was made to change an executable file with
	      more than one fragment to a non-executable file, or vice versa.

       GFARM_ERR_NO_SUCH_OBJECT
	      The file does not exist.

       GFARM_ERR_NOT_A_DIRECTORY
	      A component of the path prefix is not a directory.

       Others An error except the above occurred.  The reason is shown by its pointed strings.

Gfarm								 13 November 2006						      GFS_CHMOD(3)