7.9 Pragma Directives

Pragma directives tell the compiler how to treat a certain function, object, or section of code. The C6000 C/C++ compiler supports the following pragmas:

• CALLS (See Section 7.9.1)
• CHECK_MISRA (See Section 7.9.2)
• CLINK (See Section 7.9.3)
• CODE_SECTION (See Section 7.9.4)
• DATA_ALIGN (See Section 7.9.5)
• DATA_MEM_BANK (See Section 7.9.6)
• DATA_SECTION (See Section 7.9.7)
• diag_suppress, diag_remark, diag_warning, diag_error, diag_default, diag_push, diag_pop (See Section 7.9.8)
• FORCEINLINE (See Section 7.9.9)
• FORCEINLINE_RECURSIVE (See Section 7.9.10)
• FUNC_ALWAYS_INLINE (See Section 7.9.11)
• FUNC_CANNOT_INLINE (See Section 7.9.12)
• FUNC_EXT_CALLED (See Section 7.9.13)
• FUNC_INTERRUPT_THRESHOLD (See Section 7.9.14)
• FUNC_IS_PURE (See Section 7.9.15)
• FUNC_IS_SYSTEM (See Section 7.9.16)
• FUNC_NEVER_RETURNS (See Section 7.9.17)
• FUNC_NO_GLOBAL_ASG (See Section 7.9.18)
• FUNC_NO_IND_ASG (See Section 7.9.19)
• FUNCTION_OPTIONS (See Section 7.9.20)
• INTERRUPT (See Section 7.9.21)
• LOCATION (See Section 7.9.22)
• MUST_ITERATE (See Section 7.9.23)
• NMI_INTERRUPT (See Section 7.9.24)
• NOINIT (See Section 7.9.25)
• NOINLINE (See Section 7.9.26)
• NO_HOOKS (See Section 7.9.27)
• pack (See Section 7.9.28)
• PERSISTENT (See Section 7.9.25)
• PROB_ITERATE (See Section 7.9.29)
• RESET_MISRA (See Section 7.9.30)
• RETAIN (See Section 7.9.31)
• SET_CODE_SECTION (See Section 7.9.32)
• SET_DATA_SECTION (See Section 7.9.32)
• STRUCT_ALIGN (See Section 7.9.33)
• UNROLL (See Section 7.9.34)

Additional pragmas are provided to support the OpenMP API (see Section 8.10.1). For descriptions of these pragmas, see the OpenMP Accelerator Model User's Guide on the Texas Instruments wiki.

Most of these pragmas apply to functions. Except for the DATA_MEM_BANK pragma, the arguments func and symbol cannot be defined or declared inside the body of a function. You must specify the pragma outside the body of a function; and the pragma specification must occur before any declaration, definition, or reference to the func or symbol argument. If you do not follow these rules, the compiler issues a warning and may ignore the pragma.

For pragmas that apply to functions or symbols, the syntax differs between C and C++.

• In C, you must supply the name of the object or function to which you are applying the pragma as the first argument. Because the entity operated on is specified, a pragma in C can appear some distance way from the definition of that entity.
• In C++, pragmas are positional. They do not name the entity on which they operate as an argument. Instead, they always operate on the next entity defined after the pragma.