Update configurable sigalgs documentation for providers
[openssl.git] / include / crypto / dsa.h
1 /*
2  * Copyright 2019-2022 The OpenSSL Project Authors. All Rights Reserved.
3  *
4  * Licensed under the Apache License 2.0 (the "License").  You may not use
5  * this file except in compliance with the License.  You can obtain a copy
6  * in the file LICENSE in the source distribution or at
7  * https://www.openssl.org/source/license.html
8  */
9
10 #ifndef OSSL_CRYPTO_DSA_H
11 # define OSSL_CRYPTO_DSA_H
12 # pragma once
13
14 # include <openssl/core.h>
15 # include <openssl/dsa.h>
16 # include "internal/ffc.h"
17
18 /*
19  * DSA Paramgen types
20  * Note, adding to this list requires adjustments to various checks
21  * in dsa_gen range validation checks
22  */
23 #define DSA_PARAMGEN_TYPE_FIPS_186_4   0   /* Use FIPS186-4 standard */
24 #define DSA_PARAMGEN_TYPE_FIPS_186_2   1   /* Use legacy FIPS186-2 standard */
25 #define DSA_PARAMGEN_TYPE_FIPS_DEFAULT 2
26
27 DSA *ossl_dsa_new(OSSL_LIB_CTX *libctx);
28 void ossl_dsa_set0_libctx(DSA *d, OSSL_LIB_CTX *libctx);
29
30 int ossl_dsa_generate_ffc_parameters(DSA *dsa, int type, int pbits, int qbits,
31                                      BN_GENCB *cb);
32
33 int ossl_dsa_sign_int(int type, const unsigned char *dgst, int dlen,
34                       unsigned char *sig, unsigned int *siglen, DSA *dsa,
35                       unsigned int nonce_type, const char *digestname,
36                       OSSL_LIB_CTX *libctx, const char *propq);
37
38 FFC_PARAMS *ossl_dsa_get0_params(DSA *dsa);
39 int ossl_dsa_ffc_params_fromdata(DSA *dsa, const OSSL_PARAM params[]);
40 int ossl_dsa_key_fromdata(DSA *dsa, const OSSL_PARAM params[],
41                           int include_private);
42 DSA *ossl_dsa_key_from_pkcs8(const PKCS8_PRIV_KEY_INFO *p8inf,
43                              OSSL_LIB_CTX *libctx, const char *propq);
44
45 int ossl_dsa_generate_public_key(BN_CTX *ctx, const DSA *dsa,
46                                  const BIGNUM *priv_key, BIGNUM *pub_key);
47 int ossl_dsa_check_params(const DSA *dsa, int checktype, int *ret);
48 int ossl_dsa_check_pub_key(const DSA *dsa, const BIGNUM *pub_key, int *ret);
49 int ossl_dsa_check_pub_key_partial(const DSA *dsa, const BIGNUM *pub_key,
50                                    int *ret);
51 int ossl_dsa_check_priv_key(const DSA *dsa, const BIGNUM *priv_key, int *ret);
52 int ossl_dsa_check_pairwise(const DSA *dsa);
53 int ossl_dsa_is_foreign(const DSA *dsa);
54 DSA *ossl_dsa_dup(const DSA *dsa, int selection);
55
56 #endif