SPRUI04G June   2015  – August 2025

 

  1.   1
  2.   Read This First
    1.     About This Manual
    2.     Notational Conventions
    3.     Related Documentation
    4.     Related Documentation From Texas Instruments
    5.     Trademarks
  3. 1 Introduction to the Software Development Tools
    1. 1.1 Software Development Tools Overview
    2. 1.2 Compiler Interface
    3. 1.3 ANSI/ISO Standard
    4. 1.4 Output Files
    5. 1.5 Utilities
  4. 2 Getting Started with the Code Generation Tools
    1. 2.1 How Code Composer Studio Projects Use the Compiler
    2. 2.2 Compiling from the Command Line
  5. 3 Using the C/C++ Compiler
    1. 3.1  About the Compiler
    2. 3.2  Invoking the C/C++ Compiler
    3. 3.3  Changing the Compiler's Behavior with Options
      1. 3.3.1  Linker Options
      2. 3.3.2  Frequently Used Options
      3. 3.3.3  Miscellaneous Useful Options
      4. 3.3.4  Run-Time Model Options
      5. 3.3.5  Selecting Target CPU Version (--silicon_version Option)
      6. 3.3.6  Symbolic Debugging and Profiling Options
      7. 3.3.7  Specifying Filenames
      8. 3.3.8  Changing How the Compiler Interprets Filenames
      9. 3.3.9  Changing How the Compiler Processes C Files
      10. 3.3.10 Changing How the Compiler Interprets and Names Extensions
      11. 3.3.11 Specifying Directories
      12. 3.3.12 Assembler Options
    4. 3.4  Controlling the Compiler Through Environment Variables
      1. 3.4.1 Setting Default Compiler Options (C6X_C_OPTION)
      2. 3.4.2 Naming One or More Alternate Directories (C6X_C_DIR)
    5. 3.5  Controlling the Preprocessor
      1. 3.5.1  Predefined Macro Names
      2. 3.5.2  The Search Path for #include Files
        1. 3.5.2.1 Adding a Directory to the #include File Search Path (--include_path Option)
      3. 3.5.3  Support for the #warning and #warn Directives
      4. 3.5.4  Generating a Preprocessed Listing File (--preproc_only Option)
      5. 3.5.5  Continuing Compilation After Preprocessing (--preproc_with_compile Option)
      6. 3.5.6  Generating a Preprocessed Listing File with Comments (--preproc_with_comment Option)
      7. 3.5.7  Generating Preprocessed Listing with Line-Control Details (--preproc_with_line Option)
      8. 3.5.8  Generating Preprocessed Output for a Make Utility (--preproc_dependency Option)
      9. 3.5.9  Generating a List of Files Included with #include (--preproc_includes Option)
      10. 3.5.10 Generating a List of Macros in a File (--preproc_macros Option)
    6. 3.6  Passing Arguments to main()
    7. 3.7  Understanding Diagnostic Messages
      1. 3.7.1 Controlling Diagnostic Messages
      2. 3.7.2 How You Can Use Diagnostic Suppression Options
    8. 3.8  Other Messages
    9. 3.9  Generating Cross-Reference Listing Information (--gen_cross_reference_listing Option)
    10. 3.10 Generating a Raw Listing File (--gen_preprocessor_listing Option)
    11. 3.11 Using Inline Function Expansion
      1. 3.11.1 Inlining Intrinsic Operators
      2. 3.11.2 Inlining Restrictions
      3. 3.11.3 Unguarded Definition-Controlled Inlining
        1. 3.11.3.1 Using the Inline Keyword
      4. 3.11.4 Guarded Inlining and the _INLINE Preprocessor Symbol
        1. 3.11.4.1 Header File string.h
        2. 3.11.4.2 Library Definition File
    12. 3.12 Interrupt Flexibility Options (--interrupt_threshold Option)
    13. 3.13 Using Interlist
    14. 3.14 About the Application Binary Interface
    15. 3.15 Enabling Entry Hook and Exit Hook Functions
  6. 4 Optimizing Your Code
    1. 4.1  Invoking Optimization
    2. 4.2  Controlling Code Size Versus Speed
    3. 4.3  Performing File-Level Optimization (--opt_level=3 option)
      1. 4.3.1 Creating an Optimization Information File (--gen_opt_info Option)
    4. 4.4  Program-Level Optimization (--program_level_compile and --opt_level=3 options)
      1. 4.4.1 Controlling Program-Level Optimization (--call_assumptions Option)
      2. 4.4.2 Optimization Considerations When Mixing C/C++ and Assembly
    5. 4.5  Automatic Inline Expansion (--auto_inline Option)
    6. 4.6  Optimizing Software Pipelining
      1. 4.6.1 Turn Off Software Pipelining (--disable_software_pipeline Option)
      2. 4.6.2 Software Pipelining Information
        1. 4.6.2.1 Software Pipelining Information
        2. 4.6.2.2 Software Pipelining Information Terms
        3. 4.6.2.3 Loop Disqualified for Software Pipelining Messages
        4. 4.6.2.4 Pipeline Failure Messages
        5. 4.6.2.5 Register Usage Table Generated by the --debug_software_pipeline Option
      3. 4.6.3 Collapsing Prologs and Epilogs for Improved Performance and Code Size
        1. 4.6.3.1 Speculative Execution
        2. 4.6.3.2 Selecting the Best Threshold Value
    7. 4.7  Redundant Loops
    8. 4.8  Utilizing the Loop Buffer Using SPLOOP
    9. 4.9  Reducing Code Size (--opt_for_space (or -ms) Option)
    10. 4.10 Using Feedback Directed Optimization
      1. 4.10.1 Feedback Directed Optimization
        1. 4.10.1.1 Phase 1 -- Collect Program Profile Information
        2. 4.10.1.2 Phase 2 -- Use Application Profile Information for Optimization
        3. 4.10.1.3 Generating and Using Profile Information
        4. 4.10.1.4 Example Use of Feedback Directed Optimization
        5. 4.10.1.5 The .ppdata Section
        6. 4.10.1.6 Feedback Directed Optimization and Code Size Tune
        7. 4.10.1.7 Instrumented Program Execution Overhead
        8. 4.10.1.8 Invalid Profile Data
      2. 4.10.2 Profile Data Decoder
      3. 4.10.3 Feedback Directed Optimization API
      4. 4.10.4 Feedback Directed Optimization Summary
    11. 4.11 Using Profile Information to Get Better Program Cache Layout and Analyze Code Coverage
      1. 4.11.1 Background and Motivation
      2. 4.11.2 Code Coverage
        1. 4.11.2.1 Phase1 -- Collect Program Profile Information
        2. 4.11.2.2 Phase 2 -- Generate Code Coverage Reports
      3. 4.11.3 What Performance Improvements Can You Expect to See?
        1. 4.11.3.1 Evaluating L1P Cache Performance
      4. 4.11.4 Program Cache Layout Related Features and Capabilities
        1. 4.11.4.1 Path Profiler
        2. 4.11.4.2 Analysis Options
        3. 4.11.4.3 Environment Variables
        4. 4.11.4.4 Program Cache Layout Tool, clt6x
        5. 4.11.4.5 Linker
        6. 4.11.4.6 Linker Command File Operator unordered()
      5. 4.11.5 Program Instruction Cache Layout Development Flow
        1. 4.11.5.1 Gather Dynamic Profile Information
        2. 4.11.5.2 Generate Preferred Function Order from Dynamic Profile Information
        3. 4.11.5.3 Utilize Preferred Function Order in Re-Build of Application
      6. 4.11.6 Comma-Separated Values (CSV) Files with Weighted Call Graph (WCG) Information
      7. 4.11.7 Linker Command File Operator - unordered()
        1. 4.11.7.1 Output Section for unordered() Operator
        2.       124
        3. 4.11.7.2 Generated Linker Map File for
        4. 4.11.7.3 About Dot (.) Expressions in the Presence of unordered()
          1. 4.11.7.3.1 Respecting Position of a . Expression
          2.        128
        5. 4.11.7.4 GROUPs and UNIONs
          1. 4.11.7.4.1 Applying unordered() to GROUPs
        6.       131
      8. 4.11.8 Things to be Aware of
    12. 4.12 Indicating Whether Certain Aliasing Techniques Are Used
      1. 4.12.1 Use the --aliased_variables Option When Certain Aliases are Used
      2. 4.12.2 Use the --no_bad_aliases Option to Indicate That These Techniques Are Not Used
      3. 4.12.3 Using the --no_bad_aliases Option With the Assembly Optimizer
    13. 4.13 Prevent Reordering of Associative Floating-Point Operations
    14. 4.14 Use Caution With asm Statements in Optimized Code
    15. 4.15 Using Performance Advice to Optimize Code
      1. 4.15.1  Advice #27000
      2. 4.15.2  Advice #27001 Increase Optimization Level
      3. 4.15.3  Advice #27002 Do not turn off software pipelining
      4. 4.15.4  Advice #27003 Avoid compiling with debug options
      5. 4.15.5  Advice #30000 Prevent Loop Disqualification due to call
      6. 4.15.6  Advice #30001 Prevent Loop Disqualification due to rts-call
      7. 4.15.7  Advice #30002 Prevent Loop Disqualification due to asm statement
      8. 4.15.8  Advice #30003 Prevent Loop Disqualification due to complex condition
      9. 4.15.9  Advice #30004 Prevent Loop Disqualification due to switch statement
      10. 4.15.10 Advice #30005 Prevent Loop Disqualification due to arithmetic operation
      11. 4.15.11 Advice #30006 Prevent Loop Disqualification due to call(2)
      12. 4.15.12 Advice #30007 Prevent Loop Disqualification due to rts-call(2)
      13. 4.15.13 Advice #30008 Improve Loop; Qualify with restrict
      14. 4.15.14 Advice #30009 Improve Loop; Add MUST_ITERATE pragma
      15. 4.15.15 Advice #30010 Improve Loop; Add MUST_ITERATE pragma(2)
      16. 4.15.16 Advice #30011 Improve Loop; Add _nasssert()
    16. 4.16 Using the Interlist Feature With Optimization
    17. 4.17 Debugging and Profiling Optimized Code
      1. 4.17.1 Profiling Optimized Code
    18. 4.18 What Kind of Optimization Is Being Performed?
      1. 4.18.1  Cost-Based Register Allocation
      2. 4.18.2  Alias Disambiguation
      3. 4.18.3  Branch Optimizations and Control-Flow Simplification
      4. 4.18.4  Data Flow Optimizations
      5. 4.18.5  Expression Simplification
      6. 4.18.6  Inline Expansion of Functions
      7. 4.18.7  Function Symbol Aliasing
      8. 4.18.8  Induction Variables and Strength Reduction
      9. 4.18.9  Loop-Invariant Code Motion
      10. 4.18.10 Loop Rotation
      11. 4.18.11 Unroll-and-jam
      12. 4.18.12 Vectorization (SIMD)
      13. 4.18.13 Instruction Scheduling
      14. 4.18.14 Register Variables
      15. 4.18.15 Register Tracking/Targeting
      16. 4.18.16 Software Pipelining
  7. 5 Using the Assembly Optimizer
    1. 5.1 Code Development Flow to Increase Performance
    2. 5.2 About the Assembly Optimizer
    3. 5.3 What You Need to Know to Write Linear Assembly
      1. 5.3.1 Linear Assembly Source Statement Format
      2. 5.3.2 Register Specification for Linear Assembly
        1. 5.3.2.1 Linear Assembly Code for Computing a Dot Product
        2.       183
        3. 5.3.2.2 C Code for Computing a Dot Product
        4.       185
        5. 5.3.2.3 Specifying a Register Pair
        6.       187
        7. 5.3.2.4 Specifying a Register Quad (C6600 Only)
        8.       189
      3. 5.3.3 Functional Unit Specification for Linear Assembly
      4. 5.3.4 Using Linear Assembly Source Comments
        1. 5.3.4.1 Lmac Function Code Showing Comments
      5. 5.3.5 Assembly File Retains Your Symbolic Register Names
    4. 5.4 Assembly Optimizer Directives
      1.      .call
      2.      .circ
      3.      .cproc/.endproc
      4.      .map
      5.      .mdep
      6.      .mptr
      7.      .no_mdep
      8.      .pref
      9.      .proc/.endproc
      10.      .reg
      11.      .rega/.regb
      12.      .reserve
      13.      .return
      14.      .trip
      15.      .volatile
      16. 5.4.1 Instructions That Are Not Allowed in Procedures
    5. 5.5 Avoiding Memory Bank Conflicts With the Assembly Optimizer
      1. 5.5.1 Preventing Memory Bank Conflicts
        1. 5.5.1.1 Load and Store Instructions That Specify Memory Bank Information
      2. 5.5.2 A Dot Product Example That Avoids Memory Bank Conflicts
        1. 5.5.2.1 C Code for Dot Product
        2. 5.5.2.2 Linear Assembly for Dot Product
        3. 5.5.2.3 Dot Product Software-Pipelined Kernel
        4.       218
        5. 5.5.2.4 Dot Product From Unrolled to Prevent Memory Bank Conflicts
        6.       220
        7. 5.5.2.5 Unrolled Dot Product Kernel From
        8.       222
      3. 5.5.3 Memory Bank Conflicts for Indexed Pointers
        1. 5.5.3.1 Using .mptr for Indexed Pointers
      4. 5.5.4 Memory Bank Conflict Algorithm
    6. 5.6 Memory Alias Disambiguation
      1. 5.6.1 How the Assembly Optimizer Handles Memory References (Default)
      2. 5.6.2 Using the --no_bad_aliases Option to Handle Memory References
      3. 5.6.3 Using the .no_mdep Directive
      4. 5.6.4 Using the .mdep Directive to Identify Specific Memory Dependencies
        1. 5.6.4.1 Annotating a Memory Reference
        2.       232
        3. 5.6.4.2 Software Pipeline Using .mdep ld1, st1
        4.       234
        5. 5.6.4.3 Software Pipeline Using .mdep st1, ld1 and .mdep ld1, st1
        6.       236
      5. 5.6.5 Memory Alias Examples
  8. 6 Linking C/C++ Code
    1. 6.1 Invoking the Linker Through the Compiler (-z Option)
      1. 6.1.1 Invoking the Linker Separately
      2. 6.1.2 Invoking the Linker as Part of the Compile Step
      3. 6.1.3 Disabling the Linker (--compile_only Compiler Option)
    2. 6.2 Linker Code Optimizations
      1. 6.2.1 Conditional Linking
      2. 6.2.2 Generating Function Subsections (--gen_func_subsections Compiler Option)
      3. 6.2.3 Generating Aggregate Data Subsections (--gen_data_subsections Compiler Option)
    3. 6.3 Controlling the Linking Process
      1. 6.3.1 Including the Run-Time-Support Library
        1. 6.3.1.1 Automatic Run-Time-Support Library Selection
          1. 6.3.1.1.1 Using the --issue_remarks Option
        2. 6.3.1.2 Manual Run-Time-Support Library Selection
        3. 6.3.1.3 Library Order for Searching for Symbols
      2. 6.3.2 Run-Time Initialization
      3. 6.3.3 Global Object Constructors
      4. 6.3.4 Specifying the Type of Global Variable Initialization
      5. 6.3.5 Specifying Where to Allocate Sections in Memory
      6. 6.3.6 A Sample Linker Command File
  9. 7 C/C++ Language Implementation
    1. 7.1  Characteristics of TMS320C6000 C
      1. 7.1.1 Implementation-Defined Behavior
    2. 7.2  Characteristics of TMS320C6000 C++
    3. 7.3  Data Types
      1. 7.3.1 Size of Enum Types
      2. 7.3.2 Vector, Complex, and Complex Vector Data Types
    4. 7.4  File Encodings and Character Sets
    5. 7.5  Keywords
      1. 7.5.1 The complex Keyword
      2. 7.5.2 The const Keyword
      3. 7.5.3 The __cregister Keyword
        1. 7.5.3.1 Define and Use Control Registers
      4. 7.5.4 The __interrupt Keyword
      5. 7.5.5 The __near and __far Keywords
        1. 7.5.5.1 Near and Far Data Objects
        2. 7.5.5.2 Near and Far Function Calls
      6. 7.5.6 The restrict Keyword
      7. 7.5.7 The volatile Keyword
    6. 7.6  C++ Exception Handling
    7. 7.7  Register Variables and Parameters
    8. 7.8  The __asm Statement
    9. 7.9  Pragma Directives
      1. 7.9.1  The CALLS Pragma
      2. 7.9.2  The CLINK Pragma
      3. 7.9.3  The CODE_ALIGN Pragma
      4. 7.9.4  The CODE_SECTION Pragma
      5. 7.9.5  The DATA_ALIGN Pragma
      6. 7.9.6  The DATA_MEM_BANK Pragma
        1. 7.9.6.1 Using the DATA_MEM_BANK Pragma
      7. 7.9.7  The DATA_SECTION Pragma
        1. 7.9.7.1 Using the DATA_SECTION Pragma C Source File
        2. 7.9.7.2 Using the DATA_SECTION Pragma C++ Source File
        3. 7.9.7.3 Using the DATA_SECTION Pragma Assembly Source File
      8. 7.9.8  The Diagnostic Message Pragmas
      9. 7.9.9  The FORCEINLINE Pragma
      10. 7.9.10 The FORCEINLINE_RECURSIVE Pragma
      11. 7.9.11 The FUNC_ALWAYS_INLINE Pragma
      12. 7.9.12 The FUNC_CANNOT_INLINE Pragma
      13. 7.9.13 The FUNC_EXT_CALLED Pragma
      14. 7.9.14 The FUNC_INTERRUPT_THRESHOLD Pragma
      15. 7.9.15 The FUNC_IS_PURE Pragma
      16. 7.9.16 The FUNC_IS_SYSTEM Pragma
      17. 7.9.17 The FUNC_NEVER_RETURNS Pragma
      18. 7.9.18 The FUNC_NO_GLOBAL_ASG Pragma
      19. 7.9.19 The FUNC_NO_IND_ASG Pragma
      20. 7.9.20 The FUNCTION_OPTIONS Pragma
      21. 7.9.21 The INTERRUPT Pragma
      22. 7.9.22 The LOCATION Pragma
      23. 7.9.23 The MUST_ITERATE Pragma
        1. 7.9.23.1 The MUST_ITERATE Pragma Syntax
        2. 7.9.23.2 Using MUST_ITERATE to Expand Compiler Knowledge of Loops
      24. 7.9.24 The NMI_INTERRUPT Pragma
      25. 7.9.25 The NOINIT and PERSISTENT Pragmas
      26. 7.9.26 The NOINLINE Pragma
      27. 7.9.27 The NO_HOOKS Pragma
      28. 7.9.28 The once Pragma
      29. 7.9.29 The pack Pragma
      30. 7.9.30 The PROB_ITERATE Pragma
      31. 7.9.31 The RETAIN Pragma
      32. 7.9.32 The SET_CODE_SECTION and SET_DATA_SECTION Pragmas
      33. 7.9.33 The STRUCT_ALIGN Pragma
      34. 7.9.34 The UNROLL Pragma
    10. 7.10 The _Pragma Operator
    11. 7.11 Application Binary Interface
    12. 7.12 Object File Symbol Naming Conventions (Linknames)
    13. 7.13 Changing the ANSI/ISO C/C++ Language Mode
      1. 7.13.1 C99 Support (--c99)
      2. 7.13.2 C11 Support (--c11)
      3. 7.13.3 Strict ANSI Mode and Relaxed ANSI Mode (--strict_ansi and --relaxed_ansi)
    14. 7.14 GNU and Clang Language Extensions
      1. 7.14.1 Extensions
      2. 7.14.2 Function Attributes
      3. 7.14.3 For Loop Attributes
      4. 7.14.4 Variable Attributes
      5. 7.14.5 Type Attributes
      6. 7.14.6 Built-In Functions
    15. 7.15 Operations and Functions for Vector Data Types
      1. 7.15.1 Vector Literals and Concatenation
      2. 7.15.2 Unary and Binary Operators for Vectors
        1. 7.15.2.1 Using Address Operator on a Vector
      3. 7.15.3 Swizzle Operators for Vectors
      4. 7.15.4 Conversion Functions for Vectors
      5. 7.15.5 Re-Interpretation Functions for Vectors
      6. 7.15.6 Using printf() with Vectors
      7. 7.15.7 Built-In Vector Functions
  10. 8 Run-Time Environment
    1. 8.1  Memory Model
      1. 8.1.1 Sections
      2. 8.1.2 C/C++ System Stack
      3. 8.1.3 Dynamic Memory Allocation
      4. 8.1.4 Data Memory Models
        1. 8.1.4.1 Determining the Data Address Model
        2. 8.1.4.2 DP-Relative Vs. Absolute Addressing
        3. 8.1.4.3 Const Objects as Far
      5. 8.1.5 Trampoline Generation for Function Calls
      6. 8.1.6 Position Independent Data
    2. 8.2  Object Representation
      1. 8.2.1 Data Type Storage
        1. 8.2.1.1 char and short Data Types (signed and unsigned)
        2. 8.2.1.2 enum, int, and long Data Types (signed and unsigned)
        3. 8.2.1.3 float Data Type
        4. 8.2.1.4 The __int40_t Data Type (signed and unsigned)
        5. 8.2.1.5 long long Data Types (signed and unsigned)
        6. 8.2.1.6 double and long double Data Types
        7. 8.2.1.7 Pointer to Data Member Types
        8. 8.2.1.8 Pointer to Member Function Types
        9. 8.2.1.9 Structures and Arrays
      2. 8.2.2 Bit Fields
      3. 8.2.3 Character String Constants
      4.      368
    3. 8.3  Register Conventions
    4. 8.4  Function Structure and Calling Conventions
      1. 8.4.1 How a Function Makes a Call
      2. 8.4.2 How a Called Function Responds
      3. 8.4.3 Accessing Arguments and Local Variables
    5. 8.5  Accessing Linker Symbols in C and C++
    6. 8.6  Interfacing C and C++ With Assembly Language
      1. 8.6.1  Using Assembly Language Modules With C/C++ Code
      2. 8.6.2  Accessing Assembly Language Functions From C/C++
        1. 8.6.2.1 Calling an Assembly Language Function From a C/C++ Program
        2. 8.6.2.2 Assembly Language Program Called by
        3.       380
      3. 8.6.3  Accessing Assembly Language Variables From C/C++
        1. 8.6.3.1 Accessing Assembly Language Global Variables
          1. 8.6.3.1.1 Assembly Language Variable Program
          2. 8.6.3.1.2 C Program to Access Assembly Language From
        2.       385
        3. 8.6.3.2 Accessing Assembly Language Constants
          1. 8.6.3.2.1 Accessing an Assembly Language Constant From C
          2. 8.6.3.2.2 Assembly Language Program for
          3.        389
      4. 8.6.4  Sharing C/C++ Header Files With Assembly Source
      5. 8.6.5  Using Inline Assembly Language
      6. 8.6.6  Using Intrinsics to Access Assembly Language Statements
      7. 8.6.7  The __x128_t Container Type
        1. 8.6.7.1 The __x128_t Container Type
        2.       395
      8. 8.6.8  The __float2_t Container Type
      9. 8.6.9  Using Intrinsics for Interrupt Control and Atomic Sections
      10. 8.6.10 Using Unaligned Data and 64-Bit Values
        1. 8.6.10.1 Using the _mem8 Intrinsic
      11. 8.6.11 Using MUST_ITERATE and _nassert to Enable SIMD and Expand Compiler Knowledge of Loops
      12. 8.6.12 Methods to Align Data
        1. 8.6.12.1 Base Address of an Array
        2. 8.6.12.2 Offset from the Base of an Array
        3. 8.6.12.3 Dynamic Memory Allocation
        4. 8.6.12.4 Member of a Structure or Class
          1. 8.6.12.4.1 An Array in a Structure
          2. 8.6.12.4.2 An Array in a Class
          3.        408
      13. 8.6.13 SAT Bit Side Effects
      14. 8.6.14 IRP and AMR Conventions
      15. 8.6.15 Floating Point and Saturation Control Register Side Effects
    7. 8.7  Interrupt Handling
      1. 8.7.1 Saving the SGIE Bit
      2. 8.7.2 Saving Registers During Interrupts
      3. 8.7.3 Using C/C++ Interrupt Routines
      4. 8.7.4 Using Assembly Language Interrupt Routines
    8. 8.8  Run-Time-Support Arithmetic Routines
    9. 8.9  System Initialization
      1. 8.9.1 Boot Hook Functions for System Pre-Initialization
      2. 8.9.2 Automatic Initialization of Variables
        1. 8.9.2.1 Zero Initializing Variables
        2. 8.9.2.2 Direct Initialization
        3. 8.9.2.3 Autoinitialization of Variables at Run Time
        4. 8.9.2.4 Autoinitialization Tables
          1. 8.9.2.4.1 Length Followed by Data Format
          2. 8.9.2.4.2 Zero Initialization Format
          3. 8.9.2.4.3 Run Length Encoded (RLE) Format
          4. 8.9.2.4.4 Lempel-Ziv-Storer-Szymanski Compression (LZSS) Format
          5. 8.9.2.4.5 Sample C Code to Process the C Autoinitialization Table
        5. 8.9.2.5 Initialization of Variables at Load Time
        6. 8.9.2.6 Global Constructors
    10. 8.10 Multi-Threading Runtime Support
      1. 8.10.1 Runtime Thread Safety
      2. 8.10.2 Thread Creation, Initialization, and Termination
      3. 8.10.3 Thread Local Storage (TLS)
      4. 8.10.4 Accessing Shared Data
  11. 9 Using Run-Time-Support Functions and Building Libraries
    1. 9.1 C and C++ Run-Time Support Libraries
      1. 9.1.1 Linking Code With the Object Library
      2. 9.1.2 Header Files
      3. 9.1.3 Modifying a Library Function
      4. 9.1.4 Support for String Handling
      5. 9.1.5 Minimal Support for Internationalization
      6. 9.1.6 Support for Time and Clock Functions
      7. 9.1.7 Allowable Number of Open Files
      8. 9.1.8 Library Naming Conventions
    2. 9.2 The C I/O Functions
      1. 9.2.1 High-Level I/O Functions
        1. 9.2.1.1 Formatting and the Format Conversion Buffer
      2. 9.2.2 Overview of Low-Level I/O Implementation
        1.       open
        2.       close
        3.       read
        4.       write
        5.       lseek
        6.       unlink
        7.       rename
      3. 9.2.3 Device-Driver Level I/O Functions
        1.       DEV_open
        2.       DEV_close
        3.       DEV_read
        4.       DEV_write
        5.       DEV_lseek
        6.       DEV_unlink
        7.       DEV_rename
      4. 9.2.4 Adding a User-Defined Device Driver for C I/O
        1. 9.2.4.1 Mapping Default Streams to Device
      5. 9.2.5 The device Prefix
        1.       add_device
        2.       470
        3. 9.2.5.1 Program for C I/O Device
    3. 9.3 Handling Reentrancy (_register_lock() and _register_unlock() Functions)
    4. 9.4 Library-Build Process
      1. 9.4.1 Required Non-Texas Instruments Software
      2. 9.4.2 Using the Library-Build Process
        1. 9.4.2.1 Automatic Standard Library Rebuilding by the Linker
        2. 9.4.2.2 Invoking mklib Manually
          1. 9.4.2.2.1 Building Standard Libraries
          2. 9.4.2.2.2 Shared or Read-Only Library Directory
          3. 9.4.2.2.3 Building Libraries With Custom Options
          4. 9.4.2.2.4 The mklib Program Option Summary
      3. 9.4.3 Extending mklib
        1. 9.4.3.1 Underlying Mechanism
        2. 9.4.3.2 Libraries From Other Vendors
  12. 10C++ Name Demangler
    1. 10.1 Invoking the C++ Name Demangler
    2. 10.2 Sample Usage of the C++ Name Demangler
  13.   A Glossary
    1.     489
  14.   B Revision History

B Revision History

Changes from April 6, 2023 to August 7, 2025 (from Revision F (April 2023) to Revision G (August 2025))

  • Performance advice is not enabled by default.Go
  • OpenMP is no longer supported for C6000 targets.Go
  • OpenMP is no longer supported for C6000 targets.Go
  • Performance advice is not enabled by default.Go
  • Changed "trip count" to "iteration count" throughout to match new software pipelined loop information.Go
  • Performance advice is not enabled by default.Go
  • Performance advice code #27004 is no longer supported.Go
  • Added information about using the --diag_suppress option with the FUNCTION_OPTIONS pragma.Go
  • Added unroll-and-jam optimization.Go
  • Clarified information about using the CLINK pragma, since conditional linking is enabled by default.Go
  • The --rtti option is no longer documented. RTTI generation is always enabled for C++ applications.Go
  • Documented TI syntax complex types.Go
  • Documented that enum types smaller than an int are not supported.Go
  • Documented complex types in addition to the complex vector types that were documented previously.Go
  • Cross-referenced C99 and TI syntax for complex variables and clarified role of complex.h.Go
  • OpenMP is no longer supported for C6000 targets.Go
  • Clarified information about using the CLINK pragma, since conditional linking is enabled by default.Go
  • Removed mention of --auto_stream and --assume_addresses_ok_for_stream options, which are not supported.Go
  • Added that the --diag_suppress option may be used with the FUNCTION_OPTIONS pragma.Go
  • The full set of library functions and macros declared in math.h is supported.Go
  • Added documentation and examples for vector constructor-style syntax, which is now supported for C6000.Go
  • Added an example that initializes a complex vector.Go
  • Add types of vectors legal with each operator and details about unary & operator for vectors.Go
  • Added documentation for use of vector pointers.Go
  • Documented complex types in addition to the complex vector types that were documented previously.Go
  • Added information about where the return address is saved when a called function calls another function.Go
  • OpenMP is no longer supported for C6000 targets.Go
  • Added information about time zones in RTS functions.Go
  • Added terms related to vectors and complex types.Go

Changes from January 17, 2023 to April 6, 2023 (from Revision E (January 2023) to Revision F (April 2023))

  • Removed documentation of vector constructor-style syntax that is not supported for C6000.Go

Changes from January 14, 2022 to January 17, 2023 (from Revision D (January 2022) to Revision E (January 2023))

  • Added the --assume_control_regs_read option.Go
  • The --strict_compatibility linker option no longer has any effect and has been removed from the documentation.Go
  • Added the --fp_single_precision_constant compiler option.Go
  • Added the --assume_control_regs_read option.Go
  • Documented predefined macros for ptrdiff_t and size_t types.Go
  • Corrected names of the --gen_cross_reference_listing and --asm_cross_reference_listing options wherever they appear.Go
  • Added links to additional documentation to the list of --opt_level optimizations.Go
  • Added information about corresponding --opt_level to some optimization descriptions.Go
  • Native vector types are now called "TI vector types."Go
  • Examples have been updated to use constructors to initialize elements of a vector rather than cast/scalar-widening syntax.Go
  • Examples have been updated to use constructors to initialize elements of a vector rather than cast/scalar-widening syntax.Go
  • Added description of the effects of the --assume_control_regs_read option.Go

Changes from June 15, 2018 to January 14, 2022 (from Revision C (June 2018) to Revision D (January 2022))

  • This document revision is an update for the v8.3.x release. The previous revision, SPRU514C, was also published for v8.3.x.Go
  • Updated the numbering format for tables, figures, and cross-references throughout the document.Go
  • Removed references to the Processors wiki throughout the document.Go
  • Dynamic linking and dynamic loading are no longer supported by the C6000 compiler and linker.Go
  • The --small_enum option is deprecated.Go
  • MISRA-C checking is no longer supported.Go
  • Removed documentation of the --rom linker option, which is not supported.Go
  • MISRA-C checking is no longer supported.Go
  • The --small_enum option is deprecated.Go
  • Added information about default for --gen_func_subsections option.Go
  • The SET_DATA_SECTION pragma takes precedence over the --gen_data_subsections=on option.Go
  • Corrected information about default for --gen_data_subsections option.Go
  • Documented that C11 atomic operations are not supported.Go
  • Updated information about the size of enum types.Go
  • Added information about character sets and file encoding.Go
  • Pragmas for MISRA-C checking are no longer supported.Go
  • Clarify interaction between --opt_level and FUNCTION_OPTIONS pragma.Go
  • Added C++ attribute syntax for attributes that correspond to the MUST_ITERATE pragma.Go
  • The SET_DATA_SECTION pragma takes precedence over the --gen_data_subsections=on option.Go
  • Added C++ attribute syntax for attributes that correspond to the UNROLL pragma.Go
  • Documented that C11 atomic operations are not supported.Go
  • Added example using the location attribute.Go
  • Correct documentation of arguments for the _avgu4, _dmvd, _spint, and _ssub2 intrinsics.Go
  • Correct documentation of return types for the _labs and _lsadd intrinsics.Go
  • Correct documentation of assembly instructions for the _dintsp and _maxu4 intrinsics.Go
  • Correct documentation of descriptions for the _avgu4, _cmpgtu4, _rpack2, and _subabs4 intrinsics.Go
  • Clarified information about string handling functions.Go
  • Added information about time and clock RTS functions.Go

This document describes the v8.x TI Code Generation Tools for the C64x+, C6740, and C6600 variants of the TMS320C6000™ processor series. The C6200, C6400, C6700, and C6700+ variants are not supported in v8.0 and later versions of the TI Code Generation Tools. In addition, the v8.x tools no longer support the COFF object file format and the associated STABS debugging format. If you are using a legacy device or want COFF support, please use v7.4 of the Code Generation Tools and refer to SPRU187 and SPRU186 for documentation.

The following table lists changes made to this document prior to changes to the document numbering format. The left column identifies the first version of this document in which that particular change appeared.

Table 1-64 Revision History
Version Added Chapter Location Additions / Modifications / Deletions
SPRUI04C Using the Compiler,
C/C++ Language		 #GUID-59BABC3F-17EF-4BDA-9460-EA65AB368624 and #GUID-A676B826-6EEE-4FB7-9262-1E91372DF6AF The compiler now follows the C++14 standard. In addition, removed several older C++ features from the exception list because they have been supported for several releases.
SPRUI04C Using the Compiler and Optimization GUID-59BABC3F-17EF-4BDA-9460-EA65AB368624.html#unique_38_Connect_42_STDZ0581722 and #GUID-04B31129-F100-493B-9E69-7D5E6484F886 Corrected the spelling of the --disable_software_pipeline option.
SPRUI04C Using the Compiler #GUID-FF359EC0-6D08-43E3-AA27-EA1A9F598931 Added the --ecc=on linker option, which enables ECC generation. Note that ECC generation is now off by default. Also added the --no_const_clink options, which prevents the compiler from generating .clink directives for const global arrays.
SPRUI04C Using the Compiler,
C/C++ Language		 #GUID-50354AE1-9585-4868-878F-0939036324F0 and #GUID-362B62BD-A57F-4B62-B515-FB9D9A04C460 Revised the section on inline function expansion and its subsections to include new pragmas and changes to the compilers decision-making about what functions to inline. The FORCEINLINE, FORCEINLINE_RECURSIVE, and NOINLINE pragmas have been added.
SPRUI04C C/C++ Language #GUID-965A0B01-9C16-4E42-AEBB-003AFE34E9F6 and #GUID-5A2C04DB-3D30-4BED-91C1-C7F3B1DC1D3E Support for vector data types no longer requires the use of the optimizer.
SPRUI04C C/C++ Language #GUID-65EEBDAB-33A6-4AD1-98FD-3B1CCA815FC6 and #GUID-78D218C4-1A65-4CD5-AA2D-2665B500E717 Added "retain" as a function attribute and variable attribute.
SPRUI04C C/C++ Language #GUID-A925CBFA-6F2F-4AA2-BAC1-43EA9E843FFF Vector data types can be used with printf() as described in the OpenCL 1.2 specification.
SPRUI04C Run-Time Environment #GUID-DFE71BC9-F8ED-452B-9577-2E099E2FDD62 Clarified information about the alignment of __x128_t objects.
SPRUI04C Run-Time Support Functions #GUID-9F44BAF4-841E-42A9-BBA2-8A6753978CF8 Added information about the FORMAT_CONVERSION_BUFSIZE macro defined in format.h and used by functions such as printf().
SPRUI04B Using the Compiler Several compiler options have been deprecated, removed, or renamed. The compiler continues to accept some of the deprecated options, but they are not recommended for use.
SPRUI04B Using the Compiler #GUID-59BABC3F-17EF-4BDA-9460-EA65AB368624 The --multithread option has been added as both a compiler and linker option.
SPRUI04B Using the Compiler,
C/C++ Language		 #GUID-97003E53-CEE2-4243-926D-82A585EC4D26 Revised to state that --check_misra option is required even if the CHECK_MISRA pragma is used.
SPRUI04B Using the Compiler #GUID-9BFAC774-FE99-4657-9AA8-A99E6D0E9BAA Corrected the document to describe the ---gen_preprocessor_listing option. The name --gen_parser_listing was incorrect.
SPRUI04B Optimization #GUID-94AD1998-9815-4CD9-AC0A-40F74CE12241 Corrected function names for _TI_start_pprof_collection() and _TI_stop_pprof_collection().
SPRUI04B Linking C/C++ Code #GUID-62504B41-B565-469D-91C5-7417F7C2AF09 Added .ovly and .TI.crctab to list of initialized sections created by the compiler.
SPRUI04B Run-Time Environment #GUID-D48E2C0E-E51E-416A-8F21-0515C73F673A Identified the intrinsics that are defined as macros and so require that the c6x.h header file be included.
SPRUI04A Using the Compiler #GUID-59BABC3F-17EF-4BDA-9460-EA65AB368624 and #GUID-FDB5BEF2-DB94-44B7-B39A-4174561543BB The --gen_data_subsections option has been added.
SPRUI04A Run-Time Environment #GUID-549B99AD-98DB-468A-AA41-884BA7E554BD Additional boot hook functions are available. These can be customized for use during system initialization.
SPRUI04 Introduction #GUID-95851690-4BAF-4A9E-8C4C-F37D3EA7D342 The COFF object file format and the associated STABS debugging format are no longer supported. The C6000 compiler now supports only the Embedded Application Binary Interface (EABI) ABI, which works only with object files that use the ELF object file format and the DWARF debug format. Sections of this document that referred to the COFF format have been removed or simplified. If you need COFF support, please use v7.4 of the Code Generation Tools and refer to SPRU187 and SPRU186 for documentation.
SPRUI04 Getting Started #GUID-57010919-D0FC-4994-B90D-9856A104F553 Added a Getting Started chapter with introductory information for new users.
SPRUI04 Using the Compiler #GUID-B68154EB-3798-41F5-BC91-346E163891AA The --ramfunc option has been added to the compiler command-line options.
SPRUI04 Using the Compiler #GUID-62B991B6-24C4-4AF4-86E0-F757BEE76E6A The C6200, C6400, C6700, and C6700+ variants are no longer supported. Sections of this document that referred to these devices have been removed or simplified. If you are using one of these legacy devices, please use v7.4 of the Code Generation Tools and refer to SPRU187 and SPRU186 for documentation.
SPRUI04 Using the Compiler #GUID-A6EFC38A-6EF1-4E62-A91F-6B2B91AEE69D Added section on techniques for passing arguments to main().
SPRUI04 Using the Compiler #GUID-50354AE1-9585-4868-878F-0939036324F0 Corrected to state that automatic inlining is performed with --opt_level=3, but not --opt_level=2.
SPRUI04 C/C++ Language #GUID-0E24B11E-48B0-45B9-8F58-1408BBCD5F77 Added the diag_push and diag_pop diagnostic message pragmas.
SPRUI04 C/C++ Language #GUID-F63D16C2-349F-4357-935E-2F7F5E70C589 Added the NOINIT and PERSISTENT pragmas.
SPRUI04 C/C++ Language #GUID-65EEBDAB-33A6-4AD1-98FD-3B1CCA815FC6 The ramfunc function attribute has been added.
SPRUI04 C/C++ Language #GUID-965A0B01-9C16-4E42-AEBB-003AFE34E9F6 and #GUID-5A2C04DB-3D30-4BED-91C1-C7F3B1DC1D3E Added vector data types.
SPRUI04 Run-Time Environment #GUID-EA663CE9-F9EC-4E49-88A6-E33E2B797DB8 Added reference to section on accessing linker symbols in C and C++ in the Assembly Language Tools User's Guide.
SPRUI04 Run-Time Environment #GUID-D48E2C0E-E51E-416A-8F21-0515C73F673A Corrected the operands for the _shr2 and _shru2 intrinsics.

Changes from Revision () to Revision ()