TMS320C2000 C/C++ Compiler              v22.6.1.LTS
Copyright (c) 1996-2018 Texas Instruments Incorporated

Usage: cl2000 [-options] filename

Use 'cl2000 --help <option>' for more information on a particular option.  Use
'cl2000 --help <text>' to search options for information regarding <text>.

Option arguments surrounded by [] declare they are optional.  Option arguments
separated by commas specify that the option's argument must be chosen from
those arguments listed.

When shown, option arguments and defaults apply to the usage of both long and
short option forms.

Processor Options:
  -v,--silicon_version=28      Processor version (when not specified, compiler
                                defaults to --silicon_version=28)
  -ml,--large_memory_model     Option deprecated, set by default
  -mt,--unified_memory         Unified memory
  --cla_support[=cla0,cla1,cla2]
                               Specify CLA support (argument optional, defaults
                                to: cla0)
  --float_support=fpu32,fpu64,softlib
                               Specify floating point support
  --idiv_support[=none,idiv0]  Specify support for enhanced integer divison
                                (argument optional, defaults to: idiv0)
  --isr_save_vcu_regs=on,off   Specify VCU register save/restore for interrupts
  --tmu_support[=tmu0,tmu1]    Specify TMU support (argument optional, defaults
                                to: tmu0)
  --vcu_support[=vcu0,vcu2,vcrc]
                               Specify VCU support (argument optional, defaults
                                to: vcu0)

Optimization Options:
  -O,--opt_level[=off,0,1,2,3,4]
                               Optimization level (argument optional, defaults
                                to: 2)
  --opt_for_speed,-mf[=0-5]    Speed vs. size trade-offs  (argument optional,
                                defaults to: 4)
  --fp_mode=relaxed,strict     Floating Point mode (when not specified,
                                compiler defaults to --fp_mode=strict)
  --fp_reassoc=on,off          Allow reassociation of FP arithmetic (when not
                                specified, compiler defaults to
                                --fp_reassoc=on)

Include Options:
  --include_path,-I=dir        Add dir to #include search path
  --preinclude=filename        Specify a preinclude file

Performance Advisor Options:
  --advice:performance[=all,none]
                               Provide advice on optimization techniques
                                (argument optional, defaults to: all)

Predefined Symbols Options:
  --define,-D=NAME[=value]     Pre-define NAME
  --undefine,-U=NAME           Undefine NAME

Control Options:
  --compile_only,-c            Disable linking (overrides -z)
  --help,-h                    Show help screen
  --run_linker,-z[=arguments]  Perform link using options following
  --skip_assembler,-n          Compile only; do not assemble

Advanced Debug Options:
  -g,--symdebug:dwarf          Full symbolic debug
  --symdebug:none              Suppress all symbolic debug generation
  --symdebug:dwarf_version=3,4 Specify DWARF version

Language Options:
  --c11                        Compile program in C11 mode.
  --c89                        Compile program in ANSI C89 mode.
  --c99                        Compile program in C99 mode.
  --c++03                      Compile program in C++03 mode.
  --relaxed_ansi,-pr           Relaxed parsing (non-strict ANSI)
  --strict_ansi,-ps            Strict ANSI mode (errors)
  --exceptions                 Enable C++ exception handling
  --rtti,-rtti                 Support C++ run-time type information
  --cpp_default,-fg            Treat C files as C++ files
  --extern_c_can_throw         Allow extern C functions to propagate exceptions
  --float_operations_allowed=all,32,64,none
                               Floating point precision accepted by compiler
                                (when not specified, compiler defaults to
                                --float_operations_allowed=all)
  --fp_single_precision_constant
                               Treat floating-point constants as single
                                precision
  --cla_default                Treat C files as CLA files
  --pending_instantiations=#   Limit pending template instantiations
  --printf_support=nofloat,minimal,full
                               Level of printf/scanf support required (when not
                                specified, compiler defaults to
                                --printf_support=full)
  --static_template_instantiation
                               Do static early template instantiation

Parser Preprocessing Options:
  --preproc_dependency,-ppd[=filename]
                               Generate include file dependency information
  --preproc_includes,-ppi[=filename]
                               Generate first-level include file list
  --preproc_macros,-ppm[=filename]
                               Generate list of pre- & user-defined macros
  --preproc_only,-ppo          Preprocess only
  --preproc_with_comment,-ppc  Preprocess only; maintain comments
  --preproc_with_compile,-ppa  Continue compilation after using -pp<X> options.
  --preproc_with_line,-ppl     Preprocess only; maintain line directives

Diagnostic Options:
  --compiler_revision          Print compiler revision and exit
  --diag_error,-pdse=id        Treat diagnostic <id> as error
  --diag_remark,-pdsr=id       Treat diagnostic <id> as remark
  --diag_suppress,-pds=id      Suppress diagnostic <id>
  --diag_warning,-pdsw=id      Treat diagnostic <id> as warning
  --diag_wrap[=on,off]         Wrap diagnostic messages (argument optional,
                                defaults to: on)
  --display_error_number,-pden Emit diagnostic identifier numbers
  --emit_warnings_as_errors,-pdew
                               Treat warnings as errors
  --issue_remarks,-pdr         Issue remarks
  --no_warnings,-pdw           Suppress warnings
  --quiet,-q                   Quiet Mode
  --set_error_limit,-pdel=count
                               Set error limit to <count>
  --super_quiet,-qq            Super Quiet Mode
  --tool_version,-version      Print version numbers for each tool
  --verbose                    Display banner and function progress information
  --verbose_diagnostics,-pdv   Verbose diagnostics
  --write_diagnostics_file,-pdf
                               Output diagnostic to .err file

Runtime Model Options:
  --gen_func_subsections,-mo[=on,off]
                               Place each function in a separate subsection
                                (argument optional, defaults to: on)
  --gen_data_subsections=on,off
                               Place structs and arrays in separate subsections
  --abi=coffabi,eabi           Application binary interface (when not
                                specified, compiler defaults to --abi=coffabi)
  --cla_background_task=on,off Specify if a CLA background task is in use (when
                                not specified, compiler defaults to
                                --cla_background_task=off)
  --cla_signed_compare_workaround=on,off
                               Workaround for CLA signed integer comparison
                                (when not specified, compiler defaults to
                                --cla_signed_compare_workaround=off)
  --no_rpt,-mi                 Don't generate RPT instructions
  --protect_volatile,-mv[=nops]
                               Pipeline protect volatiles by <nops> nops (C27x)
                                [def: 2]
  --ramfunc[=on,off]           Run functions from RAM. (argument optional,
                                defaults to: on)
  --rpt_threshold=0-256        Specify max number of repetitions in a RPT
                                instruction
  --silicon_errata_fpu1_workaround=on,off
                               Workaround CPU-to-FPU register write

Advanced Optimizations Options:
  --sat_reassoc=on,off         Allow reassociation of sat arithmetic (when not
                                specified, compiler defaults to
                                --sat_reassoc=off)
  --program_level_compile,-pm  Program mode compilation
  --call_assumptions,-op=0-3   Specify call assumptions when optimizing
  --auto_inline,-oi[=size]     Specify threshold for automatic inlining
  --disable_inlining           Disable inlining
  -ms,--opt_for_space          Optimize for code size
  --aliased_variables,-ma      Assume called funcs create hidden aliases (rare)

Entry/Exit Hook Options:
  --entry_hook[=hook_function_name]
                               Insert this call at entry to each function
                                (argument optional, defaults to: __entry_hook)
  --exit_hook[=hook_function_name]
                               Insert this call at exit from each function
                                (argument optional, defaults to: __exit_hook)
  --entry_parm=name,address,none
                               Pass caller's name or address to entry hook
  --exit_parm=name,address,none
                               Pass caller's name or address to exit hook
  --remove_hooks_when_inlining Remove entry/exit hooks from inlined functions

Feedback and Analysis Options:
  --gen_profile_info           Generate profile feedback data
  --analyze=codecov            Generate analysis info from profile data
  --analyze_only               Only generate analysis
  --use_profile_info[=filelist]
                               Use profile feedback file(s)

Assembler Options:
  -k,--keep_asm                Keep the generated assembly language (.asm) file
  --asm_listing,-al            Generate listing file
  --c_src_interlist,-ss        Generate C source interlisted assembly file
  --src_interlist,-s           Generate interlisted assembly file
  --asm_define,-ad=NAME[=value]
                               Pre-define assembly symbol NAME
  --asm_undefine,-au=NAME      Undefine assembly symbol NAME
  --absolute_listing,-aa       Generate absolute listing file
  --asm_cross_reference_listing
                               Generate cross reference assembly listing file
  --asm_dependency,-apd[=filename]
                               Generate assembly dependency information
  --asm_includes,-api          Generate first-level assembly include file list
  --flash_prefetch_warn        Assembler warnings for F281X BF flash prefetch
                                issue
  --preproc_asm,-mx            Preprocess assembly source, expand macros.

File Type Specifier Options:
  --asm_file,-fa=filename      File is an assembly file (default for .asm)
  --c_file,-fc=filename        File is a C file (default for .c/no ext)
  --cpp_file,-fp=filename      File is a C++ file (default for .C .cpp .cc)
  --obj_file,-fo=filename      File is an object file (default for .obj)

Directory Specifier Options:
  --abs_directory,-fb=dir      Absolute listing directory (default is .obj dir)
  --asm_directory,-fs=dir      Assembly file directory (default is .)
  --list_directory,-ff=dir     Listing/xref file directory (default is .obj
                                dir)
  --obj_directory,-fr=dir      Object file directory (default is .)
  --output_file,-fe=filename   Compilation output file name, can override
                                --obj_directory
  --pp_directory=dir           Preprocessor file directory (default is .)
  --temp_directory,-ft=dir     Temporary file directory (default is .)

Default File Extensions Options:
  --asm_extension,-ea=.ext     Extension for assembly files (default is .asm)
  --c_extension,-ec=.ext       Extension for C files (default is .c)
  --cpp_extension,-ep=.ext     Extension for C++ files (default is .cpp)
  --listing_extension,-es=.ext Extension for listing files (default is .lst)
  --obj_extension,-eo=.ext     Extension for object files (default is .obj)

Internal Support Options:
  --lfu_default[=none,preserve]
                               Default behavior of symbols for Live Firmware
                                Update (argument optional, defaults to:
                                preserve)
  --lfu_reference_elf,-lfu=path
                               Path to reference ELF executable for Live
                                Firmware Update

Command Files Options:
  --cmd_file,-@=filename       Read options from specified file 

Supplemental Information Options:
  --gen_cross_reference_listing
                               Output cross reference listing to .crl file
  --gen_opt_info,-on=0-2       Generate optimizer information file at level
                                [0-2]
  --gen_preprocessor_listing   Output preprocessor listing to .rl file
  --section_sizes[=on,off]     Output section size summary information.
                                (argument optional, defaults to: on)

Miscellaneous Options:
  --parallel[=parallelism]     Allow parallel compilation up to this many
                                threads (argument optional, defaults to: 0)

The following Linker options can be specified following the -z
option.  Linking is only enabled if -z is used and -c is not:

Basic Options:
  --emit_references:file=file  Specify the output path for section dependence
                                information
  --emit_references:format=TEXT
                               Specify the format for section reference
                                information
  -m,--map_file=file           Link information (map) listed into <file>
  -o,--output_file=file        Specify output file name
  --heap_size,-heap,--heap=size
                               Heap size for C/C++ dynamic memory allocation
  --stack_size,-stack,--stack=size
                               Set C system stack size
  --warn_sections,-w           Warn if an unspecified output section is created

File Search Path Options:
  -l,--library=file            Include library file or command file as input
  -i,--search_path=dir         Add <dir> to library search path
  --end-group                  End reread library group
  --priority,-priority         Search libraries in priority order
  --reread_libs,-x             Reread libraries; resolve backward references
  --start-group                Begin reread library group; resolve backward
                                references
  --disable_auto_rts           Disable automatic RTS selection

Command File Preprocessing Options:
  --define=name=value          Pre-define preprocessor macro _name_ to _value_
  --undefine=name              Undefine preprocessor macro _name_
  --disable_pp                 Don't use C preprocessor for command files

Diagnostics Options:
  --diag_error=id              Treat diagnostic <id> as error
  --diag_remark=id             Treat diagnostic <id> as remark
  --diag_suppress=id           Suppress diagnostic <id>
  --diag_warning=id            Treat diagnostic <id> as warning
  --diag_wrap[=on,off]         Wrap diagnostic messages (argument optional,
                                defaults to: on)
  --display_error_number       Emit diagnostic identifier numbers
  --emit_warnings_as_errors,-pdew
                               Treat warnings as errors
  --issue_remarks              Issue remarks
  --no_demangle                Don't demangle symbol names in diagnostics
  --no_warnings                Suppress warnings
  --set_error_limit=count      Set error limit to <count>
  --verbose_diagnostics        Verbose diagnostics

Linker Output Options:
  --absolute_exe,-a            Produce absolute executable object file
                                (default)
  --ecc:data_error=(address|symbol+offset),[page,]bitmask
                               Introduce bit errors
  --ecc:ecc_error=(address|symbol+offset),[page,]bitmask
                               Introduce bit errors in ECC memory
  --ecc=on,off                 Control whether ECC generation is on or off
                                (when not specified, compiler defaults to
                                --ecc=off)
  --mapfile_contents=attribute Display attribute settings in map file
  --relocatable,-r             Produce a relocatable output module
  --run_abs,-abs               Produce absolute listing file
  --xml_link_info,-xml_link_info=file
                               Detailed link information data-base into <file>

Symbol Management Options:
  --entry_point,-e=symbol      Specify program entry point for the output
                                module
  --globalize=pattern          Do not localize symbols matching pattern
  --hide=pattern               Hide symbols matching pattern
  --localize=pattern           Make the symbols matching pattern local
  --make_global,-g=symbol      Don't make global symbol static if -h is
                                specified
  --make_static,-h             Make all global symbols static
  --no_sym_merge,-b            No type merging in symbolic debugging
                                information
  --no_symtable,-s             Strip symbol table and line number entries
  --retain=sym_or_scn_spec     Specify symbols/sections to be retained by
                                linker
  --scan_libraries,-scanlibs   Scan libraries for duplicate symbol definitions
  --symbol_map=refname=defname Specify a symbol map, mapping refname to defname
  --undef_sym,-u=sym           Add <sym> to symbol table as an unresolved
                                symbol
  --unhide=pattern             Exclude symbols matching pattern from hiding

Runtime Environment Options:
  --arg_size,--args=size       Set C argc/argv memory size
  --cinit_compression[=rle,lzss,off]
                               Compress ELF C style auto initialization data
                                (argument optional, defaults to: lzss)
  --copy_compression[=rle,lzss,off]
                               Compress ELF sections copied using copy tables
                                (argument optional, defaults to: lzss)
  --fill_value,-f=value        Default fill value for holes in output sections
  --ram_model,-cr              Link using RAM autoinitialization model
  --rom_model,-c               Link using ROM autoinitialization model

Miscellaneous Options:
  --compress_dwarf[=on,off]    Aggressively reduce size of the DWARF
                                information (argument optional, defaults to:
                                on)
  --disable_clink,-j           Disable conditional linking and ignore .clink
  --linker_help,-help,--help   Display usage information
  --preferred_order=function   Add <function> to preferred placement order list
  --unused_section_elimination[=on,off]
                               Eliminate sections not needed in the executable
                                (argument optional, defaults to: on)
  --zero_init[=on,off]         Zero initialize ELF uninitialized sections
                                (argument optional, defaults to: on)

Post-link optimization Options:
  --no_postlink_across_calls,-nf
                               Disable post-link optimizations across functions
  --plink_advice_only          Only add comments in plink without modifying the
                                program
  --postlink_exclude,-ex       Exclude files from post-link pass
  --postlink_opt,-plink        Post-link optimizations (only after -z)