NAME¶

SYNOPSIS¶

fido_cbor_info_t *
fido_cbor_info_new(void);

void
fido_cbor_info_free(fido_cbor_info_t **ci_p);

int
fido_dev_get_cbor_info(fido_dev_t *dev, fido_cbor_info_t *ci);

const unsigned char *
fido_cbor_info_aaguid_ptr(const fido_cbor_info_t *ci);

char **
fido_cbor_info_extensions_ptr(const fido_cbor_info_t *ci);

const uint8_t *
fido_cbor_info_protocols_ptr(const fido_cbor_info_t *ci);

char **
fido_cbor_info_versions_ptr(const fido_cbor_info_t *ci);

char **
fido_cbor_info_options_name_ptr(const fido_cbor_info_t *ci);

const bool *
fido_cbor_info_options_value_ptr(const fido_cbor_info_t *ci);

size_t
fido_cbor_info_aaguid_len(const fido_cbor_info_t *ci);

size_t
fido_cbor_info_extensions_len(const fido_cbor_info_t *ci);

size_t
fido_cbor_info_protocols_len(const fido_cbor_info_t *ci);

size_t
fido_cbor_info_versions_len(const fido_cbor_info_t *ci);

size_t
fido_cbor_info_options_len(const fido_cbor_info_t *ci);

uint64_t
fido_cbor_info_maxmsgsiz(const fido_cbor_info_t *ci);

uint64_t
fido_cbor_info_maxcredcntlst(const fido_cbor_info_t *ci);

uint64_t
fido_cbor_info_maxcredidlen(const fido_cbor_info_t *ci);

uint64_t
fido_cbor_info_fwversion(const fido_cbor_info_t *ci);

DESCRIPTION¶

The fido_cbor_info_free() function releases the memory backing *ci_p, where *ci_p must have been previously allocated by fido_cbor_info_new(). On return, *ci_p is set to NULL. Either ci_p or *ci_p may be NULL, in which case fido_cbor_info_free() is a NOP.

The fido_dev_get_cbor_info() function transmits a CTAP_CBOR_GETINFO command to dev and fills ci with attributes retrieved from the command's response. The fido_dev_get_cbor_info() function may block.

The fido_cbor_info_aaguid_ptr(), fido_cbor_info_extensions_ptr(), fido_cbor_info_protocols_ptr(), and fido_cbor_info_versions_ptr() functions return pointers to the authenticator attestation GUID, supported extensions, PIN protocol and CTAP version strings of ci. The corresponding length of a given attribute can be obtained by fido_cbor_info_aaguid_len(), fido_cbor_info_extensions_len(), fido_cbor_info_protocols_len(), or fido_cbor_info_versions_len().

The fido_cbor_info_options_name_ptr() and fido_cbor_info_options_value_ptr() functions return pointers to the array of option names and their respective values in ci. The length of the options array is returned by fido_cbor_info_options_len().

The fido_cbor_info_maxmsgsiz() function returns the maximum message size attribute of ci.

The fido_cbor_info_maxcredcntlst() function returns the maximum supported number of credentials in a single credential ID list as reported in ci.

The fido_cbor_info_maxcredidlen() function returns the maximum supported length of a credential ID as reported in ci.

The fido_cbor_info_fwversion() function returns the firmware version attribute of ci.

A complete example of how to use these functions can be found in the example/info.c file shipped with libfido2.

RETURN VALUES¶

SEE ALSO¶