1FIDO_DEV_GET_TOUCH_BE... BSD Library Functions Manual FIDO_DEV_GET_TOUCH_BE...
2

NAME

4     fido_dev_get_touch_begin, fido_dev_get_touch_status — asynchronously wait
5     for touch on a FIDO2 authenticator
6

SYNOPSIS

8     #include <fido.h>
9
10     int
11     fido_dev_get_touch_begin(fido_dev_t *dev);
12
13     int
14     fido_dev_get_touch_status(fido_dev_t *dev, int *touched, int ms);
15

DESCRIPTION

17     The functions described in this page allow an application to asyn‐
18     chronously wait for touch on a FIDO2 authenticator.  This is useful when
19     multiple authenticators are present and the application needs to know
20     which one to use.
21
22     The fido_dev_get_touch_begin() function initiates a touch request on dev.
23
24     The fido_dev_get_touch_status() function continues an ongoing touch re‐
25     quest on dev, blocking up to ms milliseconds.  On success, touched will
26     be updated to reflect the touch request status.  If touched is 1, the de‐
27     vice was touched, and the touch request is terminated.  If touched is 0,
28     the application may call fido_dev_get_touch_status() to continue the
29     touch request, or fido_dev_cancel() to terminate it.
30

RETURN VALUES

32     The error codes returned by fido_dev_get_touch_begin() and
33     fido_dev_get_touch_status() are defined in <fido/err.h>.  On success,
34     FIDO_OK is returned.
35

EXAMPLES

37     Please refer to examples/select.c in libfido2's source tree.
38

SEE ALSO

40     fido_dev_cancel(3)
41

CAVEATS

43     The fido_dev_get_touch_status() function will cause a command to be
44     transmitted to U2F authenticators.  These transmissions should not exceed
45     a frequency of 5Hz.
46
47BSD                             August 5, 2020                             BSD
Impressum