cryptographic data archive; written in C++; an elixir to stay forever
read more
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.
- code extraction and compilation (in directory
build)
$ mkdir -vp build; cd build
$ cmake -GNinja --install-prefix=$(pwd)/../dist -DCMAKE_BUILD_TYPE=Debug ..
$ ninja
- testing (in directory
build)
$ ./tests/cpp/utelykseer-cpp
-
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/stripContributions 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 2018-2025 by Alexander Diemand
This work is licensed under the GNU General Public License v3