Skip to content

About

eLyKseeR basis in C++

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

eLyKseeR

eLyKseeR

cryptographic data archive; written in C++; an elixir to stay forever

read more

Compilation of project with submodules and verification by unit tests

archive format

Since version 5.0.0 the archive format follows the formal specification in elykseer-ml 0.10.1 (doc/08_Format.md): assemblies are encrypted with AES-256-GCM (the aid is authenticated), chunk identifiers, data layout and file hashes are the same, and the meta data is written as XML following the schemas schema/keys.xsd (LXRbackup-*-dbks.xml) and schema/fileinformation.xsd (LXRbackup-*-files.xml). The chunks written for an assembly are byte-identical to those of elykseer-ml (tests/cpp/utConformance.cpp, vectors generated with tests/conformance/generate.sh), and archives written by elykseer-ml are restored by LXRrestore from its XML export (tests/conformance/check-elykseer-ml.sh, runs both checks in the elykseer-ml docker image).

Archives written by elykseer-cpp 4.x cannot be read by 5.x; restore them with a 4.x release.

Security notice for archives written by 4.x and earlier: their keys, ivecs and assembly identifiers came from a std::mt19937 seeded with a single 32-bit value, so an attacker who holds the chunks can recover the keys by trying all 2³² seeds; the cipher was also not authenticated. Treat the content of such archives as readable by anyone who has access to the chunk files: restore them with a 4.x release, back the data up again with 5.x, and delete the old chunks. Since 5.0.0, all key material comes from the system CSPRNG (elykseer-crypto Random::fill: OpenSSL RAND_bytes or Crypto++ OS_GenerateRandomBlock).

LXRrestore and LXRverify check the checksum of every block and exit with status 1 if a file cannot be restored completely; partially restored files are removed.

building

  1. code extraction and compilation (in directory build)

$ mkdir -vp build; cd build

$ cmake -GNinja --install-prefix=$(pwd)/../dist -DCMAKE_BUILD_TYPE=Debug ..

$ ninja

  1. testing (in directory build)

$ ./tests/cpp/utelykseer-cpp

cross compilation

  • build Docker image 'xcompile'

    • docker build -t xcompile .
  • launch Docker image 'xcompile'

    • docker run -it --rm --user=$(id -u):$(id -g) -v .:/work xcompile
export PATH=${HOME}/.local/bin:${PATH}
cd build
cmake --fresh -DCMAKE_TOOLCHAIN_FILE=../support/Toolchain_Darwin_to_Windows.cmake --install-prefix=$(pwd)/../dist -DCMAKE_BUILD_TYPE=Release -GNinja ..
ninja && ninja install/strip

contributing

Contributions are welcome! Before submitting your first pull request, please review our Contributor License Agreement (CLA). The CLA allows us to maintain eLyKseeR under a dual-licensing model (GPLv3 for open source use, with commercial licenses available for proprietary applications). It is the same for all eLyKseeR repositories. See CONTRIBUTING.md for how to sign.

copyright

Copyright 2018-2025 by Alexander Diemand

license

This work is licensed under the GNU General Public License v3

About

eLyKseeR basis in C++

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages