gfal_rename(3) - Linux man page

Name

gfal_rename - rename a file or a directory

#include "gfal_api.h"

int gfal_rename (const char *old_name, const char *new_name);

gfal_rename renames a file or a directory

old_name and new_name specify the old and new file names (this can only be a TURL in the current implementation).

This routine returns 0 if the operation was successful or -1 if the operation failed. In the latter case, errno is set appropriately.

ENOENT: A component of old_name prefix does not exist.
EACCES: Search permission is denied on a component of the file prefixes or write permission on the parent directories is denied or old_name is a directory and write permission is denied on old_name or new_name.
EFAULT: old_name or new_name is a NULL pointer.
ENOTDIR: A component of the file prefixes is not a directory.
EINVAL: old_name or new_name has an invalid syntax.
ECOMM: Communication error.
EPROTONOSUPPORT: Access method not supported.