Texas Instruments TMS320C6 Series, User Manual

Page: 31 / 304

Preparing Your Program for Debugging
1-11 Overview of a Code Development and Debugging System
For your convenience, here’s the command for invoking the shell program
when preparing a program for debugging:
cl60 [– options] –g [ filenames] [–z [ link options]]
cl60 invokes the compiler and assembler.
– options affect the way the shell processes input files. If you plan to use
the debugger’s profiling environment, include the –as option.
–g tells the C compiler to produce symbolic debugging informa-
tion. When preparing a C program for debugging, you must use
the –g option, or you won’t be able to access symbolic debug-
ging information (such as C labels, variables, etc.).
filenames are one or more C source files, assembly language source
files, or object files. Filenames are not case sensitive.
–z invokes the linker. After compiling/assembling your programs,
you can invoke the linker in a separate step. If you want the
shell to automatically invoke the linker, however, use –z.
link options
affect the way the linker processes input files; use these options
only when you use –z.
Options and filenames can be specified in any order on the command line.
However, –z must follow all C/assembly language source filenames and com-
piler options, and it must precede all linker options.
The shell identifies a file’s type by the filename’s extension.
Extension File type The shell will...
.c C source Compile, assemble, and
link the file
.asm Assembly language
source Assemble and link the file
.s
*
(any extension that
begins with s)
Assembly language
source Assemble and link the file
.o
*
(extension begins
with o)
Object file Link the file
none (.c assumed) C source Compile, assemble, and
link the file
Note: The shell links files only if you specify the –z option.