#include <XrdOssHandler.hh>

Inheritance diagram for XrdOssDFHandler:

[legend]

Collaboration diagram for XrdOssDFHandler:

[legend]

Public Member Functions
virtual int	Opendir (const char *dir_path, XrdOucEnv &Env)

virtual int	Readdir (char *buff, int blen)

virtual int	StatRet (struct stat *buff)

virtual int	Fchmod (mode_t Mode)

virtual void	Flush ()
	Flush filesystem cached pages for this file (used for checksums).

virtual int	Fstat (struct stat *buff)

virtual int	Fsync ()

virtual int	Fsync (XrdSfsAio *aiop)

virtual int	Ftruncate (unsigned long long flen)

virtual int	getFD ()

virtual off_t	getMmap (void **addr)

virtual int	isCompressed (char *cxidp=0)

virtual int	Open (const char *path, int Oflag, mode_t Mode, XrdOucEnv &Env)

virtual ssize_t	pgRead (void buffer, off_t offset, size_t rdlen, uint32_t csvec, uint64_t opts)

virtual int	pgRead (XrdSfsAio *aioparm, uint64_t opts)

virtual ssize_t	pgWrite (void buffer, off_t offset, size_t wrlen, uint32_t csvec, uint64_t opts)

virtual int	pgWrite (XrdSfsAio *aioparm, uint64_t opts)

virtual ssize_t	Read (off_t offset, size_t blen)

virtual ssize_t	Read (void *buff, off_t offset, size_t blen)

virtual int	Read (XrdSfsAio *aiop)

virtual ssize_t	ReadRaw (void *buff, off_t offset, size_t blen)

virtual ssize_t	ReadV (XrdOucIOVec *readV, int n)

virtual ssize_t	Write (const void *buff, off_t offset, size_t blen)

virtual int	Write (XrdSfsAio *aiop)

virtual ssize_t	WriteV (XrdOucIOVec *writeV, int n)

virtual int	Close (long long *retsz=0)

virtual int	Fctl (int cmd, int alen, const char args, char *resp=0)

virtual const char *	getTID ()

	XrdOssDFHandler (XrdOssDF *successor)

virtual	~XrdOssDFHandler ()

Public Member Functions inherited from XrdOssDF
uint16_t	DFType ()

	XrdOssDF (const char *tid="", uint16_t dftype=0, int fdnum=-1)

virtual	~XrdOssDF ()

Protected Attributes
XrdOssDF *	successor_

Protected Attributes inherited from XrdOssDF
const char *	tident

off_t	pgwEOF

int	fd

uint16_t	dfType

short	rsvd

Additional Inherited Members
Static Public Attributes inherited from XrdOssDF
static const uint64_t	Verify = 0x8000000000000000ULL
	all: Verify checksums

static const uint64_t	doCalc = 0x4000000000000000ULL
	pgw: Calculate checksums

static const uint16_t	DF_isDir = 0x0001
	Object is for a directory.

static const uint16_t	DF_isFile = 0x0002
	Object is for a file.

static const uint16_t	DF_isProxy = 0x0010
	Object is a proxy object.

static const int	Fctl_ckpObj = 0

static const int	Fctl_utimes = 1

Constructor & Destructor Documentation

◆ XrdOssDFHandler()

XrdOssDFHandler::XrdOssDFHandler ( XrdOssDF * successor )

inline

◆ ~XrdOssDFHandler()

virtual XrdOssDFHandler::~XrdOssDFHandler ( )

inlinevirtual

References successor_.

Member Function Documentation

◆ Close()

virtual int XrdOssDFHandler::Close ( long long * retsz = 0 )

inlinevirtual

Close a directory or file.

Parameters

retsz If not nil, where the size of the file is to be returned.

Returns: 0 upon success or -errno or -osserr (see XrdOssError.hh).

Implements XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::Close(), and successor_.

◆ Fchmod()

virtual int XrdOssDFHandler::Fchmod ( mode_t mode )

inlinevirtual

Change file mode settings.

Parameters

mode	- The new file mode setting.

Returns: 0 upon success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

References XrdOssDF::Fchmod(), and successor_.

◆ Fctl()

virtual int XrdOssDFHandler::Fctl	(	int	cmd,
		int	alen,
		const char *	args,
		char **	resp = `0`
	)

inlinevirtual

Reimplemented from XrdOssDF.

References XrdOssDF::Fctl(), and successor_.

◆ Flush()

virtual void XrdOssDFHandler::Flush ( )

inlinevirtual

Flush filesystem cached pages for this file (used for checksums).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::Flush(), and successor_.

◆ Fstat()

virtual int XrdOssDFHandler::Fstat ( struct stat * buf )

inlinevirtual

Return state information for this file.

Parameters

buf	- Pointer to the structure where info it to be returned.

Returns: 0 upon success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::Fstat(), and successor_.

◆ Fsync() [1/2]

virtual int XrdOssDFHandler::Fsync ( void )

inlinevirtual

Synchronize associated file with media (synchronous).

Returns: 0 upon success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::Fsync(), and successor_.

◆ Fsync() [2/2]

virtual int XrdOssDFHandler::Fsync ( XrdSfsAio * aiop )

inlinevirtual

Synchronize associated file with media (asynchronous).

Parameters

aiop	- Pointer to async I/O request object.

Returns: 0 upon success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::Fsync(), and successor_.

◆ Ftruncate()

virtual int XrdOssDFHandler::Ftruncate ( unsigned long long flen )

inlinevirtual

Set the size of the associated file.

Parameters

flen	- The new size of the file.

Returns: 0 upon success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::Ftruncate(), and successor_.

◆ getFD()

virtual int XrdOssDFHandler::getFD ( )

inlinevirtual

Return the underlying file descriptor.

Returns: -1 if there is no file descriptor or a non-negative FD number.

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::getFD(), and successor_.

◆ getMmap()

virtual off_t XrdOssDFHandler::getMmap ( void ** addr )

inlinevirtual

Return the memory mapped characteristics of the file.

Parameters

addr	- Pointer to where the memory mapped address is to be returned.

Returns: If mapped, the size of the file is returned and it memory location is placed in addr. Otherwise, addr is set to zero and zero is returned. Note that zero length files cannot be memory mapped.

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::getMmap(), and successor_.

◆ getTID()

virtual const char * XrdOssDFHandler::getTID ( )

inlinevirtual

Return trace identifier associated with this object.

Returns: Pointer to trace identifier

Reimplemented from XrdOssDF.

References XrdOssDF::getTID(), and successor_.

◆ isCompressed()

virtual int XrdOssDFHandler::isCompressed ( char * cxidp = 0 )

inlinevirtual

Return file compression charectistics.

Parameters

cxidp - Pointer to where the compression algorithm name returned.

Returns: If the file is compressed, the region size if returned. Otherwise, zero is returned (file not compressed).

Reimplemented from XrdOssDF.

References XrdOssDF::isCompressed(), and successor_.

◆ Open()

virtual int XrdOssDFHandler::Open	(	const char *	path,
		int	Oflag,
		mode_t	Mode,
		XrdOucEnv &	env
	)

inlinevirtual

Open a file.

Parameters

path	- Pointer to the path of the file to be opened.
Oflag	- Standard open flags.
Mode	- File open mode (ignored unless creating a file).
env	- Reference to environmental information.

Returns: 0 upon success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::Open(), and successor_.

◆ Opendir()

virtual int XrdOssDFHandler::Opendir	(	const char *	path,
		XrdOucEnv &	env
	)

inlinevirtual

Open a directory.

Parameters

path	- Pointer to the path of the directory to be opened.
env	- Reference to environmental information.

Returns: 0 upon success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiDir.

References XrdOssDF::Opendir(), and successor_.

◆ pgRead() [1/2]

virtual ssize_t XrdOssDFHandler::pgRead	(	void *	buffer,
		off_t	offset,
		size_t	rdlen,
		uint32_t *	csvec,
		uint64_t	opts
	)

inlinevirtual

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::pgRead(), and successor_.

◆ pgRead() [2/2]

virtual int XrdOssDFHandler::pgRead	(	XrdSfsAio *	aioparm,
		uint64_t	opts
	)

inlinevirtual

Read file pages and checksums using asynchronous I/O.

Parameters

aioparm	- Pointer to async I/O object controlling the I/O.
opts	- Processing options (see above).

Returns: 0 upon if request started success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::pgRead(), and successor_.

◆ pgWrite() [1/2]

virtual ssize_t XrdOssDFHandler::pgWrite	(	void *	buffer,
		off_t	offset,
		size_t	wrlen,
		uint32_t *	csvec,
		uint64_t	opts
	)

inlinevirtual

Write file pages into a file with corresponding checksums.

Parameters

buffer	- pointer to buffer containing the bytes to write.
offset	- The offset where the write is to start.
wrlen	- The number of bytes to write.
csvec	- A vector which contains the corresponding CRC32 checksum for each page. See XrdOucPgrwUtils::csNum() for sizing.
opts	- Processing options (see above).

Returns: >= 0 The number of bytes written upon success. or -errno or -osserr upon failure. (see XrdOssError.hh).; < 0 -errno or -osserr upon failure. (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::pgWrite(), and successor_.

◆ pgWrite() [2/2]

virtual int XrdOssDFHandler::pgWrite	(	XrdSfsAio *	aioparm,
		uint64_t	opts
	)

inlinevirtual

Write file pages and checksums using asynchronous I/O.

Parameters

aioparm	- Pointer to async I/O object controlling the I/O.
opts	- Processing options (see above).

Returns: 0 upon if request started success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::pgWrite(), and successor_.

◆ Read() [1/3]

virtual ssize_t XrdOssDFHandler::Read	(	off_t	offset,
		size_t	size
	)

inlinevirtual

Preread file blocks into the file system cache.

Parameters

offset	- The offset where the read is to start.
size	- The number of bytes to pre-read.

Returns: 0 upon success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::Read(), and successor_.

◆ Read() [2/3]

virtual ssize_t XrdOssDFHandler::Read	(	void *	buffer,
		off_t	offset,
		size_t	size
	)

inlinevirtual

Read file bytes into a buffer.

Parameters

buffer	- pointer to buffer where the bytes are to be placed.
offset	- The offset where the read is to start.
size	- The number of bytes to read.

Returns: >= 0 The number of bytes that placed in buffer.; < 0 -errno or -osserr upon failure (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::Read(), and successor_.

◆ Read() [3/3]

virtual int XrdOssDFHandler::Read ( XrdSfsAio * aiop )

inlinevirtual

Read file bytes using asynchronous I/O.

Parameters

aiop	- Pointer to async I/O object controlling the I/O.

Returns: 0 upon if request started success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::Read(), and successor_.

◆ Readdir()

virtual int XrdOssDFHandler::Readdir	(	char *	buff,
		int	blen
	)

inlinevirtual

Get the next directory entry.

Parameters

buff	- Pointer to buffer where a null terminated string of the entry name is to be returned. If no more entries exist, a null string is returned.
blen	- Length of the buffer.

Returns: 0 upon success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiDir.

References XrdOssDF::Readdir(), and successor_.

◆ ReadRaw()

virtual ssize_t XrdOssDFHandler::ReadRaw	(	void *	buffer,
		off_t	offset,
		size_t	size
	)

inlinevirtual

Read uncompressed file bytes into a buffer.

Parameters

buffer	- pointer to buffer where the bytes are to be placed.
offset	- The offset where the read is to start.
size	- The number of bytes to read.

Returns: >= 0 The number of bytes that placed in buffer.; < 0 -errno or -osserr upon failure (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::ReadRaw(), and successor_.

◆ ReadV()

virtual ssize_t XrdOssDFHandler::ReadV	(	XrdOucIOVec *	readV,
		int	rdvcnt
	)

inlinevirtual

Read file bytes as directed by the read vector.

Parameters

readV	pointer to the array of read requests.
rdvcnt	the number of elements in readV.

Returns: >=0 The numbe of bytes read.; < 0 -errno or -osserr upon failure (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References XrdOssDF::ReadV(), and successor_.

◆ StatRet()

virtual int XrdOssDFHandler::StatRet ( struct stat * buff )

inlinevirtual

Set the stat() buffer where stat information is to be placed corresponding to the directory entry returned by Readdir().

Parameters

buff	- Pointer to stat structure to be used.

Returns: 0 upon success or -ENOTSUP if not supported.

Note: This is a one-time call as stat structure is reused for each Readdir.; When StatRet() is in effect, directory entries that have been deleted from the target directory are quietly skipped.

Reimplemented from XrdOssDF.

References XrdOssDF::StatRet(), and successor_.

◆ Write() [1/2]

virtual ssize_t XrdOssDFHandler::Write	(	const void *	buffer,
		off_t	offset,
		size_t	size
	)

inlinevirtual

Write file bytes from a buffer.

Parameters

buffer	- pointer to buffer where the bytes reside.
offset	- The offset where the write is to start.
size	- The number of bytes to write.

Returns: >= 0 The number of bytes that were written.; < 0 -errno or -osserr upon failure (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References successor_, and XrdOssDF::Write().

◆ Write() [2/2]

virtual int XrdOssDFHandler::Write ( XrdSfsAio * aiop )

inlinevirtual

Write file bytes using asynchronous I/O.

Parameters

aiop	- Pointer to async I/O object controlling the I/O.

Returns: 0 upon if request started success or -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References successor_, and XrdOssDF::Write().

◆ WriteV()

virtual ssize_t XrdOssDFHandler::WriteV	(	XrdOucIOVec *	writeV,
		int	wrvcnt
	)

inlinevirtual

Write file bytes as directed by the write vector.

Parameters

writeV	pointer to the array of write requests.
wrvcnt	the number of elements in writeV.

Returns: >=0 The numbe of bytes read.; < 0 -errno or -osserr upon failure (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Reimplemented in XrdOssCsiFile.

References successor_, and XrdOssDF::WriteV().

Member Data Documentation

◆ successor_

XrdOssDF* XrdOssDFHandler::successor_

protected

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

XrdOssHandler.hh

Public Member Functions

Protected Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ XrdOssDFHandler()

◆ ~XrdOssDFHandler()

Member Function Documentation

◆ Close()

◆ Fchmod()

◆ Fctl()

◆ Flush()

◆ Fstat()

◆ Fsync() [1/2]

◆ Fsync() [2/2]

◆ Ftruncate()

◆ getFD()

◆ getMmap()

◆ getTID()

◆ isCompressed()

◆ Open()

◆ Opendir()

◆ pgRead() [1/2]

◆ pgRead() [2/2]

◆ pgWrite() [1/2]

◆ pgWrite() [2/2]

◆ Read() [1/3]

◆ Read() [2/3]

◆ Read() [3/3]

◆ Readdir()

◆ ReadRaw()

◆ ReadV()

◆ StatRet()

◆ Write() [1/2]

◆ Write() [2/2]

◆ WriteV()

Member Data Documentation

◆ successor_