Name

NFSPROC_RENAME - Rename File

Call Arguments

 

struct renameargs {
    diropargs from;       
    diropargs to;
};

diropargs is defined in Basic Data Types .

Return Arguments

 

stat status;

stat is defined in Basic Data Types .

RPC Procedure Description

 

stat
NFSPROC_RENAME(renameargs) = 11;

Description

The existing file from.name in the directory given by from.dir is renamed to to.name in the directory given by to.dir. If the reply is NFS_OK, the file was renamed. The NFSPROC_RENAME operation is required to be atomic on the server; it cannot be interrupted in the middle; that is, a link and unlink combination is not sufficient.

Note that this is possibly a non-idempotent operation. A server should attempt to provide this function in an idempotent fashion.

Return Codes

NFS_OK

Indicates that the call completed successfully and the results are valid.

NFSERR_NOENT

No such file or directory. The file or directory specified does not exist.

NFSERR_IO

Some sort of hard error occurred when the operation was in progress. This could be a disk error, for example.

NFSERR_ACCES

Permission denied. The caller does not have the correct permission to perform the requested operation.

NFSERR_NOTDIR

Not a directory. The caller specified a non-directory in a directory operation.

NFSERR_ISDIR

Is a directory. The caller specified a directory in a non-directory operation.

NFSERR_NOSPC

No space left on device. The operation caused the server's file system to reach its limit.

NFSERR_ROFS

Read-only file system. Write attempted on a read-only file system.

NFSERR_NAMETOOLONG

File name too long. The filename in an operation was too long.

NFSERR_NOTEMPTY

Directory not empty. Attempted to remove a directory that was not empty.

NFSERR_DQUOT

Disk quota exceeded. The client's disk quota on the server has been exceeded.

NFSERR_STALE

The fhandle given in the arguments was invalid. That is, the file referred to by that file handle no longer exists, or access to it has been revoked.