1FIDO_BIO_DEV_GET_INFO(3) BSD Library Functions Manual FIDO_BIO_DEV_GET_INFO(3)
2

NAME

4     fido_bio_dev_get_info, fido_bio_dev_enroll_begin,
5     fido_bio_dev_enroll_continue, fido_bio_dev_enroll_cancel,
6     fido_bio_dev_enroll_remove, fido_bio_dev_get_template_array,
7     fido_bio_dev_set_template_name — FIDO2 biometric authenticator API
8

SYNOPSIS

10     #include <fido.h>
11     #include <fido/bio.h>
12
13     int
14     fido_bio_dev_get_info(fido_dev_t *dev, fido_bio_info_t *info);
15
16     int
17     fido_bio_dev_enroll_begin(fido_dev_t *dev, fido_bio_template_t *template,
18         fido_bio_enroll_t *enroll, uint32_t timeout_ms, const char *pin);
19
20     int
21     fido_bio_dev_enroll_continue(fido_dev_t *dev,
22         const fido_bio_template_t *template, fido_bio_enroll_t *enroll,
23         uint32_t timeout_ms);
24
25     int
26     fido_bio_dev_enroll_cancel(fido_dev_t *dev);
27
28     int
29     fido_bio_dev_enroll_remove(fido_dev_t *dev,
30         const fido_bio_template_t *template, const char *pin);
31
32     int
33     fido_bio_dev_get_template_array(fido_dev_t *dev,
34         fido_bio_template_array_t *template_array, const char *pin);
35
36     int
37     fido_bio_dev_set_template_name(fido_dev_t *dev,
38         const fido_bio_template_t *template, const char *pin);
39

DESCRIPTION

41     The functions described in this page allow biometric templates on a FIDO2
42     authenticator to be listed, created, removed, and customised.  Please
43     note that not all FIDO2 authenticators support biometric enrollment.  For
44     a description of the types involved, please refer to
45     fido_bio_info_new(3), fido_bio_enroll_new(3), and fido_bio_template(3).
46
47     The fido_bio_dev_get_info() function populates info with sensor informa‐
48     tion from dev.
49
50     The fido_bio_dev_enroll_begin() function initiates a biometric enrollment
51     on dev, instructing the authenticator to wait timeout_ms milliseconds.
52     On success, template and enroll will be populated with the newly created
53     template's information and enrollment status, respectively.
54
55     The fido_bio_dev_enroll_continue() function continues an ongoing enroll‐
56     ment on dev, instructing the authenticator to wait timeout_ms millisec‐
57     onds.  On success, enroll will be updated to reflect the status of the
58     biometric enrollment.
59
60     The fido_bio_dev_enroll_cancel() function cancels an ongoing enrollment
61     on dev.
62
63     The fido_bio_dev_enroll_remove() function removes template from dev.
64
65     The fido_bio_dev_get_template_array() function populates template_array
66     with the templates currently enrolled on dev.
67
68     The fido_bio_dev_set_template_name() function sets the friendly name of
69     template on dev.
70

RETURN VALUES

72     The error codes returned by fido_bio_dev_get_info(),
73     fido_bio_dev_enroll_begin(), fido_bio_dev_enroll_continue(),
74     fido_bio_dev_enroll_cancel(), fido_bio_dev_enroll_remove(),
75     fido_bio_dev_get_template_array(), and fido_bio_dev_set_template_name()
76     are defined in <fido/err.h>.  On success, FIDO_OK is returned.
77

SEE ALSO

79     fido_bio_enroll_new(3), fido_bio_info_new(3), fido_bio_template(3)
80
81BSD                           September 13, 2019                           BSD
Impressum