Man page - fido_dev_set_pin(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
FIDO_DEV_SET_PIN (3) Library Functions Manual FIDO_DEV_SET_PIN (3)
NAME
fido_dev_set_pin, fido_dev_get_retry_count, fido_dev_get_uv_retry_count, fido_dev_reset ā FIDO2 device management functions
SYNOPSIS
#include <fido.h>
int
fido_dev_set_pin ( fido_dev_tĀ *dev , constĀ charĀ *pin , constĀ charĀ *oldpin );
int
fido_dev_get_retry_count ( fido_dev_tĀ *dev , intĀ *retries );
int
fido_dev_get_uv_retry_count ( fido_dev_tĀ *dev , intĀ *retries );
int
fido_dev_reset ( fido_dev_tĀ *dev );
DESCRIPTION
The fido_dev_set_pin () function sets the PIN of device dev to pin , where pin is a NUL-terminated UTF-8 string. If oldpin is not NULL, the deviceās PIN is changed from oldpin to pin , where pin and oldpin are NUL-terminated UTF-8 strings.
The fido_dev_get_retry_count () function fills retries with the number of PIN retries left in dev before lock-out, where retries is an addressable pointer.
The fido_dev_get_uv_retry_count () function fills retries with the number of built-in UV retries left in dev before built-in UV is disabled, where retries is an addressable pointer.
The fido_dev_reset () function performs a reset on dev , resetting the deviceās PIN and erasing credentials stored on the device.
Please note that fido_dev_set_pin (), fido_dev_get_retry_count (), fido_dev_get_uv_retry_count (), and fido_dev_reset () are synchronous and will block if necessary.
RETURN VALUES
The error codes returned by fido_dev_set_pin (), fido_dev_get_retry_count (), fido_dev_get_uv_retry_count (), and fido_dev_reset () are defined in < fido/err.h >. On success, FIDO_OK is returned.
SEE ALSO
fido_cbor_info_uv_attempts (3)
CAVEATS
Regarding fido_dev_reset (), the actual user-flow to perform a reset is outside the scope of the FIDO2 specification, and may therefore vary depending on the authenticator. Yubico authenticators will return FIDO_ERR_NOT_ALLOWED if a reset is issued later than 5 seconds after power-up, and FIDO_ERR_ACTION_TIMEOUT if the user fails to confirm the reset by touching the key within 30 seconds. Debian MayĀ 25, 2018 FIDO_DEV_SET_PIN (3)