Command-Line Interface (CLI) Reference
The DodaZIP CLI (dodazip) is a standalone, memory-safe command-line tool designed for system administrators, DevOps engineers, and power users. Built in Rust with zero dynamic dependencies, it provides automated batch archiving, deduplication, hardware-grade encryption, Reed-Solomon self-healing parity, archive verification, and DoD-grade permanent file shredding.
It operates with high efficiency in headless environments, server automation scripts, and automated CI/CD pipelines, supporting both long flags and standard single-letter aliases.

๐ Quick Reference & Command Aliases
DodaZIP supports both descriptive subcommands and single-letter short aliases (similar to tar or 7z):
| Full Command | Short Aliases | Description |
|---|---|---|
compress | c, a, add | Create .dzip vaults or foreign archives (.zip, .7z, .tar.gz, etc.) |
sfx | -- | Package files into a standalone self-extracting Windows executable (.exe) |
extract | x, e | Extract archive contents with automatic integrity verification |
list | l, ls | Inspect archive table of contents without decompressing |
test | t, v, verify | Cryptographically verify BLAKE3 chunk hashes and Reed-Solomon parity |
shred | s, rm | Permanently sanitize and wipe files using 3-Pass DoD 5220.22-M |
bench | b | Run real-time multi-threaded CPU and compression benchmark |
# Display global help and command list
dodazip --help
# Display help and options for a specific subcommand
dodazip compress --help
dodazip extract --help
dodazip test --help๐ฆ compress (Create Archives)
Create a compressed archive or encrypted .dzip vault from files or directories.
Syntax
dodazip compress -o <OUTPUT> [OPTIONS] [INPUTS]...
# Or using the short alias:
dodazip c -o <OUTPUT> [OPTIONS] [INPUTS]...Options & Flags
| Flag | Type | Default | Description |
|---|---|---|---|
-o, --output <PATH> | File path | Required | Path to the output archive (.dzip, .zip, .7z, .tar.gz, etc.) |
-i, --input <PATH> | Path(s) | Optional | Input file(s) or folder(s). Can also be supplied as positional arguments. |
-l, --level <LEVEL> | Enum | balanced | Compression level: fast, balanced, or maximum. |
-c, --codec <CODEC> | Enum | zstd | Compression algorithm: zstd, lz4, lzma2, or store (uncompressed). |
--dedup | Flag | true | Enable FastCDC content-defined chunk deduplication (default). |
--no-dedup | Flag | false | Disable chunk deduplication (useful for pre-compressed streams or media). |
--password <PASS> | String | Optional | Master encryption password (Argon2id + XChaCha20-Poly1305). |
--password-stdin | Flag | false | Read password interactively from terminal standard input without shell echo. |
--ecc <LEVEL> | Enum | none | Add Reed-Solomon forward error correction: low (2 shards), medium (4 shards), or high (8 shards). |
Examples: compress
1. Basic Archiving
Compress a directory using balanced Zstandard compression and FastCDC deduplication:
dodazip compress -o backup.dzip ./my-project/
# Or using the short alias:
dodazip c -o backup.dzip ./my-project/2. Maximum Ratio Archiving (LZMA2)
For archiving source code repositories, log sets, or text documents with the smallest possible file footprint:
dodazip compress -o archive.dzip --codec lzma2 --level maximum ./source-code/3. Ultra-Fast High-Throughput Archiving (LZ4)
For streaming backups or real-time pipeline archival where CPU speed is critical:
dodazip compress -o stream.dzip --codec lz4 --level fast ./data-pipeline/4. Encrypted Vault Creation (Argon2id + XChaCha20-Poly1305)
Create an encrypted vault where both data chunks and file metadata (filenames, directory structure, timestamps) are sealed:
# Passing password via flag:
dodazip compress -o financial_vault.dzip --password "CorrectHorseBatteryStaple!" ./finances/
# Passing password securely via terminal prompt (no shell history exposure):
dodazip compress -o financial_vault.dzip --password-stdin ./finances/
# Using the DODAZIP_PASSWORD environment variable:
$env:DODAZIP_PASSWORD = "CorrectHorseBatteryStaple!"
dodazip compress -o financial_vault.dzip ./finances/5. Self-Healing Enterprise Backups (Reed-Solomon ECC)
Add mathematical parity matrices to protect against silent bit rot, damaged drive sectors, or network transmission packet loss:
# Add High parity (8 Reed-Solomon recovery shards per chunk block)
dodazip compress -o cold-storage.dzip --ecc high ./mission-critical/6. Disabling Chunk Deduplication
If archiving multimedia files (already compressed JPEGs, MP4s) where chunk indexing is unnecessary:
dodazip compress -o media.dzip --no-dedup ./video-recordings/7. Packaging Foreign Formats (.zip, .7z, .tar.gz)
DodaZIP automatically detects the requested file extension and invokes the appropriate format engine:
# Standard ZIP for cross-platform clients:
dodazip compress -o package.zip ./distribution/
# 7-Zip LZMA archive:
dodazip compress -o release.7z ./build/
# Linux TAR gzip archive:
dodazip compress -o source.tar.gz ./src/๐ sfx (Create Self-Extracting Executables)
Package files or folders into a standalone Windows executable (.exe) embedding a native, zero-dependency Win32 extraction stub. Recipients can unpack the archive without needing any software installed. For full architectural details, see Self-Extracting SFX Archives.
Syntax
dodazip sfx -o <OUTPUT.exe> [OPTIONS] [INPUTS]...Options
| Flag | Short | Default | Description |
|---|---|---|---|
--output <FILE> | -o | (Required) | Destination executable path (auto-appends .exe) |
--level <LEVEL> | -l | balanced | Compression level: fast, balanced, or max |
Examples
1. Create a Standalone SFX Package
# Package distribution directory into a standalone executable
dodazip sfx -o ReleasePackage.exe ./distribution/2. Extracting the Generated SFX Executable on Target Machines
Recipients can double-click ReleasePackage.exe to open the native GUI, or run it via terminal with silent switches:
# Interactive GUI extraction dialog
.\ReleasePackage.exe
# Silent extraction to default folder (unattended/script mode)
.\ReleasePackage.exe -y
# Silent extraction to a specific target directory
.\ReleasePackage.exe -y -o="C:\Deploy\App"๐ extract (Decompress & Restore)
Extract files from any supported archive format to a destination folder.
Syntax
dodazip extract [OPTIONS] <ARCHIVE>
# Or using the short alias:
dodazip x [OPTIONS] <ARCHIVE>Options & Flags
| Flag | Type | Default | Description |
|---|---|---|---|
-o, --output <DIR> | Directory | . (current) | Destination directory for extracted contents. Created automatically if missing. |
--password <PASS> | String | Optional | Decryption password for password-protected archives. |
--password-stdin | Flag | false | Prompt for password on standard input without echo. |
Examples: extract
1. Extract to Specific Directory
dodazip extract -o ./restored_data/ backup.dzip
# Or using short alias:
dodazip x -o ./restored_data/ backup.dzip2. Extract Encrypted Vault
# Interactive password prompt:
dodazip extract -o ./decrypted/ --password-stdin confidential.dzip
# Inline password:
dodazip extract -o ./decrypted/ --password "VaultSecret123" confidential.dzip3. Extract Foreign Archives
Extract .zip, .7z, .rar, .tar.gz, .tar.bz2, or .tar.xz seamlessly without external dependencies:
dodazip x -o ./extracted_vendor/ vendor_assets.rar
dodazip x -o ./dist/ app_release.7z
dodazip x -o ./src/ kernel.tar.xz๐ list (Inspect Contents)
Inspect file paths, uncompressed file sizes, and directory hierarchies without unpacking the archive to disk.
Syntax
dodazip list [OPTIONS] <ARCHIVE>
# Or using short aliases:
dodazip l <ARCHIVE>
dodazip ls <ARCHIVE>Examples: list
dodazip list backup.dzip
dodazip l release.zip
dodazip l client-package.7zSample Output:
Archive: "backup.dzip" (dzip)
Archive contents:
62 file1.txt
1644 file2.txt
1644 sub\file2_duplicate.txt
65536 sub\random.bin
Summary:
Total files: 4
Total size: 68886 bytes๐ test / verify (Cryptographic Integrity Audit)
Verify 100% cryptographic data integrity and Reed-Solomon parity health without writing any files to disk.
Syntax
dodazip test [OPTIONS] <ARCHIVE>
# Or using short aliases:
dodazip t <ARCHIVE>
dodazip v <ARCHIVE>
dodazip verify <ARCHIVE>What It Audits:
- Container Header & Salt: Validates container magic bytes and crypto headers.
- BLAKE3 Cryptographic Hashes: Calculates tree hashes for every chunk block and compares them against index fingerprints.
- AEAD Authentication Tags: Verifies XChaCha20-Poly1305 MAC tags to ensure zero bit tampering.
- Reed-Solomon Parity: Verifies that error-correction parity blocks match data shards.
Example: test
dodazip test backup.dzip
# Or:
dodazip v backup.dzipSample Output:
Testing archive integrity: "backup.dzip" (dzip)
Verifying 4 entries with BLAKE3 checksums & parity...
โ [1/4] file1.txt (62 bytes)
โ [2/4] file2.txt (1644 bytes)
โ [3/4] sub\file2_duplicate.txt (1644 bytes)
โ [4/4] sub\random.bin (65536 bytes)
=== Verification Succeeded: All files 100% intact (3.42ms) ===๐งน shred (Permanent DoD 5220.22-M Sanitization)
Permanently and irrevocably destroy confidential files or directory structures so that forensic data recovery tools cannot salvage any plaintext remnants.
Overwrite Protocol:
- Pass 1: Physical overwrite of all sectors with binary zeros (
0x00). - Pass 2: Physical overwrite of all sectors with binary ones (
0xFF). - Pass 3: Physical overwrite of all sectors with cryptographically secure pseudo-random bytes from the OS CSPRNG.
- Metadata Scramble: Renames file record in the Master File Table (MFT) to random alphanumeric characters, truncates file length to 0 bytes, flushes hardware write caches, and unlinks the node.
Syntax
dodazip shred [OPTIONS] <PATHS>...
# Or using short aliases:
dodazip s <PATHS>...
dodazip rm <PATHS>...Examples: shred
# Permanently sanitize a single sensitive file:
dodazip shred ./secret_keys.pem
# Permanently sanitize multiple files and subdirectories:
dodazip shred ./financial_2025.xlsx ./private_tokens/Caution
Shredded data is mathematically and physically impossible to recover. Do not use this command on files you ever intend to restore.
โก bench (Hardware & Compression Benchmark)
Measure multi-threaded compression throughput, decompression speeds, and space-saving ratios directly on your machine’s CPU.
Syntax
dodazip bench [FILE]
# Or using short alias:
dodazip bExamples: bench
# Run benchmark on synthetic 10 MB multi-pattern buffer:
dodazip bench
# Run benchmark using a specific large file on disk:
dodazip bench ./large_dataset.isoSample Output:
Running benchmarks with 10485760 bytes of test data...
=== Compression Benchmark ===
Data size: 10485760 bytes
Fast (Zstd):
Compressed: 279712 bytes
Ratio: 37.49x
Space saving: 97.3%
Compress time: 27.48ms
Decompress time: 36.98ms
Balanced (Zstd):
Compressed: 1146 bytes
Ratio: 9149.88x
Space saving: 100.0%
Compress time: 48.24ms
Decompress time: 27.20ms
Maximum (Zstd):
Compressed: 1061 bytes
Ratio: 9882.90x
Space saving: 100.0%
Compress time: 631.80ms
Decompress time: 23.29ms๐ค Automated Scripting & CI/CD Pipelines
Because DodaZIP exits with standard Unix status codes (0 for success, 1 for error), it integrates smoothly into scheduled tasks, backup scripts, and CI/CD pipelines.
PowerShell Nightly Backup Script
# Nightly automated server backup script
$date = Get-Date -Format "yyyy-MM-dd"
$sourceDir = "C:\inetpub\wwwroot"
$backupFile = "D:\Backups\site_backup_$date.dzip"
# Create deduplicated, self-healing archive with encryption
$env:DODAZIP_PASSWORD = (Get-Content "C:\Secrets\backup_key.txt")
dodazip.exe compress -o $backupFile -l balanced --ecc medium $sourceDir
# Verify archive integrity immediately
dodazip.exe test $backupFile
if ($LASTEXITCODE -eq 0) {
Write-Host "Backup verified successfully!" -ForegroundColor Green
} else {
Write-Error "Backup integrity verification FAILED!"
}GitHub Actions Workflow Step
name: Release Packaging
on: [push]
jobs:
package:
runs-on: windows-latest
steps:
- uses: actions/checkout@v4
- name: Build and Package with DodaZip
run: |
dodazip compress -o release.dzip --codec zstd --level maximum ./dist/
dodazip test release.dzip
- name: Upload Artifact
uses: actions/upload-artifact@v4
with:
name: release-vault
path: release.dzip