1FIDO_CRED_EXCLUDE(3) BSD Library Functions Manual FIDO_CRED_EXCLUDE(3)
2
4 fido_cred_exclude, fido_cred_empty_exclude_list — manage exclude lists in
5 a FIDO2 credential
6
8 #include <fido.h>
9
10 int
11 fido_cred_exclude(fido_cred_t *cred, const unsigned char *ptr,
12 size_t len);
13
14 int
15 fido_cred_empty_exclude_list(fido_cred_t *cred);
16
18 The fido_cred_exclude() function adds ptr to the list of credentials ex‐
19 cluded by cred, where ptr points to a credential ID of len bytes. A copy
20 of ptr is made, and no references to the passed pointer are kept. If
21 fido_cred_exclude() fails, the existing list of excluded credentials is
22 preserved.
23
24 If fido_cred_exclude returns success and cred is later passed to
25 fido_dev_make_cred(3) on a device that contains the credential denoted by
26 ptr, then fido_dev_make_cred(3) will fail.
27
28 For the format of a FIDO2 credential ID, please refer to the Web Authen‐
29 tication (webauthn) standard.
30
31 The fido_cred_empty_exclude_list() function empties the list of creden‐
32 tials excluded by cred.
33
35 The error codes returned by fido_cred_exclude() and
36 fido_cred_empty_exclude_list() are defined in <fido/err.h>. On success,
37 FIDO_OK is returned.
38
40 fido_cred_new(3), fido_cred_set_authdata(3), fido_dev_make_cred(3)
41
42BSD December 2, 2022 BSD