Intel(R) C++ Compiler for VxWorks* User and Reference Guides Document Number: 324063-003US Intel(R) C++ Compiler - VxWorks* OS www.intel.com Disclaimer and Legal Information Contents Legal Information........................................................................37 Getting Help and Support.............................................................39 Chapter 1: Introduction Introducing the Intel® C++ Compiler...................................................41 Notational Conventions......................................................................42 Related Information...........................................................................44 Part I: Building Applications Chapter 2: Overview: Building Applications Introduction to the Compiler.......................................................49 Compilation Phases...................................................................49 Default Output Files..................................................................49 Using Compiler Options.............................................................50 Saving Compiler Information in Your Executable............................53 Redistributing Libraries When Deploying Applications.....................54 Chapter 3: Building Applications from the Command Line Invoking the Compiler from the Command Line.............................55 Invoking the Compiler from the Command Line with make.............56 Passing Options to the Linker.....................................................56 Compiler Input Files..................................................................57 Output Files.............................................................................58 Specifying Compilation Output....................................................59 iii Intel(R) C++ Compiler for VxWorks* User and Reference Guides Specifying Executable Files..........................................59 Specifying Object Files................................................59 Specifying Assembly Files............................................59 Specifying Alternate Tools and Paths.....................................59 Using Precompiled Header Files............................................60 Compiler Option Mapping Tool..............................................63 Open Source Tools..............................................................65 Chapter 4: Using Preprocessor Options About Preprocessor Options.................................................67 Using Options for Preprocessing...........................................68 Using Options to Define Macros............................................69 Chapter 5: Modifying the Compilation Environment About Modifying the Compilation Environment........................71 Setting Environment Variables..............................................71 Using Configuration Files.....................................................74 Specifying Include Files.......................................................75 Using Response Files...........................................................75 Chapter 6: Debugging Using the Debugger............................................................77 Preparing for Debugging......................................................77 Symbolic Debugging and Optimizations.................................77 Using Options for Debug Information....................................78 Chapter 7: Creating and Using Libraries Overview: Using Libraries....................................................81 Supplied Libraries...............................................................81 Managing Libraries..............................................................83 Creating Libraries...............................................................84 Compiling for Non-shared Libraries.......................................85 Overview: Compiling for Non-shared Libraries................85 iv Contents Global Symbols and Visibility Attributes.........................86 Symbol Preemption....................................................87 Specifying Symbol Visibility Explicitly............................88 Other Visibility-related Command-line Options...............89 Chapter 8: gcc* Compatibility gcc Compatibility................................................................91 gcc* Interoperability...........................................................95 gcc Interoperability....................................................95 Compiler Options for Interoperability............................95 Predefined Macros for Interoperability...........................98 gcc Built-in Functions..................................................99 Thread-local Storage.................................................100 Chapter 9: Language Conformance Conformance to the C Standard..........................................101 Conformance to the C++ Standard.....................................101 Exported Templates..........................................................101 Template Instantiation.......................................................104 Chapter 10: Porting Applications Overview: Porting Applications...........................................105 Modifying Your makefile.....................................................107 Equivalent Macros.............................................................109 Equivalent Environment Variables.......................................112 Other Considerations.........................................................112 Porting from GNU gcc* to Microsoft Visual C++*...................116 Chapter 11: Error Handling Remarks, Warnings, and Errors...........................................119 Chapter 12: Reference C/C++ Calling Conventions................................................123 v Intel(R) C++ Compiler for VxWorks* User and Reference Guides ANSI Standard Predefined Macros.......................................128 Additional Predefined Macros..............................................129 Part II: Compiler Options Overview.................................................................................136 Overview: Compiler Options...............................................136 Chapter 13: Alphabetical Compiler Options Compiler Option Descriptions and General Rules...................137 A Options........................................................................139 A............................................................................139 A-..........................................................................140 alias-const...............................................................141 align.......................................................................142 ansi........................................................................143 ansi-alias................................................................143 ansi-alias-check.......................................................144 auto-ilp32...............................................................146 auto-p32.................................................................147 ax..........................................................................148 B Options........................................................................151 B............................................................................151 Bdynamic................................................................152 Bstatic....................................................................153 Bsymbolic................................................................154 Bsymbolic-functions..................................................155 C Options........................................................................156 C............................................................................156 c............................................................................157 c99.........................................................................158 check-uninit.............................................................159 complex-limited-range..............................................159 cxxlib......................................................................160 vi Contents D Options........................................................................161 D...........................................................................161 dD..........................................................................162 debug.....................................................................163 diag........................................................................166 diag-dump...............................................................169 diag-error-limit........................................................170 diag-file..................................................................171 diag-file-append.......................................................172 diag-id-numbers.......................................................174 diag-once................................................................175 dM..........................................................................175 dN..........................................................................176 dryrun....................................................................177 dumpmachine..........................................................178 dumpversion............................................................178 dynamic-linker.........................................................179 E Options.........................................................................180