rename

Synopsis:

          int rename(const char *oldpath, const char *newpath);

Request:

‘Frename,oldpathptr/len,newpathptr/len’

Return value:

On success, zero is returned. On error, -1 is returned.

Errors:

EISDIR

newpath is an existing directory, but oldpath is not a directory.

EEXIST

newpath is a non-empty directory.

EBUSY

oldpath or newpath is a directory that is in use by some process.

EINVAL

An attempt was made to make a directory a subdirectory of itself.

ENOTDIR

A component used as a directory in oldpath or new path is not a directory. Or oldpath is a directory and newpath exists but is not a directory.

EFAULT

oldpathptr or newpathptr are invalid pointer values.

EACCES

No access to the file or the path of the file.

ENAMETOOLONG

oldpath or newpath was too long.

ENOENT

A directory component in oldpath or newpath does not exist.

EROFS

The file is on a read-only filesystem.

ENOSPC

The device containing the file has no room for the new directory entry.

EINTR

The call was interrupted by the user.