mbed TLS v2.6.0
ecdsa.h
Go to the documentation of this file.
1 
25 #ifndef MBEDTLS_ECDSA_H
26 #define MBEDTLS_ECDSA_H
27 
28 #include "ecp.h"
29 #include "md.h"
30 
31 /*
32  * RFC 4492 page 20:
33  *
34  * Ecdsa-Sig-Value ::= SEQUENCE {
35  * r INTEGER,
36  * s INTEGER
37  * }
38  *
39  * Size is at most
40  * 1 (tag) + 1 (len) + 1 (initial 0) + ECP_MAX_BYTES for each of r and s,
41  * twice that + 1 (tag) + 2 (len) for the sequence
42  * (assuming ECP_MAX_BYTES is less than 126 for r and s,
43  * and less than 124 (total len <= 255) for the sequence)
44  */
45 #if MBEDTLS_ECP_MAX_BYTES > 124
46 #error "MBEDTLS_ECP_MAX_BYTES bigger than expected, please fix MBEDTLS_ECDSA_MAX_LEN"
47 #endif
48 
49 #define MBEDTLS_ECDSA_MAX_LEN ( 3 + 2 * ( 3 + MBEDTLS_ECP_MAX_BYTES ) )
50 
55 
56 #ifdef __cplusplus
57 extern "C" {
58 #endif
59 
82  const mbedtls_mpi *d, const unsigned char *buf, size_t blen,
83  int (*f_rng)(void *, unsigned char *, size_t), void *p_rng );
84 
85 #if defined(MBEDTLS_ECDSA_DETERMINISTIC)
86 
106  const mbedtls_mpi *d, const unsigned char *buf, size_t blen,
107  mbedtls_md_type_t md_alg );
108 #endif /* MBEDTLS_ECDSA_DETERMINISTIC */
109 
129  const unsigned char *buf, size_t blen,
130  const mbedtls_ecp_point *Q, const mbedtls_mpi *r, const mbedtls_mpi *s);
131 
162  const unsigned char *hash, size_t hlen,
163  unsigned char *sig, size_t *slen,
164  int (*f_rng)(void *, unsigned char *, size_t),
165  void *p_rng );
166 
167 #if defined(MBEDTLS_ECDSA_DETERMINISTIC)
168 #if ! defined(MBEDTLS_DEPRECATED_REMOVED)
169 #if defined(MBEDTLS_DEPRECATED_WARNING)
170 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
171 #else
172 #define MBEDTLS_DEPRECATED
173 #endif
174 
202  const unsigned char *hash, size_t hlen,
203  unsigned char *sig, size_t *slen,
205 #undef MBEDTLS_DEPRECATED
206 #endif /* MBEDTLS_DEPRECATED_REMOVED */
207 #endif /* MBEDTLS_ECDSA_DETERMINISTIC */
208 
229  const unsigned char *hash, size_t hlen,
230  const unsigned char *sig, size_t slen );
231 
244  int (*f_rng)(void *, unsigned char *, size_t), void *p_rng );
245 
255 
262 
269 
270 #ifdef __cplusplus
271 }
272 #endif
273 
274 #endif /* ecdsa.h */
void mbedtls_ecdsa_free(mbedtls_ecdsa_context *ctx)
Free context.
Elliptic curves over GF(p)
ECP key pair structure.
Definition: ecp.h:167
void mbedtls_ecdsa_init(mbedtls_ecdsa_context *ctx)
Initialize context.
int mbedtls_ecdsa_verify(mbedtls_ecp_group *grp, const unsigned char *buf, size_t blen, const mbedtls_ecp_point *Q, const mbedtls_mpi *r, const mbedtls_mpi *s)
Verify ECDSA signature of a previously hashed message.
ECP group structure.
Definition: ecp.h:140
int mbedtls_ecdsa_sign(mbedtls_ecp_group *grp, mbedtls_mpi *r, mbedtls_mpi *s, const mbedtls_mpi *d, const unsigned char *buf, size_t blen, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
Compute ECDSA signature of a previously hashed message.
int mbedtls_ecdsa_from_keypair(mbedtls_ecdsa_context *ctx, const mbedtls_ecp_keypair *key)
Set an ECDSA context from an EC key pair.
int mbedtls_ecdsa_sign_det(mbedtls_ecp_group *grp, mbedtls_mpi *r, mbedtls_mpi *s, const mbedtls_mpi *d, const unsigned char *buf, size_t blen, mbedtls_md_type_t md_alg)
Compute ECDSA signature of a previously hashed message, deterministic version (RFC 6979)...
mbedtls_ecp_keypair mbedtls_ecdsa_context
ECDSA context structure.
Definition: ecdsa.h:54
mbedtls_ecp_group_id
Domain parameters (curve, subgroup and generator) identifiers.
Definition: ecp.h:64
int mbedtls_ecdsa_genkey(mbedtls_ecdsa_context *ctx, mbedtls_ecp_group_id gid, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
Generate an ECDSA keypair on the given curve.
Generic message digest wrapper.
int mbedtls_ecdsa_write_signature_det(mbedtls_ecdsa_context *ctx, const unsigned char *hash, size_t hlen, unsigned char *sig, size_t *slen, mbedtls_md_type_t md_alg) MBEDTLS_DEPRECATED
Compute ECDSA signature and write it to buffer, serialized as defined in RFC 4492 page 20...
MPI structure.
Definition: bignum.h:181
int mbedtls_ecdsa_read_signature(mbedtls_ecdsa_context *ctx, const unsigned char *hash, size_t hlen, const unsigned char *sig, size_t slen)
Read and verify an ECDSA signature.
ECP point structure (jacobian coordinates)
Definition: ecp.h:108
mbedtls_md_type_t
Definition: md.h:41
#define MBEDTLS_DEPRECATED
Definition: ecdsa.h:172
int mbedtls_ecdsa_write_signature(mbedtls_ecdsa_context *ctx, mbedtls_md_type_t md_alg, const unsigned char *hash, size_t hlen, unsigned char *sig, size_t *slen, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
Compute ECDSA signature and write it to buffer, serialized as defined in RFC 4492 page 20...