#include <XrdOssMirageFile.hh>

Inheritance diagram for XrdOssMirageFile:

Collaboration diagram for XrdOssMirageFile:

Public Member Functions
	XrdOssMirageFile (XrdOssMirage &oss)

virtual	~XrdOssMirageFile ()=default

virtual int	Close (long long *retsz=0) override

virtual int	Fchmod (mode_t mode) override

virtual int	Fstat (struct stat *buf) override

virtual int	Fsync () override

virtual int	Fsync (XrdSfsAio *aiop) override

virtual int	Ftruncate (unsigned long long flen) override

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

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

virtual int	pgRead (XrdSfsAio *aioparm, uint64_t opts) override

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

virtual int	pgWrite (XrdSfsAio *aioparm, uint64_t opts) override

virtual ssize_t	Read (off_t offset, size_t size) override

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

virtual int	Read (XrdSfsAio *aiop) override

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

virtual int	StatRet (struct stat *buff) override

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

virtual int	Write (XrdSfsAio *aiop) override

Public Member Functions inherited from XrdOssDF
	XrdOssDF (const char *tid="", uint16_t dftype=0, int fdnum=-1)

virtual	~XrdOssDF ()

virtual int	Clone (const std::vector< XrdOucCloneSeg > &cVec)

virtual int	Clone (XrdOssDF &srcFile)

uint16_t	DFType ()

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

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

virtual bool	getErrMsg (std::string &eText)

virtual int	getFD ()

virtual off_t	getMmap (void **addr)

virtual const char *	getTID ()

virtual int	isCompressed (char *cxidp=0)

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

virtual ssize_t	Read (XrdOucRangeList &rlist)

virtual int	Readdir (char *buff, int blen)

virtual ssize_t	ReadV (XrdOucIOVec *readV, int rdvcnt)

virtual ssize_t	WriteV (XrdOucIOVec *writeV, int wrvcnt)

Additional Inherited Members
Static Public Attributes inherited from XrdOssDF
static const uint16_t	DF_isDir = 0x0001
	Object is for a directory. More...

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

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

static const uint64_t	doCalc = 0x4000000000000000ULL
	pgw: Calculate checksums More...

static const int	Fctl_ckpObj = 0

static const int	Fctl_QFinfo = 3

static const int	Fctl_setFD = 2

static const int	Fctl_utimes = 1

static const uint64_t	Verify = 0x8000000000000000ULL
	all: Verify checksums More...

Protected Attributes inherited from XrdOssDF
uint16_t	dfType

int	fd

off_t	pgwEOF

short	rsvd

const char *	tident

Detailed Description

Definition at line 10 of file XrdOssMirageFile.hh.

Constructor & Destructor Documentation

◆ XrdOssMirageFile()

XrdOssMirageFile::XrdOssMirageFile ( XrdOssMirage & oss )

Definition at line 11 of file XrdOssMirageFile.cc.

                                                     :
     oss(oss),
     entry(&std::get<XrdOssMirageEntry>(entry_storage))
 {
 }

◆ ~XrdOssMirageFile()

virtual XrdOssMirageFile::~XrdOssMirageFile ( )

virtualdefault

Member Function Documentation

◆ Close()

int XrdOssMirageFile::Close ( long long * retsz = 0 )

overridevirtual

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.

Definition at line 148 of file XrdOssMirageFile.cc.

 {
     if (std::holds_alternative<XrdOssMirageEntryPtr>(entry_storage))
         std::get<XrdOssMirageEntryPtr>(entry_storage).reset();
     return XrdOssOK;
 }

References XrdOssOK.

◆ Fchmod()

int XrdOssMirageFile::Fchmod ( mode_t mode )

overridevirtual

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.

Definition at line 22 of file XrdOssMirageFile.cc.

 {
     return -ENOTSUP;
 }

◆ Fstat()

int XrdOssMirageFile::Fstat ( struct stat * buf )

overridevirtual

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.

Definition at line 27 of file XrdOssMirageFile.cc.

 {
     *buf = {};
     buf->st_size = entry->size;
     return XrdOssOK;
 }

References XrdOssMirageEntry::size, and XrdOssOK.

◆ Fsync() [1/2]

int XrdOssMirageFile::Fsync ( void )

overridevirtual

Synchronize associated file with media (synchronous).

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

Reimplemented from XrdOssDF.

Definition at line 34 of file XrdOssMirageFile.cc.

 {
     return XrdOssOK;
 }

References XrdOssOK.

◆ Fsync() [2/2]

int XrdOssMirageFile::Fsync ( XrdSfsAio * aiop )

overridevirtual

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.

Definition at line 39 of file XrdOssMirageFile.cc.

 {
     return -ENOTSUP;
 }

◆ Ftruncate()

int XrdOssMirageFile::Ftruncate ( unsigned long long flen )

overridevirtual

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.

Definition at line 44 of file XrdOssMirageFile.cc.

 {
     entry->size = flen;
     return XrdOssOK;
 }

References XrdOssMirageEntry::size, and XrdOssOK.

◆ Open()

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

overridevirtual

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.

Definition at line 50 of file XrdOssMirageFile.cc.

 {
     if ((Oflag & O_ACCMODE) == O_RDONLY)
     {
         const auto opt = oss.get_entry_read(path);
         if (!opt.has_value())
             return -ENOENT;
  
         entry_storage = opt.value();
         entry = &std::get<XrdOssMirageEntry>(entry_storage);
     }
     else
     {
         const auto opt = oss.get_entry_write(path);
         if (!opt.has_value())
             return -ENOENT;
  
         entry_storage = opt.value();
         entry = &*std::get<XrdOssMirageEntryPtr>(entry_storage);
     }
  
     if (entry->open.return_code != XrdOssOK)
         return -entry->open.return_code;
  
     return XrdOssOK;
 }

References XrdOssMirage::get_entry_read(), XrdOssMirage::get_entry_write(), XrdOssMirageEntry::open, and XrdOssOK.

Here is the call graph for this function:

◆ pgRead() [1/2]

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

overridevirtual

Reimplemented from XrdOssDF.

Definition at line 77 of file XrdOssMirageFile.cc.

 {
     return -ENOTSUP;
 }

◆ pgRead() [2/2]

int XrdOssMirageFile::pgRead	(	XrdSfsAio *	aioparm,
		uint64_t	opts
	)

overridevirtual

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.

Definition at line 82 of file XrdOssMirageFile.cc.

 {
     return -ENOTSUP;
 }

◆ pgWrite() [1/2]

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

overridevirtual

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.

Definition at line 87 of file XrdOssMirageFile.cc.

 {
     return -ENOTSUP;
 }

◆ pgWrite() [2/2]

int XrdOssMirageFile::pgWrite	(	XrdSfsAio *	aioparm,
		uint64_t	opts
	)

overridevirtual

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.

Definition at line 92 of file XrdOssMirageFile.cc.

 {
     return -ENOTSUP;
 }

◆ Read() [1/3]

ssize_t XrdOssMirageFile::Read	(	off_t	offset,
		size_t	size
	)

overridevirtual

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 When 0, the request was ignored; otherwise, it has been accepted.; < 0 Failed with -errno or -osserr (see XrdOssError.hh).

Reimplemented from XrdOssDF.

Definition at line 97 of file XrdOssMirageFile.cc.

 {
     return XrdOssOK;
 }

References XrdOssOK.

Referenced by ReadRaw().

Here is the caller graph for this function:

◆ Read() [2/3]

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

overridevirtual

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.

Definition at line 102 of file XrdOssMirageFile.cc.

 {
     if (entry->read.return_code != XrdOssOK && 
         entry->read.return_position >= static_cast<std::size_t>(offset) && 
         entry->read.return_position <= static_cast<std::size_t>(offset + size))
         return -entry->read.return_code;
  
     const std::size_t num_bytes = std::min(size, static_cast<std::size_t>(entry->size - offset));
  
     if (entry->pattern.size() == 1)
         std::fill_n(static_cast<char *>(buffer), num_bytes, entry->pattern.front());
  
     if (entry->pattern.size() > 1)
         std::generate_n(static_cast<char *>(buffer), num_bytes, [i = offset % entry->pattern.size(), this] () mutable {
             return entry->pattern[i++ % entry->pattern.size()]; 
         });
  
     return num_bytes;
 }

References XrdOssMirageEntry::pattern, XrdOssMirageEntry::read, XrdOssMirageEntry::size, and XrdOssOK.

◆ Read() [3/3]

int XrdOssMirageFile::Read ( XrdSfsAio * aiop )

overridevirtual

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.

Definition at line 122 of file XrdOssMirageFile.cc.

 {
     return -ENOTSUP;
 }

◆ ReadRaw()

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

overridevirtual

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.

Definition at line 127 of file XrdOssMirageFile.cc.

 {
     return Read(buffer, offset, size);
 }

References Read().

Here is the call graph for this function:

◆ StatRet()

int XrdOssMirageFile::StatRet ( struct stat * buff )

overridevirtual

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.

Definition at line 17 of file XrdOssMirageFile.cc.

 {
     return -ENOTDIR;
 }

◆ Write() [1/2]

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

overridevirtual

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.

Definition at line 132 of file XrdOssMirageFile.cc.

 {
     if (entry->write.return_code != XrdOssOK && 
         entry->write.return_position >= static_cast<std::size_t>(offset) && 
         entry->write.return_position <= static_cast<std::size_t>(offset + size))
         return -entry->write.return_code;
  
     entry->size += size;
     return size;
 }

References XrdOssMirageEntry::size, XrdOssMirageEntry::write, and XrdOssOK.

◆ Write() [2/2]

int XrdOssMirageFile::Write ( XrdSfsAio * aiop )

overridevirtual

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.

Definition at line 143 of file XrdOssMirageFile.cc.

 {
     return -ENOTSUP;
 }

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

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ XrdOssMirageFile()

◆ ~XrdOssMirageFile()

Member Function Documentation

◆ Close()

◆ Fchmod()

◆ Fstat()

◆ Fsync() [1/2]

◆ Fsync() [2/2]

◆ Ftruncate()

◆ Open()

◆ pgRead() [1/2]

◆ pgRead() [2/2]

◆ pgWrite() [1/2]

◆ pgWrite() [2/2]

◆ Read() [1/3]

◆ Read() [2/3]

◆ Read() [3/3]

◆ ReadRaw()

◆ StatRet()

◆ Write() [1/2]

◆ Write() [2/2]