Man page - es256_pk_free(3)
Packages contains this manual
- fido_cred_set_uv(3)
- fido_cred_flags(3)
- fido_cred_type(3)
- fido_assert_set_count(3)
- es384_pk_from_ptr(3)
- fido_credman_rk_new(3)
- fido_assert_blob_ptr(3)
- fido_dev_set_timeout(3)
- fido_assert_user_id_len(3)
- fido_assert_set_extensions(3)
- fido_cbor_info_certs_value_ptr(3)
- fido_dev_close(3)
- fido_dev_info_set(3)
- fido_cred_sigcount(3)
- fido_cred_x5c_ptr(3)
- fido_cbor_info_maxcredbloblen(3)
- fido_bio_info_type(3)
- fido_dev_get_cbor_info(3)
- fido_cbor_info_protocols_ptr(3)
- fido_dev_info_product_string(3)
- fido_credman_rp_id(3)
- fido_dev_info_manufacturer_string(3)
- fido_bio_template_id_len(3)
- es384_pk_new(3)
- fido_credman_get_dev_rk(3)
- fido_bio_template_set_id(3)
- fido_cred_set_clientdata(3)
- fido_dev_largeblob_get(3)
- eddsa_pk_new(3)
- fido_dev_set_pin(3)
- fido_assert_set_authdata_raw(3)
- fido_cbor_info_extensions_len(3)
- fido_cred_set_rp(3)
- fido_cred_id_len(3)
- fido_cbor_info_algorithm_type(3)
- rs256_pk_from_ptr(3)
- fido_assert_id_len(3)
- fido_cbor_info_maxcredidlen(3)
- fido_cred_authdata_len(3)
- fido_cred_set_attstmt(3)
- fido_dev_get_retry_count(3)
- fido_credman_rp_name(3)
- fido_assert_set_hmac_secret(3)
- fido_cred_verify(3)
- fido_credman_rk_remaining(3)
- fido_cred_set_user(3)
- fido_dev_force_fido2(3)
- fido_bio_template_name(3)
- es256_pk_free(3)
- fido_cbor_info_certs_name_ptr(3)
- fido_cbor_info_uv_modality(3)
- fido_dev_flags(3)
- fido_cred_clientdata_hash_len(3)
- fido_dev_supports_permissions(3)
- fido_dev_open_with_info(3)
- fido_dev_is_winhello(3)
- fido_bio_template_free(3)
- fido_cred_pin_minlen(3)
- rs256_pk_free(3)
- fido_dev_largeblob_set(3)
- fido_dev_supports_pin(3)
- fido_dev_is_fido2(3)
- fido_bio_template_array_new(3)
- fido_cred_attstmt_ptr(3)
- fido_assert_sig_ptr(3)
- fido_credman_rk(3)
- fido_cbor_info_free(3)
- fido_bio_dev_get_template_array(3)
- fido_assert_allow_cred(3)
- fido_dev_set_pin_minlen(3)
- fido_cred_exclude(3)
- fido_cred_aaguid_ptr(3)
- fido_cbor_info_algorithm_count(3)
- fido_bio_info_max_samples(3)
- fido_credman_rp_id_hash_ptr(3)
- fido_cred_new(3)
- fido_bio_template(3)
- fido_dev_info_product(3)
- fido_credman_rp_id_hash_len(3)
- fido_cred_verify_self(3)
- eddsa_pk_free(3)
- fido_assert_set_winhello_appid(3)
- fido_cred_x5c_list_count(3)
- fido_bio_dev_get_info(3)
- fido_dev_get_assert(3)
- fido_credman_rk_count(3)
- fido_dev_reset(3)
- fido_credman_rp_free(3)
- fido_assert_set_sig(3)
- es384_pk_free(3)
- fido_cbor_info_maxmsgsiz(3)
- fido_cbor_info_transports_ptr(3)
- fido_cred_set_clientdata_hash(3)
- fido_cred_authdata_raw_ptr(3)
- fido_cred_set_sig(3)
- fido_assert_hmac_secret_len(3)
- fido_cbor_info_maxcredcntlst(3)
- fido_dev_info_ptr(3)
- fido_bio_dev_set_template_name(3)
- fido_dev_info_free(3)
- fido_cbor_info_extensions_ptr(3)
- fido_cbor_info_new_pin_required(3)
- fido_dev_has_uv(3)
- fido_assert_set_hmac_salt(3)
- fido_cbor_info_fwversion(3)
- fido_cred_set_authdata_raw(3)
- fido_cred_display_name(3)
- fido_credman_get_dev_metadata(3)
- fido_cred_user_id_ptr(3)
- fido_bio_info_free(3)
- fido_dev_largeblob_remove(3)
- fido_dev_info_manifest(3)
- fido_strerr(3)
- fido_cred_empty_exclude_list(3)
- fido_cred_set_fmt(3)
- fido_assert_authdata_raw_len(3)
- fido_assert_hmac_secret_ptr(3)
- fido_cred_set_type(3)
- fido_dev_set_transport_functions(3)
- es256_pk_from_ptr(3)
- fido_cred_prot(3)
- rs256_pk_new(3)
- fido_assert_rp_id(3)
- fido_assert_set_authdata(3)
- fido_dev_supports_uv(3)
- fido_dev_free(3)
- fido_dev_cancel(3)
- fido_cred_free(3)
- fido_cred_user_name(3)
- fido_cbor_info_algorithm_cose(3)
- fido_cred_set_prot(3)
- fido_assert_authdata_len(3)
- fido_dev_toggle_always_uv(3)
- fido_assert_largeblob_key_len(3)
- fido_cred_set_authdata(3)
- fido_assert_authdata_ptr(3)
- fido_dev_get_touch_status(3)
- fido_assert_set_uv(3)
- fido_cred_pubkey_len(3)
- fido_dev_open(3)
- fido_cbor_info_aaguid_len(3)
- fido_set_log_handler(3)
- fido_assert_free(3)
- fido_dev_supports_credman(3)
- fido_bio_enroll_remaining_samples(3)
- fido_assert_user_icon(3)
- fido_assert_sigcount(3)
- fido_credman_metadata_new(3)
- fido_cbor_info_new(3)
- fido_cred_x5c_list_len(3)
- es256_pk_new(3)
- fido_cred_fmt(3)
- fido_assert_count(3)
- fido_bio_dev_enroll_begin(3)
- fido_init(3)
- fido_assert_sig_len(3)
- fido_dev_largeblob_set_array(3)
- fido_dev_minor(3)
- fido_cbor_info_versions_len(3)
- fido_dev_info_vendor(3)
- fido_credman_metadata_free(3)
- fido_bio_dev_enroll_continue(3)
- fido_bio_dev_enroll_cancel(3)
- fido_cred_authdata_raw_len(3)
- fido_cred_set_id(3)
- fido_dev_new(3)
- fido_dev_force_pin_change(3)
- fido_cbor_info_options_name_ptr(3)
- fido_credman_rk_existing(3)
- fido_assert_empty_allow_list(3)
- fido_cbor_info_options_len(3)
- fido_bio_template_id_ptr(3)
- fido_cred_largeblob_key_ptr(3)
- fido_cred_aaguid_len(3)
- fido_cred_set_x509(3)
- fido_bio_template_new(3)
- fido_dev_get_uv_retry_count(3)
- fido_dev_enable_entattest(3)
- fido_credman_get_dev_rp(3)
- fido_cred_sig_len(3)
- fido_dev_get_touch_begin(3)
- fido_dev_new_with_info(3)
- fido_cred_authdata_ptr(3)
- fido_cred_set_attobj(3)
- fido_cbor_info_rk_remaining(3)
- fido_bio_dev_enroll_remove(3)
- fido_cbor_info_transports_len(3)
- fido_cbor_info_aaguid_ptr(3)
- fido_cred_set_rk(3)
- fido_assert_blob_len(3)
- fido_bio_template_array_count(3)
- fido_dev_make_cred(3)
- fido_cred_attstmt_len(3)
- fido_assert_flags(3)
- fido_dev_set_io_functions(3)
- fido_assert_set_rp(3)
- fido_cred_user_id_len(3)
- fido_dev_info_new(3)
- fido_cbor_info_maxlargeblob(3)
- fido_cbor_info_protocols_len(3)
- fido_credman_set_dev_rk(3)
- eddsa_pk_from_ptr(3)
- fido_assert_user_id_ptr(3)
- fido_cbor_info_certs_len(3)
- fido_credman_del_dev_rk(3)
- fido_bio_info_new(3)
- fido_bio_enroll_free(3)
- fido_dev_major(3)
- fido_assert_verify(3)
- fido_cbor_info_options_value_ptr(3)
- fido_cred_pubkey_ptr(3)
- fido_cbor_info_versions_ptr(3)
- fido_cred_rp_name(3)
- fido_cbor_info_uv_attempts(3)
- fido_dev_supports_cred_prot(3)
- fido_credman_rp_count(3)
- fido_cred_largeblob_key_len(3)
- fido_assert_id_ptr(3)
- fido_assert_largeblob_key_ptr(3)
- fido_assert_clientdata_hash_ptr(3)
- fido_assert_set_up(3)
- fido_cbor_info_maxrpid_minpinlen(3)
- fido_assert_set_clientdata(3)
- fido_cred_set_pin_minlen(3)
- fido_assert_user_name(3)
- fido_dev_force_u2f(3)
- fido_cred_rp_id(3)
- fido_assert_user_display_name(3)
- fido_cred_id_ptr(3)
- fido_dev_set_sigmask(3)
- fido_bio_enroll_new(3)
- fido_dev_info_path(3)
- fido_cred_x5c_len(3)
- fido_cred_x5c_list_ptr(3)
- fido_assert_new(3)
- fido_assert_authdata_raw_ptr(3)
- fido_dev_has_pin(3)
- fido_assert_set_clientdata_hash(3)
- fido_dev_build(3)
- fido_dev_protocol(3)
- fido_credman_rk_free(3)
- fido_bio_template_array_free(3)
- fido_dev_set_pin_minlen_rpid(3)
- fido_assert_clientdata_hash_len(3)
- fido_cred_set_blob(3)
- fido_cred_clientdata_hash_ptr(3)
- fido_bio_enroll_last_status(3)
- fido_cbor_info_minpinlen(3)
- fido_dev_largeblob_get_array(3)
- fido_cred_set_extensions(3)
- fido_cred_sig_ptr(3)
- fido_dev_io_handle(3)
- fido_bio_template_set_name(3)
- fido_credman_rp_new(3)
apt-get install libfido2-doc
Manual
ES256_PK_NEW (3) Library Functions Manual ES256_PK_NEW (3)
NAME
es256_pk_new, es256_pk_free, es256_pk_from_EC_KEY, es256_pk_from_EVP_PKEY, es256_pk_from_ptr, es256_pk_to_EVP_PKEY — FIDO2 COSE ES256 API
SYNOPSIS
#include <openssl/ec.h>
#include <fido/es256.h>
es256_pk_t *
es256_pk_new ( void );
void
es256_pk_free ( es256_pk_t **pkp );
int
es256_pk_from_EC_KEY ( es256_pk_t *pk , const EC_KEY *ec );
int
es256_pk_from_EVP_PKEY ( es256_pk_t *pk , const EVP_PKEY *pkey );
int
es256_pk_from_ptr ( es256_pk_t *pk , const void *ptr , size_t len );
EVP_PKEY *
es256_pk_to_EVP_PKEY ( const es256_pk_t *pk );
DESCRIPTION
ES256 is the name given in the CBOR Object Signing and Encryption (COSE) RFC to ECDSA over P-256 with SHA-256. The COSE ES256 API of libfido2 is an auxiliary API with routines to convert between the different ECDSA public key types used in libfido2 and OpenSSL .
In libfido2 , ES256 public keys are abstracted by the es256_pk_t type.
The es256_pk_new () function returns a pointer to a newly allocated, empty es256_pk_t type. If memory cannot be allocated, NULL is returned.
The es256_pk_free () function releases the memory backing *pkp , where *pkp must have been previously allocated by es256_pk_new (). On return, *pkp is set to NULL. Either pkp or *pkp may be NULL, in which case es256_pk_free () is a NOP.
The es256_pk_from_EC_KEY () function fills pk with the contents of ec . No references to ec are kept.
The es256_pk_from_EVP_PKEY () function fills pk with the contents of pkey . No references to pkey are kept.
The es256_pk_from_ptr () function fills pk with the contents of ptr , where ptr points to len bytes. The ptr pointer may point to an uncompressed point, or to the concatenation of the x and y coordinates. No references to ptr are kept.
The es256_pk_to_EVP_PKEY () function converts pk to a newly allocated EVP_PKEY type with a reference count of 1. No internal references to the returned pointer are kept. If an error occurs, es256_pk_to_EVP_PKEY () returns NULL.
RETURN VALUES
The es256_pk_from_EC_KEY (), es256_pk_from_EVP_PKEY (), and es256_pk_from_ptr () functions return FIDO_OK on success. On error, a different error code defined in < fido/err.h > is returned.
SEE ALSO
eddsa_pk_new (3), es384_pk_new (3), fido_assert_verify (3), fido_cred_pubkey_ptr (3), rs256_pk_new (3) Debian July 15, 2022 ES256_PK_NEW (3)