dsa.h

00001 /* dsa.h
00002  *
00003  * Copyright (C) 2006-2020 wolfSSL Inc.
00004  *
00005  * This file is part of wolfSSL.
00006  *
00007  * wolfSSL is free software; you can redistribute it and/or modify
00008  * it under the terms of the GNU General Public License as published by
00009  * the Free Software Foundation; either version 2 of the License, or
00010  * (at your option) any later version.
00011  *
00012  * wolfSSL is distributed in the hope that it will be useful,
00013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00015  * GNU General Public License for more details.
00016  *
00017  * You should have received a copy of the GNU General Public License
00018  * along with this program; if not, write to the Free Software
00019  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335, USA
00020  */
00021 
00022 /*!
00023     \file wolfssl/wolfcrypt/dsa.h
00024 */
00025 
00026 #ifndef WOLF_CRYPT_DSA_H
00027 #define WOLF_CRYPT_DSA_H
00028 
00029 #include <wolfssl/wolfcrypt/types.h >
00030 
00031 #ifndef NO_DSA
00032 
00033 #include <wolfssl/wolfcrypt/integer.h>
00034 #include <wolfssl/wolfcrypt/random.h >
00035 
00036 /* for DSA reverse compatibility */
00037 #define InitDsaKey wc_InitDsaKey
00038 #define FreeDsaKey wc_FreeDsaKey
00039 #define DsaSign wc_DsaSign
00040 #define DsaVerify wc_DsaVerify
00041 #define DsaPublicKeyDecode wc_DsaPublicKeyDecode
00042 #define DsaPrivateKeyDecode wc_DsaPrivateKeyDecode
00043 #define DsaKeyToDer wc_DsaKeyToDer
00044 
00045 #ifdef __cplusplus
00046     extern "C" {
00047 #endif
00048 
00049 
00050 enum {
00051     DSA_PUBLIC   = 0,
00052     DSA_PRIVATE  = 1
00053 };
00054 
00055 enum {
00056     DSA_HALF_SIZE = 20,   /* r and s size  */
00057     DSA_SIG_SIZE  = 40    /* signature size */
00058 };
00059 
00060 /* DSA */
00061 typedef struct DsaKey {
00062     mp_int p, q, g, y, x;
00063     int   type;                               /* public or private */
00064     void* heap;                               /* memory hint */
00065 } DsaKey;
00066 
00067 WOLFSSL_API int wc_InitDsaKey(DsaKey* key);
00068 WOLFSSL_API int wc_InitDsaKey_h(DsaKey* key, void* h);
00069 WOLFSSL_API void wc_FreeDsaKey(DsaKey* key);
00070 WOLFSSL_API int wc_DsaSign(const byte* digest, byte* out,
00071                            DsaKey* key, WC_RNG* rng);
00072 WOLFSSL_API int wc_DsaVerify(const byte* digest, const byte* sig,
00073                              DsaKey* key, int* answer);
00074 WOLFSSL_API int wc_DsaPublicKeyDecode(const byte* input, word32* inOutIdx,
00075                                       DsaKey*, word32);
00076 WOLFSSL_API int wc_DsaPrivateKeyDecode(const byte* input, word32* inOutIdx,
00077                                        DsaKey*, word32);
00078 WOLFSSL_API int wc_DsaKeyToDer(DsaKey* key, byte* output, word32 inLen);
00079 WOLFSSL_API int wc_SetDsaPublicKey(byte* output, DsaKey* key,
00080                                    int outLen, int with_header);
00081 WOLFSSL_API int wc_DsaKeyToPublicDer(DsaKey* key, byte* output, word32 inLen);
00082 
00083 #ifdef WOLFSSL_KEY_GEN
00084 WOLFSSL_API int wc_MakeDsaKey(WC_RNG *rng, DsaKey *dsa);
00085 WOLFSSL_API int wc_MakeDsaParameters(WC_RNG *rng, int modulus_size, DsaKey *dsa);
00086 #endif
00087 
00088 /* raw export functions */
00089 WOLFSSL_API int wc_DsaImportParamsRaw(DsaKey* dsa, const char* p,
00090                                       const char* q, const char* g);
00091 WOLFSSL_API int wc_DsaImportParamsRawCheck(DsaKey* dsa, const char* p,
00092                                       const char* q, const char* g,
00093                                       int trusted, WC_RNG* rng);
00094 WOLFSSL_API int wc_DsaExportParamsRaw(DsaKey* dsa, byte* p, word32* pSz,
00095                                       byte* q, word32* qSz, byte* g,
00096                                       word32* gSz);
00097 WOLFSSL_API int wc_DsaExportKeyRaw(DsaKey* dsa, byte* x, word32* xSz, byte* y,
00098                                    word32* ySz);
00099 #ifdef __cplusplus
00100     } /* extern "C" */
00101 #endif
00102 
00103 #endif /* NO_DSA */
00104 #endif /* WOLF_CRYPT_DSA_H */
00105 
00106