.bd B 3.TH cl6x 1 "Apr 13, 2006" "TI Tools" "TI Code Generation Tools".SH NAMEcl6x - Compiler.SH SYNOPSIS.B cl6x[.I options] [.I file(s)].SH DESCRIPTIONThe compiler is an optimizing C/C++ compiler that accepts C++ as well as American National Standards Institute (ANSI) standard C source code and produces target specific object code.  This compiler builds object code directly from your C++ program source.  There is no intermediate C version of the program.The .B Optimizing C Compiler User's Guidediscusses the characteristics and limitations of this C/C++ compiler, as well as the languages, features and keywords supported..SH OPTIONSThe following options are accepted by this tool:.SS General Options:.SS.TP-@=filenameRead options from specified file .TP-cDisable linking (overrides -z).TP--compiler_revisionPrint out the compiler release revision and exit..TP-D=NAME[=value]Pre-define the symbol NAME, optionally setting it's contents to 'value'..TP-gppEnable 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..TP-hShow usage information.  When followed by another option or a phrase display that option's detailed information, or search for options related to that phrase..TP-I=dirAdd dir to #include search path.TP-kKeep the generated assembly language (.asm) file.TP-mkGenerate compiler consultant information.TP-nCompile only; do not assemble.TP--profile:breakptDisable optimizations that cannot be handled by a breakpoint-based profiler.TP-qSuppress common compiler non-diagnostic output.  Remarks, errors and warnings will still be generated, as well as feature specific status..TP-qqSuppress all compiler non-diagnostic output.  Remarks, errors and warnings will still be generated..TP-sGenerate interlisted assembly file.TP-ssGenerate C source interlisted assembly file.TP--tool_versionsPrint version numbers for each tool [Same as -version, -versions].TP-U=NAMEUndefine NAME.TP--verboseDisplay progress information and toolset version when executing..TP-versionPrint version numbers for each tool [Same as -versions, --tool_versions].TP-versionsPrint version numbers for each tool [Same as -version, --tool_versions].TP-z[=arguments]After compiling all the source files, perform a link and pass all the options following this option to the linker..SS Symbolic Debug Options:.SS.TP-gFull symbolic debug [Same as -gw].TP-gpAdds 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 debuggability 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..TP-gtFull symbolic debug (COFF, deprecated).TP-gwFull symbolic debug [Same as -g].TP--machine_regsWhen 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..TP--symdebug:noneSuppress all symbolic debug generation.TP--symdebug:skeletalSymbolic debug for program analysis (default).SS Parser Options:.SS.TP--exceptionsEnable C++ exception handling.TP-pcMultibyte character support.TP-peEmbedded C++.TP-piIgnore inline keyword.TP-pkK & R compatibility.TP-plOutput raw listing to .rl file.TP-pmProgram mode compilation.TP-pnDisable intrinsic functions.TP-prRelaxed parsing (non-strict ANSI).TP-psStrict ANSI mode (errors).TP-pxOutput xref listing to .crl file.TP-rttiSupport C++ run-time type information.TP--static_template_instantiationAll template entities are instantiated as needed in the file.  The instantiations are given internal (static) linkage..SS Parser Preprocessing Options:.SS.TP-ppaGenerate a preprocessed file and continue compilation.TP-ppcPreprocess only; maintain comments.TP-ppd[=filename]Generate a dependency list for the source file into the file <filename>.pp   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 (ala gcc)..TP-ppi[=filename]Generate an include list for the source file into the file <filename>.pp   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 (ala gcc)..TP-pplPreprocess only; maintain line directives.TP-ppoPreprocess only.SS Parser Diagnostics Options:.SS.TP-pdel=countSet error limit to <count>.TP-pdenEmit diagnostic identifier numbers.TP-pdfOutput diagnostic to .err file.TP-pdrIssue remarks.TP-pds=idSuppress diagnostic <id>.TP-pdse=idTreat diagnostic <id> as error.TP-pdsr=idTreat diagnostic <id> as remark.TP-pdsw=idTreat diagnostic <id> as warning.TP-pdvVerbose diagnostics.TP-pdwSuppress warnings.SS Runtime Model Options:.SS.TP-mbEnable 62xx compatibility.TP-mcDo not reorder floating point operations.TP-meGenerate big endian code.TP--mem_model:data=far,far_aggregates,nearData access model (Default:far_aggregates).TP-mh[=#]Specify speculative load byte count threshold.TP-mi[=#]Specify maximum cycles that interrupts may be disabled.TP-moPlace each function in a separate subsection.TP-ms[=0-3]Optimize for code size (Default:0).TP-mtAssume no irregular alias or loop behavior.TP-muDisable software pipelining.TP-mv=idTarget processor version (Default:6200).TP-mwGenerate verbose software pipelining information.TP--no_compressThis 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)..TP--no_reload_errorsAccept loop buffer assembly code that would normally cause the assembler to issue loop buffer reload-related errors..TP-oxTreats pointer-to-const as an indication that no other store within the pointer's scope will affect the pointer's target..TP--speculate_unknown_loadsSpeculate loads with unbounded address ranges.SS Optimizations Options:.SS.TP-maAssume called funcs create hidden aliases (rare).TP-oi[=size]Specify threshold for automatic inlining.TP-on=0-2Set 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..TP-op=0-3Specify 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..TP-osGenerate optimized source interlisted assembly file.TP-O[=0-3]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.Using -O without arguments defaults to -O2. (Default:2).SS Library Function Assumptions Options:.SS.TP-ol0File redefines an RTS library function..TP-ol1File contains an RTS library function..TP-ol2File does not define any RTS library func (def.).SS Assembler Options:.SS.TP-aaGenerate absolute listing file.TP-acSymbol names are not case-significant.TP-ad=NAME[=value]Pre-define the assembly symbol NAME, optionally setting its contents to 'value'..TP-ahc=filenameSimulate source '.copy filename'.TP-ahi=filenameSimulate source '.include filename'.TP-alGenerate listing file.TP-apdGenerate assembly dependency information.TP-apiGenerate first-level assembly include file list.TP-asKeep local symbols in output file.TP-au=NAMEUndefine assembly symbol NAME.TP-axGenerate cross reference file.SS File Type Specifier Options:.SS.TP-fa=filenameFile is an assembly file (default for .asm).TP-fc=filenameFile is a C file (default for .c/no ext).TP-fl=filenameFile is a linear asm file (default for .sa).TP-fo=filenameFile is an object file (default for .obj).TP-fp=filenameFile is a C++ file (default for .C .cpp .cc).SS Directory Specifier Options:.SS.TP-fb=dirAbsolute listing directory (default is .obj dir).TP-ff=dirListing/xref file directory (default is .obj dir).TP-fr=dirObject file directory (default is .).TP-fs=dirAssembly file directory (default is .).TP-ft=dirTemporary file directory (default is .).SS Default File Extensions Options:.SS.TP-ea=.extExtension for assembly files (default is .asm).TP-ec=.extExtension for C files (default is .c).TP-el=.extExtension for linear asm files (default is .sa).TP-eo=.extExtension for object files (default is .obj).TP-ep=.extExtension for C++ files (default is .cpp).TP-es=.extExtension for listing files (default is .lst).TP-fgTreat C files as C++ files.SH EXIT STATUSThe following error values are returned:.PD 0.TP 10.B 0Successful completion..TP.B >0Unsuccessful completion; an error occured..PD.SH COPYRIGHT.TPCopyright (c) 2006, Texas Instruments, Inc.