summaryrefslogtreecommitdiff
path: root/lib/libfido2/man/fido_init.3
diff options
context:
space:
mode:
authorDamien Miller <djm@cvs.openbsd.org>2022-08-29 03:04:30 +0000
committerDamien Miller <djm@cvs.openbsd.org>2022-08-29 03:04:30 +0000
commit267fb7a2c7d3a68ad2dc5493ad2a01f45bf631fc (patch)
treea3549304739f5cfb8b2a8ae6d95c768fa72bb722 /lib/libfido2/man/fido_init.3
parent209e6f81de6ea3eb825178e9ab0d853ace9b4fe4 (diff)
update libfido2 to 1.11.0, taking in just over a year of upstream
development. "looks ok" miod@ ok sthen@ NB. libfido2 major bump
Diffstat (limited to 'lib/libfido2/man/fido_init.3')
-rw-r--r--lib/libfido2/man/fido_init.330
1 files changed, 25 insertions, 5 deletions
diff --git a/lib/libfido2/man/fido_init.3 b/lib/libfido2/man/fido_init.3
index cd95c15d158..a54dcbc6427 100644
--- a/lib/libfido2/man/fido_init.3
+++ b/lib/libfido2/man/fido_init.3
@@ -2,16 +2,23 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: October 26 2021 $
+.Dd $Mdocdate: August 29 2022 $
.Dt FIDO_INIT 3
.Os
.Sh NAME
-.Nm fido_init
-.Nd initialise the FIDO 2 library
+.Nm fido_init ,
+.Nm fido_set_log_handler
+.Nd initialise the FIDO2 library
.Sh SYNOPSIS
.In fido.h
+.Bd -literal
+typedef void fido_log_handler_t(const char *);
+.Ed
+.Pp
.Ft void
.Fn fido_init "int flags"
+.Ft void
+.Fn fido_set_log_handler "fido_log_handler_t *handler"
.Sh DESCRIPTION
The
.Fn fido_init
@@ -43,8 +50,21 @@ then
.Em libfido2
will not fallback to U2F in
.Xr fido_dev_open 3
-if a device claims to be FIDO2 but fails to respond to a
-FIDO2 command.
+if a device claims to support FIDO2 but fails to respond to
+a CTAP 2.0 greeting.
+.Pp
+The
+.Fn fido_set_log_handler
+function causes
+.Fa handler
+to be called for each log line generated in the context of the
+executing thread.
+Lines passed to
+.Fa handler
+include a trailing newline character and are not printed by
+.Em libfido2
+on
+.Em stderr .
.Sh SEE ALSO
.Xr fido_assert_new 3 ,
.Xr fido_cred_new 3 ,