sureware.h
上传用户:yisoukefu
上传日期:2020-08-09
资源大小:39506k
文件大小:9k
- /*
- * Written by Corinne Dive-Reclus(cdive@baltimore.com)
- *
- * Copyright@2001 Baltimore Technologies Ltd.
- * *
- * THIS FILE IS PROVIDED BY BALTIMORE TECHNOLOGIES ``AS IS'' AND *
- * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE *
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE *
- * ARE DISCLAIMED. IN NO EVENT SHALL BALTIMORE TECHNOLOGIES BE LIABLE *
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL *
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS *
- * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) *
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT *
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY *
- * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF *
- * SUCH DAMAGE. *
- *
- *
- */
- #ifdef WIN32
- #define SW_EXPORT __declspec ( dllexport )
- #else
- #define SW_EXPORT
- #endif
- /*
- * List of exposed SureWare errors
- */
- #define SUREWAREHOOK_ERROR_FAILED -1
- #define SUREWAREHOOK_ERROR_FALLBACK -2
- #define SUREWAREHOOK_ERROR_UNIT_FAILURE -3
- #define SUREWAREHOOK_ERROR_DATA_SIZE -4
- #define SUREWAREHOOK_ERROR_INVALID_PAD -5
- /*
- * -----------------WARNING-----------------------------------
- * In all the following functions:
- * msg is a string with at least 24 bytes free.
- * A 24 bytes string will be concatenated to the existing content of msg.
- */
- /*
- * SureWare Initialisation function
- * in param threadsafe, if !=0, thread safe enabled
- * return SureWareHOOK_ERROR_UNIT_FAILURE if failure, 1 if success
- */
- typedef int SureWareHook_Init_t(char*const msg,int threadsafe);
- extern SW_EXPORT SureWareHook_Init_t SureWareHook_Init;
- /*
- * SureWare Finish function
- */
- typedef void SureWareHook_Finish_t(void);
- extern SW_EXPORT SureWareHook_Finish_t SureWareHook_Finish;
- /*
- * PRE_CONDITION:
- * DO NOT CALL ANY OF THE FOLLOWING FUNCTIONS IN CASE OF INIT FAILURE
- */
- /*
- * SureWare RAND Bytes function
- * In case of failure, the content of buf is unpredictable.
- * return 1 if success
- * SureWareHOOK_ERROR_FALLBACK if function not available in hardware
- * SureWareHOOK_ERROR_FAILED if error while processing
- * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure
- * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf
- *
- * in/out param buf : a num bytes long buffer where random bytes will be put
- * in param num : the number of bytes into buf
- */
- typedef int SureWareHook_Rand_Bytes_t(char*const msg,unsigned char *buf, int num);
- extern SW_EXPORT SureWareHook_Rand_Bytes_t SureWareHook_Rand_Bytes;
- /*
- * SureWare RAND Seed function
- * Adds some seed to the Hardware Random Number Generator
- * return 1 if success
- * SureWareHOOK_ERROR_FALLBACK if function not available in hardware
- * SureWareHOOK_ERROR_FAILED if error while processing
- * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure
- * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf
- *
- * in param buf : the seed to add into the HRNG
- * in param num : the number of bytes into buf
- */
- typedef int SureWareHook_Rand_Seed_t(char*const msg,const void *buf, int num);
- extern SW_EXPORT SureWareHook_Rand_Seed_t SureWareHook_Rand_Seed;
- /*
- * SureWare Load Private Key function
- * return 1 if success
- * SureWareHOOK_ERROR_FAILED if error while processing
- * No hardware is contact for this function.
- *
- * in param key_id :the name of the private protected key file without the extension
- ".sws"
- * out param hptr : a pointer to a buffer allocated by SureWare_Hook
- * out param num: the effective key length in bytes
- * out param keytype: 1 if RSA 2 if DSA
- */
- typedef int SureWareHook_Load_Privkey_t(char*const msg,const char *key_id,char **hptr,unsigned long *num,char *keytype);
- extern SW_EXPORT SureWareHook_Load_Privkey_t SureWareHook_Load_Privkey;
- /*
- * SureWare Info Public Key function
- * return 1 if success
- * SureWareHOOK_ERROR_FAILED if error while processing
- * No hardware is contact for this function.
- *
- * in param key_id :the name of the private protected key file without the extension
- ".swp"
- * out param hptr : a pointer to a buffer allocated by SureWare_Hook
- * out param num: the effective key length in bytes
- * out param keytype: 1 if RSA 2 if DSA
- */
- typedef int SureWareHook_Info_Pubkey_t(char*const msg,const char *key_id,unsigned long *num,
- char *keytype);
- extern SW_EXPORT SureWareHook_Info_Pubkey_t SureWareHook_Info_Pubkey;
- /*
- * SureWare Load Public Key function
- * return 1 if success
- * SureWareHOOK_ERROR_FAILED if error while processing
- * No hardware is contact for this function.
- *
- * in param key_id :the name of the public protected key file without the extension
- ".swp"
- * in param num : the bytes size of n and e
- * out param n: where to write modulus in bn format
- * out param e: where to write exponent in bn format
- */
- typedef int SureWareHook_Load_Rsa_Pubkey_t(char*const msg,const char *key_id,unsigned long num,
- unsigned long *n, unsigned long *e);
- extern SW_EXPORT SureWareHook_Load_Rsa_Pubkey_t SureWareHook_Load_Rsa_Pubkey;
- /*
- * SureWare Load DSA Public Key function
- * return 1 if success
- * SureWareHOOK_ERROR_FAILED if error while processing
- * No hardware is contact for this function.
- *
- * in param key_id :the name of the public protected key file without the extension
- ".swp"
- * in param num : the bytes size of n and e
- * out param pub: where to write pub key in bn format
- * out param p: where to write prime in bn format
- * out param q: where to write sunprime (length 20 bytes) in bn format
- * out param g: where to write base in bn format
- */
- typedef int SureWareHook_Load_Dsa_Pubkey_t(char*const msg,const char *key_id,unsigned long num,
- unsigned long *pub, unsigned long *p,unsigned long*q,
- unsigned long *g);
- extern SW_EXPORT SureWareHook_Load_Dsa_Pubkey_t SureWareHook_Load_Dsa_Pubkey;
- /*
- * SureWare Free function
- * Destroy the key into the hardware if destroy==1
- */
- typedef void SureWareHook_Free_t(char *p,int destroy);
- extern SW_EXPORT SureWareHook_Free_t SureWareHook_Free;
- #define SUREWARE_PKCS1_PAD 1
- #define SUREWARE_ISO9796_PAD 2
- #define SUREWARE_NO_PAD 0
- /*
- * SureWare RSA Private Decryption
- * return 1 if success
- * SureWareHOOK_ERROR_FAILED if error while processing
- * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure
- * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf
- *
- * in param flen : byte size of from and to
- * in param from : encrypted data buffer, should be a not-null valid pointer
- * out param tlen: byte size of decrypted data, if error, unexpected value
- * out param to : decrypted data buffer, should be a not-null valid pointer
- * in param prsa: a protected key pointer, should be a not-null valid pointer
- * int padding: padding id as follow
- * SUREWARE_PKCS1_PAD
- * SUREWARE_NO_PAD
- *
- */
- typedef int SureWareHook_Rsa_Priv_Dec_t(char*const msg,int flen,unsigned char *from,
- int *tlen,unsigned char *to,
- char *prsa,int padding);
- extern SW_EXPORT SureWareHook_Rsa_Priv_Dec_t SureWareHook_Rsa_Priv_Dec;
- /*
- * SureWare RSA Signature
- * return 1 if success
- * SureWareHOOK_ERROR_FAILED if error while processing
- * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure
- * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf
- *
- * in param flen : byte size of from and to
- * in param from : encrypted data buffer, should be a not-null valid pointer
- * out param tlen: byte size of decrypted data, if error, unexpected value
- * out param to : decrypted data buffer, should be a not-null valid pointer
- * in param prsa: a protected key pointer, should be a not-null valid pointer
- * int padding: padding id as follow
- * SUREWARE_PKCS1_PAD
- * SUREWARE_ISO9796_PAD
- *
- */
- typedef int SureWareHook_Rsa_Sign_t(char*const msg,int flen,unsigned char *from,
- int *tlen,unsigned char *to,
- char *prsa,int padding);
- extern SW_EXPORT SureWareHook_Rsa_Sign_t SureWareHook_Rsa_Sign;
- /*
- * SureWare DSA Signature
- * return 1 if success
- * SureWareHOOK_ERROR_FAILED if error while processing
- * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure
- * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf
- *
- * in param flen : byte size of from and to
- * in param from : encrypted data buffer, should be a not-null valid pointer
- * out param to : decrypted data buffer, should be a 40bytes valid pointer
- * in param pdsa: a protected key pointer, should be a not-null valid pointer
- *
- */
- typedef int SureWareHook_Dsa_Sign_t(char*const msg,int flen,const unsigned char *from,
- unsigned long *r,unsigned long *s,char *pdsa);
- extern SW_EXPORT SureWareHook_Dsa_Sign_t SureWareHook_Dsa_Sign;
- /*
- * SureWare Mod Exp
- * return 1 if success
- * SureWareHOOK_ERROR_FAILED if error while processing
- * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure
- * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf
- *
- * mod and res are mlen bytes long.
- * exp is elen bytes long
- * data is dlen bytes long
- * mlen,elen and dlen are all multiple of sizeof(unsigned long)
- */
- typedef int SureWareHook_Mod_Exp_t(char*const msg,int mlen,const unsigned long *mod,
- int elen,const unsigned long *exponent,
- int dlen,unsigned long *data,
- unsigned long *res);
- extern SW_EXPORT SureWareHook_Mod_Exp_t SureWareHook_Mod_Exp;