Skip to content
Command-Line Interface (CLI) Reference

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.

DodaZip CLI
Standalone CLI Suite — Production-ready for automated backups, unattended batch scripts, and server maintenance.

๐Ÿš€ Quick Reference & Command Aliases

DodaZIP supports both descriptive subcommands and single-letter short aliases (similar to tar or 7z):

Full CommandShort AliasesDescription
compressc, a, addCreate .dzip vaults or foreign archives (.zip, .7z, .tar.gz, etc.)
sfx--Package files into a standalone self-extracting Windows executable (.exe)
extractx, eExtract archive contents with automatic integrity verification
listl, lsInspect archive table of contents without decompressing
testt, v, verifyCryptographically verify BLAKE3 chunk hashes and Reed-Solomon parity
shreds, rmPermanently sanitize and wipe files using 3-Pass DoD 5220.22-M
benchbRun 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

FlagTypeDefaultDescription
-o, --output <PATH>File pathRequiredPath to the output archive (.dzip, .zip, .7z, .tar.gz, etc.)
-i, --input <PATH>Path(s)OptionalInput file(s) or folder(s). Can also be supplied as positional arguments.
-l, --level <LEVEL>EnumbalancedCompression level: fast, balanced, or maximum.
-c, --codec <CODEC>EnumzstdCompression algorithm: zstd, lz4, lzma2, or store (uncompressed).
--dedupFlagtrueEnable FastCDC content-defined chunk deduplication (default).
--no-dedupFlagfalseDisable chunk deduplication (useful for pre-compressed streams or media).
--password <PASS>StringOptionalMaster encryption password (Argon2id + XChaCha20-Poly1305).
--password-stdinFlagfalseRead password interactively from terminal standard input without shell echo.
--ecc <LEVEL>EnumnoneAdd 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

FlagShortDefaultDescription
--output <FILE>-o(Required)Destination executable path (auto-appends .exe)
--level <LEVEL>-lbalancedCompression 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

FlagTypeDefaultDescription
-o, --output <DIR>Directory. (current)Destination directory for extracted contents. Created automatically if missing.
--password <PASS>StringOptionalDecryption password for password-protected archives.
--password-stdinFlagfalsePrompt 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.dzip

2. Extract Encrypted Vault

# Interactive password prompt:
dodazip extract -o ./decrypted/ --password-stdin confidential.dzip

# Inline password:
dodazip extract -o ./decrypted/ --password "VaultSecret123" confidential.dzip

3. 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.7z

Sample 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:

  1. Container Header & Salt: Validates container magic bytes and crypto headers.
  2. BLAKE3 Cryptographic Hashes: Calculates tree hashes for every chunk block and compares them against index fingerprints.
  3. AEAD Authentication Tags: Verifies XChaCha20-Poly1305 MAC tags to ensure zero bit tampering.
  4. Reed-Solomon Parity: Verifies that error-correction parity blocks match data shards.

Example: test

dodazip test backup.dzip
# Or:
dodazip v backup.dzip

Sample 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:

  1. Pass 1: Physical overwrite of all sectors with binary zeros (0x00).
  2. Pass 2: Physical overwrite of all sectors with binary ones (0xFF).
  3. Pass 3: Physical overwrite of all sectors with cryptographically secure pseudo-random bytes from the OS CSPRNG.
  4. 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 b

Examples: 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.iso

Sample 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
Stay Updated

Subscribe to Our Newsletter

Product updates, security tips, and release announcements delivered directly to your inbox.

No spam. Unsubscribe anytime.