Skip to content

Mrdolls/forbCheck

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

229 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ForbCheck

Version Platform

ForbCheck is a powerful security and audit utility for C/C++ projects. It ensures codebase integrity by detecting unauthorized function calls through three specialized analysis modes.


Installation

To install or update ForbCheck, run the following command in your terminal:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/Mrdolls/forb/refs/heads/main/install.sh)"

The Three Core Pillars

1. Binary Scan (NM-Based)

The default mode. It analyzes symbols extracted directly from your compiled binaries. This is the most reliable way to verify what is actually included in the final executable.

  • Instant execution speed.
  • Ideal for quick checks after compilation.
  • Detects dynamically linked libraries.

binary-ezgif com-crop

2. Source Scan (-s)

This mode scans your source code (.c, .cpp, .h) directly. Essential for surgical audits during the development phase or when binaries are not yet available.

  • Pinpoint accuracy (filename and line number).
  • Smart stripping of comments and strings to eliminate false positives.
  • Recursive scanning across all project directories.

source-ezgif com-crop

3. Interactive Analysis Dashboard (-A)

New in v1.16.0. A high-performance Interactive TUI that maps your entire project structure.

  • Classification: Automatically separates internal project functions from external system calls.
  • Deep Macro Scan: Recursive analysis of #define to find hidden calls and Header Guards.
  • Navigation: Fluid Cyan/Green interface to explore symbols and their call contexts.

analyse


Quick Start

Step 1: Standard Binary Scan

Analyze your compiled binary against the authorized function list.

forb

Step 2: Deep Source Audit

Scan your .c files directly to find forbidden functions with exact line numbers.

forb -s

Step 3: Architecture Exploration

Open the interactive dashboard to visualize your project's function and macro mapping.

forb -A

Documentation & Configuration

For advanced settings, custom presets, and CI/CD integration, check our detailed guides:


Created by Mrdolls — 2026

About

A robust Bash CLI tool to analyze C binaries and source code for forbidden function usage. Built for 42-school projects, featuring deep scanning, custom presets, JSON/HTML reports, and CI/CD support.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors