Table of Contents

1. Compile C, C++, Objective-C, Ada, Fortran, Java, or treelang
2. Language Standards Supported by GCC
3. GCC Command Options

3.1 Option Summary
3.2 Options Controlling the Kind of Output
3.3 Compiling C++ Programs
3.4 Options Controlling C Dialect
3.5 Options Controlling C++ Dialect
3.6 Options Controlling Objective-C Dialect
3.7 Options to Control Diagnostic Messages Formatting
3.8 Options to Request or Suppress Warnings
3.9 Options for Debugging Your Program or GCC
3.10 Options That Control Optimization
3.11 Options Controlling the Preprocessor
3.12 Passing Options to the Assembler
3.13 Options for Linking
3.14 Options for Directory Search
3.15 Specifying subprocesses and the switches to pass to them
3.16 Specifying Target Machine and Compiler Version
3.17 Hardware Models and Configurations

3.17.1 M680x0 Options
3.17.2 M68hc1x Options
3.17.3 VAX Options
3.17.4 SPARC Options
3.17.5 ARM Options
3.17.6 MN10200 Options
3.17.7 MN10300 Options
3.17.8 M32R/D Options
3.17.9 M88K Options
3.17.10 IBM RS/6000 and PowerPC Options
3.17.11 Darwin Options
3.17.12 IBM RT Options
3.17.13 MIPS Options
3.17.14 Intel 386 and AMD x86-64 Options
3.17.15 HPPA Options
3.17.16 Intel 960 Options
3.17.17 DEC Alpha Options
3.17.18 DEC Alpha/VMS Options
3.17.19 H8/300 Options
3.17.20 SH Options
3.17.21 Options for System V
3.17.22 TMS320C3x/C4x Options
3.17.23 V850 Options
3.17.24 ARC Options
3.17.25 NS32K Options
3.17.26 AVR Options
3.17.27 MCore Options
3.17.28 IA-64 Options
3.17.29 D30V Options
3.17.30 S/390 and zSeries Options
3.17.31 CRIS Options
3.17.32 MMIX Options
3.17.33 PDP-11 Options
3.17.34 Xstormy16 Options
3.17.35 FRV Options
3.17.36 Xtensa Options

3.18 Options for Code Generation Conventions
3.19 Environment Variables Affecting GCC
3.20 Running Protoize

4. C Implementation-defined behavior

4.1 Translation
4.2 Environment
4.3 Identifiers
4.4 Characters
4.5 Integers
4.6 Floating point
4.7 Arrays and pointers
4.8 Hints
4.9 Structures, unions, enumerations, and bit-fields
4.10 Qualifiers
4.11 Preprocessing directives
4.12 Library functions
4.13 Architecture
4.14 Locale-specific behavior

5. Extensions to the C Language Family

5.1 Statements and Declarations in Expressions
5.2 Locally Declared Labels
5.3 Labels as Values
5.4 Nested Functions
5.5 Constructing Function Calls
5.6 Referring to a Type with typeof
5.7 Generalized Lvalues
5.8 Conditionals with Omitted Operands
5.9 Double-Word Integers
5.10 Complex Numbers
5.11 Hex Floats
5.12 Arrays of Length Zero
5.13 Structures With No Members
5.14 Arrays of Variable Length
5.15 Macros with a Variable Number of Arguments.
5.16 Slightly Looser Rules for Escaped Newlines
5.17 Non-Lvalue Arrays May Have Subscripts
5.18 Arithmetic on void- and Function-Pointers
5.19 Non-Constant Initializers
5.20 Compound Literals
5.21 Designated Initializers
5.22 Case Ranges
5.23 Cast to a Union Type
5.24 Mixed Declarations and Code
5.25 Declaring Attributes of Functions
5.26 Attribute Syntax
5.27 Prototypes and Old-Style Function Definitions
5.28 C++ Style Comments
5.29 Dollar Signs in Identifier Names
5.30 The Character ESC in Constants
5.31 Inquiring on Alignment of Types or Variables
5.32 Specifying Attributes of Variables
5.33 Specifying Attributes of Types
5.34 An Inline Function is As Fast As a Macro
5.35 Assembler Instructions with C Expression Operands

5.35.1 i386 floating point asm operands

5.36 Constraints for asm Operands

5.36.1 Simple Constraints
5.36.2 Multiple Alternative Constraints
5.36.3 Constraint Modifier Characters
5.36.4 Constraints for Particular Machines

5.37 Controlling Names Used in Assembler Code
5.38 Variables in Specified Registers

5.38.1 Defining Global Register Variables
5.38.2 Specifying Registers for Local Variables

5.39 Alternate Keywords
5.40 Incomplete enum Types
5.41 Function Names as Strings
5.42 Getting the Return or Frame Address of a Function
5.43 Using vector instructions through built-in functions
5.44 Other built-in functions provided by GCC
5.45 Built-in Functions Specific to Particular Target Machines

5.45.1 Alpha Built-in Functions
5.45.2 X86 Built-in Functions
5.45.3 PowerPC AltiVec Built-in Functions

5.46 Pragmas Accepted by GCC

5.46.1 ARM Pragmas
5.46.2 RS/6000 and PowerPC Pragmas
5.46.3 Darwin Pragmas
5.46.4 Solaris Pragmas
5.46.5 Tru64 Pragmas

5.47 Unnamed struct/union fields within structs/unions.
5.48 Thread-Local Storage

5.48.1 ISO/IEC 9899:1999 Edits for Thread-Local Storage
5.48.2 ISO/IEC 14882:1998 Edits for Thread-Local Storage

6. Extensions to the C++ Language

6.1 Minimum and Maximum Operators in C++
6.2 When is a Volatile Object Accessed?
6.3 Restricting Pointer Aliasing
6.4 Vague Linkage
6.5 Declarations and Definitions in One Header
6.6 Where's the Template?
6.7 Extracting the function pointer from a bound pointer to member function
6.8 C++-Specific Variable, Function, and Type Attributes
6.9 Java Exceptions
6.10 Deprecated Features
6.11 Backwards Compatibility

7. GNU Objective-C runtime features

7.1 +load: Executing code before main

7.1.1 What you can and what you cannot do in +load

7.2 Type encoding
7.3 Garbage Collection
7.4 Constant string objects
7.5 compatibility_alias

8. Binary Compatibility
9. gcov---a Test Coverage Program

9.1 Introduction to gcov
9.2 Invoking gcov
9.3 Using gcov with GCC Optimization
9.4 Brief description of gcov data files

10. Known Causes of Trouble with GCC

10.1 Actual Bugs We Haven't Fixed Yet
10.2 Cross-Compiler Problems
10.3 Interoperation
10.4 Problems Compiling Certain Programs
10.5 Incompatibilities of GCC
10.6 Fixed Header Files
10.7 Standard Libraries
10.8 Disappointments and Misunderstandings
10.9 Common Misunderstandings with GNU C++

10.9.1 Declare and Define Static Members
10.9.2 Temporaries May Vanish Before You Expect
10.9.3 Implicit Copy-Assignment for Virtual Bases

10.10 Caveats of using protoize
10.11 Certain Changes We Don't Want to Make
10.12 Warning Messages and Error Messages

11. Reporting Bugs

11.1 Have You Found a Bug?
11.2 How and where to Report Bugs

12. How To Get Help with GCC
13. Contributing to GCC Development
Funding Free Software
The GNU Project and GNU/Linux
GNU GENERAL PUBLIC LICENSE

Preamble
How to Apply These Terms to Your New Programs

GNU Free Documentation License

ADDENDUM: How to use this License for your documents

Contributors to GCC
Option Index
Keyword Index