c29clang Compiler User Manual

The TI C29x Clang Compiler Tools, commonly referred to in this user guide as c29clang, support the development of software applications intended to run on a C29x processor.

This section of the documentation provides a detailed description of each of the parts of the c29clang compiler toolchain. It provides guidance on how these tools can be used to develop C29x applications.

Contents

• 1. Using the C/C++ Compiler
  • 1.1. About the Compiler
  • 1.2. Invoking the Compiler
  • 1.3. Compiler Options
• 2. C/C++ Language Implementation
  • 2.1. Data Types
  • 2.2. Characteristics of C29x C
  • 2.3. C Language Extensions
  • 2.4. C29x C Implementation-Defined Behavior
  • 2.5. Characteristics and Implementation of C29x C++
  • 2.6. Pre-Defined Macro Symbols
  • 2.7. Attributes
  • 2.8. Pragmas
  • 2.9. Built-In Functions and Intrinsics
  • 2.10. Keywords
• 3. Run-Time Environment
  • 3.1. Memory Model
  • 3.2. Object Representation
  • 3.3. Function Structure and Calling Conventions
  • 3.4. Accessing Linker Symbols in C and C++
  • 3.5. Interfacing C and C++ With Assembly Language
  • 3.6. Interrupt Handling
  • 3.7. Built-In Functions
  • 3.8. System Initialization
• 4. Using Run-Time-Support Functions and Building Libraries
  • 4.1. C and C++ Run-Time Support Libraries
  • 4.2. The C I/O Functions
  • 4.3. Handling Reentrancy (_register_lock() and _register_unlock() Functions)
• 5. Processing Assembly Source Code
  • 5.1. Invoking the Integrated GNU-Syntax C29x Assembler
• 6. Introduction to Object Modules
  • 6.1. Object File Format Specifications
  • 6.2. Executable Object Files
  • 6.3. Introduction to Sections
  • 6.4. How the Assembler Handles Sections
  • 6.5. How the Linker Handles Sections
  • 6.6. Symbols
  • 6.7. Symbolic Relocations
  • 6.8. Loading a Program
• 7. Program Loading and Running
  • 7.1. Loading
  • 7.2. Entry Point
  • 7.3. Run-Time Initialization
  • 7.4. Arguments to main
  • 7.5. Run-Time Relocation
  • 7.6. Additional Information
• 8. Archiver Description
  • 8.1. c29ar - Archiver
  • 8.2. c29libinfo - Library Information Archiver
• 9. Linker Description
  • 9.1. Linker Overview
  • 9.2. The Linker’s Role in the Software Development Flow
  • 9.3. Invoking the Linker
  • 9.4. Linker Options
  • 9.5. Linker Command Files
  • 9.6. Linker Symbols
  • 9.7. Default Placement Algorithm
  • 9.8. Using Linker-Generated Copy Tables
  • 9.9. Linker-Generated CRC Tables and CRC Over Memory Ranges
  • 9.10. Partial (Incremental) Linking
  • 9.11. Linking C/C++ Code
  • 9.12. Linker Example
  • 9.13. XML Link Information File Description
• 10. Link Time Optimization - LTO
  • 10.1. Benefits of Using LTO - Enabling Inter-Module Optimizations
  • 10.2. LTO Development Flow
  • 10.3. Building an Application with LTO
  • 10.4. LTO Debug Aid
• 11. Code Coverage
  • 11.1. Source-Based Code Coverage in c29clang
  • 11.2. c29profdata - Profile Data Tool
  • 11.3. c29cov - Emit Coverage Information
  • 11.4. Code Coverage for Functional Safety
• 12. Compiler Security
  • 12.1. Stack Smashing Detection
  • 12.2. Filling Holes and Padding Functions
  • 12.3. C11 Secure Functions in C Runtime Support Library
• 13. C29x Security Model
  • 13.1. The Safety and Security Unit (SSU)
  • 13.2. Key Terms and Constructs
  • 13.3. Inter-STACK Calls
  • 13.4. Security Support in the Linker
• 14. Name and C++ Name Demangler Utilities
  • 14.1. c29nm - Name Utility
  • 14.2. c29dem - C++ Name Demangler Utility
• 15. Object File Utilities
  • 15.1. c29objcopy - Object Copying and Editing Tool
  • 15.2. c29objdump - Object File Dumper
  • 15.3. c29ofd - Object File Display Utility
  • 15.4. c29readelf - Object File Reader
  • 15.5. c29size - Print Size Information
  • 15.6. c29strip - Object File Stripping Tool