There are 3 tests available:
- KEM test - performance of a CRYSTALS-Kyber example
- usage: ./01_test_KEM
- OPRF test - performance of an OPRF procedure example
- usage: ./02_test_OPRF
- PQ-BRAKE test - performance of the PQ-BRAKE protocol, enrolling a fingerprint and queries another; if successful, a shared secret is established
- usage: (sudo) ./03_test_PQBRAKE path_to_reference_fingerprint.pgm path_to_query_fingerprint.pgm
- root privileges are needed in order to write the full performance numbers to the logfile, program can be run as a normal user but no logs will be made and only a shortened version of the performance numbers will be printed to console
- Hint: if the fingerprint images used for testing are in a non-.pgm format, a simple way to convert them is to use the imagemagick package in Linux:
magick mogrify -format pgm <fingerprint_image.bmp>
- The PQ-BRAKE test will only work correctly on systems that include the AVX2 instruction set.
To install the program:
- Clone the repository
- Run the installation script script as root (see requirements section below)
- executables are created in the build/ folder (same with test logs) if the installation fails for any reason, a precompiled version of the test executables is provided in the precompiled folder
- libssl-dev
- cmake
- astyle
- gcc
- ninja-build
- unzip
- xsltproc
- valgrind
- libgmp-dev (GNU mp Bignum)
- m4