summaryrefslogtreecommitdiff
path: root/lib/libfido2/man
diff options
context:
space:
mode:
authorDamien Miller <djm@cvs.openbsd.org>2020-02-07 00:57:50 +0000
committerDamien Miller <djm@cvs.openbsd.org>2020-02-07 00:57:50 +0000
commitf56c9e1efe73dd25f92879f2d27c664eb1bf581d (patch)
tree065c5255de3a9c8f3281cb7be36a2d323f8051d4 /lib/libfido2/man
parente6642495b45b7220c2cdd93f4f50e3ed848a1c9f (diff)
update to upstream libfido2 780ad3c25 (20120123)
install manual pages crank major feedback & ok jmc@ and naddy@
Diffstat (limited to 'lib/libfido2/man')
-rw-r--r--lib/libfido2/man/eddsa_pk_new.32
-rw-r--r--lib/libfido2/man/es256_pk_new.36
-rw-r--r--lib/libfido2/man/fido_assert_allow_cred.32
-rw-r--r--lib/libfido2/man/fido_assert_new.32
-rw-r--r--lib/libfido2/man/fido_assert_set_authdata.32
-rw-r--r--lib/libfido2/man/fido_assert_verify.32
-rw-r--r--lib/libfido2/man/fido_bio_dev_get_info.32
-rw-r--r--lib/libfido2/man/fido_bio_enroll_new.32
-rw-r--r--lib/libfido2/man/fido_bio_info_new.32
-rw-r--r--lib/libfido2/man/fido_bio_template.32
-rw-r--r--lib/libfido2/man/fido_cbor_info_new.32
-rw-r--r--lib/libfido2/man/fido_cred_exclude.32
-rw-r--r--lib/libfido2/man/fido_cred_new.314
-rw-r--r--lib/libfido2/man/fido_cred_set_authdata.327
-rw-r--r--lib/libfido2/man/fido_cred_verify.32
-rw-r--r--lib/libfido2/man/fido_credman_metadata_new.32
-rw-r--r--lib/libfido2/man/fido_dev_get_assert.32
-rw-r--r--lib/libfido2/man/fido_dev_info_manifest.32
-rw-r--r--lib/libfido2/man/fido_dev_make_cred.32
-rw-r--r--lib/libfido2/man/fido_dev_open.32
-rw-r--r--lib/libfido2/man/fido_dev_set_io_functions.32
-rw-r--r--lib/libfido2/man/fido_dev_set_pin.32
-rw-r--r--lib/libfido2/man/fido_init.32
-rw-r--r--lib/libfido2/man/fido_strerr.32
-rw-r--r--lib/libfido2/man/rs256_pk_new.32
25 files changed, 65 insertions, 26 deletions
diff --git a/lib/libfido2/man/eddsa_pk_new.3 b/lib/libfido2/man/eddsa_pk_new.3
index f11b7293853..09dacc7d750 100644
--- a/lib/libfido2/man/eddsa_pk_new.3
+++ b/lib/libfido2/man/eddsa_pk_new.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt EDDSA_PK_NEW 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/es256_pk_new.3 b/lib/libfido2/man/es256_pk_new.3
index 8b9c9c323b1..6f46e0d813c 100644
--- a/lib/libfido2/man/es256_pk_new.3
+++ b/lib/libfido2/man/es256_pk_new.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt ES256_PK_NEW 3
.Os
.Sh NAME
@@ -89,6 +89,10 @@ where
points to
.Fa len
bytes.
+The
+.Fa ptr
+pointer may point to an uncompressed point, or to the
+concatenation of the x and y coordinates.
No references to
.Fa ptr
are kept.
diff --git a/lib/libfido2/man/fido_assert_allow_cred.3 b/lib/libfido2/man/fido_assert_allow_cred.3
index 5c5d991f6f0..e5b8b180a91 100644
--- a/lib/libfido2/man/fido_assert_allow_cred.3
+++ b/lib/libfido2/man/fido_assert_allow_cred.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_ASSERT_ALLOW_CRED 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_assert_new.3 b/lib/libfido2/man/fido_assert_new.3
index d06269ab730..b58a7fe121f 100644
--- a/lib/libfido2/man/fido_assert_new.3
+++ b/lib/libfido2/man/fido_assert_new.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_ASSERT_NEW 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_assert_set_authdata.3 b/lib/libfido2/man/fido_assert_set_authdata.3
index a3ecfe7069d..9565954f264 100644
--- a/lib/libfido2/man/fido_assert_set_authdata.3
+++ b/lib/libfido2/man/fido_assert_set_authdata.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 19 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_ASSERT_SET_AUTHDATA 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_assert_verify.3 b/lib/libfido2/man/fido_assert_verify.3
index 615c65e3845..04380b224d6 100644
--- a/lib/libfido2/man/fido_assert_verify.3
+++ b/lib/libfido2/man/fido_assert_verify.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_ASSERT_VERIFY 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_bio_dev_get_info.3 b/lib/libfido2/man/fido_bio_dev_get_info.3
index 7bc05701ca0..c7551701158 100644
--- a/lib/libfido2/man/fido_bio_dev_get_info.3
+++ b/lib/libfido2/man/fido_bio_dev_get_info.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_BIO_DEV_GET_INFO 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_bio_enroll_new.3 b/lib/libfido2/man/fido_bio_enroll_new.3
index 3b6c7a45043..603421abcdf 100644
--- a/lib/libfido2/man/fido_bio_enroll_new.3
+++ b/lib/libfido2/man/fido_bio_enroll_new.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_BIO_ENROLL_NEW 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_bio_info_new.3 b/lib/libfido2/man/fido_bio_info_new.3
index eef7ec75e42..5712db298f6 100644
--- a/lib/libfido2/man/fido_bio_info_new.3
+++ b/lib/libfido2/man/fido_bio_info_new.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_BIO_INFO_NEW 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_bio_template.3 b/lib/libfido2/man/fido_bio_template.3
index beeb3db4759..c66a1b092d5 100644
--- a/lib/libfido2/man/fido_bio_template.3
+++ b/lib/libfido2/man/fido_bio_template.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_BIO_TEMPLATE 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_cbor_info_new.3 b/lib/libfido2/man/fido_cbor_info_new.3
index 904bbd8cc9f..6f71f9d3ded 100644
--- a/lib/libfido2/man/fido_cbor_info_new.3
+++ b/lib/libfido2/man/fido_cbor_info_new.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 19 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_CBOR_INFO_NEW 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_cred_exclude.3 b/lib/libfido2/man/fido_cred_exclude.3
index 52e2f497ac7..d27c0aabc8b 100644
--- a/lib/libfido2/man/fido_cred_exclude.3
+++ b/lib/libfido2/man/fido_cred_exclude.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_CRED_EXCLUDE 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_cred_new.3 b/lib/libfido2/man/fido_cred_new.3
index 3412f17a9a3..77650ed5d78 100644
--- a/lib/libfido2/man/fido_cred_new.3
+++ b/lib/libfido2/man/fido_cred_new.3
@@ -2,12 +2,13 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_CRED_NEW 3
.Os
.Sh NAME
.Nm fido_cred_new ,
.Nm fido_cred_free ,
+.Nm fido_cred_prot ,
.Nm fido_cred_fmt ,
.Nm fido_cred_authdata_ptr ,
.Nm fido_cred_clientdata_hash_ptr ,
@@ -28,6 +29,8 @@
.Fn fido_cred_new "void"
.Ft void
.Fn fido_cred_free "fido_cred_t **cred_p"
+.Ft int
+.Fn fido_cred_prot "fido_cred_t *cred"
.Ft const char *
.Fn fido_cred_fmt "const fido_cred_t *cred"
.Ft const unsigned char *
@@ -99,6 +102,15 @@ may be NULL, in which case
is a NOP.
.Pp
The
+.Fn fido_cred_prot
+function returns the protection of
+.Fa cred .
+See
+.Xr fido_cred_set_prot 3
+for the values understood by
+.Em libfido2 .
+.Pp
+The
.Fn fido_cred_fmt
function returns a pointer to a NUL-terminated string containing
the format of
diff --git a/lib/libfido2/man/fido_cred_set_authdata.3 b/lib/libfido2/man/fido_cred_set_authdata.3
index 4af4df6428b..6370df9f5a2 100644
--- a/lib/libfido2/man/fido_cred_set_authdata.3
+++ b/lib/libfido2/man/fido_cred_set_authdata.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 19 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_CRED_SET_AUTHDATA 3
.Os
.Sh NAME
@@ -14,6 +14,7 @@
.Nm fido_cred_set_rp ,
.Nm fido_cred_set_user ,
.Nm fido_cred_set_extensions ,
+.Nm fido_cred_set_prot ,
.Nm fido_cred_set_rk ,
.Nm fido_cred_set_uv ,
.Nm fido_cred_set_fmt ,
@@ -45,6 +46,8 @@ typedef enum {
.Ft int
.Fn fido_cred_set_extensions "fido_cred_t *cred" "int flags"
.Ft int
+.Fn fido_cred_set_prot "fido_cred_t *cred" "int prot"
+.Ft int
.Fn fido_cred_set_rk "fido_cred_t *cred" "fido_opt_t rk"
.Ft int
.Fn fido_cred_set_uv "fido_cred_t *cred" "fido_opt_t uv"
@@ -149,7 +152,9 @@ to the bitmask
.Fa flags .
At the moment, only the
.Dv FIDO_EXT_HMAC_SECRET
-extension is supported.
+and
+.Dv FIDO_EXT_CRED_PROTECT
+extensions are supported.
If
.Fa flags
is zero, the extensions of
@@ -157,6 +162,24 @@ is zero, the extensions of
are cleared.
.Pp
The
+.Fn fido_cred_set_prot
+function sets the protection of
+.Fa cred
+to the scalar
+.Fa prot .
+At the moment, only the
+.Dv FIDO_CRED_PROT_UV_OPTIONAL ,
+.Dv FIDO_CRED_PROT_UV_OPTIONAL_WITH_ID ,
+and
+.Dv FIDO_CRED_PROT_UV_REQUIRED
+protections are supported.
+If
+.Fa prot
+is zero, the protection of
+.Fa cred
+is cleared.
+.Pp
+The
.Fn fido_cred_set_rk
and
.Fn fido_cred_set_uv
diff --git a/lib/libfido2/man/fido_cred_verify.3 b/lib/libfido2/man/fido_cred_verify.3
index 261cac6d8cf..f8f794108ae 100644
--- a/lib/libfido2/man/fido_cred_verify.3
+++ b/lib/libfido2/man/fido_cred_verify.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_CRED_VERIFY 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_credman_metadata_new.3 b/lib/libfido2/man/fido_credman_metadata_new.3
index 286584d55d8..09b0bf8a76f 100644
--- a/lib/libfido2/man/fido_credman_metadata_new.3
+++ b/lib/libfido2/man/fido_credman_metadata_new.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_CREDMAN_METADATA_NEW 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_dev_get_assert.3 b/lib/libfido2/man/fido_dev_get_assert.3
index f1c45c23bda..3ea8157c5db 100644
--- a/lib/libfido2/man/fido_dev_get_assert.3
+++ b/lib/libfido2/man/fido_dev_get_assert.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_DEV_GET_ASSERT 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_dev_info_manifest.3 b/lib/libfido2/man/fido_dev_info_manifest.3
index e38cfb70219..a3b95c49cf1 100644
--- a/lib/libfido2/man/fido_dev_info_manifest.3
+++ b/lib/libfido2/man/fido_dev_info_manifest.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 19 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_DEV_INFO_MANIFEST 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_dev_make_cred.3 b/lib/libfido2/man/fido_dev_make_cred.3
index a58a089efca..7e5697108e7 100644
--- a/lib/libfido2/man/fido_dev_make_cred.3
+++ b/lib/libfido2/man/fido_dev_make_cred.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_DEV_MAKE_CRED 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_dev_open.3 b/lib/libfido2/man/fido_dev_open.3
index 3ac53ffb209..fd472ed63ef 100644
--- a/lib/libfido2/man/fido_dev_open.3
+++ b/lib/libfido2/man/fido_dev_open.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 19 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_DEV_OPEN 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_dev_set_io_functions.3 b/lib/libfido2/man/fido_dev_set_io_functions.3
index e6982fbf257..de3b618c25b 100644
--- a/lib/libfido2/man/fido_dev_set_io_functions.3
+++ b/lib/libfido2/man/fido_dev_set_io_functions.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 19 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_DEV_SET_IO_FUNCTIONS 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_dev_set_pin.3 b/lib/libfido2/man/fido_dev_set_pin.3
index bb60f71abbe..a6deddf20bd 100644
--- a/lib/libfido2/man/fido_dev_set_pin.3
+++ b/lib/libfido2/man/fido_dev_set_pin.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 19 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_DEV_SET_PIN 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_init.3 b/lib/libfido2/man/fido_init.3
index 8b862c50f0c..32629d320c7 100644
--- a/lib/libfido2/man/fido_init.3
+++ b/lib/libfido2/man/fido_init.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_INIT 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/fido_strerr.3 b/lib/libfido2/man/fido_strerr.3
index 68f03f6a0d1..fa1919b3a92 100644
--- a/lib/libfido2/man/fido_strerr.3
+++ b/lib/libfido2/man/fido_strerr.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 19 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt FIDO_STRERR 3
.Os
.Sh NAME
diff --git a/lib/libfido2/man/rs256_pk_new.3 b/lib/libfido2/man/rs256_pk_new.3
index e6f2cb1d525..a11e012229d 100644
--- a/lib/libfido2/man/rs256_pk_new.3
+++ b/lib/libfido2/man/rs256_pk_new.3
@@ -2,7 +2,7 @@
.\" Use of this source code is governed by a BSD-style
.\" license that can be found in the LICENSE file.
.\"
-.Dd $Mdocdate: November 27 2019 $
+.Dd $Mdocdate: February 7 2020 $
.Dt RS256_PK_NEW 3
.Os
.Sh NAME