IBM XL C for AIX, V13.1.2 IBM Compiler Reference Version 13.1.2 SC27-4239-01 IBM XL C for AIX, V13.1.2 IBM Compiler Reference Version 13.1.2 SC27-4239-01 Note Before using this information and the product it supports, read the information in “Notices” on page 597. First edition This edition applies to IBM XL C for AIX, V13.1.2 (Program 5765-J06; 5725-C71) and to all subsequent releases and modifications until otherwise indicated in new editions. Make sure you are using the correct edition for the level of the product. © Copyright IBM Corporation 1996, 2015. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About this document ......... ix Chapter 3. Tracking and reporting Who should read this document ....... ix compiler usage ........... 47 How to use this document ......... ix Understanding utilization tracking and reporting .. 47 How this document is organized ....... ix Overview .............. 47 Conventions .............. x Four usage scenarios .......... 48 Related information ........... xiii Preparing to use this feature......... 56 IBM XL C information ......... xiii Time synchronization .......... 56 Standards and specifications ....... xiv License types and user information ..... 56 Other IBM information ......... xv Central configuration .......... 57 Other information ........... xv Concurrent user considerations ....... 57 Technical support ............ xv Usage file considerations ......... 58 How to send your comments ........ xv Regular utilization checking ........ 60 Testing utilization tracking ......... 60 Chapter 1. Compiling and linking Configuring utilization tracking ....... 62 applications ............. 1 Editing utilization tracking configuration file Invoking the compiler ........... 1 entries ............... 62 Command-line syntax .......... 2 Understanding the utilization reporting tool ... 66 Types of input files ............ 3 Utilization reporting tool command-line options 66 Types of output files ............ 4 Generating usage reports .......... 70 Specifying compiler options ......... 5 Understanding usage reports ....... 70 Specifying compiler options on the command line 5 Pruning usage files ............ 73 Specifying compiler options in a configuration file 7 Diagnostic messages from utilization tracking and Specifying compiler options in program source reporting ............... 74 files ................ 7 Resolving conflicting compiler options..... 8 Chapter 4. Compiler options reference 75 Specifying compiler options for Summary of compiler options by functional architecture-specific compilation ....... 9 category ............... 75 Reusing GNU C compiler options with gxlc ... 11 Output control ............ 75 gxlc syntax ............. 11 Input control ............. 76 Preprocessing.............. 12 Language element control ........ 77 Directory search sequence for include files ... 12 Floating-point and integer control ...... 78 Linking................ 14 Object code control ........... 79 Order of linking ............ 14 Error checking and debugging ....... 81 Redistributable libraries ......... 15 Listings, messages, and compiler information .. 84 Compatibility with earlier versions ..... 16 Optimization and tuning ......... 85 Compiler messages and listings........ 17 Linking............... 89 Compiler messages ........... 17 Portability and migration ......... 90 Compiler return codes.......... 19 Compiler customization ......... 91 Compiler listings ........... 20 Deprecated options ........... 91 Message catalog errors.......... 22 Individual option descriptions ........ 92 Paging space errors during compilation .... 23 -# (pound sign) ............ 93 -q32, -q64 .............. 94 Chapter 2. Configuring compiler -qaggrcopy ............. 95 defaults .............. 25 -qalias ............... 96 -qalign ............... 98 Setting environment variables ........ 25 -qalloca, -ma ............ 100 Compile-time and link-time environment -qaltivec .............. 101 variables .............. 26 -qarch ............... 102 Runtime environment variables....... 26 -qasm ............... 105 Environment variables for parallel processing .. 27 -qasm_as .............. 107 Using custom compiler configuration files .... 40 -qassert .............. 108 Creating custom configuration files ..... 41 -qattr ............... 108 Configuring the gxlc option mapping...... 44 -b ................ 109 -B ................ 110 -qbitfields.............. 111 © Copyright IBM Corp. 1996, 2015 iii -bmaxdata ............. 112 -qldbl128, -qlongdouble ......... 213 -brtl ............... 113 -qlib ............... 214 -c ................ 114 -qlibansi .............. 215 -C, -C! ............... 115 -qlibmpi .............. 216 -qcache .............. 116 -qlinedebug ............. 217 -qchars .............. 118 -qlist ............... 218 -qcheck .............. 119 -qlistfmt .............. 219 -qcompact ............. 122 -qlistopt .............. 222 -qconcurrentupdate .......... 123 -qlonglit .............. 223 -qcpluscmt ............. 123 -qlonglong ............. 224 -qcrt ............... 124 -ma................ 225 -qc_stdinc ............. 125 -qmacpstr ............. 225 -D ................ 126 -qmakedep, -M ............ 227 -qdataimported, -qdatalocal, -qtocdata .... 127 -qmaxerr .............. 229 -qdbgfmt .............. 129 -qmaxmem ............. 230 -qdbxextra ............. 130 -qmbcs, -qdbcs ............ 231 -qdfp ............... 131 -MF ............... 232 -qdigraph ............. 132 -qminimaltoc ............ 233 -qdirectstorage ............ 133 -qmkshrobj ............. 234 -qdollar .............. 133 -o ................ 236 -qdpcl ............... 134 -O, -qoptimize ............ 237 -e ................ 135 -qoptdebug ............. 240 -E ................ 136 -qoptfile .............. 242 -qenum .............. 137 -p, -pg, -qprofile ........... 244 -qexpfile .............. 141 -P ................ 245 -qextchk .............. 141 -qpath ............... 246 -f ................ 142 -qpdf1, -qpdf2 ............ 248 -F ................ 143 -qphsinfo .............. 254 -qfdpr ............... 144 -qpic ............... 255 -qflag ............... 145 -qppline .............. 256 -qfloat ............... 146 -qprefetch ............. 257 -qflttrap .............. 151 -qprint .............. 260 -qformat .............. 155 -qprocimported, -qproclocal, -qprocunknown 261 -qfullpath ............. 156 -qproto .............. 263 -qfuncsect ............. 157 -r ................ 264 -qfunctrace ............. 158 -qreport .............. 264 -g ................ 160 -qreserved_reg ............ 266 -G ................ 163 -qrestrict .............. 267 -qgenproto ............. 164 -qro ............... 268 -qhalt ............... 165 -qroconst .............. 270 -qhaltonmsg ............. 166 -qroptr .............. 271 -qheapdebug ............ 167 -s ................ 272 -qhelp ............... 169 -S ................ 272 -qhot ............... 169 -qsaveopt.............. 274 -I ................ 172 -qshowinc ............. 276 -qidirfirst .............. 173 -qshowmacros ............ 277 -qignerrno ............. 174 -qshowpdf ............. 278 -qignprag.............. 175 -qsimd .............. 279 -qinclude .............. 176 -qskipsrc .............. 281 -qinfo ............... 178 -qsmallstack ............. 282 -qinitauto.............. 186 -qsmp ............... 282 -qinlglue .............. 188 -qsource .............. 287 -qinline .............. 190 -qsourcetype............. 288 -qipa ............... 193 -qspeculateabsolutes .......... 289 -qisolated_call ............ 200 -qspill ............... 290 -qkeepparm ............. 203 -qsrcmsg .............. 291 -qkeyword ............. 204 -qstackprotect ............ 292 -l ................ 205 -qstatsym.............. 293 -L ................ 206 -qstdinc .............. 293 -qlanglvl .............. 207 -qstrict .............. 295 -qlargepage ............. 212 -qstrict_induction ........... 299 iv XL C: Compiler Reference -qsuppress ............. 300 #pragma ibm snapshot ......... 355 -qsymtab .............. 301 #pragma info ............ 355 -qsyntaxonly ............ 302 #pragma init ............ 355 -t ................ 303 #pragma isolated_call ......... 356 -qtabsize .............. 304 #pragma langlvl ........... 356 -qtbtable .............. 305 #pragma leaves............ 356 -qthreaded ............. 306 #pragma loopid ........... 357 -qtimestamps ............ 307 #pragma map ............ 358 -qtls ............... 308 #pragma mc_func ........... 359 -qtocmerge ............. 309 #pragma nofunctrace .......... 361 -qtrigraph ............. 310 #pragma nosimd ........... 362 -qtune ............... 311 #pragma novector ........... 362 -U ................ 314 #pragma options ........... 362 -qunroll .............. 315 #pragma option_override ........ 364 -qunwind.............. 317 #pragma pack ............ 366 -qupconv .............. 318 #pragma reachable .......... 369 -qutf ............... 319 #pragma reg_killed_by ......... 370 -v, -V ............... 320 #pragma simd_level .......... 372 -qvecnvol.............. 321 #pragma STDC CX_LIMITED_RANGE .... 373 -qversion .............. 322 #pragma stream_unroll ......... 374 -qvisibility ............. 323 #pragma strings ........... 375 -w ................ 325 #pragma unroll, #pragma nounroll ..... 375 -W ................ 326 #pragma unrollandfuse ......... 375 -qwarn64 .............. 328 #pragma weak ............ 377 -qweakexp ............. 329 Pragma directives for parallel processing