/*
 * 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));