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. Output Section Description
  • 4.8. Syntax
  • 4.9. Controlling Physical addresses
  • 4.10. GNU-compatibility
• 5. Diagnostics
  • 5.1. What -Wall and -Werror Mean for ELD
  • 5.2. ELD Linker Warning Flags
• 6. Shared Library Versioning
  • 6.1. Overview
  • 6.2. Key Concepts
  • 6.3. ABI vs API
  • 6.4. Backward Compatibility
  • 6.5. Best Practices
  • 6.6. Nuances
  • 6.7. SONAME Usage Example
  • 6.8. Semantic Versioning Example
  • 6.9. ABI vs API Example
  • 6.10. Symbolic Link Structure
  • 6.11. Nuances
• 7. GNU ELF Symbol Versioning
  • 7.1. Goal
  • 7.2. Files
  • 7.3. Build & Run
  • 7.4. Inspecting the Result
• 8. Image Structure and Generation
  • 8.1. Processor-specific flags
• 9. Linker Map Files
  • 9.1. Map File Styles
  • 9.2. Navigating Text Map File
• 10. Image layout
  • 10.1. Linker terminology
  • 10.2. Image layout
• 11. Linker Plugins
  • 11.1. Linker Plugins
  • 11.2. Linker Plugin Examples
  • 11.3. Linker Plugin API Usage and Reference
• 12. Linker Optimization Features
• 13. Getting Image Details
  • 13.1. Overview
  • 13.2. Supported Diagnostic Options
• 14. Command
• 15. Command-line options
  • 15.1. Common options for all the backends
  • 15.2. ARM and AArch64 specific options
  • 15.3. Hexagon specific options
  • 15.4. RISCV specific options
• 16. Target Specific Features
• 17. Linker support and frequently asked questions!!!
  • 17.1. General Linker Questions
  • 17.2. Input File to Linker
  • 17.3. Linker Script General Questions
  • 17.4. Linker Script PHDRS
  • 17.5. String Merging
  • 17.6. Hexagon
  • 17.7. RISC-V
  • 17.8. Usage
  • 17.9. Linker Plugin Framework
  • 17.10. Symbol Resolution
  • 17.11. Build time issues
  • 17.12. Hexagon
  • 17.13. ARM
  • 17.14. Runtime issues
  • 17.15. Improving your image/build
  • 17.16. LinkerPlugin API

Indices and tables

• Index

• Module Index

• Search Page

• Build Dashboard