W5.0
C/C++ Compiler and Library Manual
for TigerSHARC
®
Processors
Revision 4.0, August 2007
Part Number
82-000336-03
Analog Devices, Inc.
One Technology Way
Norwood, Mass. 02062-9106
a
Copyright Information
©2006 Analog Devices, Inc., ALL RIGHTS RESERVED. This document
may not be reproduced in any form without prior, express written consent
from Analog Devices, Inc.
Printed in the USA.
Disclaimer
Analog Devices, Inc. reserves the right to change this product without
prior notice. Information furnished by Analog Devices is believed to be
accurate and reliable. However, no responsibility is assumed by Analog
Devices for its use; nor for any infringement of patents or other rights of
third parties which may result from its use. No license is granted by impli-
cation or otherwise under the patent rights of Analog Devices, Inc.
Trademark and Service Mark Notice
The Analog Devices logo, icon bar and logo, the CROSSCORE logo,
VisualDSP++, SHARC, TigerSHARC, and EZ-KIT Lite are registered
trademarks of Analog Devices, Inc.
All other brand and product names are trademarks or service marks of
their respective owners.
CONTENTS
VisualDSP++ 5.0 C/C++ Compiler and Library Manual iii
for TigerSHARC Processors
CONTENTS
PREFACE
Purpose of This Manual ............................................................. xxxix
Intended Audience ..................................................................... xxxix
Manual Contents Description ......................................................... xl
What’s New in This Manual ............................................................ xl
Technical or Customer Support ...................................................... xli
Supported Processors ..................................................................... xlii
Product Information ..................................................................... xlii
MyAnalog.com ........................................................................ xlii
Processor Product Information ................................................ xliii
Related Documents ................................................................. xliv
Online Technical Documentation ............................................. xlv
Accessing Documentation From VisualDSP++ ...................... xlv
Accessing Documentation From Windows ........................... xlvi
Accessing Documentation From the Web ............................. xlvi
Printed Manuals ..................................................................... xlvii
Hardware Tools Manuals .................................................... xlvii
CONTENTS
iv VisualDSP++ 5.0 C/C++ Compiler and Library Manual
for TigerSHARC Processors
Processor Manuals ............................................................. xlvii
Data Sheets ....................................................................... xlvii
Notation Conventions ................................................................ xlviii
COMPILER
C/C++ Compiler Overview ........................................................... 1-3
Compiler Command-Line Interface .............................................. 1-5
Running the Compiler ............................................................ 1-6
Compiler Command-Line Switches ....................................... 1-10
C/C++ Compiler Switch Summaries .................................. 1-10
C/C++ Mode Selection Switch Descriptions ...................... 1-22
-c89 ............................................................................. 1-22
-c++ ............................................................................. 1-22
C/C++ Compiler Common Switch Descriptions ................ 1-23
sourcefile ...................................................................... 1-23
-@ filename .................................................................. 1-23
-A name [(<tokens>)] .................................................... 1-23
-add-debug-libpaths ...................................................... 1-24
-align-branch-lines ........................................................ 1-25
-allow-macs-to-extend-saturation .................................. 1-25
-alttok .......................................................................... 1-25
-always-inline ............................................................... 1-26
-annotate ...................................................................... 1-26
-annotate-loop-instr ...................................................... 1-27
-auto-attrs .................................................................... 1-27
CONTENTS
VisualDSP++ 5.0 C/C++ Compiler and Library Manual v
for TigerSHARC Processors
-bss ............................................................................... 1-27
-build-lib ...................................................................... 1-27
-C ................................................................................. 1-27
-c .................................................................................. 1-28
-char-size-any ................................................................ 1-28
-char-size-{8|32} ............................................................ 1-28
-const-read-write ........................................................... 1-29
-const-strings ................................................................ 1-29
-Dmacro[=definition] .................................................... 1-29
-debug-types ................................................................. 1-30
-default-branch-{np|p} ................................................... 1-30
-double-size-any ............................................................ 1-30
-double-size-{32 | 64} .................................................... 1-31
-dry .............................................................................. 1-32
-dryrun ......................................................................... 1-32
-E ................................................................................. 1-32
-ED .............................................................................. 1-32
-EE ............................................................................... 1-33
-enum-is-int .................................................................. 1-33
-extra-keywords ............................................................. 1-33
-file-attr name[=value] ................................................... 1-34
-flags-{asm|compiler|lib|link|mem} switch [,switch2 [,...]] 1-34
-force-circbuf ................................................................ 1-34
-fp-associative ............................................................... 1-35
