diff --git a/bin/archive.md b/bin/archive.md new file mode 100644 index 00000000..8c72809a --- /dev/null +++ b/bin/archive.md @@ -0,0 +1,31 @@ +# Naming Convention + + - `results.{ISA}.{OS}.tar.xz`: original binaries (`.elf`) + test results (`.elf.errno`, `elf.func`). For example: `results.x86_64.ubuntu20.tar.xz`. + + - `results.{ISA}.{OS}.{TOOL}.tar.xz`: binaries transformed by `TOOL` + test results (`.rewritten`, `.rewritten.errno`, etc). For example: `results.x86_64.ubuntu20.ddisasm.tar.xz`. + + These are symlinks to the latest actual archives (which have dates in their names). For example: +``` +results.x86_64.ubuntu20.tar.xz -> results.x86_64.ubuntu20.2022-12-17.tar.xz +``` + +# Unpacking + +To unpack the latest binaries go to "lifter-eval" repository root and run: +``` +tar -xvf /u4/TARBALLS/lifter-eval/results.x86_64.ubuntu20.tar.xz +``` + +To unpack the latest results for a particular tool: +``` +tar -xvf /u4/TARBALLS/lifter-eval/results.x86_64.ubuntu20.ddisasm.tar.xz +``` + +# Archiving + +Use `bin/archive.py` script from "lifter-eval" repo: +``` +bin/archive.py --isa x86_64 --os ubuntu20 -- [TOOL] +``` + +If `TOOL` is not specified then original binaries will be archived.