johnthagen/min-sized-rust
Min Sized Rust
This project is a collection of techniques and configurations for reducing the disk footprint of compiled Rust executables. It serves as a guide and toolset for binary size optimization, providing strategies to minimize the final executable size through compiler flags and configuration.
The project focuses on aggressive size reduction strategies, including recompiling the standard library from source to prune unused functions and implementing no-standard-library modes for memory-constrained environments. It details how to eliminate runtime overhead by removing standard library entry points and replacing stack unwinding with immediate abort strategies to remove backtrace metadata.
Additional capabilities cover binary bloat analysis to identify size-increasing dependencies, the use of link-time optimization to remove dead code, and post-compilation symbol stripping. The guide also addresses the reduction of storage footprints for applications deployed within container images and the use of external packing tools for binary compression.
Features
- Binary Size Reduction - Implements various techniques to minimize the final executable size through release profiles and symbol stripping.
- Binary Footprint Optimizers - Provides a comprehensive set of compiler flags and configurations to prioritize minimal binary footprint over execution speed.
- Standard Libraries - Provides techniques to strip the standard library or restrict formatting utilities to achieve minimal binary size.
- Standard Library Optimizations - Provides instructions for recompiling the standard library from source to prune unused functions and reduce binary size.
- Debug Symbol Configurators - Sets up a pipeline to remove debug metadata and non-essential symbols from the binary after compilation.
- Symbol Stripping - Details techniques for stripping debug symbols and metadata to reclaim storage space in the final binary.
- Debug Symbol Stripping - Provides methods to remove non-essential symbol information from compiled binaries to reduce file size.
- Binary Bloat Analysis - Enables identification of functions, generic instantiations, and dependencies that contribute most to executable size.
- No-Std Environment Adapters - Guides the creation of lightweight runtimes by removing standard library dependencies for memory-constrained environments.
- Binary Size Optimizations - Provides comprehensive configurations and flags to reduce the size of compiled Rust executables.
- Binary Bloat Analyzers - Provides methods for analyzing binary bloat and identifying the specific functions or dependencies that increase executable size.
- Standard Library Size Optimizations - Offers strategies to compile the base library from source with aggressive size-focused optimizations.
- Compilation Optimization Guides - Provides instructions for optimizing the standard library and link-time optimization to minimize bloat.
- No-Standard-Library Modes - Provides a guide for building lightweight runtimes by entirely removing the Rust standard library.
- Custom Standard Library Builds - Provides instructions for recompiling the standard library from source to prune unused functions and reduce binary size.
- Link-Time Optimizations - Uses link-time optimization to analyze and remove dead code across compilation units to minimize binary size.
- Debug Metadata Removal - Details how to strip file locations and formatting functions to reclaim space used by traceback information.
- Usage Constraints - Instructs how to avoid formatting code or substitute the base library with a minimal environment to decrease size.
- Panic Handlers - Reduces binary size by replacing stack unwinding with immediate aborts and stripping formatting details.
- Binary Bloat Analysis - Identifies which dependencies or functions increase final binary size to target specific areas for reduction.
- Image Slimming - Offers strategies for using specialized base images and slimming tools to reduce the footprint of deployed applications.
- Container Image Optimizers - Provides guidance on using minification tools and minimal base images to shrink deployment footprints.
- Executable Compression Tools - Utilizes external packing tools to compress compiled binaries and reduce their total disk footprint.
- Program Entry Points - Provides techniques to eliminate standard library boot-up sequences and runtime overhead at the program entry point.
- Embedded Rust - Supports building minimal Rust programs for bare-metal and memory-constrained environments.
- Panic Strategy Configurations - Implements an abort-on-panic strategy to eliminate the binary bloat caused by stack unwinding and backtrace metadata.
- System Programming Foundations - Techniques for optimizing binary size in Rust projects.
