63 lines
2.6 KiB
Markdown
63 lines
2.6 KiB
Markdown
# evbunpack (bundled tool)
|
|
|
|
`evbunpack.exe` is a bundled, third-party unpacker used by the **Evb** engine module to
|
|
unpack applications protected with **Enigma Virtual Box**.
|
|
|
|
## Provenance
|
|
|
|
- Upstream project: https://github.com/mos9527/evbunpack
|
|
- Description: Enigma Virtual Box Unpacker / 解包・脱壳工具
|
|
- License: Apache-2.0 (see `LICENSE` in this folder for the full text)
|
|
- Repository status: **archived (read-only) by the owner on 2026-02-06**
|
|
- Version / release: bundled from the upstream Windows builds
|
|
(see the "For Windows Users: Builds are available here" link in the upstream README,
|
|
which points to the project's GitHub Releases page).
|
|
|
|
> **NOTE**: The binary in this folder is not committed as part of the normal source
|
|
> tree review flow. Place the upstream-release `evbunpack.exe` here before publishing.
|
|
> If the file is absent, the `Evb` engine module reports the tool as unavailable and
|
|
> skips unpacking instead of throwing (callers degrade gracefully).
|
|
|
|
## CLI usage
|
|
|
|
```
|
|
evbunpack [-h] [--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [-l]
|
|
[--ignore-fs] [--ignore-pe] [--legacy-fs]
|
|
[-pe {10_70,9_70,7_80}] [--out-pe OUT_PE]
|
|
file output
|
|
```
|
|
|
|
- `file` : the packed `.exe` (input)
|
|
- `output` : the folder that receives the unpacked files (created if missing)
|
|
|
|
The tool restores **both** the virtual file system contents **and** the original PE
|
|
executable, in a single invocation.
|
|
|
|
### PE variant selection
|
|
|
|
| Packer version | Unpack with flags |
|
|
|----------------|------------------------------|
|
|
| 11.00 | `-pe 10_70` |
|
|
| 10.70 | `-pe 10_70` |
|
|
| 9.70 | `-pe 9_70` |
|
|
| 7.80 | `-pe 7_80 --legacy-fs` |
|
|
|
|
`EvbUnpackerToolProvider.BuildArguments` defaults to `-pe 9_70` and can be overridden
|
|
per call.
|
|
|
|
## Alternatives (when re-bundling is not possible)
|
|
|
|
- Install via PyPI: `pip install evbunpack` and run `python -m evbunpack ...`
|
|
(requires a Python runtime on the target machine).
|
|
- Build from source with `setup.py` / `pyinstaller` following the upstream README.
|
|
|
|
## Where it is used
|
|
|
|
- `Engines/Evb/EvbUnpackerToolProvider.cs` — resolves the executable and builds CLI arguments.
|
|
- `Engines/Evb/EvbUnpackService.cs` — orchestrates detection, unpacking and re-detection.
|
|
|
|
Resolution order (see `EvbUnpackerToolProvider.GetToolPath`):
|
|
1. `Engines/Evb/Tools/evbunpack/evbunpack.exe` (bundled layout, this folder)
|
|
2. `Engines/Evb/Tools/evbunpack.exe` (flat layout)
|
|
3. `AppPathHelper.ResolveEngineTool("Evb", "evbunpack/evbunpack.exe")` fallback probe.
|