COMPILER C/C++ COMPILER 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 improving performance. Currently provides TMU performance advice when TMU hardware support is enabled. 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. 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. simple --asm_code_fill NUMBER required # Assembler fill value for code section A 16-bit fill value used by the assembler when creating holes for the .align directive in .text section or any section that has a valid instruction encoded. simple --asm_data_fill NUMBER required # Assembler fill value for data section A 16-bit fill value used by the assembler when creating holes for the .align directive in any section that does not have a valid instruction encoded. 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_remarks -mw Generate asm extended warnings Generate asm extended warnings 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 --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 --c2xlp_src_compatible -m20 C2XLP source compatibility C2XLP source compatibility 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 --cdebug_asm_data -mg Generate asm debug directive Generate asm debug directive 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 --cla_default Treat C files as CLA files Treat C files as CLA files simple --cla_support ONEOF optional cla0,cla1 cla0 cla1 cla0 Specify CLA support This option can be used to specify how CLA support is provided. cla0 - target has CLA support from device type 0 cla1 - target has CLA support from device type 1 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 --cross_reference -ax Generate cross reference file Generate cross reference file 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_dp_load_opt -md No DP load optimization No DP load optimization 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 --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 --flash_prefetch_warn Assembler warnings for F281X BF flash prefetch issue Assembler will issue a warning if a program data access instruction follows within 8 words of a BF/SBF instruction. As outlined in TMS320C281X/TMS320F281X DSP Silicon Errata document SPRZ193K, page 7, section titled 'Memory: Flash and OTP Prefetch Buffer Overflow' the flash prefetch buffer may overflow if this instruction sequence is executed from flash or OTP with the flash prefetch buffer enabled. Whether or not an overflow actually occurs depends on the instruction sequence, flash wait states and CPU pipeline stall. If an overflow occurs it will result in execution of invalid opcodes. Instructions that use program memory addressing include MAC/XMAC, DMAC/XMACD, QMACL, IMACL, PREAD/XPREAD, and PWRITE/XPWRITE 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 --float_support ONEOF required fpu32,softlib fpu32 softlib Specify floating point support This option can be used to specify how the floating point support is provided. fpu32 - target has 32-bit hardware floating point unit softlib - no hardware floating point support, use RTS routines. simple --fp_mode ONEOF required relaxed,strict relaxed strict strict Floating Point mode Specify a floating point mode. In relaxed mode, hardware instructions may replace floating point library calls when available. This behavior is not ISO conformant, but results in faster/smaller code, with some loss in accuracy. 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_data_subsections ONEOF required on,off on off Place structs and arrays in separate subsections Placing structs and arrays in subsections allows the linker to remove unused data at link time. For C28x, this can have a negative impact on optimizing dp loads, which can result in less efficient code. If the option is not specified, the default behavior is off RAMFUNC USE_DEAD_FUNCS_LIST GEN_FUNC_SUBSECTIONS simple --gen_func_subsections -mo ONEOF optional on,off on off on Place each function in a separate subsection Placing functions in subsections allows the linker to remove unused functions at link time. If the option is not specified, the default behavior for C28x is off. The default behavior for CLA is on GEN_DATA_SUBSECTIONS 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. 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 --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 --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 --large_memory_model -ml Option deprecated, set by default Option deprecated, set by default 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 --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 --no_const_clink true 3 The --no_const_clink option is deprecated. The functionality is controlled by --gen_data_subsections 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. GEN_DATA_SUBSECTIONS --gen_data_subsections=off simple --no_fast_branch -me true 3 The '--no_fast_branch' option is no longer supported and has no effect. Fast branch instruction will only be generated for functions running from RAM as specified by the --ramfunc=on option or by __attribute__((ramfunc)). Disable C28x fast branch instructions Disable C28x fast branch instructions 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_rpt -mi Don't generate RPT instructions Don't generate RPT instructions 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 --opt_for_space -ms Optimize for code size Optimize for code size SIZE_SPEED_GOAL --size_speed_goal=high_risk_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,4 off 0 1 2 3 4 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. Level 4 adds whole program optimizations. Level 4 must be passed to the linker for the optimizations to take affect. 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 --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. 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. simple --preproc_asm -mx Preprocess assembly source, expand macros. Preprocess assembly source, expand macros. 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_WITH_COMMENT PREPROC_WITH_LINE PREPROC_ONLY 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_LINE PREPROC_WITH_COMMENT PREPROC_INCLUDES PREPROC_DEPENDENCY cmdline --preproc_only -ppo Preprocess only Only preprocess the source file(s) and then stop. PREPROC_MACROS PREPROC_INCLUDES 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_DEPENDENCY PREPROC_MACROS PREPROC_INCLUDES 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: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 --protect_volatile -mv NUMBER optional nops Pipeline protect volatiles by <nops> nops (C27x) [def: 2] Pipeline protect volatiles by <nops> nops (C27x) [def: 2] 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. VERBOSE SUPER_QUIET 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_DATA_SUBSECTIONS 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 --rpt_threshold RANGE required 0-256 Specify max number of repetitions in a RPT instruction Specify max number of repetitions in a RPT instruction 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 -v ONEOF required 28 27 28 28 Processor version 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 --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 --super_quiet -qq Super Quiet Mode Suppress all compiler non-diagnostic output. Remarks, errors and warnings will still be generated. QUIET VERBOSE simple --symdebug:coff Full symbolic debug (COFF, deprecated) Enable full symbolic COFF debugging in the generated object or out file (DEPRECATED). SYMDEBUG__NONE SYMDEBUG__PROFILE_COFF SYMDEBUG__SKELETAL SYMDEBUG__DWARF simple --symdebug:dwarf -g Full symbolic debug Enable full symbolic DWARF debugging in the generated object or out file. SYMDEBUG__SKELETAL SYMDEBUG__PROFILE_COFF SYMDEBUG__COFF SYMDEBUG__NONE simple --symdebug:dwarf_version ONEOF required 2,3,4 2 3 4 Specify DWARF version Specify DWARF version SYMDEBUG__NONE SYMDEBUG__PROFILE_COFF SYMDEBUG__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. PROFILE__POWER PROFILE__BREAKPT OCS_ACTIVE SYMDEBUG__DWARF SYMDEBUG__SKELETAL SYMDEBUG__COFF SYMDEBUG__PROFILE_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__NONE SYMDEBUG__COFF SYMDEBUG__SKELETAL SYMDEBUG__DWARF simple --symdebug:skeletal Symbolic debug for program analysis (DEPRECATED) Enable symbolic debug information for program analysis. (DEPRECATED) SYMDEBUG__DWARF SYMDEBUG__PROFILE_COFF SYMDEBUG__COFF SYMDEBUG__NONE simple --syms_ignore_case -ac Symbol names are not case-significant Symbol names are not case-significant simple --temp_directory -ft STRING required dir Temporary file directory (default is .) Temporary file directory (default is .) simple --tmu_support ONEOF optional tmu0 tmu0 tmu0 Specify TMU support This option can be used to specify how TMU support is provided. tmu0 - target has TMU support from device type 0 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 --unified_memory -mt Unified memory Unified memory 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. simple --vcu_support ONEOF optional vcu0,vcu2 vcu0 vcu2 vcu0 Specify VCU support This option can be used to specify how VCU support is provided. vcu0 - target has VCU support from device type 0 vcu2 - target has VCU support from device type 2 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 --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. 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 GEN_DATA_SUBSECTIONS RAMFUNC Processor Options: SILICON_VERSION LARGE_MEMORY_MODEL UNIFIED_MEMORY CLA_SUPPORT TMU_SUPPORT VCU_SUPPORT FLOAT_SUPPORT Optimization: OPT_LEVEL OPT_FOR_SPEED FP_REASSOC FP_MODE Include Options: PREINCLUDE INCLUDE_PATH Performance Advisor: 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: SKIP_ASSEMBLER COMPILE_ONLY HELP RUN_LINKER Advanced Debug Options: MUTEX_DEBUGGING_MODEL OPTIMIZE_WITH_DEBUG SYMDEBUG__KEEP_ALL_TYPES SYMDEBUG__DWARF_VERSION Language Options: MUTEX_C_DIALECT MUTEX_C___DIALECT MUTEX_LANGUAGE_MODE NO_INLINING CLA_DEFAULT GCC FLOAT_OPERATIONS_ALLOWED PROGRAM_LEVEL_COMPILE EXCEPTIONS NO_INTRINSICS PENDING_INSTANTIATIONS RTTI CPP_DEFAULT KEEP_UNNEEDED_STATICS GEN_ACP_RAW GEN_ACP_XREF MULTIBYTE_CHARS STATIC_TEMPLATE_INSTANTIATION Parser Preprocessing Options: MUTEX_PREPROCESSOR_ANALYSIS_OPTIONS PREPROC_WITH_COMMENT PREPROC_WITH_COMPILE PREPROC_WITH_LINE PREPROC_ONLY Predefined Symbols: DEFINE UNDEFINE Diagnostic Options: MUTEX_QUIET_LEVEL DISPLAY_ERROR_NUMBER NO_WARNINGS EMIT_WARNINGS_AS_ERRORS DIAG_SUPPRESS DIAG_WARNING DIAG_WRAP DIAG_ERROR SET_ERROR_LIMIT BUFFER_DIAGNOSTICS SECTION_SIZES TOOL_VERSION DIAG_REMARK VERBOSE_DIAGNOSTICS WRITE_DIAGNOSTICS_FILE ISSUE_REMARKS COMPILER_REVISION Runtime Model Options: MUTEX_FUNCTION_SUBSECTIONS NO_RPT RPT_THRESHOLD NO_FAST_BRANCH PROFILE__POWER SAT_REASSOC ASM_DATA_FILL DISABLE_DP_LOAD_OPT ASM_CODE_FILL C2XLP_SRC_COMPATIBLE PROTECT_VOLATILE Advanced Optimizations: SINGLE_INLINE OPT_FOR_SPACE AUTO_INLINE GEN_OPT_INFO CALL_ASSUMPTIONS REMOVE_HOOKS_WHEN_INLINING ALIASED_VARIABLES Entry/Exit Hook Options: EXIT_PARM EXIT_HOOK ENTRY_HOOK ENTRY_PARM Feedback and Analysis Options: ANALYZE USE_PROFILE_INFO GEN_PROFILE_INFO ANALYZE_ONLY Library Function Assumptions: STD_LIB_FUNC_REDEFINED STD_LIB_FUNC_DEFINED STD_LIB_FUNC_NOT_DEFINED PRINTF_SUPPORT Assembler Options: KEEP_ASM MUTEX_SOURCE_INTERLIST ASM_LISTING CROSS_REFERENCE SYMS_IGNORE_CASE PREPROC_ASM NO_CONST_CLINK COPY_FILE ASM_DEFINE ASM_REMARKS ASM_INCLUDES INCLUDE_FILE ABSOLUTE_LISTING CDEBUG_ASM_DATA OUTPUT_ALL_SYMS ASM_UNDEFINE FLASH_PREFETCH_WARN ASM_DEPENDENCY File Type Specifier: ASM_FILE OBJ_FILE C_FILE CPP_FILE Directory Specifier: PP_DIRECTORY LIST_DIRECTORY OUTPUT_FILE TEMP_DIRECTORY ASM_DIRECTORY OBJ_DIRECTORY ABS_DIRECTORY Default File Extensions: CPP_EXTENSION LISTING_EXTENSION OBJ_EXTENSION ASM_EXTENSION C_EXTENSION Command Files: CMD_FILE MISRA-C:2004: MISRA_ADVISORY CHECK_MISRA MISRA_REQUIRED 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 --buffer_diagnostics -pdb Line buffer diagnostic output Line buffer diagnostic output to reduce message mixing when compiling in parallel. 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 --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 --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 --far_heapsize -farheap HEXNUMBER required size DEPRECATED: Use --heap_size instead. DEPRECATED: Use --heap_size instead. 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 --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 --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 --no_demangle Don't demangle symbol names in diagnostics Don't demangle symbol names in diagnostics simple --no_postlink_across_calls -nf Disable post-link optimizations across functions Disable post-link optimizations across function calls. 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 --plink_advice_only Only add comments in plink without modifying the program Only add comments in plink without modifying the program simple --postlink_exclude -ex Exclude files from post-link pass Exclude files from post-link pass simple --postlink_opt -plink Post-link optimizations (only after -z) Post-link optimizations (only after -z) 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 --rom_model -c Link using ROM autoinitialization model Link using ROM autoinitialization model RAM_MODEL cmdline --run_abs -abs Produce absolute listing file Produce absolute listing file 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 --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 --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 --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>. Initialization model RESET optional ROM_MODEL RAM_MODEL Basic Options: MAP_FILE OUTPUT_FILE HEAP_SIZE STACK_SIZE WARN_SECTIONS 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: DEFINE UNDEFINE DISABLE_PP Diagnostics: NO_WARNINGS SET_ERROR_LIMIT EMIT_WARNINGS_AS_ERRORS DIAG_SUPPRESS ISSUE_REMARKS DIAG_WRAP DIAG_WARNING NO_DEMANGLE DIAG_ERROR DISPLAY_ERROR_NUMBER BUFFER_DIAGNOSTICS DIAG_REMARK VERBOSE_DIAGNOSTICS Linker Output: MAPFILE_CONTENTS ABSOLUTE_EXE ECC__DATA_ERROR RELOCATABLE RUN_ABS XML_LINK_INFO ECC__ECC_ERROR Symbol Management: HIDE ENTRY_POINT MAKE_STATIC SCAN_LIBRARIES NO_SYM_MERGE SYMBOL_MAP UNHIDE LOCALIZE MAKE_GLOBAL NO_SYMTABLE UNDEF_SYM GLOBALIZE Runtime Environment: MUTEX_INITIALIZATION_MODEL ARG_SIZE FAR_HEAPSIZE FILL_VALUE Linktime Optimization: POSTLINK_EXCLUDE NO_POSTLINK_ACROSS_CALLS POSTLINK_OPT COMPRESS_DWARF PLINK_ADVICE_ONLY Miscellaneous: DISABLE_CLINK STRICT_COMPATIBILITY PREFERRED_ORDER LINKER_HELP