VisualAge C++ for AIX Compiler Reference SC09-4959-00 VisualAge C++ for AIX Compiler Reference SC09-4959-00 Before using this information and the product it supports, be sure to read the information in “Notices” on page 411. May 2002 Edition This edition applies to Version 6 Release 0 of VisualAge C++ Professional for AIX (product number 5765–F56) and to all subsequent releases and modifications until otherwise indicated in new editions. IBM® welcomes your comments. You can send them by either of the following methods: v Internet: [email protected] Be sure to include your e-mail address if you want a reply. v By mail to the following address: IBM Canada Ltd. Laboratory Information Development B3/KB7/8200/MKM 8200 Warden Avenue Markham, Ontario, Canada L6G 1C7 Include the title and order number of this book, and the page number or topic related to your comment. When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright International Business Machines Corporation 1995,2002. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents How to read syntax diagrams .....vii Specify Compiler Options for Architecture-Specific, Symbols...............vii 32-or64-bitCompilation..........29 Syntax items ..............vii Resolving Conflicting Compiler Options .....31 Syntax examples ............viii Specify Path Names for Include Files 33 Part 1. Concepts ..........1 Directory Search Sequence for Include Files Using RelativePathNames...........33 VisualAge C++ Compiler .......3 Structure a Program that Uses Compiler Modes .............3 Object Models ..............4 Templates .............35 Compiler Options.............5 Declaration of Stack in stack.h ........35 Types of Input Files ............6 Declaration of operator Functions in stack.c . 35 Types of Output Files ...........7 Template Functions Declared Inline and Template Compiler Message and Listing Information ....8 Functions With Internal Linkage .......36 Compiler Messages ...........8 Template Functions Defined within the Compilation Compiler Listings............8 Unit.................37 Use -qtempinc to Generate Template Functions Program Parallelization ........9 Automatically .............38 How the Compiler Generates the Function IBM SMP Directives ............9 Definitions..............39 OpenMP Directives ............10 Specifying the Template-Implementation File . 40 Countable Loops ............11 Specifying a Different Path for the tempinc Reduction Operations in Parallelized Loops . 12 Subdirectory .............40 Shared and Private Variables in a Parallel Regenerating the Template Instantiation File . 40 Environment ..............13 Breaking a Template Instantiation File into More Than One File ............40 Using VisualAge C++ with Other ContentsofTemplateInstantiationFile....40 Programming Languages.......15 Using #pragma Directives in Header Files . 41 Considerations for Shared Libraries .....42 Part 2. Tasks ...........17 Use -qnotempinc to Define Template Functions . 42 Use -qtemplateregistry to Define Template Functions 43 Recompiling Parts of Your Program After Making Set Up the Compilation Environment 19 Source Changes ............43 Set Environment Variables .........19 Set Environment Variables in bsh, ksh, or sh Control Parallel Processing with Shells ...............19 Pragmas ..............45 Set Environment Variables in csh Shell ....19 Set Environment Variables to Select 64- or 32-bit Modes................20 Use C and C++ with Other Set Parallel Processing Run-time Options ....20 Programming Languages.......47 Set Environment Variables for the Message and Interlanguage Calling Conventions ......47 Help Files ...............20 Corresponding Data Types .........47 Special Treatment of Character and Aggregate Invoke the Compiler .........23 Data................48 Invoke the Linkage Editor .........23 Use the Subroutine Linkage Conventions in Interlanguage Calls ............49 Specify Compiler Options ......25 Interlanguage Calls - Parameter Passing ....50 Interlanguage Calls - Call by Reference Specify Compiler Options on the Command Line. 25 Parameters .............51 -qOptions..............25 Interlanguage Calls - Call by Value Parameters 52 FlagOptions.............26 Interlanguage Calls - Rules for Passing Specify Compiler Options in Your Program Source Parameters by Value ..........52 Files .................27 Interlanguage Calls - Pointers to Functions . 54 Specify Compiler Options in a Configuration File. 27 Interlanguage Calls - Function Return Values . 54 TailoraConfigurationFile........28 Interlanguage Calls - Stack Floor ......55 Configuration File Attributes .......28 © Copyright IBM Corp. 1995,2002 iii Interlanguage Calls - Stack Overflow .....55 haltonmsg.............144 Interlanguage Calls - Traceback Table.....56 heapdebug .............145 Interlanguage Calls - Type Encoding and hot................146 Checking..............56 hsflt ...............148 Sample Program: C Calling Fortran ......57 hssngl...............149 I.................150 Part 3. Reference .........59 idirfirst ..............151 ignerrno ..............152 ignprag ..............153 Compiler Options ..........61 info...............154 Compiler Command Line Options .......61 initauto..............157 +(plussign).............71 inlglue..............158 # (pound sign) ............72 inline...............159 32,64...............73 ipa................163 aggrcopy ..............74 isolated_call.............170 alias................75 keepinlines.............171 align................77 keyword..............172 alloca...............81 L................173 ansialias..............82 l.................174 arch................83 langlvl...............175 assert ...............86 largepage..............189 attr................87 ldbl128, longdouble ..........190 B.................88 libansi ...............191 b.................89 linedebug.............192 bitfields ..............90 list ................193 bmaxdata ..............91 listopt ...............194 brtl................92 longlit...............195 C.................93 longlong ..............197 c.................94 M................198 cache...............95 ma................199 chars...............97 macpstr..............200 check...............98 maf................203 cinc...............100 makedep..............204 compact..............101 maxerr..............206 cpluscmt..............102 maxmem..............208 D................106 mbcs,dbcs.............209 dataimported ............108 mkshrobj..............210 datalocal..............109 namemangling............214 dbxextra ..............110 O,optimize.............215 digraph..............111 o................219 dollar...............113 objmodel..............220 dpcl...............114 oldpassbyvalue ............221 E................115 P................222 e ................117 p................223 eh................118 pascal...............224 enum...............119 path...............225 expfile...............125 pdf1,pdf2.............226 extchk...............126 pg................229 F................127 phsinfo..............230 f.................128 print...............231 fdpr...............129 priority ..............232 flag................130 proclocal, procimported, procunknown ....233 float...............131 proto...............235 flttrap ...............135 Q................236 fold...............137 r.................239 fullpath..............138 report...............240 funcsect ..............139 rndflt...............241 G................140 rndsngl..............243 g................141 ro................244 genproto..............142 roconst..............245 halt................143 rrm................246 iv VisualAge C++ for AIX Compiler Reference rtti ................247 #pragma langlvl ...........317 S ................248 #pragma leaves............318 s ................249 #pragmamap............319 showinc..............250 #pragmamc_func...........321 smallstack .............251 #pragmanamemangling.........322 smp...............252 #pragma nameManglingRule .......323 source...............254 #pragma object_model .........324 spill...............255 #pragmaoptions...........325 spnans ..............256 #pragma option_override ........331 srcmsg..............257 #pragmapack............332 staticinline .............258 #pragma pass_by_value .........335 statsym..............259 #pragma priority ...........336 stdinc...............260 #pragma reachable ..........337 strict ...............261 #pragma reg_killed_by .........338 strict_induction............262 #pragmareport............339 suppress ..............263 #pragma strings ...........341 symtab..............264 #pragmaunroll............342 syntaxonly .............265 Pragmas to Control Parallel Processing .....344 t.................266 #pragma ibm critical ..........346 tabsize...............267 #pragmaibmindependent_calls......347 tbtable...............268 #pragmaibmindependent_loop......348 tempinc..............269 #pragma ibm iterations .........349 templaterecompile...........270 #pragma ibm parallel_loop ........350 templateregistry ...........271 #pragmaibmpermutation........351 tempmax..............272 #pragmaibmschedule.........352 threaded..............273 #pragmaibmsequential_loop.......354 tmplparse.............274 #pragmaompatomic..........355 tocdata..............275