aboutsummaryrefslogtreecommitdiff
path: root/lib/Utils.Cryptography/monocypher/readme.md
diff options
context:
space:
mode:
Diffstat (limited to 'lib/Utils.Cryptography/monocypher/readme.md')
-rw-r--r--lib/Utils.Cryptography/monocypher/readme.md30
1 files changed, 25 insertions, 5 deletions
diff --git a/lib/Utils.Cryptography/monocypher/readme.md b/lib/Utils.Cryptography/monocypher/readme.md
index 940c95f..7c73d80 100644
--- a/lib/Utils.Cryptography/monocypher/readme.md
+++ b/lib/Utils.Cryptography/monocypher/readme.md
@@ -1,11 +1,12 @@
-# VNLib.Utils.Cryptography
-Contains vendored packages that are (optionally)used with VNLib applications such as Argon2 and MonoCypher, as well as build files for compiling the projects cross-platform using CMake and Taskfile.dev.
+# vnlib_monocypher
+A native shared/dynamic library for transforming exporting Monocypher library functions for use with my .NET managed libraries. A vendored version of Monocypher is included in this directory, that I maintain.
-Pre-build Windows binaries are available on my website (link below).
+
+Pre-built Windows binaries are available on my website (link below).
Source code blobs are also packaged and ready for building. See the docs link below for building instructions.
## Builds
-Debug build w/ symbols & xml docs, release builds, NuGet packages, and individually packaged source code are available on my website (link below). All tar-gzip (.tgz) files will have an associated checksum and PGP signature of the desired download file.
+C libraries are packaged in source code (to compile locally) or Windows amd64 dll binaries and individually packaged source code are available on my website (link below). All tar-gzip (.tgz) files will have an associated checksum and PGP signature of the desired download file.
## Docs and Guides
Documentation, specifications, and setup guides are available on my website.
@@ -14,4 +15,23 @@ Documentation, specifications, and setup guides are available on my website.
[Builds and Source](https://www.vaughnnugent.com/resources/software/modules/VNLib.Core)
## License
-Code is individually licensed. See the `LICENSE` file in each subdirectory for more information. \ No newline at end of file
+Code is individually licensed. See the `LICENSE` file in each subdirectory for more information.
+
+## Notes
+
+### Building from source
+> This guide may become out-of-date, use the docs link above for the most recent information.
+
+This project uses the [CMake](https://cmake.org) build system for cross-platform compilation. My CMakelist.txt might not be perfect for your platform, so feel free to make a new issue or send me an email if you run into problems compiling on your platform.
+
+Download the package [source code src.tgz](https://www.vaughnnugent.com/resources/software/modules/VNLib.Core?p=vnlib_monocypher) archive from my builds page.
+
+```bash
+tar -xzf src.tgz
+cmake -B./build/ -DCMAKE_BUILD_TYPE=Release
+cmake --build ./build/ --config Release
+```
+
+On **Windows**, you should navigate to build/Release to see your `vnlib_monocypher.dll` file.
+
+On **Linux**, you should navigate to build/ to see your `libvn_monocypher.so` file. \ No newline at end of file