xrootd
|
#include <XrdCksLoad.hh>
Classes | |
struct | csInfo |
Public Member Functions | |
virtual int | Calc (const char *Pfn, XrdCksData &Cks, int doSet=1) |
virtual int | Config (const char *Token, char *Line) |
virtual int | Del (const char *Pfn, XrdCksData &Cks) |
virtual int | Get (const char *Pfn, XrdCksData &Cks) |
virtual int | Init (const char *ConfigFN, const char *AddCalc=0) |
virtual char * | List (const char *Pfn, char *Buff, int Blen, char Sep=' ') |
virtual const char * | Name (int seqNum=0) |
virtual XrdCksCalc * | Object (const char *name) |
virtual int | Size (const char *Name=0) |
virtual int | Set (const char *Pfn, XrdCksData &Cks, int myTime=0) |
virtual int | Ver (const char *Pfn, XrdCksData &Cks) |
XrdCksLoader (XrdSysError *erP, int iosz, XrdVersionInfo *vInfo) | |
virtual | ~XrdCksLoader () |
XrdCksCalc * | Load (const char *csName, const char *csParms=0, char *eBuff=0, int eBlen=0, bool orig=false) |
XrdCksLoader (XrdVersionInfo &vInfo, const char *libPath=0) | |
~XrdCksLoader () | |
Destructor. More... | |
![]() | |
virtual int | Calc (const char *Xfn, XrdCksData &Cks, XrdCksPCB *pcbP, int doSet=1) |
virtual int | Ver (const char *Xfn, XrdCksData &Cks, XrdCksPCB *pcbP) |
XrdCks (XrdSysError *erP) | |
Constructor. More... | |
virtual | ~XrdCks () |
Destructor. More... | |
Protected Member Functions | |
virtual int | Calc (const char *Pfn, time_t &MTime, XrdCksCalc *CksObj) |
virtual int | ModTime (const char *Pfn, time_t &MTime) |
Private Member Functions | |
int | Config (const char *cFN, csInfo &Info) |
csInfo * | Find (const char *Name) |
csInfo * | Find (const char *Name) |
Private Attributes | |
csInfo | csTab [csMax] |
int | csLast |
int | segSize |
XrdVersionInfo * | myVersion |
char * | verMsg |
XrdVersionInfo * | urVersion |
char * | ldPath |
Static Private Attributes | |
static const int | csMax = 4 |
Additional Inherited Members | |
![]() | |
XrdSysError * | eDest |
This class defines the checksum loader interface. It is intended to be used by xrootd clients to obtain an instance of a checksum calculation object. This object may be builtin or may come from a shared library.
XrdCksLoader::XrdCksLoader | ( | XrdSysError * | erP, |
int | iosz, | ||
XrdVersionInfo * | vInfo | ||
) |
|
virtual |
XrdCksLoader::XrdCksLoader | ( | XrdVersionInfo & | vInfo, |
const char * | libPath = 0 |
||
) |
Constructor
vInfo | Is the reference to the version information corresponding to the xrootd version you compiled with. You define this information using the XrdVERSIONINFODEF macro defined in XrdVersion.hh. You must supply your version information and it must be compatible with the loader and any shared libraries that it might load on your behalf. |
libPath | The path where dynamic checksum calculators are to be found and dynamically loaded, if need be. If libPath is nil then the default loader search order is used. The name of the shared library must follow the naming convention "libXrdCksCalc<csName>.so" where <csName> is the checksum name. So, an sha256 checksum would try to load libXrdCksCalcsha256.so shared library. |
XrdCksLoader::~XrdCksLoader | ( | ) |
Destructor.
|
virtual |
Calculate a new checksum for a physical file using the checksum algorithm named in the Cks parameter.
Xfn | The logical or physical name of the file to be checksumed. |
Cks | For input, it specifies the checksum algorithm to be used. For output, the checksum value is returned upon success. |
doSet | When true, the new value must replace any existing value in the Xfn's extended file attributes. |
pcbP | In the second form, the pointer to the callback object. A nil pointer does not invoke any callback. |
Implements XrdCks.
|
protectedvirtual |
|
virtual |
Parse a configuration directives specific to the checksum manager.
Token | Points to the directive that triggered the call. |
Line | All the characters after the directive. |
Implements XrdCks.
|
private |
|
virtual |
Delete the checksum from the Xfn's xattrs.
Xfn | The logical or physical name of the file to be checksumed. |
Cks | Specifies the checksum type to delete. |
Implements XrdCks.
|
private |
|
private |
|
virtual |
Retreive the checksum from the Xfn's xattrs and return it and indicate whether or not it is stale (i.e. the file modification has changed or the name and length are not the expected values).
Xfn | The logical or physical name of the file to be checksumed. |
Cks | For input, it specifies the checksum type to return. For output, the checksum value is returned upon success. |
Implements XrdCks.
|
virtual |
Fully initialize the manager which includes loading any plugins.
ConfigFN | Points to the configuration file path. |
DfltCalc | Is the default checksum and should be defaulted if NULL. The default implementation defaults this to adler32. A default is only needed should the checksum name in the XrdCksData object be omitted. |
Implements XrdCks.
|
virtual |
List names of the checksums associated with a Xfn or all supported ones.
Xfn | The logical or physical file name whose checksum names are to be returned. When Xfn is null, return all supported checksum algorithm names. |
Buff | Points to a buffer, at least 64 bytes in length, to hold a "Sep" separated list of checksum names. |
Blen | The length of the buffer. |
Sep | The separation character to be used between adjacent names. |
Implements XrdCks.
XrdCksCalc* XrdCksLoader::Load | ( | const char * | csName, |
const char * | csParms = 0 , |
||
char * | eBuff = 0 , |
||
int | eBlen = 0 , |
||
bool | orig = false |
||
) |
Get a new XrdCksCalc object that can calculate the checksum corresponding to the specified name. The object can be used to compute checksums on the fly. The object's Recycle() method must be used to delete it. The adler32, crc32, and md5 checksums are natively supported. Up to five more checksum algorithms can be loaded from shared libraries.
csNme | The name of the checksum algorithm (e.g. md5). |
csParms | Any parameters that might be needed by the checksum algorithm should it be loaded from a shared library. |
eBuff | Optional pointer to a buffer to receive the reason for a load failure as a null terminated string. |
eBlen | The length of the buffer. |
orig | Returns the original object not a new instance of it. This is usually used by CksManager during an autoload. |
|
protectedvirtual |
|
virtual |
Get the name of the checksums associated with a sequence number. Note that Name() may be called prior to final config to see if there are any chksums to configure and avoid unintended errors.
seqNum | The sequence number. Zero signifies the default name. Higher numbers are alternates. |
Implements XrdCks.
|
virtual |
Get a new XrdCksCalc object that can calculate the checksum corresponding to the specified name or the default object if name is a null pointer. The object can be used to compute checksums on the fly. The object's Recycle() method must be used to delete it.
name | The name of the checksum algorithm. If null, use the default one. |
Reimplemented from XrdCks.
|
virtual |
Set a file's checksum in the extended attributes along with the file's mtime and the time of setting.
Xfn | The logical or physical name of the file to be set. |
Cks | Specifies the checksum name and value. |
myTime | When true then the fmTime and gmTime in the Cks structure are to be used; as opposed to the current time. |
Implements XrdCks.
|
virtual |
Get the binary length of the checksum with the corresponding name.
Name | The checksum algorithm name. If null, use the default name. |
Implements XrdCks.
|
virtual |
Retreive the checksum from the Xfn's xattrs and compare it to the supplied checksum. If the checksum is not available or is stale, a new checksum is calculated and written to the extended attributes.
Xfn | The logical or physical name of the file to be verified. |
Cks | Specifies the checksum name and value. |
pcbP | In the second form, the pointer to the callback object. A nil pointer does not invoke any callback. |
Implements XrdCks.
|
private |
|
staticprivate |
|
private |
|
private |
|
private |
|
private |
|
private |
|
private |