COMPILER C/C++ COMPILER simple --abi true 3 As of version 8.0.0 of the C6000 Code Generation Tools the only ABI supported is the ELF EABI. The specification of an --abi option is unnecessary. ONEOF required coffabi,eabi,elfabi coffabi eabi elfabi eabi 6 As of version 8.0.0 of the C6000 Code Generation Tools COFF ABI support is discontinued. If COFF ABI support is needed for your application, please use the latest version 7.4.x of the C6000 Code Generation Tools. ABI --abi=eabi Application binary interface (coffabi not supported) Specify application binary interface (option deprecated). COFFABI is no longer supported; to use it use Code Generation Tools 7.4.x. Default is eabi. cmdline --abs_directory -fb STRING required dir Absolute listing directory (default is .obj dir) Absolute listing directory (default is .obj dir) cmdline --absolute_listing -aa Generate absolute listing file Generate absolute listing file simple --advice:performance ONEOF optional all,none all none all Provide advice on optimization techniques Provide advice on optimization techniques to ensure use of right options and improve software pipelining. simple --advice:performance_dir STRING required opt Place advice file in specified directory Place advice file in specified directory simple --advice:performance_file STRING optional opt Place advice in specified file Place advice in specified file simple --aliased_variables -ma Assume called funcs create hidden aliases (rare) Assume called funcs create hidden aliases (rare) simple --analyze ONEOF required codecov,callgraph codecov callgraph Generate analysis info from profile data Generate analysis information about code coverage or call graph information in the form of CSV files. This information can then be read and interpreted by other tools. For example, the cache layout tool, clt6x, can be used to interpret the call graph information and produce a preferred function order that can be incorporated into the application link. The compiler can only generate one kind of analysis information for a given invocation of the compiler. GEN_PROFILE_INFO simple --analyze_only Only generate analysis Generate analysis only; do not continue compilation. This option is used in combination with the --analyze option to instruct the compiler to halt the compilation after it has completed the generation of analysis information requested in the --analyze option. GEN_PROFILE_INFO simple --ap_extension -el STRING required .ext Extension for linear asm files (default is .sa) Extension for linear asm files (default is .sa) simple --ap_file -fl STRINGLIST required filename File is a linear asm file (default for .sa) File is a linear asm file (default for .sa) simple --asm_define -ad STRINGLIST required NAME[=value] Pre-define assembly symbol NAME Pre-define the assembly symbol NAME, optionally setting its contents to 'value'. simple --asm_dependency -apd STRING optional filename Generate assembly dependency information Generate assembly dependency information. Optionally, name the assembly dependency file. simple --asm_directory -fs STRING required dir Assembly file directory (default is .) Assembly file directory (default is .) simple --asm_extension -ea STRING required .ext Extension for assembly files (default is .asm) Extension for assembly files (default is .asm) simple --asm_file -fa STRINGLIST required filename File is an assembly file (default for .asm) File is an assembly file (default for .asm) simple --asm_includes -api Generate first-level assembly include file list Generate first-level assembly include file list simple --asm_listing -al Generate listing file Generate listing file simple --asm_undefine -au STRINGLIST required NAME Undefine assembly symbol NAME Undefine assembly symbol NAME simple --auto_inline -oi NUMBER optional size Specify threshold for automatic inlining Specify threshold for automatic inlining simple --big_endian -me Generate big endian code Generate big endian code ENDIAN --endian=big simple --buffer_diagnostics -pdb Line buffer diagnostic output Line buffer diagnostic output to reduce message mixing when compiling in parallel. simple --c++03 Compile program in C++03 mode. Compile program in C++03 mode. EMBEDDED_CPP simple --c89 Compile program in ANSI C89 mode. Compile program in ANSI C89 mode. C99 KR_COMPATIBLE simple --c99 Compile program in C99 mode. Compile program in C99 mode. KR_COMPATIBLE C89 simple --c_extension -ec STRING required .ext Extension for C files (default is .c) Extension for C files (default is .c) simple --c_file -fc STRINGLIST required filename File is a C file (default for .c/no ext) File is a C file (default for .c/no ext) simple --c_src_interlist -ss Generate C source interlisted assembly file Generate C source interlisted assembly file SRC_INTERLIST simple --call_assumptions -op RANGE required 0-3 Specify call assumptions when optimizing Specify assumptions to make about function calls when optimizing. Level 0 (-op0) indicates that the module has functions that are called from other modules. Level 1 (-op1) indicates that the module does not have functions that are called by other modules but has global variables that are modified in other modules. Level 2 (-op2) indicates that the module does not have functions that are called or globals that are modified by other modules. Level 3 (-op3) indicates that the module has functions that are called by other modules but does not have globals that are modified by other modules. simple --check_misra STRINGLIST optional RULE all Enable checking of MISRA-C:2004 rules Enable verification of the MISRA-C:2004 rules, 'Guidelines for the use of the C language in critical systems.' For information on MISRA-C, see http://www.misra.org.uk. MISRA and MISRA-C are trademarks of MIRA Ltd. <body> <group id="required" name="Required"/> <group id="advisory" name="Advisory"/> <category id="1" name="Environment"> <rule id="1.1" groups="required" name="All code shall conform to ISO 9899:1990 &quot;Programming languages - C&quot;, amended and corrected by ISO/IEC 9899/COR1:1995, ISO/IEC 9899/AMD1:1995, and ISO/IEC 9899/COR2:1996."/> </category> <category id="2" name="Language extensions"> <rule id="2.1" groups="required" name="Assembly language shall be encapsulated and isolated."/> <rule id="2.2" groups="required" name="Source code shall only use /* ... */ style comments."/> <rule id="2.3" groups="required" name="The character sequence /* shall not be used within a comment."/> </category> <category id="3" name="Documentation"> </category> <category id="4" name="Character sets"> <rule id="4.1" groups="required" name="Only those excape sequences that are defined in the ISO C standard shall be used."/> <rule id="4.2" groups="required" name="Trigraphs shall not be used."/> </category> <category id="5" name="Identifiers"> <rule id="5.2" groups="required" name="Identifiers in an inner scope shall not use the same name as an identifier in an outer scope, and therefore hide that identifier."/> <rule id="5.3" groups="required" name="A typedef name shall be a unique identifier."/> <rule id="5.4" groups="required" name="A tag name shall be a unique identifier."/> <rule id="5.6" groups="advisory" name="No identifier in one name space should have the same spelling as an identifier in another name space, with the exception of structure and union member names."/> <rule id="5.7" groups="advisory" name="No identifier name should be reused"/> </category> <category id="6" name="Types"> <rule id="6.1" groups="required" name="The plain char type shall be used only for storage and use of character values."/> <rule id="6.2" groups="required" name="signed and unsigned char type shall be used only of the storage and use of numeric values."/> <rule id="6.3" groups="advisory" name="typedefs that indicate size and signedness should be used in place of the basic numerical types."/> <rule id="6.4" groups="required" name="Bit fields shall only be defined to be of type unsigned inti or signed int."/> <rule id="6.5" groups="required" name="Bit fields of the type signed int shall be at least 2 bits long."/> </category> <category id="7" name="Constants"> <rule id="7.1" groups="required" name="Octal extensions (other than zero) and octal escape sequences shall not be used."/> </category> <category id="8" name="Declarations and definitions"> <rule id="8.1" groups="required" name="Functions shall have prototype declarsions and the prototype shall be visible at both the function definition and call."/> <rule id="8.2" groups="required" name="Whenever an object or function is declared or defined, its type shall be explicitly stated."/> <rule id="8.5" groups="required" name="There shall be no definitions of objects or functons in a header file."/> <rule id="8.6" groups="required" name="Functions shall be declared at file scope."/> <rule id="8.7" groups="required" name="Objects shall be defined at block scope if they are only accessed from within a single function."/> <rule id="8.8" groups="required" name="An external object or function shall be declared in one and only one file."/> <rule id="8.11" groups="required" name="The static storage class specifier shall be used in definitions and declarations of objects and functions that have internal linkage."/> <rule id="8.12" groups="required" name="When an array is declared with external linkage, its size shall be stated explicitly or defined implicitly by initialization."/> </category> <category id="9" name="Initialization"> <rule id="9.1" groups="required" name="All automatic variables shall have been assigned a value before being used."/> <rule id="9.2" groups="required" name="Braces shall be used to indicate and match the structure in the non-zero initialization of arrays and structures."/> <rule id="9.3" groups="required" name="In an enumerator list, the &quot;=&quot; construct shall not be used to explicitly initialize members other than the first, unless all items are explicitly initialized."/> </category> <category id="10" name="Arithmetic type conversions"> <rule id="10.1" groups="required" name="The value of an expression of integer type shall not be implicitly converted to a different underlying type if: a) it is not a conversion to a wider integer type of the same signedness, or b) the expression is complex, or c) the expression is not constant and is a function argument, or d) the expression is not constant and is a return expression."/> <rule id="10.2" groups="required" name="The value of an expression of floating type shall not be implicitly converted to a different type if: a) it is not a conversion to a wider floating type, or b) the expression is complex, or c) the expression is a function argument, or d) the expression is a return expression."/> <rule id="10.3" groups="required" name="The value of a complex expression of integer type may only be cast to a type that is narrower and of the same signedness as the underlying type of the expression."/> <rule id="10.4" groups="required" name="The value of a complex expression of floating type may only be cast to a narrower floating type."/> <rule id="10.5" groups="required" name="If the bitwise operations ~ and &lt;&lt; are applied to an operand of underlying type unsigned char or unsigned short, the result shall immediately cast to the underlying type of the operand."/> <rule id="10.6" groups="required" name="A &quot;U&quot; suffix shall be applied to all constans of unsigned type."/> </category> <category id="11" name="Pointer type conversions"> <rule id="11.1" groups="required" name="Conversions shall not be performed between a pointer to a function and any type other than an integral type."/> <rule id="11.2" groups="required" name="Conversions shall not be perfornmed between a pointer to object and any type other than an integral type, another pointer to object type or a pointer to void."/> <rule id="11.3" groups="advisory" name="A cast should not be performed between a pointer type and an integral type."/> <rule id="11.4" groups="advisory" name="A cast should not be performed between a pointer to object type and a different pointer to object type."/> <rule id="11.5" groups="required" name="A cast shall not be performed that removes any const or volatile qualifications from the type addressed by a pointer."/> </category> <category id="12" name="Expressions"> <rule id="12.1" groups="advisory" name="Limited dependence should be placed on C's operator precedence rules in expressions."/> <rule id="12.2" groups="required" name="The value of an expression shall be the same under any order of evaluation that the standard permits."/> <rule id="12.3" groups="required" name="The sizeof operator shall not be used on expression that contain side effects."/> <rule id="12.4" groups="required" name="The right-hand operand of a logical &amp;&amp; or || operator shall not contain side effects."/> <rule id="12.5" groups="required" name="The operations of a logical &amp;&amp; or || shall be primary-expressions."/> <rule id="12.6" groups="advisory" name="The operands of logical operators (&amp;&amp;, || and !) should be effectively Boolean. Expressions that are effectively Boolean should not be used as operands to operators other than (&amp;&amp;, || and !)."/> <rule id="12.7" groups="required" name="Bitwise operators shall not be applied to operands whose underlying type is signed."/> <rule id="12.8" groups="required" name="The right-hand operand of a shift operator shall lie between zero and one less than the width in bits of the underlying type of the left-hand operand."/> <rule id="12.9" groups="required" name="The unary minus operator shall not be applied to an expression whose underlying type is unsigned."/> <rule id="12.10" groups="required" name="The comma operator shall not be used"/> <rule id="12.13" groups="advisory" name="The increment (++ and decrement (--) operators should not be mixed with other operators in an expression."/> </category> <category id="13" name="Control statement expressions"> <rule id="13.1" groups="required" name="Assignment operators shall not be used in expressiopns that yield a Boolean value."/> <rule id="13.2" groups="advisory" name="Tests of a value against zero should be made explicit, unless the operand is effectively Boolean."/> <rule id="13.3" groups="required" name="Floating-point expressions shall not be tested for equality nor inequality."/> <rule id="13.4" groups="required" name="The controlling expression of a for statement shall not contain any objects of floating type."/> <rule id="13.5" groups="required" name="The three expressions of a for statement shall be concerned only with loop control."/> <rule id="13.6" groups="required" name="Numeric variables being used within a for loop for iteration counting shall not be modified in the body of the loop."/> </category> <category id="14" name="Control Flow"> <rule id="14.1" groups="required" name="There shall be no unreachable code."/> <rule id="14.2" groups="required" name="All non-null statements shall either: a) have at least one side effect however executed, or b) cause cohntrol flow to change."/> <rule id="14.3" groups="required" name="Before preprocessing, a null statement shall only occur on a line by itself; it may be followed by a comment provided that the first character following the null statement is a white-space character."/> <rule id="14.4" groups="required" name="The goto statement shall not be used."/> <rule id="14.5" groups="required" name="The continue statement shall not be used."/> <rule id="14.6" groups="required" name="For any iteration statement there shall be at most one break statement used for loop termination."/> <rule id="14.7" groups="required" name="A function shall have a single point of exit at the end of the function."/> <rule id="14.8" groups="required" name="The statement forming the body of a switch, while, do ... while or for statement shall be a compound statement."/> <rule id="14.9" groups="required" name="An if (expression) construct shall be followed by a compound statement. The else keyword shall be followed by either a compound statement, or another if statement."/> <rule id="14.10" groups="required" name="All if ... else if constructs shall be terminated with an else clause."/> </category> <category id="15" name="Switch statements"> <rule id="15.1" groups="required" name="A switch label shall only be used when the most closely-enclosing compound statement is the body of a switch statement."/> <rule id="15.2" groups="required" name="An unconditional break statement shall terminate every non-empty switch clause."/> <rule id="15.3" groups="required" name="The final clause of a switch statement sahll be the default clause."/> <rule id="15.4" groups="required" name="A switch statement shall not represent a value that is effectively Boolean."/> <rule id="15.5" groups="required" name="Every switch statement shall have at least one case clause."/> </category> <category id="16" name="Functions"> <rule id="16.1" groups="required" name="Functions shall not be defined with variable numbers of arguments."/> <rule id="16.3" groups="required" name="Identifiers shall be given for all of the parameters in a functuion protoype declaration."/> <rule id="16.4" groups="required" name="The identifiers used in the declaration and definition of a function shall be identical."/> <rule id="16.5" groups="required" name="Functions with no parameters shall be declared with parameter type void."/> <rule id="16.7" groups="advisory" name="A pointer parameter in a function prototype shall be declared as pointer to const if the pointer is not used to modify the adressed object."/> <rule id="16.8" groups="required" name="All exit paths from a function with non-void return type shall have an explicit return statement with an expression."/> <rule id="16.9" groups="required" name="A function identifier shall only be used with either a preceding &amp;, or with a parenthesized parameter list, which may be empty."/> </category> <category id="17" name="Pointers and arrays"> <rule id="17.4" groups="required" name="Array indexing shall be the only allowed form of pointer arithmetic."/> <rule id="17.5" groups="advisory" name="The declaration of objects should contain no more than 2 levels of pointer indirection."/> <rule id="17.6" groups="required" name="The address of an object with automatic storage shall not be assigned to another object that may persist after the first object has ceased to exist."/> </category> <category id="18" name="Structures and unions"> <rule id="18.1" groups="required" name="All structure or union types shall be complete at the end of a translation unit."/> <rule id="18.4" groups="required" name="Unions shall not be used."/> </category> <category id="19" name="Preprocessing directives"> <rule id="19.1" groups="advisory" name="#include statements in a file should only be preceded by other preprocessor directives or comments."/> <rule id="19.2" groups="advisory" name="Non-standard characters should not occur in header file hnames in #include directives."/> <rule id="19.3" groups="required" name="The #include directive shall be followed by either a &lt;filename&gt; or &quot;filename&quot; sequence."/> <rule id="19.4" groups="required" name="C macros shall only expand to a braced initializer, a constant, a parenthesized expression, a type qualifier, a storage class specifier, or a do-while-zero construct."/> <rule id="19.5" groups="required" name="Macros shall not be #define'd or #undef'd within a block."/> <rule id="19.6" groups="required" name="#undef shall not be used."/> <rule id="19.7" groups="advisory" name="A function should be used in preference to a function-like macro."/> <rule id="19.8" groups="required" name="A function-like macro shall not be invoked without all of its arguments."/> <rule id="19.9" groups="required" name="Arguments to a function-like macro shall not contain tokens that look like preprocessing directives."/> <rule id="19.10" groups="required" name="In the definition of a function-like macro each instance of a parameter shall be enclosed in parentheses unless it it used as the operand of # or ##."/> <rule id="19.11" groups="required" name="All macro identifiers in preprocessor directives shall be defined before use, except in #ifdef and #ifndef preprocessor directives and the defined() operator."/> <rule id="19.12" groups="required" name="There shall be at most one occurrence of the # or ## preprocessor operators in a single macro definition."/> <rule id="19.13" groups="advisory" name="The # and ## preprocessor operators should not be used."/> <rule id="19.14" groups="required" name="The defined preprocessor operator shall only be used in one of the two standard forms."/> <rule id="19.15" groups="required" name="Precautions shall be taken in order to prevent the contents of a header file being included twice."/> <rule id="19.16" groups="required" name="Preprocessoing directives shall be syntactically meaningful even when excluded by the preprocessor."/> <rule id="19.17" groups="required" name="All #else, #elif and #endif preprocessor directives shall reside in the same file as the #if or #ifdef directive to which they are related."/> </category> <category id="20" name="Standard libraries"> <rule id="20.1" groups="required" name="Reserved identifiers, macros and functions in the standard library, shall not be defined, redefined or undefined."/> <rule id="20.2" groups="required" name="The names of standard library macros, obhjects and functions shall not be reused."/> <rule id="20.4" groups="required" name="Dynamic heap memory allocation shall not be used."/> <rule id="20.5" groups="required" name="The error indicator errno shall not be used."/> <rule id="20.6" groups="required" name="The macro offsetof, in library &lt;stddef.h&gt;, shall not be used."/> <rule id="20.7" groups="required" name="The setjmp macro and the longjmp function shall not be used."/> <rule id="20.8" groups="required" name="The signal handling facilities of &lt;signal.h&gt; shall not be used."/> <rule id="20.9" groups="required" name="The input/output library &lt;stdio.h&gt; shall not be used in production code."/> <rule id="20.10" groups="required" name="The library functions atof, atoi and atol from library &lt;stdlib.h&gt; shall not be used."/> <rule id="20.11" groups="required" name="The library functions abort, exit, getenv and system from library &lt;stdlib.h&gt; shall not be used."/> <rule id="20.12" groups="required" name="The time handling functions of library &lt;time.h&gt; shall not be used."/> </category> </body> simple --cmd_file -@ STRINGLIST required filename Read options from specified file Read additional compile options the specified filename. cmdline --compile_only -c Disable linking (overrides -z) Disable linking, overriding -z (if used). cmdline --compiler_revision Print compiler revision and exit Print out the compiler release revision and exit. simple --copy_file -ahc STRINGLIST required filename Simulate source '.copy filename' Simulate source '.copy filename' simple --cpp_default -fg Treat C files as C++ files Treat C files as C++ files simple --cpp_extension -ep STRING required .ext Extension for C++ files (default is .cpp) Extension for C++ files (default is .cpp) simple --cpp_file -fp STRINGLIST required filename File is a C++ file (default for .C .cpp .cc) File is a C++ file (default for .C .cpp .cc) simple --create_pch STRING required filename Create a precompiled header file as named Create a precompiled header file with the name specified. This option specifies the filename for the precompiled header file. If this option is not used, the precompiled header file will use the primary source file name as its filename with .pch as suffix. simple --cross_reference -ax Generate cross reference file Generate cross reference file simple --debug_software_pipeline -mw Generate verbose software pipelining information Generate verbose software pipelining information KEEP_ASM --keep_asm simple --define -D STRINGLIST required NAME[=value] Pre-define NAME Pre-define a symbol with the id 'NAME', optionally setting it's contents to 'value'. simple --diag_error -pdse STRINGLIST required id Treat diagnostic <id> as error Treat diagnostic <id> as error simple --diag_remark -pdsr STRINGLIST required id Treat diagnostic <id> as remark Treat diagnostic <id> as remark simple --diag_suppress -pds STRINGLIST required id Suppress diagnostic <id> Suppress diagnostic <id> simple --diag_warning -pdsw STRINGLIST required id Treat diagnostic <id> as warning Treat diagnostic <id> as warning simple --diag_wrap ONEOF optional on,off on off on Wrap diagnostic messages Set diagnostic messages to wrap at 79 columns (on) or not (off). simple --disable_push_pop Disable push-pop optimization. Disable code-size optimization that calls RTS functions _push_rts() and _pop_rts(). simple --disable_software_pipeline -mu Disable software pipelining Disable software pipelining simple --display_error_number -pden Emit diagnostic identifier numbers Emit the diagnostic identifier numbers along with diagnostic messages. These identifiers can be used with options such as -pds to suppress a specific diagnostic. simple --dprel Always use DP-relative addressing for data (ELF only) Always use DP-relative addressing for data (ELF only) simple --dsbt Generate addressing via Dynamic Segment Base Table This option causes the compiler to load the DP from the Data Segment Address Table (DBST) for every function marked exported. This allows each dynamic object to have its own near DP segment and allows efficient near DP addressing in each dynamic module. simple --embedded_cpp -pe Embedded C++ Enable support for embedded C++ CPLUSPLUS03 simple --emit_warnings_as_errors -pdew Treat warnings as errors Treat warnings as errors NO_WARNINGS simple --entry_hook STRING optional hook_function_name __entry_hook Insert this call at entry to each function Insert this call at entry to each function simple --entry_parm ONEOF required name,address,none name address none Pass caller's name or address to entry hook Pass caller's name or address to entry hook simple --exceptions Enable C++ exception handling Enable C++ exception handling RTTI --rtti DISABLE_CUSTOM_CALL_CONV --disable_custom_call_conv simple --exit_hook STRING optional hook_function_name __exit_hook Insert this call at exit from each function Insert this call at exit from each function simple --exit_parm ONEOF required name,address,none name address none Pass caller's name or address to exit hook Pass caller's name or address to exit hook simple --export_all_cpp_vtbl Export C++ virtual tables by default If a c++ class is not exported, its virtual table and typeinfo are not exported. This option exports these symbols for all classes. simple --extern_c_can_throw Allow extern C functions to propagate exceptions This option is only supported under EABI for table-driven exception handling (TDEH). This option is valid only when `--exceptions` is also present. This option allows a function defined in C++ with extern `C` linkage to propagate exceptions. simple --float_operations_allowed ONEOF required all,32,64,none all 32 64 none Floating point precision accepted by compiler Control the acceptable precision of floating point operations. The default is all. simple --fp_mode ONEOF required relaxed,strict relaxed strict strict Floating Point mode Specify a floating point mode. In relaxed mode if the result of a double-precision floating point expression is assigned to a single-precision floating-point or an integer, the computations in the expression are converted to single-precision computations. Any double-precision constants in the expression are also converted to single-precision if they will fit. Hardware instructions may replace floating point library calls when available. Floating point arithmetic reassociation is also allowed. This behavior is not ISO conformant, but results in faster/smaller code, with some loss in accuracy. simple --fp_not_associative -mc Do not reorder floating point operations Do not reorder floating point operations FP_REASSOC --fp_reassoc=off simple --fp_reassoc ONEOF required on,off on off on Allow reassociation of FP arithmetic Set to on to allow reassociation of floating point arithmetic even in cases where the reassociation will result in a slightly different answer. simple --gcc Enable support for GCC extensions (DEPRECATED) This option enables the support for GCC extensions. This feature is incompatible with strict ANSI mode. RELAXED_ANSI --relaxed_ansi STRICT_ANSI simple --gen_acp_raw -pl Output raw listing to .rl file Output raw listing to .rl file simple --gen_acp_xref -px Output xref listing to .crl file Output xref listing to .crl file simple --gen_func_subsections -mo ONEOF optional on,off on off on Place each function in a separate subsection Place each function in a separate subsection USE_DEAD_FUNCS_LIST RAMFUNC simple --gen_opt_info -on RANGE required 0-2 Generate optimizer information file at level [0-2] Set the optimizer information file level, or disable with 0. Level 1 includes basic information. Level 2 includes detailed information. The file will be created in the assembly directory if a custom asm directory is specified on the command line otherwise it will be created in the object file directory. simple --gen_profile_info Generate profile feedback data Instrument the object code that is generated for a compilation with path profiling information. The compiler will annotate the code that is generated for an application so that, when executed, the application can generate information about which code paths were executed and how often. This profile data can then be used by subsequent compiles to analyze code coverage or call graph information to assist with subsequent development. ANALYZE USE_PROFILE_INFO cmdline --help -h Show help screen Show usage information. When followed by another option or a phrase display that option's detailed information, or search for options related to that phrase. simple --import_helper_functions Treat compiler helper functions as imported refs This option tells the compiler to treat calls to compiler helper functions as imported references. Compiler helper functions are part of the runtime support library. This option is useful in platforms that support dynamic shared objects (DSO/DLL) where the OS can provide runtime support in a shared object. Without this option, the compiler treats helper function calls as non-imported references and the supporting runtime functions are statically linked in by the static linker. simple --import_undef ONEOF optional on,off on off on Import all undefined symbols This option imports all undefined symbols. simple --include_file -ahi STRINGLIST required filename Simulate source '.include filename' Simulate source '.include filename' simple --include_path -I STRINGLIST required dir Add dir to #include search path Add the specified dir(ectory) to the #include file search path list. simple --inline_plt ONEOF optional on,off on off on Inline the import function call stub. The linker generates an import function call stub to call an imported function. This linker generated call stub is called 'Procedure Linkage Table' (PLT) entry. The PLT entry is similar to a trampoline. The performance of the generated code can be improved if the PLT entry is inlined. This option makes the compiler inline the PLT. Note that the use of this option can increase the code size in some cases. Also the dynamic load time can increase as the dynamic linker needs to patch more entries simple --interrupt_threshold -mi NUMBER optional # Specify maximum disabled interrupt cycles Specify the maximum number of cycles that interrupts may be disabled. simple --issue_remarks -pdr Issue remarks Issue remarks, which are normally suppressed. simple --keep_asm -k Keep the generated assembly language (.asm) file Keep the generated assembly language (.asm) file simple --keep_unneeded_statics Do not delete unreferenced static variables The parser, by default, will remark about and then remove any unreferenced static variables. This option will keep the parser from deleting unreferenced static variables and any static functions that are, in turn referenced by these variables. simple --kr_compatible -pk K & R compatibility Enable K & R C compatibility. C89 C99 simple --linux Generate code for Linux Set all the necessary options to build code for Linux. ABI --abi=eabi DSBT --dsbt GEN_PIC --gen_pic STATIC_TLS --static_tls=off simple --list_directory -ff STRING required dir Listing/xref file directory (default is .obj dir) Listing/xref file directory (default is .obj dir) ASM_LISTING --asm_listing simple --listing_extension -es STRING required .ext Extension for listing files (default is .lst) Extension for listing files (default is .lst) simple --llopt ONEOF required 0,1,2,3 0 1 2 3 LLVM Optimization Level Run LLVM with specified optimization level simple --machine_regs Display reg operands as machine registers in asm When compiling linear assembly, register operands can be displayed in the assembly file as either machine registers or symbolic registers. Symbolic registers is the default. Use this option to display machine registers in the assembly file when compiling linear assembly. When compiling C/C++ machine registers are the default. simple --mem_model:const ONEOF required data,far,far_aggregates data far far_aggregates data Const access model Const access model simple --mem_model:data ONEOF required near,far,far_aggregates near far far_aggregates far_aggregates Data access model Data access model simple --misra_advisory ONEOF required error,warning,remark,suppress error warning remark suppress Set severity of MISRA 'advisory' rule class Set diagnostic severity level for the MISRA advisory class of rules. See the --check_misra option for further information. simple --misra_required ONEOF required error,warning,remark,suppress error warning remark suppress Set severity of MISRA 'required' rule class Set the diagnostic severity level for the MISRA required class of rules. See the --check_misra option for further information. simple --multibyte_chars -pc Multibyte character support Enable parser support for multibyte character sequences in comments, string literals, and character constants. simple --multithread Multi-threading is assumed Indicate that application uses multi-threading or prefers to be linked with a thread-safe version of the RTS library USE_LIBC_TLS --use_libc_tls simple --no_bad_aliases -mt Assume no irregular alias or loop behavior Assume no irregular alias or loop behavior simple --no_compress Disable compression for 6400+ This option disables compression (use of 16-bit instructions) for 6400+. It also tells the assembler to (1) prevent labeled execute packets from spanning fetch packet boundaries, (2) pad the end of code sections to 32-byte boundaries, and (3) handle .align directives. Normally for 6400+, these are the responsibilities of the compressor (cmp6x). simple --no_const_clink Do not generate .clink for .const sections Do not generate .clink directives for const global arrays. By default these arrays are placed in a .const subsection and conditionally linked. simple --no_inlining -pi Ignore inline keyword Ignore the inline keyword while parsing. simple --no_intrinsics -pn Disable intrinsic functions Disable intrinsic functions in the parser. simple --no_reload_errors Prevent loop buffer reload-related error detection Prevent detection of loop buffer reload-related errors. Accept loop buffer assembly code that would normally cause the assembler to issue loop buffer reload-related errors. simple --no_warnings -pdw Suppress warnings Suppress all parser warnings. EMIT_WARNINGS_AS_ERRORS simple --obj_directory -fr STRING required dir Object file directory (default is .) Object file directory (default is .) simple --obj_extension -eo STRING required .ext Extension for object files (default is .obj) Extension for object files (default is .obj) OUTPUT_FILE simple --obj_file -fo STRINGLIST required filename File is an object file (default for .obj) File is an object file (default for .obj) simple --openmp --omp Enable support for OpenMP 3.0 Enable support for OpenMP 3.0 MULTITHREAD --multithread simple --opt_for_space -ms RANGE optional 0-3 0 Optimize for code size Optimize for code size simple --opt_for_speed -mf RANGE optional 0-5 4 Speed vs. size trade-offs Control speed vs. size trade-offs in optimization. A value of 5 indicates fully optimizing for speed with a potentially large code size penalty, while a value of 0 indicates fully optimizing for size. Values between 0 and 5 indicate trade-offs between the two extremes. simple --opt_level -O ONEOF optional off,0,1,2,3 off 0 1 2 3 2 Optimization level Set compiler optimization level. Level 0 includes register optimizations. Level 1 adds local optimizations. Level 2 further adds global optimizations. Level 3 further adds interprocedure optimizations. simple --optimize_with_debug -mn ONEOF optional on,off on off on Optimize fully in the presence of debug (DEPRECATED) Optimize fully in the presence of debug (DEPRECATED) simple --output_all_syms -as Keep local symbols in output file Keep local symbols in output file simple --output_file -fe STRING required filename Compilation output file name, can override --obj_directory Compilation output file name, can override --obj_directory OBJ_EXTENSION simple --pch Automatically create/use precompiled headers Automatically create and/or use precompiled header files. This option will enable EDG parser to provide a mechanism for, in effect, taking a snapshot of the state of the compilation at a particular point and writing it to a disk file before completing the parsing; then, when recompiling the same source file or compiling another file with the same set of header files, it can recognize the `snapshot point`, and reload this file instead of recompile these headers. In this way, compilation time can be reduced. simple --pch_dir STRING required dir Specify precompiled header path Specify path where precompiled header file will reside. This option will direct the parser to put the generated precompiled header file in the specified directory. If this option is not used, the precompiled header file will be put into the same directory as the primary source file simple --pch_verbose Info on considered & unused precompiled headers This option displays a message for each precompiled header file that is considered but can not be used. It also gives the reason why it can not be used. simple --pending_instantiations NUMBER required # limit pending template instantiations The number of template instantiations that may be in progress at any given time. Use 0 to specify an unlimited number. simple --pic ONEOF optional near,far near far near Position-independent addressing for a shared object Generate position-independent addressing for a dynamic shared object. All externally visible objects will be addressed through a Global Offset Table (GOT). DSBT --dsbt cmdline --pp_directory STRING required dir Preprocessor file directory (default is .) Place preprocessor output files in specified directory. The directory must exist prior to compiler invocation. simple --preinclude STRINGLIST required filename Specify a preinclude file Include the source code of the indicated file at the beginning of the compilation. This can be used to establish standard macro definitions, etc. The file name is searched for in the directories on the include search list. The files are processed in the order in which they were specified. cmdline --preproc_dependency -ppd STRING optional filename Generate include file dependency information Generate a dependency list for the source file into the file <filename>.pp and then exit. Optionally, name the output file. The output will include all files included in the source file as well as any of the files included. Also see the -ppa option to continue compilation after generating the dependency list (similar to gcc). PREPROC_ONLY PREPROC_WITH_LINE PREPROC_WITH_COMMENT PREPROC_INCLUDES PREPROC_MACROS cmdline --preproc_includes -ppi STRING optional filename Generate first-level include file list Generate an include list for the source file into the file <filename>.pp and then exit. Optionally, name the output file. The output will include only those files directly included by the source file. Also see the -ppa option to continue compilation after generating the include list (similar to gcc). PREPROC_ONLY PREPROC_WITH_COMMENT PREPROC_WITH_LINE PREPROC_MACROS PREPROC_DEPENDENCY cmdline --preproc_macros -ppm STRING optional filename Generate list of pre- & user-defined macros Generate a list of predefined and user defined macros for the source file into the file <filename>.pp and then exit. Optionally, name the output file. The output will include only those files directly included by the source file. Also see the -ppa option to continue compilation after generating the macro list (similar to gcc). PREPROC_ONLY PREPROC_WITH_COMMENT PREPROC_WITH_LINE PREPROC_INCLUDES PREPROC_DEPENDENCY cmdline --preproc_only -ppo Preprocess only Only preprocess the source file(s) and then stop. PREPROC_INCLUDES PREPROC_MACROS PREPROC_DEPENDENCY cmdline --preproc_with_comment -ppc Preprocess only; maintain comments Only preprocess the source file(s) and then stop; maintain source comments in the output. PREPROC_INCLUDES PREPROC_MACROS PREPROC_DEPENDENCY cmdline --preproc_with_compile -ppa Continue compilation after using -pp<X> options. This option instructs the compiler to additionally continue compilation of the source file (rather than exiting) after generating a pre-processing .pp output file such as those generated by -ppd (dependencies) -ppi (included files), or -ppm (macros). cmdline --preproc_with_line -ppl Preprocess only; maintain line directives Only preprocess the source file(s) and then stop; maintain #line directives in the output.. PREPROC_DEPENDENCY PREPROC_INCLUDES PREPROC_MACROS simple --printf_support ONEOF required nofloat,minimal,full nofloat minimal full Level of printf/scanf support required The printf and scanf families of functions are large because they provide complex formatting capabilities, which may not be required in typical embedded applications. Use this option to reduce code size by eliminating features. This option must be specified at link time. Use '--printf_support=nofloat' to exclude support for printing and scanning floating values. All format specifiers except %f, %F, %g, %G, %e, and %E are supported. Use '--printf_support=minimal' to exclude support for width and precision flags and all format specifiers except %%, %d %o, %c, %s, and %x. simple --profile:breakpt Compile for breakpoint-based profiling Disable optimizations that cannot be handled by a breakpoint-based profiler SYMDEBUG__NONE simple --profile:power Compile for power profiling Enable power profiling support by inserting NOPs into the frame code. These NOPs can then be instrumented by the power profiling tooling to track power usage of functions. If the power profiling tool is not used, this option will increase the cycle count of each function because of the NOPs. This switch also disables optimizations that cannot be handled by the power-profiler. SYMDEBUG__NONE cmdline --program_level_compile -pm Program mode compilation Enable program mode compilation. simple --quiet -q Quiet Mode Suppress common compiler non-diagnostic output. Remarks, errors and warnings will still be generated, as well as feature specific status. SUPER_QUIET VERBOSE simple --ramfunc ONEOF optional on,off on off on Run functions from RAM. Indicate that each function will be run out of RAM. Functions will be placed in RAM and optimized for RAM execution. Equivalent to specifying __attribute__((ramfunc)) on all functions in the translation units compiled with this option. For additional information, see http://processors.wiki.ti.com/index.php/Ramfunc_Attribute GEN_FUNC_SUBSECTIONS USE_DEAD_FUNCS_LIST simple --relaxed_ansi -pr Relaxed parsing (non-strict ANSI) Enable relaxed ANSI source parsing mode. STRICT_ANSI simple --remove_hooks_when_inlining Remove entry/exit hooks from inlined functions Remove the entry and exit hooks from the bodies of inlined functions. simple --rtti -rtti Support C++ run-time type information Support C++ run-time type information cmdline --run_linker -z STRING optional arguments Perform link using options following After compiling all the source files, perform a link and pass all the options following this option to the linker. simple --sat_reassoc ONEOF required on,off on off off Allow reassociation of sat arithmetic Set to on to allow reassociation of saturating arithmetic even in cases where the reassociation will cause saturation to occur differently. simple --section_sizes ONEOF optional on,off on off on Output section size summary information. Output section size summary information for code, const, and data. simple --set_error_limit -pdel NUMBER required count Set error limit to <count> Set error limit to <count> simple --silicon_version -mv STRING required id 6500 Target processor version Target processor version simple --single_inline Inline functions only called once. Inline function that are called only once. Will inline these functions even if auto inlining has been turned off (-oi0) cmdline --skip_assembler -n Compile only; do not assemble Compile only; do not assemble KEEP_ASM --keep_asm simple --speculate_loads -mh STRING optional bytes|'auto' Specify speculative load byte count threshold or 'auto' Specify the number of bytes the compiler is allowed to speculatively load beyond the proven allocated memory. The argument 0 (-mh=0) has a special meaning and turns off speculative loads. The special argument 'auto' (-mh=auto) means the compiler chooses the number of bytes and also adds required padding during link step. -mh with no argument means no limit on the number of bytes loaded speculatively by the compiler. simple --speculate_unknown_loads Speculate loads with unbounded address ranges Speculate loads with unbounded address ranges simple --src_interlist -s Generate interlisted assembly file Generate interlisted assembly file C_SRC_INTERLIST simple --static_template_instantiation Do static early template instantiation All template entities are instantiated as needed in the file. The instantiations are given internal (static) linkage. singlefile --std_lib_func_defined -ol1 File contains an RTS library function. File contains an RTS library function. singlefile --std_lib_func_not_defined -ol2 File does not define any RTS library func (def.) File does not define any RTS library func (def.) singlefile --std_lib_func_redefined -ol0 File redefines an RTS library function. File redefines an RTS library function. simple --strict_ansi -ps Strict ANSI mode (errors) Enable strict ANSI source parsing mode. Any source violating strict ANSI guidelines will generate a parsing error. GCC RELAXED_ANSI simple --strip_coff_underscore Aid for transitioning hand-coded assembly from COFF to ELF Strip underscores from externally defined or referenced symbols to aid transition of hand-coded assembly code from COFF to ELF. simple --super_quiet -qq Super Quiet Mode Suppress all compiler non-diagnostic output. Remarks, errors and warnings will still be generated. VERBOSE QUIET simple --symdebug:coff Full symbolic debug (COFF, deprecated) Enable full symbolic COFF debugging in the generated object or out file (DEPRECATED). SYMDEBUG__NONE SYMDEBUG__SKELETAL SYMDEBUG__DWARF SYMDEBUG__PROFILE_COFF simple --symdebug:dwarf -g Full symbolic debug Enable full symbolic DWARF debugging in the generated object or out file. SYMDEBUG__COFF SYMDEBUG__NONE SYMDEBUG__SKELETAL SYMDEBUG__PROFILE_COFF simple --symdebug:dwarf_version ONEOF required 2,3,4 2 3 4 Specify DWARF version Specify DWARF version SYMDEBUG__NONE SYMDEBUG__COFF SYMDEBUG__PROFILE_COFF simple --symdebug:keep_all_types Keep unreferenced type info (default for elf w/ debug) Keep referenced type info (default for elf w/ debug) KEEP_UNNEEDED_TYPES --keep_unneeded_types=true simple --symdebug:none Suppress all symbolic debug generation Disable debug and suppress all symbolic debug information from being included in the generated object or out file. OCS_ACTIVE PROFILE__POWER PROFILE__BREAKPT SYMDEBUG__PROFILE_COFF SYMDEBUG__DWARF SYMDEBUG__SKELETAL SYMDEBUG__COFF simple --symdebug:profile_coff Function profile debug (COFF, deprecated) Adds the necessary debug directives to the object file which are needed by the profiler to allow function level profiling with minimal impact on optimization (if optimization is enabled). Using -g may hinder some optimizations to ensure that debugability is maintained, while this option will not hinder optimization. You will still be able to set breakpoints and profile on function-level boundaries, but you will not be able to single-step through code as with full debug ability. SYMDEBUG__SKELETAL SYMDEBUG__DWARF SYMDEBUG__COFF SYMDEBUG__NONE simple --symdebug:skeletal Symbolic debug for program analysis (DEPRECATED) Enable symbolic debug information for program analysis. (DEPRECATED) SYMDEBUG__COFF SYMDEBUG__NONE SYMDEBUG__DWARF SYMDEBUG__PROFILE_COFF simple --syms_ignore_case -ac Symbol names are not case-significant Symbol names are not case-significant simple --target_compatibility_6200 -mb Enable 62xx compatibility (Option disabled) Enable 62xx compatibility (Option disabled) DISABLE_PUSH_POP --disable_push_pop DISABLE_STRASGI_64PLUS --disable_strasgi_64plus DISABLE_CUSTOM_CALL_CONV --disable_custom_call_conv simple --temp_directory -ft STRING required dir Temporary file directory (default is .) Temporary file directory (default is .) simple --tool_version -version Print version numbers for each tool Print version numbers for each tool simple --undefine -U STRINGLIST required NAME Undefine NAME Undefine the symbol with the id 'NAME'. simple --use_const_for_alias_analysis -ox Use const to disambiguate pointers. Treats pointer-to-const as an indication that no other store within the pointer's scope will affect the pointer's target. simple --use_pch STRING required filename Precompiled header file for compilation This option specifies the file name of the precompiled header file for this compilation. simple --use_profile_info STRINGLIST optional filelist Use profile feedback file(s) This option is used in combination with the --analyze option to generate analysis information about code coverage or call graph information in the form of CSV files. This information can then be read and interpreted by other tools. For example, the cache layout tool, clt6x, can be used to interpret the call graph information and produce a preferred function order that can be incorporated into the application link. The compiler can only generate one kind of analysis information for a given invocation of the compiler. GEN_PROFILE_INFO simple --vectypes --vtypes ONEOF optional on,off on off on Support OpenCL C-like vector types Support OpenCL C-like vector types USE_G3 --use_g3 simple --verbose Display banner and function progress information Display progress information and toolset version when executing. QUIET SUPER_QUIET simple --verbose_diagnostics -pdv Verbose diagnostics Enable verbose diagnostic information from the parser, including the source line of the error and an indicator of the error position within the line. simple --visibility ONEOF required default,protected,hidden default protected hidden Specify visibility of global symbols. This option specifies the ELF visibility attribute of the global symbols. The ELF visibility attribute controls if and how the symbol can be accessed by other modules. simple --wchar_t ONEOF required 16,32 16 32 16 Set the size (in bits) of the C/C++ type wchar_t (16,32) Designate the size of the C/C++ type wchar_t. In EABI mode users can choose either 16-bit or 32-bit wchar_t type. Note that objects built with 16-bit wchar_t are not compatible with 32-bit wchar_t objects. The default is 16-bit wchar_t. simple --write_diagnostics_file -pdf Output diagnostic to .err file Write diagnostics to an .err file instead of the standard output. The file name with be the same as the source file but with an .err extension. simple -W STRINGLIST required -W[warning_argument] Give Clang warning argument Forwards a warning argument to Clang Quiet Level RESET optional VERBOSE QUIET SUPER_QUIET Debugging model OVERRIDE optional SYMDEBUG__DWARF SYMDEBUG__COFF SYMDEBUG__PROFILE_COFF SYMDEBUG__NONE SYMDEBUG__SKELETAL Source interlist OVERRIDE optional SRC_INTERLIST C_SRC_INTERLIST C Dialect RESET optional C89 C99 KR_COMPATIBLE C++ Dialect RESET optional CPLUSPLUS03 EMBEDDED_CPP Language mode RESET optional RELAXED_ANSI STRICT_ANSI Preprocessor Analysis Options OVERRIDE optional PREPROC_DEPENDENCY PREPROC_INCLUDES PREPROC_MACROS Function Subsections OVERRIDE optional GEN_FUNC_SUBSECTIONS RAMFUNC Processor Options: SILICON_VERSION BIG_ENDIAN ABI Optimization: OPT_LEVEL OPT_FOR_SPEED OPT_FOR_SPACE Include Options: INCLUDE_PATH PREINCLUDE Performance Advisor: ADVICE__PERFORMANCE_DIR ADVICE__PERFORMANCE_FILE ADVICE__PERFORMANCE Advanced Options: CONTROL SYMDEBUG PARSER PREPROC DEFINES PDIAG MODEL OPTIM OCS HOOK FEEDBACK LIB GRAPH ASM FILE DIRECTORY FILEEXT INTERNAL DYNAMIC CMDFILES MISRA Control Options: COMPILE_ONLY SKIP_ASSEMBLER HELP RUN_LINKER Advanced Debug Options: MUTEX_DEBUGGING_MODEL OPTIMIZE_WITH_DEBUG SYMDEBUG__KEEP_ALL_TYPES MACHINE_REGS SYMDEBUG__DWARF_VERSION Language Options: MUTEX_C_DIALECT MUTEX_C___DIALECT MUTEX_LANGUAGE_MODE KEEP_UNNEEDED_STATICS EXTERN_C_CAN_THROW MULTIBYTE_CHARS PCH VECTYPES GEN_ACP_XREF EXCEPTIONS PROGRAM_LEVEL_COMPILE CPP_DEFAULT PENDING_INSTANTIATIONS GEN_ACP_RAW PCH_VERBOSE RTTI GCC NO_INLINING USE_PCH FLOAT_OPERATIONS_ALLOWED NO_INTRINSICS CREATE_PCH PCH_DIR STATIC_TEMPLATE_INSTANTIATION Parser Preprocessing Options: MUTEX_PREPROCESSOR_ANALYSIS_OPTIONS PREPROC_WITH_COMMENT PREPROC_ONLY PREPROC_WITH_COMPILE PREPROC_WITH_LINE Predefined Symbols: LLOPT UNDEFINE DEFINE W Diagnostic Options: MUTEX_QUIET_LEVEL TOOL_VERSION DIAG_SUPPRESS DIAG_WRAP DIAG_WARNING COMPILER_REVISION SECTION_SIZES ISSUE_REMARKS VERBOSE_DIAGNOSTICS NO_WARNINGS EMIT_WARNINGS_AS_ERRORS WRITE_DIAGNOSTICS_FILE SET_ERROR_LIMIT DIAG_ERROR DISPLAY_ERROR_NUMBER DIAG_REMARK BUFFER_DIAGNOSTICS Runtime Model Options: MUTEX_FUNCTION_SUBSECTIONS NO_RELOAD_ERRORS PROFILE__POWER NO_BAD_ALIASES SAT_REASSOC USE_CONST_FOR_ALIAS_ANALYSIS FP_REASSOC WCHAR_T INTERRUPT_THRESHOLD MEM_MODEL__DATA NO_COMPRESS TARGET_COMPATIBILITY_6200 DEBUG_SOFTWARE_PIPELINE SPECULATE_LOADS DISABLE_SOFTWARE_PIPELINE DPREL PROFILE__BREAKPT MEM_MODEL__CONST FP_NOT_ASSOCIATIVE SPECULATE_UNKNOWN_LOADS Advanced Optimizations: MULTITHREAD REMOVE_HOOKS_WHEN_INLINING GEN_OPT_INFO DISABLE_PUSH_POP OPENMP SINGLE_INLINE AUTO_INLINE CALL_ASSUMPTIONS FP_MODE ALIASED_VARIABLES Entry/Exit Hook Options: EXIT_HOOK EXIT_PARM ENTRY_HOOK ENTRY_PARM Feedback and Analysis Options: ANALYZE GEN_PROFILE_INFO USE_PROFILE_INFO ANALYZE_ONLY Library Function Assumptions: STD_LIB_FUNC_NOT_DEFINED PRINTF_SUPPORT STD_LIB_FUNC_REDEFINED STD_LIB_FUNC_DEFINED Assembler Options: KEEP_ASM MUTEX_SOURCE_INTERLIST ASM_LISTING ASM_UNDEFINE ASM_DEPENDENCY STRIP_COFF_UNDERSCORE SYMS_IGNORE_CASE INCLUDE_FILE ABSOLUTE_LISTING COPY_FILE OUTPUT_ALL_SYMS ASM_DEFINE CROSS_REFERENCE ASM_INCLUDES NO_CONST_CLINK File Type Specifier: CPP_FILE C_FILE OBJ_FILE ASM_FILE AP_FILE Directory Specifier: PP_DIRECTORY OBJ_DIRECTORY ASM_DIRECTORY TEMP_DIRECTORY LIST_DIRECTORY ABS_DIRECTORY OUTPUT_FILE Default File Extensions: OBJ_EXTENSION ASM_EXTENSION AP_EXTENSION CPP_EXTENSION LISTING_EXTENSION C_EXTENSION Dynamic Linking Support Options: EXPORT_ALL_CPP_VTBL INLINE_PLT DSBT IMPORT_UNDEF PIC VISIBILITY LINUX IMPORT_HELPER_FUNCTIONS Command Files: CMD_FILE MISRA-C:2004: MISRA_REQUIRED CHECK_MISRA MISRA_ADVISORY LINKER C/C++ LINKER simple --absolute_exe -a Produce absolute executable object file (default) Produce absolute executable object file (default) simple --arg_size --args HEXNUMBER required size Set C argc/argv memory size Set C argc/argv memory size simple --bind_now Disable Linux default lazy binding mechanisms Disable Linux default lazy binding mechanisms simple --buffer_diagnostics -pdb Line buffer diagnostic output Line buffer diagnostic output to reduce message mixing when compiling in parallel. simple --cinit_compression STRING optional compression_kind rle Compress ELF C style auto initialization data Specify the compression to apply to the c auto initialization data simple --compress_dwarf ONEOF optional on,off on off on Aggressively reduce size of the DWARF information Aggressively reduce the size of the DWARF information. When this option used, the DWARF information is parsed and examined to look for and eliminate duplicate types, and builds a .debug_abbrev table for the whole program. simple --copy_compression STRING optional compression_kind rle Compress ELF sections copied using copy tables Overlays can be managed by using linker generated copy tables. To save ROM space, the linker can compress the data copied by copy tables. The compressed data is decompressed during copy. simple --define STRINGLIST required name=value Pre-define preprocessor macro _name_ to _value_ Pre-define preprocessor macro _name_ to _value_ simple --diag_error STRINGLIST required id Treat diagnostic <id> as error Treat diagnostic <id> as error simple --diag_remark STRINGLIST required id Treat diagnostic <id> as remark Treat diagnostic <id> as remark simple --diag_suppress STRINGLIST required id Suppress diagnostic <id> Suppress diagnostic <id> simple --diag_warning STRINGLIST required id Treat diagnostic <id> as warning Treat diagnostic <id> as warning simple --diag_wrap ONEOF optional on,off on off on Wrap diagnostic messages Set diagnostic messages to wrap at 79 columns (on) or not (off). simple --disable_auto_rts Disable automatic RTS selection Do not attempt to automatically select and link a runtime library. simple --disable_clink -j Disable conditional linking and ignore .clink Disable conditional linking; ignore all .clink directives. simple --disable_pp Don't use C preprocessor for command files This disables preprocessing of linker command files. simple --display_error_number Emit diagnostic identifier numbers Emit diagnostic identifier numbers simple --dsbt_index NUMBER required index The DSBT index of this component The Data Segment Base Table (DSBT) contains the Data Page (DP) pointer for each component (executable or shared object) in a dynamic linking system. A dynamic component uses a unique index to access its DP value. This index can be allocated at run time by the dynamic loader or can be statically assigned via this option. The index value should be less than the DSBT size. simple --dsbt_size NUMBER required size The size of Data Segment Base Table (DSBT) in words The Data Segment Base Table (DSBT) contains the Data Page (DP) pointer for each component (executable or shared object) in a dynamic linking system. Each dynamic component in the system has an entry in the DSBT. This option specifies the size of the DSBT, and should be no less than the number of dynamic components in the system. simple --dynamic ONEOF optional exe,lib exe lib exe Generate dynamic executable or a dynamic library Generate a dynamic executable or a dynamic library for use in an application that is dynamically linked and relocated at load time simple --ecc:data_error STRINGLIST required (address|symbol+offset),[page,]bitmask Introduce bit errors --ecc:data_error=(address|symbol+offset),[page,]bitmask - Introduce bit errors in the outfile. The bits to be flipped in the outfile are located in the unit at the specified offset. The offset is relative to either the origin of the page, or relative to the position of the base symbol, if specified. The default page is zero, and any page may be specified. The bits to be flipped at the specified location are indicated by set bits in the bitmask. In effect, the data in the outfile will be the bitwise-exclusive-or of the bitmask with original code or data. Bit errors can only be applied to initialized data, such as the contents of Flash memory. The effective address of the error must lie inside either the output memory range or the input memory range of an ECC specification. simple --ecc:ecc_error STRINGLIST required (address|symbol+offset),[page,]bitmask Introduce bit errors in ECC memory --ecc:ecc_error=(address|symbol+offset),[page,]bitmask - Introduce bit errors in corresponding ECC memory. This option behaves like the --ecc:data_error option, except that the bits are not flipped in the code/data memory at the specified location. Instead, the bits are flipped in the ECC memory area that corresponds to the specified location. The bitmask is 8 bits wide. In the presence of mirroring, bits will be flipped in all mirrored copies of the corresponding ECC byte. The effective address of the error must lie inside the input memory range of an ECC specification. simple --emit_warnings_as_errors -pdew Treat warnings as errors Treat warnings as errors NO_WARNINGS simple --entry_point -e STRING required symbol Specify program entry point for the output module Specify program entry point for the output module NO_ENTRY_POINT simple --export STRINGLIST required sym Export specified symbol This option makes the specified global symbol an exported definition. Global symbols that are given restricted (hidden) visibility by source code annotations will not be exported by this option. simple --fill_value -f HEXNUMBER required value Default fill value for holes in output sections Set the default fill value for filling holes in output sections. simple --fini STRING required sym Specify the symbol name of the finalization code This option sets the entry point symbol for finalization code. The dynamic loader calls the finalization code when it unloads a dynamically loaded object. When this option is used, the linker generates the DT_FINI dynamic tag and sets it to the address of the symbol. RETAIN --retain=$sym simple --forced_static_binding ONEOF optional on,off on off on Force all import references to bind during static linking Force all import references to bind during static linking. simple --globalize STRINGLIST required pattern Do not localize symbols matching pattern The option '--localize=l_pattern' makes the symbols matching the l_pattern hidden. The '--globalilze=g_pattern' option excludes symbols matching g_pattern from symbol localization provided g_pattern is more restrictive than l_pattern. simple --heap_size -heap --heap HEXNUMBER required size Heap size for C/C++ dynamic memory allocation Specify the maximum heap size for C/C++ dynamic memory allocation. simple --hide STRINGLIST required pattern Hide symbols matching pattern Hide the symbols matching the pattern by changing the name to empty string simple --import STRINGLIST required sym Import specified symbol This option makes specified global symbol an imported references. Global symbols that are given restricted (hidden) visibility by source code annotations will not be imported by this option. simple --init STRING required sym Specify the symbol name of the initialization code This option sets the entry point symbol for initialization code. The dynamic loader calls the initialization code when it loads a dynamically loaded object. When this option is used, the linker generates the DT_INIT dynamic tag and sets it to the address of the symbol. RETAIN --retain=$sym simple --issue_remarks Issue remarks Issue remarks simple --library -l STRINGLIST required file Include library file or command file as input Include library file or command file as input cmdline --linker_help -help --help Display usage information Display usage information. Followed by another option, will display detailed information on that option. simple --localize STRINGLIST required pattern Make the symbols matching pattern local Given a symbol name pattern, make all the symbols matching this pattern local simple --make_global -g STRINGLIST required symbol Don't make global symbol static if -h is specified Don't make global symbol static if -h is specified simple --make_static -h Make all global symbols static Make all global symbols static simple --map_file -m STRING required file Link information (map) listed into <file> Produce a listing of all input and output sections into <file>. simple --mapfile_contents STRING required attribute Display attribute settings in map file Enable the display of <attribute> or disable with no<attribute> in the linker generated map file. Multiple attributes can be specified by separating them with commas (e.g. --mapfile_contents=sections,nosymbols). Type --mapfile_contents=help for a list of attributes. simple --minimize_trampolines ONEOF optional postorder,off postorder off postorder Select trampoline minimization algorithm This option attempts to place sections so as to minimize the number of far call trampolines required, possibly at the expense of optimal memory packing. The argument selects a heuristic to use. The 'postorder' heuristic attempts to place functions before their callers so that the PC-relative offset is known when the caller is placed. simple --multithread Multi-threading is used; choose thread-safe RTS library Multi-threading is used; choose thread-safe RTS library simple --no_demangle Don't demangle symbol names in diagnostics Don't demangle symbol names in diagnostics simple --no_sym_merge -b No type merging in symbolic debugging information Disable type merging in symbolic debugging information. simple --no_symtable -s Strip symbol table and line number entries Strip symbol table and line number entries simple --no_warnings Suppress warnings Suppress warnings EMIT_WARNINGS_AS_ERRORS simple --output_file -o STRING required file Specify output file name Full filename of the output file. simple --preferred_order STRINGLIST required function Add <function> to preferred placement order list Insert a function into the preferred function order list for placement. Functions that are close to each other in the preferred function order list will tend to be placed close together (increase program locality between them). Static functions of the same name can be distinguished from each other by prefixing the function name with the path and file in which the function is defined followed by a ':' character to delimit the beginning of the function name. simple --priority -priority Search libraries in priority order Search libraries in priority order simple --ram_model -cr Link using RAM autoinitialization model Link using RAM autoinitialization model ROM_MODEL simple --relocatable -r Produce a relocatable output module Produce a relocatable output module simple --reread_libs -x Reread libraries; resolve backward references Reread libraries; resolve backward references simple --retain STRINGLIST required sym_or_scn_spec Specify symbols/sections to be retained by linker When --unused_section_elimination is enabled, the ELF linker does not include a section in the final link if it is not needed in the executable to resolve references. This option can be used to tell the linker to retain a list of sections that would otherwise be not retained. This option accepts the wild cards '*' and '?' and when wild cards are used, the argument should be in quotes. The following option parameters are accepted: --retain=symbol_spec retains sections that define symbol matching the argument. For ex, --retain='init*' retains sections that define symbols that start with 'init'. User may not specify --retain='*'. --retain=file_spec(scn_spec [,scn_spec ...]) retains sections matching scn_spec(s) from files matching file_spec. For ex, the argument '*(.initvec)' causes the linker to retain .initvec sections from all input files. NOTE: User can specify --retain='*(*)' to retain all the sections from all the input object files. Note that this does not prevent sections from library members from being optimized out. If you want to totally disable unused section elimination, please use --unused_section_elimination=off. --retain=ar_spec<mem_spec, [mem_spec ...]>(scn_spec, [scn_spec ...]) retains sections matching scn_spec(s) from members matching mem_spec(s) from archive files matching ar_spec. For ex, rts32eabi.lib<printf.obj>(.text) causes the linker to retain .text section from printf.obj in rts32eabi.lib. If the library is specified with -l option (-lrts32eabi.lib) the library search path is used to search the library. User may not specify '*<*>(*)'. simple --rom Create a ROM object This option allows the creation of ROM object module simple --rom_model -c Link using ROM autoinitialization model Link using ROM autoinitialization model RAM_MODEL simple --rpath STRINGLIST required dir Add directory to beginning of dynamic library search path The specified directory will be searched BEFORE the directories in LD_LIBRARY_PATH cmdline --run_abs -abs Produce absolute listing file Produce absolute listing file simple --runpath STRINGLIST required dir Add directory to end of dynamic library search path The specified directory will be searched AFTER the directories in LD_LIBRARY_PATH simple --scan_libraries -scanlibs Scan libraries for duplicate symbol definitions Check whether symbol definitions that are pulled into the link are duplicated in any of the libraries included in the build. This information is typically ignored as the linker will pull in the first definition it encounters. simple --search_path -i STRINGLIST required dir Add <dir> to library search path Alter the library-search algorithm to look in dir before looking in the default location. This option must appear before the -l option. simple --set_error_limit NUMBER required count Set error limit to <count> Set error limit to <count> simple --soname STRING required soname Specify ELF shared object file name Specify ELF shared object file name simple --stack_size -stack --stack HEXNUMBER required size Set C system stack size Set C system stack size simple --strict_compatibility ONEOF optional on,off on off on Strict compatibility checking Strict compatibility checking simple --symbol_map STRINGLIST required refname=defname Specify a symbol map, mapping refname to defname Symbol mapping allows a symbol reference to be resolved by a symbol with different name. Symbol mapping allows functions to be overridden with alternate definitions. This feature can be used to patch in alternate implementations, which provide patches (bug fixes) or alternate functionality. For example, the option --symbol_map='foo=foo_patch' makes the linker resolve any references to foo by the definition foo_patch. simple --trampoline_min_spacing HEXNUMBER required size Minimum space between non-adjacent trampolines When trampoline reservations are spaced more closely than this limit, try to make them adjacent. A higher value minimizes fragmentation, but may result in more trampolines. A lower value may reduce trampolines, at the expense of fragmentation and linker running time. Specifying 0 for this option disables coalescing. The default is 16K. simple --trampolines ONEOF optional on,off on off on Generate far call trampolines Generate far call trampolines simple --undef_sym -u STRINGLIST required sym Add <sym> to symbol table as an unresolved symbol Add <sym> to symbol table as an unresolved symbol simple --undefine STRINGLIST required name Undefine preprocessor macro _name_ Undefine preprocessor macro _name_ simple --unhide STRINGLIST required pattern Exclude symbols matching pattern from hiding The option --hide=hide_pattern makes the symbols matching the hide_pattern hidden. The --unhide=unhide_pattern option excludes symbols matching unhide_pattern from symbol hiding provided unhide_pattern is more restrictive than hide_pattern. simple --unused_section_elimination ONEOF optional on,off on off on Eliminate sections not needed in the executable In order to minimize memory use, the linker does not include a section that is not needed to resolve any references in the final executable. --unused_section_elimination=off can be used to disable this optimization. simple --verbose_diagnostics Verbose diagnostics Verbose diagnostics simple --warn_sections -w Warn if an unspecified output section is created Warn if an unspecified output section is created simple --xml_link_info -xml_link_info STRING required file Detailed link information data-base into <file> Produce a detailed link information data-base into the file named <file>. simple --zero_init ONEOF optional on,off on off on Zero initialize ELF uninitialized sections This option indicates that the linker should generate compressed cinit table records that zero initializes ELF uninitialized sections during boot. This option is ignored if --rom_model option is not specified. Initialization model RESET optional ROM_MODEL RAM_MODEL Basic Options: OUTPUT_FILE MAP_FILE STACK_SIZE HEAP_SIZE File Search Path: LIBRARY SEARCH_PATH PRIORITY REREAD_LIBS DISABLE_AUTO_RTS Advanced Options: LNKCPP LNKDIAG LNKOUTF LNKSYM LNKRTENV LNKOPT LNKMISC LNKINT DYNAMIC LNKULP LNKADVICE Command File Preprocessing: UNDEFINE DEFINE DISABLE_PP Diagnostics: BUFFER_DIAGNOSTICS DIAG_ERROR ISSUE_REMARKS NO_DEMANGLE VERBOSE_DIAGNOSTICS SET_ERROR_LIMIT WARN_SECTIONS NO_WARNINGS DIAG_WARNING DIAG_REMARK EMIT_WARNINGS_AS_ERRORS DISPLAY_ERROR_NUMBER DIAG_SUPPRESS DIAG_WRAP Linker Output: XML_LINK_INFO RUN_ABS MAPFILE_CONTENTS ECC__DATA_ERROR ROM ECC__ECC_ERROR ABSOLUTE_EXE RELOCATABLE Symbol Management: MAKE_STATIC NO_SYM_MERGE NO_SYMTABLE UNHIDE RETAIN UNDEF_SYM ENTRY_POINT HIDE LOCALIZE SCAN_LIBRARIES GLOBALIZE SYMBOL_MAP MAKE_GLOBAL Runtime Environment: MUTEX_INITIALIZATION_MODEL FILL_VALUE TRAMPOLINES ARG_SIZE MULTITHREAD Linktime Optimization: COPY_COMPRESSION UNUSED_SECTION_ELIMINATION CINIT_COMPRESSION COMPRESS_DWARF Miscellaneous: STRICT_COMPATIBILITY DISABLE_CLINK PREFERRED_ORDER ZERO_INIT MINIMIZE_TRAMPOLINES LINKER_HELP TRAMPOLINE_MIN_SPACING Dynamic Linking Support Options: EXPORT INIT DSBT_INDEX RPATH IMPORT BIND_NOW DSBT_SIZE DYNAMIC RUNPATH FORCED_STATIC_BINDING SONAME FINI