Class NfsReaddirplusRequest

java.lang.Object

com.emc.ecs.nfsclient.rpc.RpcRequest

com.emc.ecs.nfsclient.nfs.NfsRequestBase

com.emc.ecs.nfsclient.nfs.NfsReaddirplusRequest

All Implemented Interfaces:

NfsRequest

Direct Known Subclasses:

Nfs3ReaddirplusRequest

public class NfsReaddirplusRequest
extends NfsRequestBase

The request, as specified by RFC 1813 (https://tools.ietf.org/html/rfc1813).

Procedure READDIRPLUS retrieves a variable number of entries from a file system directory and returns complete information about each along with information to allow the client to request additional directory entries in a subsequent READDIRPLUS. READDIRPLUS differs from READDIR only in the amount of information returned for each entry. In READDIR, each entry returns the filename and the fileid. In READDIRPLUS, each entry returns the name, the fileid, attributes (including the fileid), and file handle.

Field Summary

Fields inherited from class RpcRequest

CHARSET

Constructor Summary

Constructors

Constructor	Description
NfsReaddirplusRequest(byte[] fileHandle, long cookie, long cookieverf, int dircount, int maxcount, Credential credential, int nfsVersion)	Creates the request, as specified by RFC 1813 (https://tools.ietf.org/html/rfc1813).

Method Summary

Modifier and Type	Method	Description
void	marshalling(Xdr xdr)	Writes the RPC call header and authentication credentials to the XDR buffer.
String	toString()

Methods inherited from class NfsRequestBase

getErrorMessage, getFileHandle, getIpKey, startToString

Methods inherited from class RpcRequest

cloneFileHandle, isUsePrivilegedPort, setUsePrivilegedPort, trimFileName

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

NfsReaddirplusRequest

public NfsReaddirplusRequest(byte[] fileHandle,
 long cookie,
 long cookieverf,
 int dircount,
 int maxcount,
 Credential credential,
 int nfsVersion)
                      throws FileNotFoundException

Creates the request, as specified by RFC 1813 (https://tools.ietf.org/html/rfc1813).

Procedure READDIRPLUS retrieves a variable number of entries from a file system directory and returns complete information about each along with information to allow the client to request additional directory entries in a subsequent READDIRPLUS. READDIRPLUS differs from READDIR only in the amount of information returned for each entry. In READDIR, each entry returns the filename and the fileid. In READDIRPLUS, each entry returns the name, the fileid, attributes (including the fileid), and file handle.

Parameters:

fileHandle - The file handle for the directory to be read.

cookie - This should be set to 0 in the first request to read the directory. On subsequent requests, it should be a cookie as returned by the server.

cookieverf - This should be set to 0 in the first request to read the directory. On subsequent requests, it should be a cookieverf as returned by the server. The cookieverf must match that returned by the READDIRPLUS in which the cookie was acquired.

dircount - The maximum number of bytes of directory information returned. This number should not include the size of the attributes and file handle portions of the result.

maxcount - The maximum size of the READDIRPLUS3resok structure, in bytes. The size must include all XDR overhead. The server is free to return less than maxcount bytes of data.

credential - The credential used for RPC authentication.

nfsVersion - The NFS version number

Throws:

FileNotFoundException

Method Details

marshalling

public void marshalling(Xdr xdr)

Writes the RPC call header and authentication credentials to the XDR buffer.

Specified by:

marshalling in interface NfsRequest

Overrides:

marshalling in class NfsRequestBase

Parameters:

xdr - the Xdr to be sent.

toString

public String toString()

Overrides:

toString in class Object