#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).
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.
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 uint64_t	doCalc = 0x4000000000000000ULL
	pgw: Calculate checksums
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
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

References Mode, opts, and stat.

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 stat, 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 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 Mode, and XrdOssOK.

◆ 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;
}

References opts.

◆ 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;
}

References opts.

◆ 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;
}

References opts.

◆ 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;
}

References opts.

◆ 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 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;
}

References stat.

◆ 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 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:

	XRootD

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]