engines/vendor_defns/cswift.h

   1 /*
   2  * Attribution notice: Rainbow have generously allowed me to reproduce the
   3  * necessary definitions here from their API. This means the support can
   4  * build independently of whether application builders have the API or
   5  * hardware. This will allow developers to easily produce software that has
   6  * latent hardware support for any users that have accelertors installed,
   7  * without the developers themselves needing anything extra. I have only
   8  * clipped the parts from the CryptoSwift header files that are (or seem)
   9  * relevant to the CryptoSwift support code. This is simply to keep the file
  10  * sizes reasonable. [Geoff]
  11  */
  12
  13 /*
  14  * NB: These type widths do *not* seem right in general, in particular
  15  * they're not terribly friendly to 64-bit architectures (unsigned long) will
  16  * be 64-bit on IA-64 for a start. I'm leaving these alone as they agree with
  17  * Rainbow's API and this will only be called into question on platforms with
  18  * Rainbow support anyway! ;-)
  19  */
  20
  21 #ifdef __cplusplus
  22 extern "C" {
  23 #endif                          /* __cplusplus */
  24
  25     typedef long SW_STATUS;     /* status */
  26     typedef unsigned char SW_BYTE; /* 8 bit byte */
  27     typedef unsigned short SW_U16; /* 16 bit number */
  28 #if defined(_IRIX)
  29 # include <sgidefs.h>
  30     typedef __uint32_t SW_U32;
  31 #else
  32     typedef unsigned long SW_U32; /* 32 bit integer */
  33 #endif
  34
  35 #if defined(OPENSSL_SYS_WIN32)
  36     typedef struct _SW_U64 {
  37         SW_U32 low32;
  38         SW_U32 high32;
  39     } SW_U64;                   /* 64 bit integer */
  40 #elif defined(OPENSSL_SYS_MACINTOSH_CLASSIC)
  41     typedef longlong SW_U64
  42 #else                           /* Unix variants */
  43     typedef struct _SW_U64 {
  44         SW_U32 low32;
  45         SW_U32 high32;
  46     } SW_U64;                   /* 64 bit integer */
  47 #endif
  48
  49 /* status codes */
  50 #define SW_OK                 (0L)
  51 #define SW_ERR_BASE           (-10000L)
  52 #define SW_ERR_NO_CARD        (SW_ERR_BASE-1) /* The Card is not present */
  53 #define SW_ERR_CARD_NOT_READY (SW_ERR_BASE-2) /* The card has not powered */
  54     /*    up yet                 */
  55 #define SW_ERR_TIME_OUT       (SW_ERR_BASE-3) /* Execution of a command */
  56     /*    time out               */
  57 #define SW_ERR_NO_EXECUTE     (SW_ERR_BASE-4) /* The Card failed to */
  58     /*    execute the command    */
  59 #define SW_ERR_INPUT_NULL_PTR (SW_ERR_BASE-5) /* a required pointer is */
  60     /*    NULL                   */
  61 #define SW_ERR_INPUT_SIZE     (SW_ERR_BASE-6) /* size is invalid, too */
  62     /*    small, too large.      */
  63 #define SW_ERR_INVALID_HANDLE (SW_ERR_BASE-7) /* Invalid SW_ACC_CONTEXT */
  64     /*    handle                 */
  65 #define SW_ERR_PENDING        (SW_ERR_BASE-8) /* A request is already out- */
  66     /*    standing at this       */
  67     /*    context handle         */
  68 #define SW_ERR_AVAILABLE      (SW_ERR_BASE-9) /* A result is available.  */
  69 #define SW_ERR_NO_PENDING     (SW_ERR_BASE-10) /* No request is pending.  */
  70 #define SW_ERR_NO_MEMORY      (SW_ERR_BASE-11) /* Not enough memory */
  71 #define SW_ERR_BAD_ALGORITHM  (SW_ERR_BASE-12) /* Invalid algorithm type */
  72     /*    in SW_PARAM structure  */
  73 #define SW_ERR_MISSING_KEY    (SW_ERR_BASE-13) /* No key is associated with */
  74     /*    context.               */
  75     /*    swAttachKeyParam() is  */
  76     /*    not called.            */
  77 #define SW_ERR_KEY_CMD_MISMATCH \
  78                               (SW_ERR_BASE-14) /* Cannot perform requested */
  79     /*    SW_COMMAND_CODE since  */
  80     /*    key attached via       */
  81     /*    swAttachKeyParam()     */
  82     /*    cannot be used for this */
  83     /*    SW_COMMAND_CODE.       */
  84 #define SW_ERR_NOT_IMPLEMENTED \
  85                               (SW_ERR_BASE-15) /* Not implemented */
  86 #define SW_ERR_BAD_COMMAND    (SW_ERR_BASE-16) /* Bad command code */
  87 #define SW_ERR_BAD_ITEM_SIZE  (SW_ERR_BASE-17) /* too small or too large in */
  88     /*    the "initems" or       */
  89     /*    "outitems".            */
  90 #define SW_ERR_BAD_ACCNUM     (SW_ERR_BASE-18) /* Bad accelerator number */
  91 #define SW_ERR_SELFTEST_FAIL  (SW_ERR_BASE-19) /* At least one of the self */
  92     /*    test fail, look at the */
  93     /*    selfTestBitmap in      */
  94     /*    SW_ACCELERATOR_INFO for */
  95     /*    details.               */
  96 #define SW_ERR_MISALIGN       (SW_ERR_BASE-20) /* Certain alogrithms require */
  97     /*    key materials aligned  */
  98     /*    in certain order, e.g. */
  99     /*    128 bit for CRT        */
 100 #define SW_ERR_OUTPUT_NULL_PTR \
 101                               (SW_ERR_BASE-21) /* a required pointer is */
 102     /*    NULL                   */
 103 #define SW_ERR_OUTPUT_SIZE \
 104                               (SW_ERR_BASE-22) /* size is invalid, too */
 105     /*    small, too large.      */
 106 #define SW_ERR_FIRMWARE_CHECKSUM \
 107                               (SW_ERR_BASE-23) /* firmware checksum mismatch */
 108     /*    download failed.       */
 109 #define SW_ERR_UNKNOWN_FIRMWARE \
 110                               (SW_ERR_BASE-24) /* unknown firmware error */
 111 #define SW_ERR_INTERRUPT      (SW_ERR_BASE-25) /* request is abort when */
 112     /*    it's waiting to be     */
 113     /*    completed.             */
 114 #define SW_ERR_NVWRITE_FAIL   (SW_ERR_BASE-26) /* error in writing to Non- */
 115     /*    volatile memory        */
 116 #define SW_ERR_NVWRITE_RANGE  (SW_ERR_BASE-27) /* out of range error in */
 117     /*    writing to NV memory   */
 118 #define SW_ERR_RNG_ERROR      (SW_ERR_BASE-28) /* Random Number Generation */
 119     /*    failure                */
 120 #define SW_ERR_DSS_FAILURE    (SW_ERR_BASE-29) /* DSS Sign or Verify failure */
 121 #define SW_ERR_MODEXP_FAILURE (SW_ERR_BASE-30) /* Failure in various math */
 122     /*    calculations           */
 123 #define SW_ERR_ONBOARD_MEMORY (SW_ERR_BASE-31) /* Error in accessing on - */
 124     /*    board memory           */
 125 #define SW_ERR_FIRMWARE_VERSION \
 126                               (SW_ERR_BASE-32) /* Wrong version in firmware */
 127     /*    update                 */
 128 #define SW_ERR_ZERO_WORKING_ACCELERATOR \
 129                               (SW_ERR_BASE-44) /* All accelerators are bad */
 130
 131     /* algorithm type */
 132 #define SW_ALG_CRT          1
 133 #define SW_ALG_EXP          2
 134 #define SW_ALG_DSA          3
 135 #define SW_ALG_NVDATA       4
 136
 137     /* command code */
 138 #define SW_CMD_MODEXP_CRT   1   /* perform Modular Exponentiation using */
 139     /*  Chinese Remainder Theorem (CRT)      */
 140 #define SW_CMD_MODEXP       2   /* perform Modular Exponentiation */
 141 #define SW_CMD_DSS_SIGN     3   /* perform DSS sign */
 142 #define SW_CMD_DSS_VERIFY   4   /* perform DSS verify */
 143 #define SW_CMD_RAND         5   /* perform random number generation */
 144 #define SW_CMD_NVREAD       6   /* perform read to nonvolatile RAM */
 145 #define SW_CMD_NVWRITE      7   /* perform write to nonvolatile RAM */
 146
 147     typedef SW_U32 SW_ALGTYPE;  /* alogrithm type */
 148     typedef SW_U32 SW_STATE;    /* state */
 149     typedef SW_U32 SW_COMMAND_CODE; /* command code */
 150     typedef SW_U32 SW_COMMAND_BITMAP[4]; /* bitmap */
 151
 152     typedef struct _SW_LARGENUMBER {
 153         SW_U32 nbytes;          /* number of bytes in the buffer "value" */
 154         SW_BYTE *value;         /* the large integer as a string of */
 155         /*   bytes in network (big endian) order  */
 156     } SW_LARGENUMBER;
 157
 158 #if defined(OPENSSL_SYS_WIN32)
 159 # include <windows.h>
 160     typedef HANDLE SW_OSHANDLE; /* handle to kernel object */
 161 # define SW_OS_INVALID_HANDLE  INVALID_HANDLE_VALUE
 162 # define SW_CALLCONV _stdcall
 163 #elif defined(OPENSSL_SYS_MACINTOSH_CLASSIC)
 164     /* async callback mechanisms */
 165     /* swiftCallbackLevel */
 166 # define SW_MAC_CALLBACK_LEVEL_NO         0
 167 # define SW_MAC_CALLBACK_LEVEL_HARDWARE   1/* from the hardware ISR */
 168 # define SW_MAC_CALLBACK_LEVEL_SECONDARY  2/* as secondary ISR */
 169     typedef int SW_MAC_CALLBACK_LEVEL;
 170     typedef int SW_OSHANDLE;
 171 # define SW_OS_INVALID_HANDLE  (-1)
 172 # define SW_CALLCONV
 173 #else                           /* Unix variants */
 174     typedef int SW_OSHANDLE;    /* handle to driver */
 175 # define SW_OS_INVALID_HANDLE  (-1)
 176 # define SW_CALLCONV
 177 #endif
 178
 179     typedef struct _SW_CRT {
 180         SW_LARGENUMBER p;       /* prime number p */
 181         SW_LARGENUMBER q;       /* prime number q */
 182         SW_LARGENUMBER dmp1;    /* exponent1 */
 183         SW_LARGENUMBER dmq1;    /* exponent2 */
 184         SW_LARGENUMBER iqmp;    /* CRT coefficient */
 185     } SW_CRT;
 186
 187     typedef struct _SW_EXP {
 188         SW_LARGENUMBER modulus; /* modulus */
 189         SW_LARGENUMBER exponent; /* exponent */
 190     } SW_EXP;
 191
 192     typedef struct _SW_DSA {
 193         SW_LARGENUMBER p;       /* */
 194         SW_LARGENUMBER q;       /* */
 195         SW_LARGENUMBER g;       /* */
 196         SW_LARGENUMBER key;     /* private/public key */
 197     } SW_DSA;
 198
 199     typedef struct _SW_NVDATA {
 200         SW_U32 accnum;          /* accelerator board number */
 201         SW_U32 offset;          /* offset in byte */
 202     } SW_NVDATA;
 203
 204     typedef struct _SW_PARAM {
 205         SW_ALGTYPE type;        /* type of the alogrithm */
 206         union {
 207             SW_CRT crt;
 208             SW_EXP exp;
 209             SW_DSA dsa;
 210             SW_NVDATA nvdata;
 211         } up;
 212     } SW_PARAM;
 213
 214     typedef SW_U32 SW_CONTEXT_HANDLE; /* opaque context handle */
 215
 216     /*
 217      * Now the OpenSSL bits, these function types are the for the function
 218      * pointers that will bound into the Rainbow shared libraries.
 219      */
 220     typedef SW_STATUS SW_CALLCONV t_swAcquireAccContext(SW_CONTEXT_HANDLE
 221                                                         *hac);
 222     typedef SW_STATUS SW_CALLCONV t_swAttachKeyParam(SW_CONTEXT_HANDLE hac,
 223                                                      SW_PARAM *key_params);
 224     typedef SW_STATUS SW_CALLCONV t_swSimpleRequest(SW_CONTEXT_HANDLE hac,
 225                                                     SW_COMMAND_CODE cmd,
 226                                                     SW_LARGENUMBER pin[],
 227                                                     SW_U32 pin_count,
 228                                                     SW_LARGENUMBER pout[],
 229                                                     SW_U32 pout_count);
 230     typedef SW_STATUS SW_CALLCONV t_swReleaseAccContext(SW_CONTEXT_HANDLE
 231                                                         hac);
 232
 233 #ifdef __cplusplus
 234 }
 235 #endif                          /* __cplusplus */