fido_bio_enroll_new, fido_bio_enroll_free, fido_bio_enroll_last_status, fido_bio_enroll_remaining_samples

Ongoing FIDO2 biometric enrollments are abstracted in libfido2 by the fido_bio_enroll_t type. The functions described in this page allow a fido_bio_enroll_t type to be allocated, deallocated, and inspected. For device operations on fido_bio_enroll_t, please refer to fido_bio_dev_get_info(3). The fido_bio_enroll_new() function returns a pointer to a newly allocated, empty fido_bio_enroll_t type. If memory cannot be allocated, NULL is returned. The fido_bio_enroll_free() function releases the memory backing *enroll_p, where *enroll_p must have been previously allocated by fido_bio_enroll_new(). On return, *enroll_p is set to NULL. Either enroll_p or *enroll_p may be NULL, in which case fido_bio_enroll_free() is a NOP. The fido_bio_enroll_last_status() function returns the enrollment status of enroll. The fido_bio_enroll_remaining_samples() function returns the number of samples left for enroll to complete.

fido_bio_enroll_new, fido_bio_enroll_free, fido_bio_enroll_last_status, fido_bio_enroll_remaining_samples — FIDO2 biometric enrollment API

fido_bio_dev_get_info(3), fido_bio_template(3) Debian September 13, 2019 FIDO_BIO_ENROLL_NEW(3)

#include<fido.h>#include<fido/bio.h> #define FIDO_BIO_ENROLL_FP_GOOD 0x00 #define FIDO_BIO_ENROLL_FP_TOO_HIGH 0x01 #define FIDO_BIO_ENROLL_FP_TOO_LOW 0x02 #define FIDO_BIO_ENROLL_FP_TOO_LEFT 0x03 #define FIDO_BIO_ENROLL_FP_TOO_RIGHT 0x04 #define FIDO_BIO_ENROLL_FP_TOO_FAST 0x05 #define FIDO_BIO_ENROLL_FP_TOO_SLOW 0x06 #define FIDO_BIO_ENROLL_FP_POOR_QUALITY 0x07 #define FIDO_BIO_ENROLL_FP_TOO_SKEWED 0x08 #define FIDO_BIO_ENROLL_FP_TOO_SHORT 0x09 #define FIDO_BIO_ENROLL_FP_MERGE_FAILURE 0x0a #define FIDO_BIO_ENROLL_FP_EXISTS 0x0b #define FIDO_BIO_ENROLL_FP_DATABASE_FULL 0x0c #define FIDO_BIO_ENROLL_NO_USER_ACTIVITY 0x0d #define FIDO_BIO_ENROLL_NO_USER_PRESENCE_TRANSITION 0x0e fido_bio_enroll_t*fido_bio_enroll_new(void); voidfido_bio_enroll_free(fido_bio_enroll_t**enroll_p); uint8_tfido_bio_enroll_last_status(constfido_bio_enroll_t*enroll); uint8_tfido_bio_enroll_remaining_samples(constfido_bio_enroll_t*enroll);