SPNU151W January   1998  – March 2023 66AK2E05 , 66AK2H06 , 66AK2H12 , 66AK2H14 , AM1705 , AM1707 , AM1802 , AM1806 , AM1808 , AM1810 , AM5K2E04 , C346BA02 , C348A01 , CS241C01-Q1 , CS241C05-Q1 , CS246C01-Q1 , CS348C02-Q1 , OMAP-L132 , OMAP-L137 , OMAP-L138 , S470AV336LYSQRB , TMS470R1A288 , TMS470R1A384 , TMS470R1A64 , TMS470R1B1M , TMS470R1B512 , TMS470R1B768

 

  1.   Read This First
    1.     About This Manual
    2.     Notational Conventions
    3.     Related Documentation
    4.     Related Documentation From Texas Instruments
    5.     Trademarks
  2. 1Introduction 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
  3. 2Using the C/C++ Compiler
    1. 2.1  About the Compiler
    2. 2.2  Invoking the C/C++ Compiler
    3. 2.3  Changing the Compiler's Behavior with Options
      1. 2.3.1  Linker Options
      2. 2.3.2  Frequently Used Options
      3. 2.3.3  Miscellaneous Useful Options
      4. 2.3.4  Run-Time Model Options
      5. 2.3.5  Symbolic Debugging and Profiling Options
      6. 2.3.6  Specifying Filenames
      7. 2.3.7  Changing How the Compiler Interprets Filenames
      8. 2.3.8  Changing How the Compiler Processes C Files
      9. 2.3.9  Changing How the Compiler Interprets and Names Extensions
      10. 2.3.10 Specifying Directories
      11. 2.3.11 Assembler Options
      12. 2.3.12 Deprecated Options
    4. 2.4  Controlling the Compiler Through Environment Variables
      1. 2.4.1 Setting Default Compiler Options (TI_ARM_C_OPTION)
      2. 2.4.2 Naming One or More Alternate Directories (TI_ARM_C_DIR)
    5. 2.5  Controlling the Preprocessor
      1. 2.5.1  Predefined Macro Names
      2. 2.5.2  The Search Path for #include Files
        1. 2.5.2.1 Adding a Directory to the #include File Search Path (--include_path Option)
      3. 2.5.3  Support for the #warning and #warn Directives
      4. 2.5.4  Generating a Preprocessed Listing File (--preproc_only Option)
      5. 2.5.5  Continuing Compilation After Preprocessing (--preproc_with_compile Option)
      6. 2.5.6  Generating a Preprocessed Listing File with Comments (--preproc_with_comment Option)
      7. 2.5.7  Generating Preprocessed Listing with Line-Control Details (--preproc_with_line Option)
      8. 2.5.8  Generating Preprocessed Output for a Make Utility (--preproc_dependency Option)
      9. 2.5.9  Generating a List of Files Included with #include (--preproc_includes Option)
      10. 2.5.10 Generating a List of Macros in a File (--preproc_macros Option)
    6. 2.6  Passing Arguments to main()
    7. 2.7  Understanding Diagnostic Messages
      1. 2.7.1 Controlling Diagnostic Messages
      2. 2.7.2 How You Can Use Diagnostic Suppression Options
    8. 2.8  Other Messages
    9. 2.9  Generating Cross-Reference Listing Information (--gen_cross_reference_listing Option)
    10. 2.10 Generating a Raw Listing File (--gen_preprocessor_listing Option)
    11. 2.11 Using Inline Function Expansion
      1. 2.11.1 Inlining Intrinsic Operators
      2. 2.11.2 Inlining Restrictions
    12. 2.12 Using Interlist
    13. 2.13 Controlling Application Binary Interface
    14. 2.14 VFP Support
    15. 2.15 Enabling Entry Hook and Exit Hook Functions
  4. 3Optimizing Your Code
    1. 3.1  Invoking Optimization
    2. 3.2  Controlling Code Size Versus Speed
    3. 3.3  Performing File-Level Optimization (--opt_level=3 option)
      1. 3.3.1 Creating an Optimization Information File (--gen_opt_info Option)
    4. 3.4  Program-Level Optimization (--program_level_compile and --opt_level=3 options)
      1. 3.4.1 Controlling Program-Level Optimization (--call_assumptions Option)
      2. 3.4.2 Optimization Considerations When Mixing C/C++ and Assembly
    5. 3.5  Automatic Inline Expansion (--auto_inline Option)
    6. 3.6  Link-Time Optimization (--opt_level=4 Option)
      1. 3.6.1 Option Handling
      2. 3.6.2 Incompatible Types
    7. 3.7  Using Feedback Directed Optimization
      1. 3.7.1 Feedback Directed Optimization
        1. 3.7.1.1 Phase 1 -- Collect Program Profile Information
        2. 3.7.1.2 Phase 2 -- Use Application Profile Information for Optimization
        3. 3.7.1.3 Generating and Using Profile Information
        4. 3.7.1.4 Example Use of Feedback Directed Optimization
        5. 3.7.1.5 The .ppdata Section
        6. 3.7.1.6 Feedback Directed Optimization and Code Size Tune
        7. 3.7.1.7 Instrumented Program Execution Overhead
        8. 3.7.1.8 Invalid Profile Data
      2. 3.7.2 Profile Data Decoder
      3. 3.7.3 Feedback Directed Optimization API
      4. 3.7.4 Feedback Directed Optimization Summary
    8. 3.8  Using Profile Information to Analyze Code Coverage
      1. 3.8.1 Code Coverage
        1. 3.8.1.1 Phase1 -- Collect Program Profile Information
        2. 3.8.1.2 Phase 2 -- Generate Code Coverage Reports
      2. 3.8.2 Related Features and Capabilities
        1. 3.8.2.1 Path Profiler
        2. 3.8.2.2 Analysis Options
        3. 3.8.2.3 Environment Variables
    9. 3.9  Accessing Aliased Variables in Optimized Code
    10. 3.10 Use Caution With asm Statements in Optimized Code
    11. 3.11 Using the Interlist Feature With Optimization
    12. 3.12 Debugging and Profiling Optimized Code
      1. 3.12.1 Profiling Optimized Code
    13. 3.13 What Kind of Optimization Is Being Performed?
      1. 3.13.1  Cost-Based Register Allocation
      2. 3.13.2  Alias Disambiguation
      3. 3.13.3  Branch Optimizations and Control-Flow Simplification
      4. 3.13.4  Data Flow Optimizations
      5. 3.13.5  Expression Simplification
      6. 3.13.6  Inline Expansion of Functions
      7. 3.13.7  Function Symbol Aliasing
      8. 3.13.8  Induction Variables and Strength Reduction
      9. 3.13.9  Loop-Invariant Code Motion
      10. 3.13.10 Loop Rotation
      11. 3.13.11 Instruction Scheduling
      12. 3.13.12 Tail Merging
      13. 3.13.13 Autoincrement Addressing
      14. 3.13.14 Block Conditionalizing
        1. 3.13.14.1 Block Conditionalizing C Source
        2. 3.13.14.2 C/C++ Compiler Output for
      15. 3.13.15 Epilog Inlining
      16. 3.13.16 Removing Comparisons to Zero
      17. 3.13.17 Integer Division With Constant Divisor
      18. 3.13.18 Branch Chaining
  5. 4Linking C/C++ Code
    1. 4.1 Invoking the Linker Through the Compiler (-z Option)
      1. 4.1.1 Invoking the Linker Separately
      2. 4.1.2 Invoking the Linker as Part of the Compile Step
      3. 4.1.3 Disabling the Linker (--compile_only Compiler Option)
    2. 4.2 Linker Code Optimizations
      1. 4.2.1 Generate List of Dead Functions (--generate_dead_funcs_list Option)
      2. 4.2.2 Generating Aggregate Data Subsections (--gen_data_subsections Compiler Option)
    3. 4.3 Controlling the Linking Process
      1. 4.3.1 Including the Run-Time-Support Library
        1. 4.3.1.1 Automatic Run-Time-Support Library Selection
          1. 4.3.1.1.1 Using the --issue_remarks Option
        2. 4.3.1.2 Manual Run-Time-Support Library Selection
        3. 4.3.1.3 Library Order for Searching for Symbols
      2. 4.3.2 Run-Time Initialization
      3. 4.3.3 Initialization of Cinit and Watchdog Timer Hold
      4. 4.3.4 Global Object Constructors
      5. 4.3.5 Specifying the Type of Global Variable Initialization
      6. 4.3.6 Specifying Where to Allocate Sections in Memory
      7. 4.3.7 A Sample Linker Command File
  6. 5C/C++ Language Implementation
    1. 5.1  Characteristics of ARM C
      1. 5.1.1 Implementation-Defined Behavior
    2. 5.2  Characteristics of ARM C++
    3. 5.3  Using MISRA C 2004
    4. 5.4  Using the ULP Advisor
    5. 5.5  Data Types
      1. 5.5.1 Size of Enum Types
    6. 5.6  File Encodings and Character Sets
    7. 5.7  Keywords
      1. 5.7.1 The const Keyword
      2. 5.7.2 The __interrupt Keyword
      3. 5.7.3 The volatile Keyword
    8. 5.8  C++ Exception Handling
    9. 5.9  Register Variables and Parameters
      1. 5.9.1 Local Register Variables and Parameters
      2. 5.9.2 Global Register Variables
    10. 5.10 The __asm Statement
    11. 5.11 Pragma Directives
      1. 5.11.1  The CALLS Pragma
      2. 5.11.2  The CHECK_MISRA Pragma
      3. 5.11.3  The CHECK_ULP Pragma
      4. 5.11.4  The CODE_SECTION Pragma
      5. 5.11.5  The CODE_STATE Pragma
      6. 5.11.6  The DATA_ALIGN Pragma
      7. 5.11.7  The DATA_SECTION Pragma
        1. 5.11.7.1 Using the DATA_SECTION Pragma C Source File
        2. 5.11.7.2 Using the DATA_SECTION Pragma C++ Source File
        3. 5.11.7.3 Using the DATA_SECTION Pragma Assembly Source File
      8. 5.11.8  The Diagnostic Message Pragmas
      9. 5.11.9  The DUAL_STATE Pragma
      10. 5.11.10 The FORCEINLINE Pragma
      11. 5.11.11 The FORCEINLINE_RECURSIVE Pragma
      12. 5.11.12 The FUNC_ALWAYS_INLINE Pragma
      13. 5.11.13 The FUNC_CANNOT_INLINE Pragma
      14. 5.11.14 The FUNC_EXT_CALLED Pragma
      15. 5.11.15 The FUNCTION_OPTIONS Pragma
      16. 5.11.16 The INTERRUPT Pragma
      17. 5.11.17 The LOCATION Pragma
      18. 5.11.18 The MUST_ITERATE Pragma
        1. 5.11.18.1 The MUST_ITERATE Pragma Syntax
        2. 5.11.18.2 Using MUST_ITERATE to Expand Compiler Knowledge of Loops
      19. 5.11.19 The NOINIT and PERSISTENT Pragmas
      20. 5.11.20 The NOINLINE Pragma
      21. 5.11.21 The NO_HOOKS Pragma
      22. 5.11.22 The once Pragma
      23. 5.11.23 The pack Pragma
      24. 5.11.24 The PROB_ITERATE Pragma
      25. 5.11.25 The RESET_MISRA Pragma
      26. 5.11.26 The RESET_ULP Pragma
      27. 5.11.27 The RETAIN Pragma
      28. 5.11.28 The SET_CODE_SECTION and SET_DATA_SECTION Pragmas
      29. 5.11.29 The SWI_ALIAS Pragma
      30. 5.11.30 The TASK Pragma
      31. 5.11.31 The UNROLL Pragma
      32. 5.11.32 The WEAK Pragma
    12. 5.12 The _Pragma Operator
    13. 5.13 Application Binary Interface
    14. 5.14 ARM Instruction Intrinsics
    15. 5.15 Object File Symbol Naming Conventions (Linknames)
    16. 5.16 Changing the ANSI/ISO C/C++ Language Mode
      1. 5.16.1 C99 Support (--c99)
      2. 5.16.2 C11 Support (--c11)
      3. 5.16.3 Strict ANSI Mode and Relaxed ANSI Mode (--strict_ansi and --relaxed_ansi)
    17. 5.17 GNU , Clang, and ACLE Language Extensions
      1. 5.17.1 Extensions
      2. 5.17.2 Function Attributes
      3. 5.17.3 For Loop Attributes
      4. 5.17.4 Variable Attributes
      5. 5.17.5 Type Attributes
      6. 5.17.6 Built-In Functions
    18. 5.18 AUTOSAR
    19. 5.19 Compiler Limits
  7. 6Run-Time Environment
    1. 6.1  Memory Model
      1. 6.1.1 Sections
      2. 6.1.2 C/C++ System Stack
      3. 6.1.3 Dynamic Memory Allocation
    2. 6.2  Object Representation
      1. 6.2.1 Data Type Storage
        1. 6.2.1.1 char and short Data Types (signed and unsigned)
        2. 6.2.1.2 float, int, and long Data Types (signed and unsigned)
        3. 6.2.1.3 double, long double, and long long Data Types (signed and unsigned)
        4. 6.2.1.4 Pointer to Data Member Types
        5. 6.2.1.5 Pointer to Member Function Types
        6. 6.2.1.6 Structure and Array Alignment
      2. 6.2.2 Bit Fields
      3. 6.2.3 Character String Constants
    3. 6.3  Register Conventions
    4. 6.4  Function Structure and Calling Conventions
      1. 6.4.1 How a Function Makes a Call
      2. 6.4.2 How a Called Function Responds
      3. 6.4.3 C Exception Handler Calling Convention
      4. 6.4.4 Accessing Arguments and Local Variables
    5. 6.5  Accessing Linker Symbols in C and C++
    6. 6.6  Interfacing C and C++ With Assembly Language
      1. 6.6.1 Using Assembly Language Modules With C/C++ Code
      2. 6.6.2 Accessing Assembly Language Functions From C/C++
        1. 6.6.2.1 Calling an Assembly Language Function From a C/C++ Program
        2. 6.6.2.2 Assembly Language Program Called by
        3.       237
      3. 6.6.3 Accessing Assembly Language Variables From C/C++
        1. 6.6.3.1 Accessing Assembly Language Global Variables
          1. 6.6.3.1.1 Assembly Language Variable Program
          2. 6.6.3.1.2 C Program to Access Assembly Language From
        2.       242
        3. 6.6.3.2 Accessing Assembly Language Constants
          1. 6.6.3.2.1 Accessing an Assembly Language Constant From C
          2. 6.6.3.2.2 Assembly Language Program for
          3.        246
      4. 6.6.4 Sharing C/C++ Header Files With Assembly Source
      5. 6.6.5 Using Inline Assembly Language
      6. 6.6.6 Modifying Compiler Output
    7. 6.7  Interrupt Handling
      1. 6.7.1 Saving Registers During Interrupts
      2. 6.7.2 Using C/C++ Interrupt Routines
      3. 6.7.3 Using Assembly Language Interrupt Routines
      4. 6.7.4 How to Map Interrupt Routines to Interrupt Vectors
        1. 6.7.4.1 Sample intvecs.asm File
      5. 6.7.5 Using Software Interrupts
      6. 6.7.6 Other Interrupt Information
    8. 6.8  Intrinsic Run-Time-Support Arithmetic and Conversion Routines
      1. 6.8.1 CPSR Register and Interrupt Intrinsics
    9. 6.9  Built-In Functions
    10. 6.10 System Initialization
      1. 6.10.1 Boot Hook Functions for System Pre-Initialization
      2. 6.10.2 Run-Time Stack
      3. 6.10.3 Automatic Initialization of Variables
        1. 6.10.3.1 Zero Initializing Variables
        2. 6.10.3.2 Direct Initialization
        3. 6.10.3.3 Autoinitialization of Variables at Run Time
        4. 6.10.3.4 Autoinitialization Tables
          1. 6.10.3.4.1 Length Followed by Data Format
          2. 6.10.3.4.2 Zero Initialization Format
          3. 6.10.3.4.3 Run Length Encoded (RLE) Format
          4. 6.10.3.4.4 Lempel-Ziv-Storer-Szymanski Compression (LZSS) Format
          5. 6.10.3.4.5 Sample C Code to Process the C Autoinitialization Table
        5. 6.10.3.5 Initialization of Variables at Load Time
        6. 6.10.3.6 Global Constructors
      4. 6.10.4 Initialization Tables
    11. 6.11 Dual-State Interworking Under TIABI (Deprecated)
      1. 6.11.1 Level of Dual-State Support
      2. 6.11.2 Implementation
        1. 6.11.2.1 Naming Conventions for Entry Points
        2. 6.11.2.2 Indirect Calls
          1. 6.11.2.2.1 C Code Compiled for 16-BIS State: sum( )
          2. 6.11.2.2.2 16-Bit Assembly Program for
          3. 6.11.2.2.3 C Code Compiled for 32-BIS State: sum( )
          4. 6.11.2.2.4 32-Bit Assembly Program for
          5.        286
  8. 7Using Run-Time-Support Functions and Building Libraries
    1. 7.1 C and C++ Run-Time Support Libraries
      1. 7.1.1 Linking Code With the Object Library
      2. 7.1.2 Header Files
      3. 7.1.3 Modifying a Library Function
      4. 7.1.4 Support for String Handling
      5. 7.1.5 Minimal Support for Internationalization
      6. 7.1.6 Support for Time and Clock Functions
      7. 7.1.7 Allowable Number of Open Files
      8. 7.1.8 Nonstandard Header Files in the Source Tree
      9. 7.1.9 Library Naming Conventions
    2. 7.2 The C I/O Functions
      1. 7.2.1 High-Level I/O Functions
        1. 7.2.1.1 Formatting and the Format Conversion Buffer
      2. 7.2.2 Overview of Low-Level I/O Implementation
        1.       open
        2.       close
        3.       read
        4.       write
        5.       lseek
        6.       unlink
        7.       rename
      3. 7.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. 7.2.4 Adding a User-Defined Device Driver for C I/O
        1. 7.2.4.1 Mapping Default Streams to Device
      5. 7.2.5 The device Prefix
        1.       add_device
        2.       321
        3. 7.2.5.1 Program for C I/O Device
    3. 7.3 Handling Reentrancy (_register_lock() and _register_unlock() Functions)
    4. 7.4 Library-Build Process
      1. 7.4.1 Required Non-Texas Instruments Software
      2. 7.4.2 Using the Library-Build Process
        1. 7.4.2.1 Automatic Standard Library Rebuilding by the Linker
        2. 7.4.2.2 Invoking mklib Manually
          1. 7.4.2.2.1 Building Standard Libraries
          2. 7.4.2.2.2 Shared or Read-Only Library Directory
          3. 7.4.2.2.3 Building Libraries With Custom Options
          4. 7.4.2.2.4 The mklib Program Option Summary
      3. 7.4.3 Extending mklib
        1. 7.4.3.1 Underlying Mechanism
        2. 7.4.3.2 Libraries From Other Vendors
  9. 8C++ Name Demangler
    1. 8.1 Invoking the C++ Name Demangler
    2. 8.2 Sample Usage of the C++ Name Demangler
  10.   A Glossary
    1.     A.1 Terminology
  11.   B Revision History
  12.   B Earlier Revisions

Earlier Revisions

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.

Earlier Revisions
Version Added Chapter Location Additions / Modifications / Deletions
SPNU151V Linking Section 4.3.5 Clarified that either --rom_model or --ram_model is required if only the linker is being run, but --rom_model is the default if the compiler runs on C/C++ files on the same command line.
SPNU151V C/C++ Language Section 5.11.22 The #pragma once is now documented for use in header files.
SPNU151V Run-Time Environment Section 6.10.3.1 Clarified that zero initialization takes place only if the --rom_model linker option is used, not if the --ram_model option is used.
SPNU151U -- throughout -- The default file extensions for object files created by the compiler have been changed in order to prevent conflicts when C and C++ files have the same names. Object files generated from C source files have the .c.obj extension. Object files generated from C++ source files have the .cpp.obj extension.
SPNU151T Using the Compiler Section 2.3.1 Added the --emit_references:file linker option.
SPNU151T Using the Compiler Section 2.5.1 Documented that C standard macros such as __STDC_VERSION__ are supported.
SPNU151T C/C++ Language Section 5.11 Added documentation for the CODE_ALIGN pragma.
SPNU151T C/C++ Language Section 5.11.19 Clarify section placement for the NOINIT and PERSISTENT pragmas.
SPNU151T C/C++ Language Section 5.14 Corrected syntax for the _norm intrinsic.
SPNU151T C/C++ Language Section 5.16.1 Updated list of C99 non-supported run-time functions.
SPNU151T C/C++ Language Section 5.17.2 Added documentation for the aligned, calls, naked, and weak function attributes.
SPNU151T C/C++ Language Section 5.17.4 Added documentation for the location and packed variable attributes.
SPNU151T Run-Time Support Functions DEV_lseek topic Corrected syntax documented for DEV_lseek function.
SPNU151S Introduction,
Using the Compiler,
C/C++ Language
Section 1.3, Section 2.3, Section 5.1, and Section 5.16.2 Added support for C11.
SPNU151S Using the Compiler Section 2.3.1 Added the --ecc=on linker option, which enables ECC generation. Note that ECC generation is now off by default.
SPNU151S Using the Compiler Section 2.5.1 The __TI_STRICT_ANSI_MODE__ and __TI_STRICT_FP_MODE__ macros are defined as 0 if their conditions are false.
SPNU151S Using the Compiler,
C/C++ Language
Section 2.11 and Section 5.11 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.
SPNU151S C/C++ Language Section 5.2 C++11 features related to atomics are now supported. In addition, removed several C++ features from the exception list because they have been supported for several releases.
SPNU151S C/C++ Language Section 5.6 Added information about character sets and file encoding.
SPNU151S C/C++ Language Section 5.14 Corrected syntax for _smac intrinsic.
SPNU151S C/C++ Language Section 5.17.2 and Section 5.17.4 Added "retain" as a function attribute and variable attribute.
SPNU151S C/C++ Language Section 5.17.6 Clarified the availability of the __builtin_sqrt() and __builtin_sqrtf() functions.
SPNU151R Using the Compiler,
C/C++ Language
Section 2.3 and Section 5.2 The compiler now follows the C++14 standard.
SPNU151R C/C++ Language Section 5.17 The compiler now supports several Clang __has_ macro extensions.
SPNU151R C/C++ Language Section 5.17.1 The wrapper header file GCC extension (#include_next) is now supported.
SPNU151Q Using the Compiler,
C/C++ Language
Table 2-31, Section 5.1, Section 5.14, Section 5.17.2 ARM C Language Extensions (ACLE) are supported.
SPNU151Q Using the Compiler Section 2.14 Updated the list of settings for the --float_support option.
SPNU151Q C/C++ Language Section 5.2 Preliminary changes have been made in order to support C++14 in a future release. These changes may cause linktime errors. Recompile object files to resolve these errors.
SPNU151Q C/C++ Language Section 5.7.1 Clarified exceptions to const data storage set by the const keyword.
SPNU151Q C/C++ Language Section 5.14 Remove incorrect third parameter for the _smuad, _smuadx, _smusd, and _smusdx intrinsics.
SPNU151P Optimization Section 3.7.1.4 Corrected error in command to process the profile data.
SPNU151O Using the Compiler,
C/C++ Language
Section 2.3.3 Revised to state that --check_misra option is required even if the CHECK_MISRA pragma is used.
SPNU151O Using the Compiler,
C/C++ Language, and
Run-Time Support Functions
Section 2.5.1, Section 5.16, and Section 7.1.1 _AEABI_PORTABILITY_LEVEL can be defined to enable full object file portability when headers files are included.
SPNU151O Using the Compiler Section 2.10 Corrected the document to describe the ---gen_preprocessor_listing option. The name --gen_parser_listing was incorrect.
SPNU151N Optimization Section 3.7.3 Corrected function names for _TI_start_pprof_collection() and _TI_stop_pprof_collection().
SPNU151M Using the Compiler Section 2.3 The default for --cinit_compression and --copy_compression has been changed from RLE to LZSS.
SPNU151M 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.
SPNU151M Using the Compiler Section 2.5.1 The __little_endian__ and __big_endian__ macros are preceded by two underscores.
SPNU151M C/C++ Language Section 5.14 The following intrinsics are supported for Cortex-M3: __ldrex, __ldrexb, __ldrexh, __strex, __strexb, and __strexh.
SPNU151M Run-Time Environment Section 6.8.1 The _enable_interrupts, _enable_IRQ, _enable_FIQ, _disable_interrupts, _disable_IRQ, and _disable_FIQ intrinsics for Cortex-R4 and Cortex-A8 now use the CPSIE and CPSID instructions.
SPNU151L Using the Compiler Section 2.3 and Section 4.2.2 The --gen_data_subsections option has been added.
SPNU151L Using the Compiler Section 2.3.5 The --symdebug:dwarf_version option can be set to 4 to enable the use of DWARF debugging format version 4.
SPNU151L Optimization Section 3.7 and Section 3.8 Feedback directed optimization is described. This technique can be used for code coverage analysis.
SPNU151L C/C++ Language Section 5.11.1 A CALLS pragma has been added to specify a set of functions that can be called indirectly from a specified calling function. Using this pragma allows such indirect calls to be included in the calculation of a functions' inclusive stack size.
SPNU151L C/C++ Language Section 5.14 The following intrinsics have been added to the documentation: __MCR, __MRC.
SPNU151L Run-Time Environment Section 6.10.1 Additional boot hook functions are available. These can be customized for use during system initialization.
SPNU151K Introduction Section 1.4 The COFF object file format and the TI_ARM9_ABI and TIARM ABIs are no longer supported. The ARM Code Generation Tools now support 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 would like to produce COFF output files, please use v5.2 of the ARM Code Generation Tools and refer to SPNU151J for documentation.

The --abi=coff, --symdebug:profile_coff, --no_sym_merge, and --diable_clink options have been deprecated.

SPNU151K Using the Compiler Section 2.3.4 The --ramfunc option has been added. If set, this option places all functions in RAM.
SPNU151K C/C++ Language Section 5.14 The following intrinsics have been added to the documentation: __nop, __sqrt, __sqrtf, __wfi, __wfe
SPNU151K C/C++ Language Section 5.17.2 The ramfunc function attribute has been added. It specifies that a function should be placed in RAM.
SPNU151K Run-Time Support Functions Section 7.1.2 Added information about header file extensions.
SPNU151J Introduction Section 1.3 Added support for C99 and C++03.
SPNU151J Using the Compiler Table 2-1 Added --endian=[big | little] option.
SPNU151J Using the Compiler Table 2-6, Section 2.7, and Section 2.3.3 Added the --advice:power and --advice:power_severity options for use with the ULP Advisor.
SPNU151J Using the Compiler Table 2-8 Added support for C99 and C++03. The -gcc option has been deprecated. The --relaxed_ansi option is now the default.
SPNU151J Using the Compiler Table 2-8 Removed documentation of precompiled headers, which have been deprecated.
SPNU151J Using the Compiler Table 2-11 and Section 2.7.1 Added --section_sizes option for diagnostic reporting of section sizes.
SPNU151J Using the Compiler Table 2-28 and Section 4.3.3 Added the –cinit_hold_wdt linker option.
SPNU151J Using the Compiler Section 2.5.1 Added __TI_ ARM_V7M4__ predefined macro name for Cortex-M4.
SPNU151J Using the Compiler Section 2.5.3 Documented that the #warning and #warn preprocessor directives are supported.
SPNU151J Using the Compiler Section 2.6 Added section on techniques for passing arguments to main().
SPNU151J Using the Compiler Section 2.11 Documented that the inline keyword is now enabled in all modes except C89 strict ANSI mode.
SPNU151J C/C++ Language Section 5.1.1 Added section documenting implementation-defined behavior.
SPNU151J C/C++ Language Section 5.4 Added support for the ULP Advisor
SPNU151J C/C++ Language Section 5.5.1 Added documentation on the size of enum types.
SPNU151J C/C++ Language Section 5.11.3, Section 5.11.12, Section 5.11.13, Section 5.11.19, and Section 5.11.26 Added the CHECK_ULP, FUNC_ALWAYS_INLINE, FUNC_CANNOT_INLINE, NOINIT, PERSISTENT, and RESET_ULP pragmas.
SPNU151J C/C++ Language Section 5.11.16, Section 5.11.27, and Section 5.17.2 Added C++ syntax for the INTERRUPT and RETAIN pragmas. Also removed unnecessary semicolons from #pragma syntax specifications. Also the GCC interrupt and alias function attributes are now supported.
SPNU151J C/C++ Language Section 5.11.8 Added the diag_push and diag_pop diagnostic message pragmas.
SPNU151J C/C++ Language Section 5.14 Added __delay_cycles, __get_PRIMASK, __set_PRIMASK, __get_MSP, and __set_MSP intrinsics.
SPNU151J C/C++ Language Section 5.14 Corrected arguments for smlalbb, smlalbt, smlaltb, smlaltt, smlabb, smlabt, smlatb, and smlatt intrinsics.
SPNU151J C/C++ Language Section 5.16, Section 5.16.1, and Section 5.16.3 Added support for C99 and C++03. The --relaxed_ansi option is now the default and --strict_ansi is the other option; "normal mode" for standards violation strictness is no longer available.
SPNU151J Run-Time Environment Section 6.5 Added reference to section on accessing linker symbols in C and C++ in the Assembly Language Tools User's Guide.
SPNU151J Run-Time Environment Section 6.7.5 Added information about allowable return values from SWI handlers.
SPNU151J Run-Time Environment Section 6.8.1 Added instructions for several device families for _disable_interrupts, _enable_interrupts, and _restore_interrupts intrinsics. Added Cortex-M support for _enable_IRQ, _disable_IRQ, and _set_interrupt_priority intrinsics.
SPNU151J Run-Time Environment Section 6.10.1 Added support for system pre-initialization.
SPNU151J Run-Time Support Functions Section 7.1.3 RTS source code is no longer provided in a rtssrc.zip file. Instead, it is located in separate files in the lib/src subdirectory of the compiler installation.
SPNU151J C++ Name Demangler Section 8.1 Corrected information about name demangler options.
SPNU151J C++ Name Demangler Section 8.2 Corrected examples of resulting assembly output.