pgphashpriv.h

PGP8.0源码 请认真阅读您的文件包然后写出其具体功能

/*____________________________________________________________________________
        Copyright (C) 2002 PGP Corporation
        All rights reserved.

        $Id: pgpHashPriv.h,v 1.9 2002/10/22 03:13:21 ajivsov Exp $
____________________________________________________________________________*/
#ifndef Included_pgpHashingPriv_h	/* [ */
#define Included_pgpHashingPriv_h

#include "pgpBase.h"
#include "pgpOpaqueStructs.h"
#include "pgpMemoryMgr.h"
#include "pgpHash.h"


PGP_BEGIN_C_DECLARATIONS

enum PGPPrivHashAlgorithm_
{
	kPGPHashAlgorithm_MD2		= 5,
	kPGPHashAlgorithm_Checksum16 = 0x101,
	/*	kPGPHashAlgorithm_SHADouble	= 100, */

	PGP_ENUM_FORCE( PGPPrivHashAlgorithm_ )
};
PGPENUM_TYPEDEF( PGPPrivHashAlgorithm_, PGPPrivHashAlgorithm );


/*____________________________________________________________________________
	A static description of a hash; analagous to a C++ virtual function tbl.
____________________________________________________________________________*/
struct PGPHashVTBL
{
	char const *		name;
	PGPHashAlgorithm	algorithm;
	void const *		DERprefix;		/* DER-encoded prefix */
	PGPSize				DERprefixsize;	/* DER-encoded prefix length */
	PGPSize				hashsize;		/* Bytes of output */
	PGPSize				blocksize;		/* Bytes of input, message block size */
	PGPSize				context_size;
	PGPSize				context_align;
	
	void			(*init)( void *priv );
	void			(*update)( void *priv, void const *buf, PGPSize len );
	void const *	(*final)( void *priv );
};



PGPHashVTBL const  *	pgpHashGetVTBL( const PGPHashContext * );


/* Create and Destroy a big bunch of hashes at once. */
PGPError 			pgpHashListCreate( PGPMemoryMgrRef memoryMgr,
						void const *buf,
						PGPHashListRef *outList, PGPUInt32 numHashes );
PGPHashContextRef	pgpHashListGetIndHash( PGPHashListRef list,
						PGPUInt32 algIndex );
void 				pgpHashListDestroy( PGPHashListRef hashes );
PGPUInt32 			pgpHashListGetSize( PGPHashListRef hashes );

/* Find the context of a given type in the list */
PGPHashContextRef	pgpHashListFind(  PGPHashListRef hashList,
							PGPHashVTBL const *vtbl);


/*____________________________________________________________________________
	The following are glue routines for compatibility with existing source.
	Use is discouraged in favor of official routines.
____________________________________________________________________________*/

void const *		pgpHashFinal( PGPHashContextRef ref );

/* Allocate, deallocate, and copy a hash context */
PGPHashContextRef	pgpHashCreate( PGPMemoryMgrRef memoryMgr,
						PGPHashVTBL const *vtbl);
	
PGPHashContextRef	pgpHashCopy( const PGPHashContext *hc);
void 				pgpHashCopyData( PGPHashContextRef src,
						PGPHashContext *dest );

/* Return a hash struction of the appropriate number */
PGPHashVTBL const  *	pgpHashByNumber( PGPHashAlgorithm type );
PGPHashVTBL const  *	pgpHashByName( char const *name, PGPSize namelen );
PGPHashVTBL const  *	pgpHashByNumberWithMask( PGPHashAlgorithm type, PGPUInt32 algorithmMask );
PGPHashVTBL const  *	pgpHashByNameWithMask( char const *name, PGPSize namelen, PGPUInt32 algorithmMask );

PGPError			pgpGetHashMessageSize( PGPHashContextRef ref, PGPSize *msgBlockSize );

PGP_END_C_DECLARATIONS

#endif /* ] Included_pgpHashingPriv_h */


/*__Editor_settings____

	Local Variables:
	tab-width: 4
	End:
	vi: ts=4 sw=4
	vim: si
_____________________*/