This code implements the MD5 message-digest algorithm.

The algorithm is due to Ron Rivest. This code was written by Colin Plumb in 1993, no copyright is claimed. This code is in the public domain; do with it what you wish.

Equivalent code is available from RSA Data Security, Inc. This code has been tested against that, and is equivalent, except that you don't need to include two pages of legalese with every copy.

To compute the message digest of a chunk of bytes, create an TMD5 object, call Update() as needed on buffers full of bytes, and then call Final(), which will, optionally, fill a supplied 16-byte array with the digest.

Definition at line 44 of file TMD5.h.

Public Member Functions
	TMD5 ()
	Create TMD5 object. More...

	TMD5 (const TMD5 &md5)
	MD5 copy ctor. More...

	TMD5 (const UChar_t *digest)
	Create finalized TMD5 object containing passed in 16 byte digest. More...

virtual	~TMD5 ()

const char *	AsString () const
	Return message digest as string. More...

void	Final ()
	MD5 finalization, ends an MD5 message-digest operation, writing the the message digest and zeroizing the context. More...

void	Final (UChar_t digest[16])
	MD5 finalization, ends an MD5 message-digest operation, writing the the message digest and zeroizing the context. More...

TMD5 &	operator= (const TMD5 &rhs)
	MD5 assignment operator. More...

void	Print () const
	Print digest in ascii hex form. More...

Int_t	SetDigest (const char *md5ascii)
	Set the digest from the ASCII representation 'md5ascii'. More...

void	Update (const UChar_t *buf, UInt_t len)
	Update TMD5 object to reflect the concatenation of another buffer full of bytes. More...

Static Public Member Functions
static TMD5 *	FileChecksum (const char *file)
	Returns checksum of specified file. More...

static Int_t	FileChecksum (const char *file, UChar_t digest[16])
	Returns checksum of specified file in digest argument. More...

static TMD5 *	ReadChecksum (const char *file)
	Returns checksum stored in ASCII in specified file. More...

static Int_t	WriteChecksum (const char file, const TMD5 md5)
	Writes checksum in ASCII format to specified file. More...

Private Member Functions
void	Decode (UInt_t out, const UChar_t in, UInt_t len)
	Decodes input into output. Assumes len is a multiple of 4. More...

void	Encode (UChar_t out, const UInt_t in, UInt_t len)
	Encodes input into output. Assumes len is a multiple of 4. More...

void	Transform (UInt_t buf[4], const UChar_t in[64])
	The core of the MD5 algorithm, this alters an existing MD5 hash to reflect the addition of 16 longwords of new data. More...

Private Attributes
UInt_t	fBits [2]
	temp buffer More...

UInt_t	fBuf [4]

UChar_t	fDigest [16]
	string representation of digest More...

Bool_t	fFinalized

UChar_t	fIn [64]
	temp buffer More...

Char_t	fString [33]
	temp buffer More...

Friends
Bool_t	operator== (const TMD5 &m1, const TMD5 &m2)
	Compare two message digests for equality. More...

#include <TMD5.h>

Constructor & Destructor Documentation

◆ TMD5() [1/3]

TMD5::TMD5 ( )

Create TMD5 object.

Set bit count to 0 and buffer to mysterious initialization constants.

Definition at line 48 of file TMD5.cxx.

◆ TMD5() [2/3]

TMD5::TMD5 ( const UChar_t * digest )

Create finalized TMD5 object containing passed in 16 byte digest.

Definition at line 60 of file TMD5.cxx.

◆ TMD5() [3/3]

TMD5::TMD5 ( const TMD5 & md5 )

MD5 copy ctor.

Special copy ctor avoids copying unnecessary temp arrays when finalized.

Definition at line 75 of file TMD5.cxx.

◆ ~TMD5()

virtual TMD5::~TMD5 ( )

inlinevirtual

Definition at line 64 of file TMD5.h.

Member Function Documentation

◆ AsString()

const char * TMD5::AsString ( ) const

Return message digest as string.

Returns "" in case Final() has not yet been called.

Definition at line 220 of file TMD5.cxx.

◆ Decode()

void TMD5::Decode	(	UInt_t *	out,
		const UChar_t *	in,
		UInt_t	len
	)

private

Decodes input into output. Assumes len is a multiple of 4.

Definition at line 255 of file TMD5.cxx.

◆ Encode()

void TMD5::Encode	(	UChar_t *	out,
		const UInt_t *	in,
		UInt_t	len
	)

private

Encodes input into output. Assumes len is a multiple of 4.

Definition at line 240 of file TMD5.cxx.

◆ FileChecksum() [1/2]

TMD5 * TMD5::FileChecksum ( const char * file )

static

Returns checksum of specified file.

The returned TMD5 object must be deleted by the user. Returns 0 in case the file does not exists or in case of error. This function preserves the modtime of the file so it can be safely used in conjunction with methods that keep track of the file's modtime. Static utility function.

Definition at line 474 of file TMD5.cxx.

◆ FileChecksum() [2/2]

Int_t TMD5::FileChecksum	(	const char *	file,
		UChar_t	digest[16]
	)

static

Returns checksum of specified file in digest argument.

Returns -1 in case of error, 0 otherwise. This method preserves the modtime of the file so it can be safely used in conjunction with methods that keep track of the file's modtime. Static utility function.

Definition at line 538 of file TMD5.cxx.

◆ Final() [1/2]

void TMD5::Final ( )

MD5 finalization, ends an MD5 message-digest operation, writing the the message digest and zeroizing the context.

Definition at line 167 of file TMD5.cxx.

◆ Final() [2/2]

void TMD5::Final ( UChar_t digest[16] )

MD5 finalization, ends an MD5 message-digest operation, writing the the message digest and zeroizing the context.

Returns digest.

Definition at line 157 of file TMD5.cxx.

◆ operator=()

TMD5 & TMD5::operator= ( const TMD5 & rhs )

MD5 assignment operator.

Special assignment operator avoids copying unnecessary temp arrays when finalized.

Definition at line 90 of file TMD5.cxx.

◆ Print()

void TMD5::Print ( ) const

Print digest in ascii hex form.

Definition at line 206 of file TMD5.cxx.

◆ ReadChecksum()

TMD5 * TMD5::ReadChecksum ( const char * file )

static

Returns checksum stored in ASCII in specified file.

Use to read files created via WriteChecksum(). The returned TMD5 object must be deleted by the user. Returns 0 in case the file cannot be opened or in case of error. Static utility function.

Definition at line 422 of file TMD5.cxx.

◆ SetDigest()

Int_t TMD5::SetDigest ( const char * md5ascii )

Set the digest from the ASCII representation 'md5ascii'.

The caller is responsible to make sure that the 32 chars md5ascii are valid. Returns -1 if md5ascii is malformed, returns 0 otherwise.

Definition at line 395 of file TMD5.cxx.

◆ Transform()

void TMD5::Transform	(	UInt_t	buf[4],
		const UChar_t	in[64]
	)

private

The core of the MD5 algorithm, this alters an existing MD5 hash to reflect the addition of 16 longwords of new data.

Update() blocks the data and converts bytes into longwords for this routine.

Definition at line 281 of file TMD5.cxx.

◆ Update()

void TMD5::Update	(	const UChar_t *	buf,
		UInt_t	len
	)

Update TMD5 object to reflect the concatenation of another buffer full of bytes.

Definition at line 108 of file TMD5.cxx.

◆ WriteChecksum()

Int_t TMD5::WriteChecksum	(	const char *	file,
		const TMD5 *	md5
	)

static

Writes checksum in ASCII format to specified file.

This file can directly be read by ReadChecksum(). The md5 must have been finalized. Returns -1 in case file cannot be opened or in case of error, 0 otherwise. Static utility function.

Definition at line 452 of file TMD5.cxx.

Friends And Related Function Documentation

◆ operator==

Bool_t operator==	(	const TMD5 &	m1,
		const TMD5 &	m2
	)

friend

Compare two message digests for equality.

Definition at line 372 of file TMD5.cxx.

Member Data Documentation

◆ fBits

UInt_t TMD5::fBits[2]

private

temp buffer

Definition at line 50 of file TMD5.h.

◆ fBuf

UInt_t TMD5::fBuf[4]

private

Definition at line 49 of file TMD5.h.

◆ fDigest

UChar_t TMD5::fDigest[16]

private

string representation of digest

Definition at line 53 of file TMD5.h.

◆ fFinalized

Bool_t TMD5::fFinalized

private

Definition at line 54 of file TMD5.h.

◆ fIn

UChar_t TMD5::fIn[64]

private

temp buffer

Definition at line 51 of file TMD5.h.

◆ fString

Char_t TMD5::fString[33]

mutableprivate

temp buffer

Definition at line 52 of file TMD5.h.

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

core/base/inc/TMD5.h
core/base/src/TMD5.cxx

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Friends

Constructor & Destructor Documentation

◆ TMD5() [1/3]

◆ TMD5() [2/3]

◆ TMD5() [3/3]

◆ ~TMD5()

Member Function Documentation

◆ AsString()

◆ Decode()

◆ Encode()

◆ FileChecksum() [1/2]

◆ FileChecksum() [2/2]

◆ Final() [1/2]

◆ Final() [2/2]

◆ operator=()

◆ Print()

◆ ReadChecksum()

◆ SetDigest()

◆ Transform()

◆ Update()

◆ WriteChecksum()

Friends And Related Function Documentation

◆ operator==

Member Data Documentation

◆ fBits

◆ fBuf

◆ fDigest

◆ fFinalized

◆ fIn

◆ fString