Home

BinaryInspector Wiki

BinaryInspector is a safe, local Rust CLI and native desktop application for inspecting ELF binaries. It never executes, loads, or dynamically links its target and performs no runtime network I/O.

• Language: Rust 1.98.1+ (edition 2021), zero unsafe
• Platforms: Linux, macOS, Windows
• License: MIT
• Repository: https://github.com/bisug/BinaryInspector

Capabilities at a glance

Area	What you get
ELF identity	ELF32/ELF64 class, endianness, type, machine, OS ABI, entry point
Structure	Section table and program segment table with sizes, flags, entropy
Dynamic linking	Interpreter (PT_INTERP), DT_NEEDED, RPATH, RUNPATH, binding mode
Symbols	.symtab and .dynsym with type, binding, visibility, import/export role
Security	checksec: RELRO, NX, PIE, stack canary, fortify, RWX segments, insecure RPATH
Notes & relocations	GNU Build ID, ABI tags, GNU property flags, SHT_REL/SHT_RELA entries
Output	Human-readable text with --json for machine-readable reports
GUI	Native desktop app with file picker, drag-and-drop, and virtualized tables

Documentation

• Getting started
  • Installation — installer, pre-built binaries, building from source
  • Command-Line-Reference — every flag, category selection, output behavior
  • GUI-Guide — the desktop application
• Reference
  • Security-Checks — what each hardening check inspects and its evidence
  • JSON-Schema — the --json document, schema version 1
  • Exit-Codes-and-Errors — exit code table and failure categories
  • Safety-Model — why parsing a hostile file is safe here
• Development
  • Architecture — module map and data flow
  • Building-from-Source — toolchain, builds, release profiles
  • Fuzzing-and-Testing — test strategy and cargo-fuzz targets
  • Contributing — rules of the road
• Project
  • Roadmap — shipped phases and planned work
  • FAQ — common questions

Quick start

# Install (Linux & macOS)
curl -fsSL https://raw.githubusercontent.com/bisug/BinaryInspector/main/install.sh | bash

# Inspect a binary
binary-inspector /bin/ls

# Security report only
binary-inspector /bin/ls -m

# Machine-readable JSON
binary-inspector /bin/ls --json