Name

NFSPROC_STATFS - Get File System Attributes

Call Arguments

 

typedef opaque fhandle[NFS_FHSIZE];

Return Arguments

 

union statfsres (stat status) {
    case NFS_OK:
        struct {
            unsigned tsize;
            unsigned bsize;
            unsigned blocks;
            unsigned bfree;
            unsigned bavail;
        } info;
    default:
        void;
};

RPC Procedure Description

 

statfsres
NFSPROC_STATFS(fhandle) = 17;

Description

If the reply status is NFS_OK, then the reply info gives the attributes for the file system that contains the file referred to by the input fhandle. The attribute fields contain the following values:

tsize

The optimum transfer size of the server in bytes. This is the number of bytes the server would like to have in the data part of NFSPROC_READ and NFSPROC_WRITE requests.

bsize

The block size in bytes of the file system.

blocks

The total number of bsize blocks on the file system.

bfree

The number of free bsize blocks on the file system.

bavail

The number of bsize blocks available to non-privileged users.

Return Codes

NFS_OK

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

NFSERR_IO

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

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