summaryrefslogtreecommitdiff
path: root/plugins/CryptoPP/PGPw/sdk8/include/pgpShare.h
blob: 04d6da569c6ef6f9cf862f8b4a99a6d8d6d47ed7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
/*____________________________________________________________________________
	Copyright (C) 2002 PGP Corporation
	All rights reserved.

	$Id: pgpShare.h,v 1.1 2004/04/01 11:45:40 wprice Exp $
____________________________________________________________________________*/
#ifndef Included_pgpShare_h	/* [ */
#define Included_pgpShare_h

#include "pgpConfig.h"
#include "pgpBase.h"
#include "pgpKeys.h"

typedef struct PGPShare *	PGPShareRef;

typedef struct PGPShareID_
{
	PGPByte 	data[8];
} PGPShareID;

#define	kInvalidPGPShareRef			((PGPShareRef) NULL)
#define PGPShareRefIsValid( ref )	( (ref) != kInvalidPGPShareRef )

PGP_BEGIN_C_DECLARATIONS
#if PRAGMA_IMPORT_SUPPORTED
#pragma import on
#endif

PGPError PGPCreateShares(PGPContextRef context, PGPKeyDBObjRef key, 
				PGPUInt32 threshold, PGPUInt32 numShares, 
				PGPShareRef *share);

/* The passkey needs to be freed with PGPFreeData(passkey) */
PGPError PGPGetPasskeyFromShares(PGPShareRef share, PGPByte **passkey,
				PGPSize *passkeySize);

PGPError PGPSplitShares(PGPShareRef share, PGPUInt32 numShares, 
				PGPShareRef *splitShares);

/* The share objects being combined are NOT freed by this function */
PGPError PGPCombineShares(PGPShareRef firstShare, PGPShareRef secondShare,
				PGPShareRef *combinedShares);

PGPError PGPFreeShares(PGPShareRef share);

PGPError PGPGetKeyIDFromShares(PGPShareRef share, PGPKeyID *id);

PGPError PGPGetShareID(PGPShareRef share, PGPShareID *id);

PGPUInt32 PGPGetShareThreshold(PGPShareRef share);

/* This is the number of shares contained in the share object */
PGPUInt32 PGPGetNumberOfShares(PGPShareRef share);

/* The share object may contain less than the total number of shares */
PGPUInt32 PGPGetTotalNumberOfShares(PGPShareRef share);

PGPBoolean IsSamePGPShares(PGPShareRef firstShare, PGPShareRef secondShare);

/* If firstID < secondID, -1 */
/* If firstID > secondID,  1 */
/* If firstID = secondID,  0 */
PGPInt32 PGPCompareShareIDs(PGPShareID firstID, PGPShareID secondID);

#if PRAGMA_IMPORT_SUPPORTED
#pragma import reset
#endif
PGP_END_C_DECLARATIONS

#endif /* ] Included_pgpShare_h */


/*__Editor_settings____

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