aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorJán Jančár2025-07-14 16:30:58 +0200
committerGitHub2025-07-14 16:30:58 +0200
commitba6657f54ed7865145c216ec13160ecf46e07633 (patch)
tree9cc81f1f8cb4ffb46b9e92415ba42ffb9cfa9c4a /README.md
parent07c5efe15e2ca88fe3818c9653a2a425923cb1c0 (diff)
parent1f582350e4c938265e0cb7f2d6369ee08d9ae4a9 (diff)
downloadECTester-ba6657f54ed7865145c216ec13160ecf46e07633.tar.gz
ECTester-ba6657f54ed7865145c216ec13160ecf46e07633.tar.zst
ECTester-ba6657f54ed7865145c216ec13160ecf46e07633.zip
Merge pull request #38 from quapka/build-rest-with-nix
Wrap building applet, reader and common with Nix
Diffstat (limited to 'README.md')
-rw-r--r--README.md32
1 files changed, 26 insertions, 6 deletions
diff --git a/README.md b/README.md
index 5c43f2d..345bb97 100644
--- a/README.md
+++ b/README.md
@@ -341,21 +341,41 @@ nix build "#lib.openssl.v331"
# To build a shim using a given version of a library (example mbedTLS 3.5):
nix build "#shim.mbedtls.v35"
# To build ECTesterStandalone.jar with a given version of a library (example libgcrypt 1.9.4):
-nix build "?submodules=1#gcrypt.v194"
+nix build ".?submodules=1#gcrypt.v194"
# The available versions of the libraries are in the nix/*_pkg_versions.json files.
# The "default" version always points to the most recent version.
# To build ECTesterStandalone with all the libraries in default versions:
-nix build "?submodules=1#"
+nix build ".?submodules=1#"
```
-Each of the build steps above puts (symlinks really) its results into `./result` directory.
-However, subsequent builds then replace that with their own results. To run ECTesterStandalone
-with a given library version and arguments do:
+Each of the build steps above puts (symlinks really) its results into `./result` directory (use `-o/--out-link {path}`
+to change that directory). However, subsequent builds then replace that with their own results. To run
+ECTesterStandalone with a given library version and arguments do:
```shell
# This runs the default test-suite agains LibreSSL 3.9.2
-nix run "?submodules=1#libressl.v392" -- test default LibreSSL
+nix run ".?submodules=1#libressl.v392" -- test default LibreSSL
+```
+
+To build the JavaCard applets:
+```shell
+nix build ".?submodules=1#applets"
+# or individually
+nix build ".?submodules=1#applet222"
+nix build ".?submodules=1#applet305"
+nix build ".?submodules=1#applet320"
+```
+
+To build or run the reader you can:
+```shell
+nix build '.?submodules=1#reader'
+nix run '.?submodules=1#reader'
+```
+
+If needed, you can also build the `common` library:
+```shell
+nix build '.?submodules=1#common'
```
#### Gradle