NAME
d2i_ECPKParameters
,
i2d_ECPKParameters
,
d2i_ECPKParameters_bio
,
i2d_ECPKParameters_bio
,
d2i_ECPKParameters_fp
,
i2d_ECPKParameters_fp
,
d2i_ECParameters
,
i2d_ECParameters
,
ECParameters_dup
,
d2i_ECPrivateKey
,
i2d_ECPrivateKey
,
d2i_ECPrivateKey_bio
,
i2d_ECPrivateKey_bio
,
d2i_ECPrivateKey_fp
,
i2d_ECPrivateKey_fp
,
o2i_ECPublicKey
,
i2o_ECPublicKey
,
ECPKParameters_print
,
ECPKParameters_print_fp
,
ECParameters_print
,
ECParameters_print_fp
,
d2i_EC_PUBKEY
,
i2d_EC_PUBKEY
,
d2i_EC_PUBKEY_bio
,
i2d_EC_PUBKEY_bio
,
d2i_EC_PUBKEY_fp
,
i2d_EC_PUBKEY_fp
—
decode and encode ASN.1 representations
of elliptic curve entities
SYNOPSIS
#include
<openssl/ec.h>
EC_GROUP *
d2i_ECPKParameters
(EC_GROUP
**val_out, const unsigned char **des_in,
long length);
int
i2d_ECPKParameters
(const EC_GROUP
*val_in, unsigned char **des_out);
EC_GROUP *
d2i_ECPKParameters_bio
(BIO
*in_bio, EC_GROUP **val_out);
int
i2d_ECPKParameters_bio
(BIO
*out_bio, EC_GROUP *val_in);
EC_GROUP *
d2i_ECPKParameters_fp
(FILE
*in_fp, EC_GROUP **val_out);
int
i2d_ECPKParameters_fp
(FILE
*out_fp, EC_GROUP *val_in);
EC_KEY *
d2i_ECParameters
(EC_KEY
**val_out, const unsigned char **des_in,
long length);
int
i2d_ECParameters
(EC_KEY *val_in,
unsigned char **des_out);
EC_KEY *
ECParameters_dup
(EC_KEY
*val_in);
EC_KEY *
d2i_ECPrivateKey
(EC_KEY
**val_out, const unsigned char **des_in,
long length);
int
i2d_ECPrivateKey
(EC_KEY *val_in,
unsigned char **des_out);
EC_KEY *
d2i_ECPrivateKey_bio
(BIO
*in_bio, EC_KEY **val_out);
int
i2d_ECPrivateKey_bio
(BIO
*out_bio, EC_KEY *val_in);
EC_KEY *
d2i_ECPrivateKey_fp
(FILE *in_fp,
EC_KEY **val_out);
int
i2d_ECPrivateKey_fp
(FILE
*out_fp, EC_KEY *val_in);
EC_KEY *
o2i_ECPublicKey
(EC_KEY
**val_out, const unsigned char **des_in,
long length);
int
i2o_ECPublicKey
(const EC_KEY
*val_in, unsigned char **des_out);
int
ECPKParameters_print
(BIO
*out_bio, const EC_GROUP *val_in,
int indent);
int
ECPKParameters_print_fp
(FILE
*out_fp, const EC_GROUP *val_in,
int indent);
int
ECParameters_print
(BIO *out_bio,
const EC_KEY *val_in);
int
ECParameters_print_fp
(FILE
*out_fp, const EC_KEY *val_in);
#include
<openssl/x509.h>
EC_KEY *
d2i_EC_PUBKEY
(EC_KEY **val_out,
const unsigned char **des_in, long
length);
int
i2d_EC_PUBKEY
(EC_KEY *val_in,
unsigned char **des_out);
EC_KEY *
d2i_EC_PUBKEY_bio
(BIO *in_bio,
EC_KEY **val_out);
int
i2d_EC_PUBKEY_bio
(BIO *out_bio,
EC_KEY *val_in);
EC_KEY *
d2i_EC_PUBKEY_fp
(FILE *in_fp,
EC_KEY **val_out);
int
i2d_EC_PUBKEY_fp
(FILE *out_fp,
EC_KEY *val_in);
DESCRIPTION
These functions decode and encode elliptic curve keys and parameters. For details about the semantics, examples, caveats, and bugs, see ASN1_item_d2i(3).
d2i_ECPKParameters
()
and
i2d_ECPKParameters
()
decode and encode the parameters of an elliptic curve.
d2i_ECPKParameters_bio
(),
i2d_ECPKParameters_bio
(),
d2i_ECPKParameters_fp
(),
and
i2d_ECPKParameters_fp
()
are similar except that they decode or encode using a
BIO or FILE pointer. These four
functions are currently implemented as macros.
d2i_ECParameters
()
does the same parsing as d2i_ECPKParameters
() but
saves the result in the group field of an
EC_KEY structure.
i2d_ECParameters
()
produces the same output as
i2d_ECPKParameters
()
but uses val_in->group for input instead of
val_in.
ECParameters_dup
()
allocates and initializes an empty EC_KEY object and
copies the EC parameters from val_in to it by calling
i2d_ECParameters
() and
d2i_ECParameters
(). If a private or public key or
any flags are present in val_in, they are not
copied.
d2i_ECPrivateKey
()
and
i2d_ECPrivateKey
()
decode and encode an EC private key using an ASN.1
ECPrivateKey structure defined in RFC 5915 section 3
and used for the privateKey field of the ASN.1
PrivateKeyInfo structure defined in RFC 5208 section
5, see PKCS8_PRIV_KEY_INFO_new(3).
d2i_ECPrivateKey_bio
(),
i2d_ECPrivateKey_bio
(),
d2i_ECPrivateKey_fp
(),
and
i2d_ECPrivateKey_fp
()
are similar except that they decode or encode using a
BIO or FILE pointer.
o2i_ECPublicKey
()
and
i2o_ECPublicKey
()
decode and encode an EC public key. In contrast to
ASN1_item_d2i(3),
o2i_ECPublicKey
() requires
val_out, *val_out, and
(*val_out)->group to be
non-NULL
.
ECPKParameters_print
()
and
ECPKParameters_print_fp
()
print human-readable output of the public parameters of the
EC_GROUP to out_bio or
out_fp. The output lines are indented by
indent spaces.
ECParameters_print
()
and
ECParameters_print_fp
()
print the parameter components of val_in to
out_bio or out_fp.
d2i_EC_PUBKEY
()
and
i2d_EC_PUBKEY
()
decode and encode an EC public key using an ASN.1
SubjectPublicKeyInfo structure defined in RFC 5280
section 4.1 and documented in X509_PUBKEY_new(3).
d2i_EC_PUBKEY_bio
(),
i2d_EC_PUBKEY_bio
(),
d2i_EC_PUBKEY_fp
(),
and
i2d_EC_PUBKEY_fp
()
are similar except that they decode or encode using a
BIO or FILE pointer.
RETURN VALUES
d2i_ECPKParameters
(),
d2i_ECPKParameters_bio
(), and
d2i_ECPKParameters_fp
() return a valid
EC_GROUP structure or NULL
if
an error occurs.
d2i_ECParameters
(),
ECParameters_dup
(),
d2i_ECPrivateKey
(),
d2i_ECPrivateKey_bio
(),
d2i_ECPrivateKey_fp
(),
o2i_ECPublicKey
(),
d2i_EC_PUBKEY
(),
d2i_EC_PUBKEY_bio
(), and
d2i_EC_PUBKEY_fp
() return a valid
EC_KEY structure or NULL
if an
error occurs.
i2d_ECPKParameters
(),
i2d_ECParameters
(),
i2d_ECPrivateKey
(),
i2o_ECPublicKey
(), and
i2d_EC_PUBKEY
() return the number of bytes
successfully encoded or a negative value if an error occurs.
i2d_ECPKParameters_bio
(),
i2d_ECPKParameters_fp
(),
i2d_ECPrivateKey_bio
(),
i2d_ECPrivateKey_fp
(),
ECPKParameters_print
(),
ECPKParameters_print_fp
(),
ECParameters_print
(),
ECParameters_print_fp
(),
i2d_EC_PUBKEY_bio
(), and
i2d_EC_PUBKEY_fp
() return 1 for success or 0 if an
error occurs.
SEE ALSO
ASN1_item_d2i(3), EC_GROUP_copy(3), EC_GROUP_new(3), EC_KEY_new(3), EVP_PKEY_set1_EC_KEY(3), PEM_write_ECPrivateKey(3), PKCS8_PRIV_KEY_INFO_new(3), X509_PUBKEY_new(3)
STANDARDS
RFC 5915: Elliptic Curve Private Key Structure
RFC 5208: Public-Key Cryptography Standards (PKCS) #8: Private-Key Information Syntax Specification
RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile, section 4.1: Basic Certificate Fields
HISTORY
d2i_ECPKParameters
(),
i2d_ECPKParameters
(),
d2i_ECPKParameters_bio
(),
i2d_ECPKParameters_bio
(),
d2i_ECPKParameters_fP
(),
i2d_ECPKParameters_fp
(),
d2i_ECParameters
(),
i2d_ECParameters
(),
ECParameters_dup
(),
d2i_ECPrivateKey
(),
i2d_ECPrivateKey
(),
d2i_ECPrivateKey_bio
(),
i2d_ECPrivateKey_bio
(),
d2i_ECPrivateKey_fp
(),
i2d_ECPrivateKey_fp
(),
o2i_ECPublicKey
(),
i2o_ECPublicKey
(),
ECPKParameters_print
(),
ECPKParameters_print_fp
(),
ECParameters_print
(),
ECParameters_print_fp
(),
d2i_EC_PUBKEY
(),
i2d_EC_PUBKEY
(),
d2i_EC_PUBKEY_bio
(),
i2d_EC_PUBKEY_bio
(),
d2i_EC_PUBKEY_fp
(), and
i2d_EC_PUBKEY_fp
() first appeared in OpenSSL 0.9.8
and have been available since OpenBSD 4.5.