ELD User Guide

This document describes usage of ELD

• 1. Getting started
  • 1.1. About the linker
  • 1.2. Source
  • 1.3. Summary of the linker features
  • 1.4. What the linker can accept as input
  • 1.5. What the linker outputs
• 2. Supported Linking Modes
  • 2.1. Static Linking
  • 2.2. Dynamic Linking
  • 2.3. Partial Linking
  • 2.4. PIE
  • 2.5. Shared Libraries
• 3. Supported Targets
• 4. Linker Script
  • 4.1. Overview
  • 4.2. Basic script syntax
  • 4.3. Script commands
  • 4.4. Expressions
  • 4.5. Symbol assignments
  • 4.6. NOCROSSREFS
  • 4.7. OVERLAY
  • 4.8. Output Section Description
  • 4.9. Syntax
  • 4.10. Sorting input sections
  • 4.11. Controlling Physical addresses
  • 4.12. GNU-compatibility
  • 4.13. PRINT Command
• 5. Diagnostics
  • 5.1. What -Wall and -Werror Mean for ELD
  • 5.2. ELD Linker Warning Flags
• 6. ELD (debugging guide)
  • 6.1. Big picture
  • 6.2. Entry point and driver selection
  • 6.3. Argument parsing and preprocessing
  • 6.4. Input actions (what gets fed to the linker)
  • 6.5. Link pipeline overview (doLink -> Linker)
  • 6.6. Prepare phase (Linker::prepare)
  • 6.7. Normalize phase (Linker::normalize)
  • 6.8. Resolve + layout + emit (Linker::link)
  • 6.9. Internal inputs and “internal sections”
  • 6.10. Section merging (input sections -> output sections)
  • 6.11. String merging (MergeString fragments)
  • 6.12. Relocations: read -> scan -> apply -> (optional) emit reloc sections
  • 6.13. Dynamic relocations (what creates .rel[a].dyn / .rel[a].plt)
  • 6.14. Garbage collection (--gc-sections)
  • 6.15. Fragment model (Fragment / FragmentRef)
  • 6.16. Map files (layout printers)
  • 6.17. Reproducing failures (tarball + mapping file)
  • 6.18. Crash/signal behavior (what gets written on a crash)
  • 6.19. Where failures typically come from (symptoms -> pipeline stage)
  • 6.20. Practical debugging checklist
  • 6.21. Debugging runtime crashes in ELD-built images
• 7. Shared Library Versioning
  • 7.1. Overview
  • 7.2. Key Concepts
  • 7.3. ABI vs API
  • 7.4. Backward Compatibility
  • 7.5. Best Practices
  • 7.6. Nuances
  • 7.7. SONAME Usage Example
  • 7.8. Semantic Versioning Example
  • 7.9. ABI vs API Example
  • 7.10. Symbolic Link Structure
  • 7.11. Nuances
• 8. GNU ELF Symbol Versioning
  • 8.1. A. Minimal Working Example (C + GNU ld)
  • 8.2. Goal
  • 8.3. Example files
  • 8.4. Build & Run
  • 8.5. Inspecting the Result
• 9. Image Structure and Generation
  • 9.1. Processor-specific flags
• 10. Linker Map Files
  • 10.1. Map File Styles
  • 10.2. Navigating Text Map File
• 11. Image layout
  • 11.1. Linker terminology
  • 11.2. Image layout
• 12. Linker Plugins
  • 12.1. Linker Plugins
  • 12.2. Linker Plugin Examples
  • 12.3. Linker Plugin API Usage and Reference
• 13. Linker Plugins
  • 13.1. Overview
  • 13.2. Plugin Usage
  • 13.3. Linker wrapper
  • 13.4. User Plugin Types
  • 13.5. LinkerScript changes
  • 13.6. User Plugin Work Flow
  • 13.7. Linker Work Flow
  • 13.8. Linker Operation
  • 13.9. Plugin data structures
  • 13.10. LinkerWrapper commands
  • 13.11. Linker plugin interface
  • 13.12. Plugin interfaces
• 14. Linker Optimization Features
• 15. ELF TOOLS
• 16. LTO Support
  • 16.1. Overview
  • 16.2. Background: LLVM LTO
  • 16.3. ELD LTO model
  • 16.4. LTO switch reference
  • 16.5. Examples
  • 16.6. References
• 17. Getting Image Details
  • 17.1. Overview
  • 17.2. Supported Diagnostic Options
• 18. Command-line options
  • 18.1. Common options for all the backends
  • 18.2. Using --start-lib / --end-lib
  • 18.3. MEMORY-related options
  • 18.4. ARM and AArch64 specific options
  • 18.5. Hexagon specific options
  • 18.6. RISCV specific options
  • 18.7. -z keyword options
  • 18.8. Linker version directive
  • 18.9. Record command line
• 19. Target Specific Features
  • 19.1. Hexagon
  • 19.2. ARM
  • 19.3. AArch64
  • 19.4. RISCV
• 20. SFrame Support
  • 20.1. Overview
  • 20.2. SFrame vs EhFrame
  • 20.3. Command Line Options
  • 20.4. Usage Examples
  • 20.5. Section Processing
  • 20.6. Supported Architectures
  • 20.7. Integration with Debugging Tools
  • 20.8. Garbage Collection Behavior
  • 20.9. Error Handling
  • 20.10. Performance Considerations
  • 20.11. Best Practices
  • 20.12. Troubleshooting
• 21. Linker support and frequently asked questions!!!
  • 21.1. General Linker Questions
  • 21.2. Input File to Linker
  • 21.3. Linker Script General Questions
  • 21.4. Linker Script PHDRS
  • 21.5. MEMORY command: common issues and fixes
  • 21.6. String Merging
  • 21.7. Hexagon
  • 21.8. RISC-V
  • 21.9. Usage
  • 21.10. Linker Plugin Framework
  • 21.11. Symbol Resolution
  • 21.12. Build time issues
  • 21.13. Hexagon
  • 21.14. ARM
  • 21.15. Runtime issues
  • 21.16. Improving your image/build
  • 21.17. LinkerPlugin API

User guide

• ELD User Guide (PDF)

Indices and tables

• Index

• Module Index

• Search Page

• Build Dashboard