aboutsummaryrefslogtreecommitdiff
path: root/nitrocli/README.md
diff options
context:
space:
mode:
authorRobin Krahl <robin.krahl@ireas.org>2019-01-13 13:51:23 +0100
committerDaniel Mueller <deso@posteo.net>2019-01-26 23:08:47 -0800
commit321dd4b4986aa7e5eba8057b4ce887dced5d24c7 (patch)
tree0b898f13adc13fde8a34ada50ec892d82e31a3c1 /nitrocli/README.md
parent541819637e0bec0b58b32ed0721d51610a8a7d3b (diff)
downloadnitrocli-321dd4b4986aa7e5eba8057b4ce887dced5d24c7.tar.gz
nitrocli-321dd4b4986aa7e5eba8057b4ce887dced5d24c7.tar.bz2
Document known problems on macOS
This change adds a new section briefly elaborating on the problem of using the program on macOS and details a possible solution.
Diffstat (limited to 'nitrocli/README.md')
-rw-r--r--nitrocli/README.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/nitrocli/README.md b/nitrocli/README.md
index 7102bdf..51db5c0 100644
--- a/nitrocli/README.md
+++ b/nitrocli/README.md
@@ -106,6 +106,13 @@ $ cargo build --release
It is recommended that the resulting executable be installed in a
directory accessible via the `PATH` environment variable.
+#### Known Problems
+
+Due to a problem with the default `hidapi` version on macOS, users are advised
+to build and install [`libnitrokey`][] from source and then set the
+`USE_SYSTEM_LIBNITROKEY` environment variable when building `nitrocli` using
+one of the methods described above.
+
Contributing
------------
@@ -133,6 +140,7 @@ See the [LICENSE](LICENSE) file that accompanies this distribution for
the full text of the license.
+[`libnitrokey`]: https://github.com/nitrokey/libnitrokey
[nitrokey-ug]: https://www.nitrokey.com
[nitrokey-pro]: https://shop.nitrokey.com/shop/product/nitrokey-pro-2-3
[nitrokey-storage]: https://shop.nitrokey.com/shop/product/nitrokey-storage-2-16gb-23