Previous section.

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


NFSPROC_RMDIR - Remove Directory

Call Arguments

struct diropargs { fhandle dir; filename name; };

fhandle and filename are defined in Basic Data Types

Return Arguments

stat status;

stat is defined in Basic Data Types .

RPC Procedure Description

stat NFSPROC_RMDIR(diropargs) = 15;


The existing empty directory name in the directory given by dir is removed. If the reply is NFS_OK, the directory was removed.

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

Return Codes

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

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

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

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

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

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


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


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

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