Previous section.

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

Name

NFSPROC_LOOKUP - Look Up File Name

Call Arguments

struct diropargs { fhandle dir; filename name; };
fhandle and filename are defined in Basic Data Types .

Return Arguments

union diropres switch (stat status) { case NFS_OK: struct diropok diropok; default: void; };

diropok is defined in Basic Data Types .

RPC Procedure Description

diropres NFSPROC_LOOKUP(diropargs) = 4;

Description

If the reply status is NFS_OK, then the reply diropok.file and reply diropok.attributes are the file handle and attributes for the file name in the directory given by dir in the argument. The file handle supplied to this procedure can refer to any of the supported file types.

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_NAMETOOLONG

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

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.

NFSERR_PERM
Not owner. The caller does not have correct ownership to perform the requested operation.


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