GCC编译器官方文档

【实例简介】
GCC编译器官方文档
Short contents Introduction 1 Programming Languages Supported by gCC Language Standards Supported by gCC 3 GCC Command options ··非 4 C Implementation-Defined Behavior 429 5 C++Implementation-Defined Behavior 437 6 Extensions to the C language family 439 7 Extensions to the C++ language 787 8 G.U Objective-C Features ..801 9 Binary Compatibility 817 10 gcov a Test Coverage Program 821 11 gcov-tool--an Offine Gcda Profile Processing Tool.......833 12 gcov-dump--an Offline Gcda and gcno Profile Dump Tool.837 13 Known Causes of Trouble with gcc 14 Reporting Bugs…… ...855 15 How To Get Help with gCC 857 16 Contributing to GCC Development 859 上 unding上 ree Software....… ..,,,,.861 The GNU Project and GNU /Linux ....863 GNU General public license ,,,,86:5 GNU Free Documentation License 877 Contributors to gcc 88 5 Option index Keyword Index ,,,,,,,,,,,,,,927 Table of Contents Introduction 1 Programming Languages Supported by GCC 2 Language standards Supported by gCc 2.1 C Language 2.2 C++language............. 6 2.3 Objective-C and Objective-C++ languages 2.4 Go Language 2.5 HSA Intermediate Language(HSAlL 2.6 References for Other Languages 3 GCC Command Options e非· 9 3.1 Option Summary 9 3.2 Options Controlling the Kind of Output ..29 3.3 Compiling C++ P rograms 34 3.4 Options Controlling C Dialect 35 3.5 Options Controlling C++ Dialect 42 3.6 Options Controlling Objective-C and Objective-C++ Dialects.55 3.7 Options to Control Diagnostic Messages Formatting 59 3.8 Options to Request or Suppress Warnings 62 3.9 Options for Debugging Your Program............ 108 3.10 Options That Control Optimization 114 3.11 Program Instrumentation Options ..172 3.12 Options Controlling the Preprocessor............ 187 3. 13 Passing Options to the assembler .194 3.16 Options for Code( eneration Conventions……….…∴……195 11 Options for Linking 看鲁· 3.15 Options for Directory Search 199 ..202 3.17 GCC Developer Options ,,,212 3.18 Machine-Dependent Options 228 3.18.1 AArch64 Options 228 318.1.1‘- march’and‘-mcpu' Fcaturc Modifiers.…232 3.18.2Ada Epiphany Options 233 3. 18.3 ARC Options 235 3.18.4 ARM Options ...245 3. 18.5 AVR Options ..258 3. 18.5.1 EIND and Devices with More Than 12& Ki Bytes of Flash 262 3.18.5.2 Handling of the RAMPD, RAMPX, RAMPY and RAMPZ Special Function registers ∴..264 Using the GNU Compiler Collection(GCC) 3.18.5.3 AVR Built-in macros 264 3 .18.6 Blackfin Options ∴......267 3. 18.7 C6X Opti 70 3.18. 8 CRIS Options .270 3. 18.9 CR16 Optio 272 3.18.10 Darwin Options............. 272 3. 18.11 DEC Alpha Options 276 3.18.12上R30 Options 280 3.18. 13 FT32 OptiOns 281 3.18. 14 FRV Options 281 3. 18.15 GNU /Linux Options 85 3. 18.16 H8 300 Options ··,· 3. 18.17 HPPA Options 286 3.18.18 IA-64 Options 鲁鲁 ..289 3.18.19 LM32 Options 292 3. 18.20 M32C Options ,∴293 3.18.21 M32R/D Options 293 3.18.22M680x0 Options...... 295 3.18.23 MCore Options 3. 18.24 Mep options 301 3.18.25 MicroBlaze Options 302 3. 18.26 MIPS Options 3.18.27 MMIX Options 18 3. 18.28 MN10300 Options....... .319 3.18.29 Moxie Options ......320 3.18.30MSP430 Options.….320 3.18.31 NDS32 Options. …∴.322 3. 18.32 Nios II Options 323 3. 18.33 Nvidia PtX Options ......328 3.18.34PDP-11 Options.........329 3.18.35 pico Chip Options ..,330 3. 18.36 PowerPC Options ..331 3.18.37 PowerPC SPE Options ∴...331 3. 18.38 RISC-V Options 342 3. 18.39 RL78 Options 344 3.18.40 IBM RS/6000 and PowerPC Options .....345 3. 18.41 RX Options .361 3. 18.42 $/390 and z Series Options 364 3. 18.43 Score Options ,.368 3. 18.44 SH Options ..369 3. 18.45 Solaris 2 Options 375 3.18.46 SPARC Options · 3. 18.47 SPU Options ,,,381 3.18.48 Options for System V 383 3. 18.49 TILE-Gx Options ...384 3.18.50 TILEPro Options ..384 3. 18.51 V850 Options ∴...384 3.18.52 VAX Options 387 3.18.53 Visium Options .··· 387 3. 18.54 VMS Options ∴......388 3. 18.55 Vx Works Options ..388 3.18.56x8 tions 389 3. 18.57 86 Windows Options 412 3.18.58 Stormy 16 Options 413 3. 18.59 Xtensa Options .,413 3.18.60 ZSeries Options 3. 19 Specifying Subprocesses and the Switches to Pass lo TheIl. 415 3.20 Environment Variables Affecting Gcc 422 3.21 Using Precompiled Headers 425 4 C Implementation-Defined Behavior 429 4.1 Translation 429 4.2 Environment 429 4.3 Identifiers ...429 4.4 Characters 430 4.5 Integers ∴...431 4.6 Floating point 431 4.7 Arrays and pointers 432 4.8Hi 133 4.9 Structures. Unions. Enumerations and Bil-Fields....... 433 1.10 Qualifiers ∴.131 4.11 Declarators 435 4.12 Statements 4.13 Preprocessing directives ,,435 4.14 Library Functions 436 4.15 Architecture ..,,,436 4.16 Localc-Spccific Bch 436 5 C++Implementation-Defined Behavior..437 5.1 Conditionally-Supported Behavior 437 5.2 Exception Handling ∴..437 6 Extensions to the C Language Family 439 6.1 Statcmcnts and Declarations in Exprcssions 439 6.2 Loca lly Declared labels 440 6.3 Labels as valucs 441 6.4 Nested functions 442 6.5 Constructing Function Calls 444 6.6 Referring to a Type with typeof 446 6.7 Conditionals with Omitted Operands ∴...447 6. 8 128-bit Integers 448 6.9 Double-Word integers ..448 6.10 Complex Numbers 448 6.11 Additional Floating Types .449 6.12 Half-Precision Floating Point 450 Using the GNU Compiler Collection(GCC) 6.13 Decimal Floating Types 451 6.14 Hex floats ··.,··,·, ,.451 6.15 Fixed-Point Types 452 6.16 Named Address Spaces................... 453 6. 16.1 AVR Named Address spaces 453 6.16.2 M32C Named Address Spaces 455 6.16.3 RL78 Named Address Spaces 455 6. 16. 1 SPU Named Address Spaces ∴....155 6. 16.5 x86 Named Address Spaces 6. 17 Arrays of Length Zero ·:· 456 6.18 Structures with No members 457 6.19 Arrays of Variable Length .457 6.20 Macros with a Variable Number of Arguments 458 6.22 Non-Ivalue Arrays May Have Subscripts 6.21 Slightly Looser Rules for Escaped Ncwlincs......... 459 459 6.23 Arithmctic on void- and Function-Pointcrs 459 6.24 Pointers to Arrays with Qualifiers Work as Expected 460 6.25 Non-Constant Initializers .,460 6.26 Compound literals 460 6.27 Designated Initializers 461 6.28 Case ranges 463 6.29 Cast to a Union Type ∴..463 6.30 Mixed Declarations and Code 463 6.31 Declaring Attributes of functions 464 6.31.1 Common Function Attributes 464 6.31.2 AArch64 Function Attributes............. 481 6.31.2.1 Inlining rules 483 6.31. 3 ARC Function Attributes 483 6.31.1 ARM Function Attributes 184 6.31.5 AVR Function attributes 486 6.31. 6 Blackfin Function attributes 187 6. 31.7 CR16 Function Attributes ,,,,,,488 6. 31.8 Epiphany Function Attributes ............. 488 6.31.9 H8/300 Function Attrib 489 6.31.10 IA-64 Function Attributes ∴,490 6.31.11M32CF Attribute 490 6. 31.12 M32R/D Function Attributes............. 491 6.31.13 m68k Function attributes 491 6.31.14 MCORE Function Attributes 鲁鲁春鲁 492 6.31. 15 MeP Function Attributes 492 6.31. 16 MicroBlaze Function Attributes .492 6.31. 17 Microsoft Windows Function Attributes ....493 6.31. 18 MIPS Function Attributes ..494 6.31.19 MSP430 Function Attributes 496 6.31.20 NDS32 Function Attributes 497 6.31.21 Nios II Function Attributes 498 6. 31.22 Nvidia PTX Function Attributes .499 6.31. 23 PowerPC Function Attributes ..499 VIl 6.31. 24 RISC-V Function Attributes ∴.502 6.31.25 RL78 Function Attributes ......502 6.31.26 RX Function Attributes .503 6.31.27 $/390 Function Attributes 504 6.31.28 SH Function Attributes 503 6.31.29 SPU Function Attributes ∴......506 6.31.30 Symbian OS Function Attributes ∴506 6.31.31 V850 Function Attributes...............506 6. 31.32 Visium Function attributes 506 6.31. 33 x86 Function Attributes ..,506 6.31.34 Xstormv16 Function Attributes ,512 6.32 Specifying Attribute b es of variables 513 6.32. 1 Common Variable Attributes. ..........................513 6.32.2 ARC Variable Attributes................518 6.32.3 AVR Variable Attribut 6.32. 4 Blackfin variable Attributes 520 6. 32.5 H8/ 300 Variable Attributes 520 6.32.6 IA-64 Variable Attributes........,...... 520 6. 32.7 M32R/D Variable Attributes ...521 6.32.8 MeP Variable Attributes .521 6.32.9 Microsoft Windows variable Attributes 522 6.32.10 MSP430 Variable Attributes ∴..,522 6.32. 11 Nvidia PTX Variable Attributes ..,,523 6.32.12 PowerPC Variable Attributes 523 6.32. 13 RL 78 Variable Attributes 523 6.32. 14 SPu Variable Attributes 523 6.32.15 V850 Variable Attributes 523 6.32.16 x86 Variable Attributes ∴..524 6.32.17 Xstormv16 Variable Attributes 521 6.33 Specifying Attributes of Types 524 6.33. 1 Common Type Attributes 524 6.33.2 ARC Type Attributes 531 6.33. 3 ARM Type Attributes 531 6.33.4 MeP Type attributes ....531 6.33.5 PowcrPC Typc Attributes 531 6.33.6 SPU Type Attributes 531 6.33.7 x86 Typc Attributes .532 6.34 Label Attributes ....532 6.35 Enumerator Attributes ∴..533 6.36 Statement Attributes 533 6.37 Attribute Syntax 534 6.38 Prototypes and Old-Style Function Definitions 537 6.39 C++ Style col ts 538 6.40 Dollar Signs in Identifier Names 538 6.41 The Character EsC in Constants ..538 6. 412 Inquiring on Alignment of Types or Variables 38 6.43 An Inline Function is As Fast as a macro 539 6.44 When is a Volatile Object Accessed? ....540 Using the GNU Compiler Collection(GCC) 6.45 How to Use Inline Assembly Language in C Code 541 6.45. 1 Basic Asm- Assembler Instructions Without Operands ∴...542 6.45.2 Extended Asm -Assembler Instructions with C Expression Operands... ∴,543 6.45.2.1 Volatile 6.45. 2.2 Assembler Template................547 6. 15.2.3 Output operands 518 6.45.2.4 Flag Output Operands 551 6. 2.5 Input Operands .552 6.45. 2.6 Clobbers and scratch registers ∴...553 6. 7 Goto labels 556 6.45. 2.8 86 Operand Modifiers 557 6.45. 2.9 86 Floating-Point asm Opcrands 558 6.45.3 Constraints for asm Operands 559 6. 1 Simplc Constraints 560 6.45.3.2 Multiple Alternative Constraints 562 6.45.3.3 Constraint Modifier Characters .562 6.45.3.4 Constraints for Particular Machine ..563 6.45. 4 Controlling Names Used in Assembler Code 592 6.45. 5 Variables in Specified Registers ...592 6.45.5. 1 Defining Global Register Variables ..593 6.45.5. 2 Specifying Registers for Local variables 594 6. 45.6 Size of an asm.....................595 6.46 Alter Keywords 595 6.47 Incomplete enum Types 596 6.48 Function Names as strings 596 6.49 Getting the Return or Frame Address of a Function..... 597 6.50 Using Vector Instructions through Built-in Functions..... 598 6.51 t for offsetof 600 6.52 Legacy -_sync Built-in Functions for Atomic Memory Access 601 6.53 Built-in Functions for Memory Model aware Atomic Operations 603 6.54 Built-in Functions to Pcrform Arithmctic with OvcrHlow Chccking ....607 6.55 x86-Spccific Mcmory Modcl Extensions for Transactional Memory 609 6.56 Object Size Checking Built-in Functions 6.57 Pointer bounds Checker Built -in Functions 611 6.58 Other Built-in Functions Provided by gco 613 6.59 Built-in Functions Specific to Particular Target Machines..626 6.59.1 AArch64 Built-in Functions 626 6.59.2 Alpha Built-in Functions ...627 6.59.3 Altera Nios ii Built-in Functions ∴....628 6.59.4 ARC Built-in Functions................ 630 6.59.5 ARC SIMD Built-in Functions ∴..,632 6.59.6 ARM iWMMXt Built-in Functions ....636 【实例截图】
【核心代码】