resq-bin — Binary & Machine-Code Analyzer

Robust interactive binary analyzer for ResQ services. Provides deep visibility into ELF/object files, disassembly using Capstone and objdump, and a performant caching system for large-scale analysis.

Build

# Build from workspace root
cargo build --release -p resq-bin

Binary: target/release/resq-bin

Usage

# Interactive TUI for a single file (default)
resq-bin --file target/release/resq

# Analyze all binaries in a directory recursively
resq-bin --dir target/release --recursive

# Emit JSON report (for CI/tooling)
resq-bin --file my-service --json

# Emit human-readable plain text report
resq-bin --file my-service --plain

Features

• Multi-format Support: Analyzes ELF, Mach-O, and PE files via the object crate.
• Interactive TUI: Visual exploration of sections, symbols, and disassembled functions.
• Disassembly Backends: Uses Capstone for high-quality instruction decoding, with fallback to objdump if needed.
• Smart Caching: Persistent analysis cache in .cache/resq/bin-explorer to avoid redundant heavy disassembly on unchanged files.
• Section & Symbol Analysis: detailed breakdown of binary layout, memory addresses, and entry points.

TUI Layout

┌─ resq-bin ────────────────────────────────────────────────────────┐
│ file: target/release/resq [ELF64 x86_64]                           │
├────────────────────────────────────────────────────────────────────┤
│ SECTIONS             SYMBOLS                DISASSEMBLY            │
│ .text  [0x1000]      main    [0x1050]       push rbp               │
│ .data  [0x2000]      _start  [0x1020]       mov  rbp, rsp          │
│ .rodata[0x1500]      ...                    sub  rsp, 0x10         │
├────────────────────────────────────────────────────────────────────┤
│ [q] quit   [Tab] focus   [↑↓] select   [/] search   [Enter] detail │
└────────────────────────────────────────────────────────────────────┘

Keyboard Shortcuts

Flags