xii
Motorola DSP56000 Family Optimizing C Compiler User’s Manual
For More Information On This Product,
Go to: www.freescale.com
Motorola
Appendix C
Utilities
C.1
C.1.1
C.1.1.1
C.1.2
C.1.3
C.1.4
C.1.4.1
C.1.5
C.1.5.1
C.1.6
C.1.6.1
C.1.7
C.1.7.1
C.1.8
Utility Programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1
asm56000—Motorola DSP56000/DSP56001 COFF Assembler. . . . . . . . . . C-1
asm5600 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-2
cldinfo—Memory size information from Motorola DSP COFF object file. . C-4
cldlod—Motorola COFF to LOD Format converter . . . . . . . . . . . . . . . . . . . C-5
cofdmp—Motorola DSP COFF File Dump Utility . . . . . . . . . . . . . . . . . . . . C-5
cofdmp Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-5
dsplib—Motorola DSP COFF Librarian . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-6
dsplib Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-6
dsplnk—Motorola DSP COFF Linker. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-7
dsplnk Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-8
gdb56—GNU Source-level Debugger for DSP56000/DSP56001. . . . . . . . C-11
gdb56 Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-11
run56—Motorola DSP56000/DSP56001 Simulator Based
Execution Device.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-12
C.1.8.1
run56 Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-12
C.1.9
srec—Motorola DSP S-Record Conversion Utility. . . . . . . . . . . . . . . . . . . C-13
C.1.9.1
srec Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-13
Appendix D
GNU Debugger (GDB)
D.1
D.1.1
D.1.2
D.1.3
D.1.4
D.1.5
D.1.6
D.1.7
D.1.8
D.2
D.3
D.3.1
D.3.2
D.4
D.5
D.5.1
D.5.2
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
Commands Not Implemented . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
DSP56000 Family Differences / Specific Requirements. . . . . . . . . . . . . . . . D-1
Summary of GDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-3
GNU General Public License. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-3
Preamble. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-3
Terms and Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-4
No Warranty. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-6
End of Terms and Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-7
Input and Output Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-8
Specifying GDB’s Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-10
Specifying Files with Arguments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-10
Specifying Files with Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-10
Compiling Your Program for Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-12
Running Your Program Under GDB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-12
Your Program’s Arguments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-13
Your Program’s Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-13
F
Freescale Semiconductor, Inc.
n
.