Previous section.

Protocols for Interworking: XNFS, Version 3W
Copyright © 1998 The Open Group

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.


Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index