aboutsummaryrefslogtreecommitdiffstats
path: root/engines/vendor_defns/aep.h
blob: 04ab87eb9cb15799382394c692d291053eadc873 (plain) (blame)
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
/*
 * This header declares the necessary definitions for using the
 * exponentiation acceleration capabilities, and rnd number generation of the
 * AEP card.
 */

/*
 *
 * Some AEP defines
 *
 */

/*
 * Successful return value
 */
#define AEP_R_OK                                0x00000000

/*
 * Miscelleanous unsuccessful return value
 */
#define AEP_R_GENERAL_ERROR                     0x10000001

/*
 * Insufficient host memory
 */
#define AEP_R_HOST_MEMORY                       0x10000002

#define AEP_R_FUNCTION_FAILED                   0x10000006

/*
 * Invalid arguments in function call
 */
#define AEP_R_ARGUMENTS_BAD                     0x10020000

#define AEP_R_NO_TARGET_RESOURCES                               0x10030000

/*
 * Error occuring on socket operation
 */
#define AEP_R_SOCKERROR                                                 0x10000010

/*
 * Socket has been closed from the other end
 */
#define AEP_R_SOCKEOF                                                   0x10000011

/*
 * Invalid handles
 */
#define AEP_R_CONNECTION_HANDLE_INVALID         0x100000B3

#define AEP_R_TRANSACTION_HANDLE_INVALID                0x10040000

/*
 * Transaction has not yet returned from accelerator
 */
#define AEP_R_TRANSACTION_NOT_READY                             0x00010000

/*
 * There is already a thread waiting on this transaction
 */
#define AEP_R_TRANSACTION_CLAIMED                               0x10050000

/*
 * The transaction timed out
 */
#define AEP_R_TIMED_OUT                                                 0x10060000

#define AEP_R_FXN_NOT_IMPLEMENTED                               0x10070000

#define AEP_R_TARGET_ERROR                                              0x10080000

/*
 * Error in the AEP daemon process
 */
#define AEP_R_DAEMON_ERROR                                              0x10090000

/*
 * Invalid ctx id
 */
#define AEP_R_INVALID_CTX_ID                                    0x10009000

#define AEP_R_NO_KEY_MANAGER                                    0x1000a000

/*
 * Error obtaining a mutex
 */
#define AEP_R_MUTEX_BAD                         0x000001A0

/*
 * Fxn call before AEP_Initialise ot after AEP_Finialise
 */
#define AEP_R_AEPAPI_NOT_INITIALIZED                    0x10000190

/*
 * AEP_Initialise has already been called
 */
#define AEP_R_AEPAPI_ALREADY_INITIALIZED                0x10000191

/*
 * Maximum number of connections to daemon reached
 */
#define AEP_R_NO_MORE_CONNECTION_HNDLS                  0x10000200

/*
 *
 * Some AEP Type definitions
 *
 */

/* an unsigned 8-bit value */
typedef unsigned char AEP_U8;

/* an unsigned 8-bit character */
typedef char AEP_CHAR;

/* a BYTE-sized Boolean flag */
typedef AEP_U8 AEP_BBOOL;

/*
 * Unsigned value, at least 16 bits long
 */
typedef unsigned short AEP_U16;

/* an unsigned value, at least 32 bits long */
#ifdef SIXTY_FOUR_BIT_LONG
typedef unsigned int AEP_U32;
#else
typedef unsigned long AEP_U32;
#endif

#ifdef SIXTY_FOUR_BIT_LONG
typedef unsigned long AEP_U64;
#else
typedef struct {
    unsigned long l1, l2;
} AEP_U64;
#endif

/* at least 32 bits; each bit is a Boolean flag */
typedef AEP_U32 AEP_FLAGS;

typedef AEP_U8 *AEP_U8_PTR;
typedef AEP_CHAR *AEP_CHAR_PTR;
typedef AEP_U32 *AEP_U32_PTR;
typedef AEP_U64 *AEP_U64_PTR;
typedef void *AEP_VOID_PTR;

/* Pointer to a AEP_VOID_PTR-- i.e., pointer to pointer to void */
typedef AEP_VOID_PTR *AEP_VOID_PTR_PTR;

/*
 * Used to identify an AEP connection handle
 */
typedef AEP_U32 AEP_CONNECTION_HNDL;

/*
 * Pointer to an AEP connection handle
 */
typedef AEP_CONNECTION_HNDL *AEP_CONNECTION_HNDL_PTR;

/*
 * Used by an application (in conjunction with the apps process id) to
 * identify an individual transaction
 */
typedef AEP_U32 AEP_TRANSACTION_ID;

/*
 * Pointer to an applications transaction identifier
 */
typedef AEP_TRANSACTION_ID *AEP_TRANSACTION_ID_PTR;

/*
 * Return value type
 */
typedef AEP_U32 AEP_RV;

#define MAX_PROCESS_CONNECTIONS 256

#define RAND_BLK_SIZE 1024

typedef enum {
    NotConnected = 0,
    Connected = 1,
    InUse = 2
} AEP_CONNECTION_STATE;

typedef struct AEP_CONNECTION_ENTRY {
    AEP_CONNECTION_STATE conn_state;
    AEP_CONNECTION_HNDL conn_hndl;
} AEP_CONNECTION_ENTRY;

typedef AEP_RV t_AEP_OpenConnection(AEP_CONNECTION_HNDL_PTR phConnection);
typedef AEP_RV t_AEP_CloseConnection(AEP_CONNECTION_HNDL hConnection);

typedef AEP_RV t_AEP_ModExp(AEP_CONNECTION_HNDL hConnection,
                            AEP_VOID_PTR pA, AEP_VOID_PTR pP,
                            AEP_VOID_PTR pN,
                            AEP_VOID_PTR pResult,
                            AEP_TRANSACTION_ID *pidTransID);

typedef AEP_RV t_AEP_ModExpCrt(AEP_CONNECTION_HNDL hConnection,
                               AEP_VOID_PTR pA, AEP_VOID_PTR pP,
                               AEP_VOID_PTR pQ,
                               AEP_VOID_PTR pDmp1, AEP_VOID_PTR pDmq1,
                               AEP_VOID_PTR pIqmp,
                               AEP_VOID_PTR pResult,
                               AEP_TRANSACTION_ID *pidTransID);

#ifdef AEPRAND
typedef AEP_RV t_AEP_GenRandom(AEP_CONNECTION_HNDL hConnection,
                               AEP_U32 Len,
                               AEP_U32 Type,
                               AEP_VOID_PTR pResult,
                               AEP_TRANSACTION_ID *pidTransID);
#endif

typedef AEP_RV t_AEP_Initialize(AEP_VOID_PTR pInitArgs);
typedef AEP_RV t_AEP_Finalize(void);
typedef AEP_RV t_AEP_SetBNCallBacks(AEP_RV (*GetBigNumSizeFunc)
                                     (AEP_VOID_PTR ArbBigNum,
                                      AEP_U32 *BigNumSize),
                                    AEP_RV (*MakeAEPBigNumFunc) (AEP_VOID_PTR
                                                                 ArbBigNum,
                                                                 AEP_U32
                                                                 BigNumSize,
                                                                 unsigned char
                                                                 *AEP_BigNum),
                                    AEP_RV (*ConverAEPBigNumFunc) (void
                                                                   *ArbBigNum,
                                                                   AEP_U32
                                                                   BigNumSize,
                                                                   unsigned
                                                                   char
                                                                   *AEP_BigNum));