xrootd
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros
Public Member Functions | List of all members
XrdOucCacheIO2 Class Reference

#include <XrdOucCache2.hh>

Inheritance diagram for XrdOucCacheIO2:
Inheritance graph
[legend]
Collaboration diagram for XrdOucCacheIO2:
Collaboration graph
[legend]

Public Member Functions

virtual int Fstat (struct stat &sbuff)
 
virtual const char * Location ()
 
virtual void Read (XrdOucCacheIOCB &iocb, char *buff, long long offs, int rlen)
 
virtual void ReadV (XrdOucCacheIOCB &iocb, const XrdOucIOVec *readV, int rnum)
 
virtual void Sync (XrdOucCacheIOCB &iocb)
 
virtual void Update (XrdOucCacheIO2 &iocp)
 
virtual void Write (XrdOucCacheIOCB &iocb, char *buff, long long offs, int wlen)
 
virtual ~XrdOucCacheIO2 ()
 
- Public Member Functions inherited from XrdOucCacheIO
virtual long long FSize ()=0
 
virtual const char * Path ()=0
 
virtual int Read (char *Buffer, long long Offset, int Length)=0
 
virtual int ReadV (const XrdOucIOVec *readV, int n)
 
virtual int Sync ()=0
 
virtual int Trunc (long long Offset)=0
 
virtual int Write (char *Buffer, long long Offset, int Length)=0
 
virtual XrdOucCacheIOBase ()
 
virtual XrdOucCacheIODetach ()
 
virtual bool ioActive ()
 
virtual void Preread (long long Offset, int Length, int Opts=0)
 
virtual void Preread (aprParms &Parms)
 
virtual ~XrdOucCacheIO ()
 

Additional Inherited Members

- Public Attributes inherited from XrdOucCacheIO
XrdOucCacheStats Statistics
 
- Static Public Attributes inherited from XrdOucCacheIO
static const int SingleUse = 0x0001
 

Detailed Description

XrdOucCache2

This class is an extension of the original XrdOucCache class and provides async I/O support, defered open and I/O decoupling. It is loaded as a cache plugin by the POSIX package via the proxy directive

pss.cache -2 <path>

Without the "-2" the original version is loaded. Implementation of a cache is similar between versions (see XrdOucCache.hh for details). The only difference is this version requires additional methods to be implemented and uses an asynchrnous callback mechanism to return the results. The XrdOucCacheIO2 object is responsible for interacting with the original data source/target. It can be used with or without a front-end cache. It an extension of the XrdOucCacheIO class which defines base methods.

Constructor & Destructor Documentation

virtual XrdOucCacheIO2::~XrdOucCacheIO2 ( )
inlinevirtual

Member Function Documentation

virtual int XrdOucCacheIO2::Fstat ( struct stat sbuff)
inlinevirtual

Perform an fstat() operation (defaults to passthrough).

Parameters
sbuffreference to the stat buffer to be filled in. Only fields st_size, st_blocks, st_mtime (st_atime and st_ctime may be set to st_mtime), st_ino, and st_mode need to be set. All other fields are preset and should not be changed.
Returns
<0 - fstat failed, value is -errno. =0 - fstat succeeded, sbuff holds stat information. >0 - fstat could not be done, forward operation to next level.

Reimplemented in XrdPosixFile, XrdFileCache::IOEntireFile, XrdFileCache::IOFileBlock, XrdPosixCacheBCIO, and XrdPosixPrepIO.

Referenced by XrdPosixCacheBCIO::Fstat().

virtual const char* XrdOucCacheIO2::Location ( )
inlinevirtual

Get the file's location (i.e. endpoint hostname and port)

Returns
A pointer to the file's location. It remains valid until the file is closed. A null string means the file is not open or is unknown.

Reimplemented in XrdPosixFile, and XrdPosixCacheBCIO.

Referenced by XrdPosixCacheBCIO::Location().

virtual void XrdOucCacheIO2::Read ( XrdOucCacheIOCB iocb,
char *  buff,
long long  offs,
int  rlen 
)
inlinevirtual

Reimplemented in XrdPosixFile, and XrdPosixPrepIO.

References XrdOucCacheIOCB::Done().

virtual void XrdOucCacheIO2::ReadV ( XrdOucCacheIOCB iocb,
const XrdOucIOVec readV,
int  rnum 
)
inlinevirtual

Reimplemented in XrdPosixFile, and XrdPosixPrepIO.

References XrdOucCacheIOCB::Done().

virtual void XrdOucCacheIO2::Sync ( XrdOucCacheIOCB iocb)
inlinevirtual

Reimplemented in XrdPosixFile, and XrdPosixPrepIO.

References XrdOucCacheIOCB::Done(), and Sync().

Referenced by Sync().

virtual void XrdOucCacheIO2::Update ( XrdOucCacheIO2 iocp)
inlinevirtual

Update the originally passed XrdOucCacheIO2 object with the object passed. All future uses underlying XrdOucCacheIO2 object must now use this object. Update() is called when Prepare() indicated that the file should not be physically opened and a file method was invoked in the XrdOucCacheIO2 passed to Attach(). When this occurs, the file is actually opened and Update() called to replace the original XrdOucCacheIO2 object with one that uses the newly opened file.

Parameters
iocpreference to the new XrdOucCacheIO2 object.

Reimplemented in XrdFileCache::IO.

virtual void XrdOucCacheIO2::Write ( XrdOucCacheIOCB iocb,
char *  buff,
long long  offs,
int  wlen 
)
inlinevirtual

Reimplemented in XrdPosixFile, and XrdPosixPrepIO.

References XrdOucCacheIOCB::Done().


The documentation for this class was generated from the following file: