--- title: GNU Compiler Collection (GCC) Internals framework: developertools role: article path: apple-archive/documentation/DeveloperTools/gcc-4.2.1/gccint --- # GNU Compiler Collection (GCC) Internals This file documents the internals of the GNU compilers. ``` ``` Copyright © 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with the Invariant Sections being “GNU General Public License” and “Funding Free Software”, the Front-Cover texts being (a) (see below), and with the Back-Cover Texts being (b) (see below). A copy of the license is included in the section entitled “GNU Free Documentation License”. (a) The FSF's Front-Cover Text is: A GNU Manual (b) The FSF's Back-Cover Text is: You have freedom to copy and modify this GNU Manual, like GNU software. Copies published by the Free Software Foundation raise funds for GNU development. ``` ``` ## Short Contents - [Introduction](index.html#toc_Top) - [1 Contributing to GCC Development](index.html#toc_Contributing) - [2 GCC and Portability](index.html#toc_Portability) - [3 Interfacing to GCC Output](index.html#toc_Interface) - [4 The GCC low-level runtime library](index.html#toc_Libgcc) - [5 Language Front Ends in GCC](index.html#toc_Languages) - [6 Source Tree Structure and Build System](index.html#toc_Source-Tree) - [7 Option specification files](index.html#toc_Options) - [8 Passes and Files of the Compiler](index.html#toc_Passes) - [9 Trees: The intermediate representation used by the C and C++ front ends](index.html#toc_Trees) - [10 Analysis and Optimization of GIMPLE Trees](index.html#toc_Tree-SSA) - [11 Analysis and Representation of Loops](index.html#toc_Loop-Analysis-and-Representation) - [12 RTL Representation](index.html#toc_RTL) - [13 Control Flow Graph](index.html#toc_Control-Flow) - [14 Machine Descriptions](index.html#toc_Machine-Desc) - [15 Target Description Macros and Functions](index.html#toc_Target-Macros) - [16 Host Configuration](index.html#toc_Host-Config) - [17 Makefile Fragments](index.html#toc_Fragments) - [18 `collect2`](index.html#toc_Collect2) - [19 Standard Header File Directories](index.html#toc_Header-Dirs) - [20 Memory Management and Type Information](index.html#toc_Type-Information) - [Funding Free Software](index.html#toc_Funding) - [The GNU Project and GNU/Linux](index.html#toc_GNU-Project) - [GNU GENERAL PUBLIC LICENSE](index.html#toc_Copying) - [GNU Free Documentation License](index.html#toc_GNU-Free-Documentation-License) - [Contributors to GCC](index.html#toc_Contributors) - [Option Index](index.html#toc_Option-Index) - [Concept Index](index.html#toc_Concept-Index) ## Table of Contents - Introduction 1 Contributing to GCC Development 2 GCC and Portability 3 Interfacing to GCC Output 4 The GCC low-level runtime library [4.1 Routines for integer arithmetic](Integer-library-routines.html#Integer-library-routines) [4.1.1 Arithmetic functions](Integer-library-routines.html#Integer-library-routines) [4.1.2 Comparison functions](Integer-library-routines.html#Integer-library-routines) [4.1.3 Trapping arithmetic functions](Integer-library-routines.html#Integer-library-routines) [4.1.4 Bit operations](Integer-library-routines.html#Integer-library-routines) [4.2 Routines for floating point emulation](Soft-float-library-routines.html#Soft-float-library-routines) - [4.2.1 Arithmetic functions](Soft-float-library-routines.html#Soft-float-library-routines) [4.2.2 Conversion functions](Soft-float-library-routines.html#Soft-float-library-routines) [4.2.3 Comparison functions](Soft-float-library-routines.html#Soft-float-library-routines) [4.2.4 Other floating-point functions](Soft-float-library-routines.html#Soft-float-library-routines) [4.3 Routines for decimal floating point emulation](Decimal-float-library-routines.html#Decimal-float-library-routines) - [4.3.1 Arithmetic functions](Decimal-float-library-routines.html#Decimal-float-library-routines) [4.3.2 Conversion functions](Decimal-float-library-routines.html#Decimal-float-library-routines) [4.3.3 Comparison functions](Decimal-float-library-routines.html#Decimal-float-library-routines) [4.4 Language-independent routines for exception handling](Exception-handling-routines.html#Exception-handling-routines) [4.5 Miscellaneous runtime library routines](Miscellaneous-routines.html#Miscellaneous-routines) - [4.5.1 Cache control functions](Miscellaneous-routines.html#Miscellaneous-routines) 5 Language Front Ends in GCC 6 Source Tree Structure and Build System - [6.1 Configure Terms and History](Configure-Terms.html#Configure-Terms) [6.2 Top Level Source Directory](Top-Level.html#Top-Level) [6.3 The gcc Subdirectory](gcc-Directory.html#gcc-Directory) [6.3.1 Subdirectories of gcc](Subdirectories.html#Subdirectories) [6.3.2 Configuration in the gcc Directory](Configuration.html#Configuration) [6.3.2.1 Scripts Used by configure](Config-Fragments.html#Config-Fragments) [6.3.2.2 The config.build; config.host; and config.gcc Files](System-Config.html#System-Config) [6.3.2.3 Files Created by `configure`](Configuration-Files.html#Configuration-Files) [6.3.3 Build System in the gcc Directory](Build.html#Build) [6.3.4 Makefile Targets](Makefile.html#Makefile) [6.3.5 Library Source Files and Headers under the gcc Directory](Library-Files.html#Library-Files) [6.3.6 Headers Installed by GCC](Headers.html#Headers) [6.3.7 Building Documentation](Documentation.html#Documentation) - [6.3.7.1 Texinfo Manuals](Texinfo-Manuals.html#Texinfo-Manuals) [6.3.7.2 Man Page Generation](Man-Page-Generation.html#Man-Page-Generation) [6.3.7.3 Miscellaneous Documentation](Miscellaneous-Docs.html#Miscellaneous-Docs) [6.3.8 Anatomy of a Language Front End](Front-End.html#Front-End) - [6.3.8.1 The Front End language Directory](Front-End-Directory.html#Front-End-Directory) [6.3.8.2 The Front End config-lang.in File](Front-End-Config.html#Front-End-Config) [6.3.9 Anatomy of a Target Back End](Back-End.html#Back-End) [6.4 Testsuites](Testsuites.html#Testsuites) - [6.4.1 Idioms Used in Testsuite Code](Test-Idioms.html#Test-Idioms) [6.4.2 Directives used within DejaGnu tests](Test-Directives.html#Test-Directives) [6.4.3 Ada Language Testsuites](Ada-Tests.html#Ada-Tests) [6.4.4 C Language Testsuites](C-Tests.html#C-Tests) [6.4.5 The Java library testsuites.](libgcj-Tests.html#libgcj-Tests) [6.4.6 Support for testing gcov](gcov-Testing.html#gcov-Testing) [6.4.7 Support for testing profile-directed optimizations](profopt-Testing.html#profopt-Testing) [6.4.8 Support for testing binary compatibility](compat-Testing.html#compat-Testing) 7 Option specification files - [7.1 Option file format](Option-file-format.html#Option-file-format) [7.2 Option properties](Option-properties.html#Option-properties) 8 Passes and Files of the Compiler - [8.1 Parsing pass](Parsing-pass.html#Parsing-pass) [8.2 Gimplification pass](Gimplification-pass.html#Gimplification-pass) [8.3 Pass manager](Pass-manager.html#Pass-manager) [8.4 Tree-SSA passes](Tree_002dSSA-passes.html#Tree_002dSSA-passes) [8.5 RTL passes](RTL-passes.html#RTL-passes) 9 Trees: The intermediate representation used by the C and C++ front ends - [9.1 Deficiencies](Deficiencies.html#Deficiencies) [9.2 Overview](Tree-overview.html#Tree-overview) [9.2.1 Trees](Macros-and-Functions.html#Macros-and-Functions) [9.2.2 Identifiers](Identifiers.html#Identifiers) [9.2.3 Containers](Containers.html#Containers) [9.3 Types](Types.html#Types) [9.4 Scopes](Scopes.html#Scopes) - [9.4.1 Namespaces](Namespaces.html#Namespaces) [9.4.2 Classes](Classes.html#Classes) [9.5 Declarations](Declarations.html#Declarations) - [9.5.1 Working with declarations](Working-with-declarations.html#Working-with-declarations) [9.5.2 Internal structure](Internal-structure.html#Internal-structure) [9.5.2.1 Current structure hierarchy](Current-structure-hierarchy.html#Current-structure-hierarchy) [9.5.2.2 Adding new DECL node types](Adding-new-DECL-node-types.html#Adding-new-DECL-node-types) [9.6 Functions](Functions.html#Functions) - [9.6.1 Function Basics](Function-Basics.html#Function-Basics) [9.6.2 Function Bodies](Function-Bodies.html#Function-Bodies) [9.6.2.1 Statements](Function-Bodies.html#Function-Bodies) [9.7 Attributes in trees](Attributes.html#Attributes) [9.8 Expressions](Expression-trees.html#Expression-trees) 10 Analysis and Optimization of GIMPLE Trees - [10.1 GENERIC](GENERIC.html#GENERIC) [10.2 GIMPLE](GIMPLE.html#GIMPLE) [10.2.1 Interfaces](Interfaces.html#Interfaces) [10.2.2 Temporaries](Temporaries.html#Temporaries) [10.2.3 Expressions](GIMPLE-Expressions.html#GIMPLE-Expressions) [10.2.3.1 Compound Expressions](Compound-Expressions.html#Compound-Expressions) [10.2.3.2 Compound Lvalues](Compound-Lvalues.html#Compound-Lvalues) [10.2.3.3 Conditional Expressions](Conditional-Expressions.html#Conditional-Expressions) [10.2.3.4 Logical Operators](Logical-Operators.html#Logical-Operators) [10.2.4 Statements](Statements.html#Statements) - [10.2.4.1 Blocks](Blocks.html#Blocks) [10.2.4.2 Statement Sequences](Statement-Sequences.html#Statement-Sequences) [10.2.4.3 Empty Statements](Empty-Statements.html#Empty-Statements) [10.2.4.4 Loops](Loops.html#Loops) [10.2.4.5 Selection Statements](Selection-Statements.html#Selection-Statements) [10.2.4.6 Jumps](Jumps.html#Jumps) [10.2.4.7 Cleanups](Cleanups.html#Cleanups) [10.2.4.8 Exception Handling](GIMPLE-Exception-Handling.html#GIMPLE-Exception-Handling) [10.2.5 GIMPLE Example](GIMPLE-Example.html#GIMPLE-Example) [10.2.6 Rough GIMPLE Grammar](Rough-GIMPLE-Grammar.html#Rough-GIMPLE-Grammar) [10.3 Annotations](Annotations.html#Annotations) [10.4 Statement Operands](Statement-Operands.html#Statement-Operands) - [10.4.1 Operand Iterators And Access Routines](Statement-Operands.html#Statement-Operands) [10.4.2 Immediate Uses](Statement-Operands.html#Statement-Operands) [10.5 Static Single Assignment](SSA.html#SSA) - [10.5.1 Preserving the SSA form](SSA.html#SSA) [10.5.2 Preserving the virtual SSA form](SSA.html#SSA) [10.5.3 Examining `SSA_NAME` nodes](SSA.html#SSA) [10.5.4 Walking use-def chains](SSA.html#SSA) [10.5.5 Walking the dominator tree](SSA.html#SSA) [10.6 Alias analysis](Alias-analysis.html#Alias-analysis) 11 Analysis and Representation of Loops - [11.1 Loop representation](Loop-representation.html#Loop-representation) [11.2 Loop querying](Loop-querying.html#Loop-querying) [11.3 Loop manipulation](Loop-manipulation.html#Loop-manipulation) [11.4 Loop-closed SSA form](LCSSA.html#LCSSA) [11.5 Scalar evolutions](Scalar-evolutions.html#Scalar-evolutions) [11.6 IV analysis on RTL](loop_002div.html#loop_002div) [11.7 Number of iterations analysis](Number-of-iterations.html#Number-of-iterations) [11.8 Data Dependency Analysis](Dependency-analysis.html#Dependency-analysis) [11.9 Linear loop transformations framework](Lambda.html#Lambda) 12 RTL Representation - [12.1 RTL Object Types](RTL-Objects.html#RTL-Objects) [12.2 RTL Classes and Formats](RTL-Classes.html#RTL-Classes) [12.3 Access to Operands](Accessors.html#Accessors) [12.4 Access to Special Operands](Special-Accessors.html#Special-Accessors) [12.5 Flags in an RTL Expression](Flags.html#Flags) [12.6 Machine Modes](Machine-Modes.html#Machine-Modes) [12.7 Constant Expression Types](Constants.html#Constants) [12.8 Registers and Memory](Regs-and-Memory.html#Regs-and-Memory) [12.9 RTL Expressions for Arithmetic](Arithmetic.html#Arithmetic) [12.10 Comparison Operations](Comparisons.html#Comparisons) [12.11 Bit-Fields](Bit_002dFields.html#Bit_002dFields) [12.12 Vector Operations](Vector-Operations.html#Vector-Operations) [12.13 Conversions](Conversions.html#Conversions) [12.14 Declarations](RTL-Declarations.html#RTL-Declarations) [12.15 Side Effect Expressions](Side-Effects.html#Side-Effects) [12.16 Embedded Side-Effects on Addresses](Incdec.html#Incdec) [12.17 Assembler Instructions as Expressions](Assembler.html#Assembler) [12.18 Insns](Insns.html#Insns) [12.19 RTL Representation of Function-Call Insns](Calls.html#Calls) [12.20 Structure Sharing Assumptions](Sharing.html#Sharing) [12.21 Reading RTL](Reading-RTL.html#Reading-RTL) 13 Control Flow Graph - [13.1 Basic Blocks](Basic-Blocks.html#Basic-Blocks) [13.2 Edges](Edges.html#Edges) [13.3 Profile information](Profile-information.html#Profile-information) [13.4 Maintaining the CFG](Maintaining-the-CFG.html#Maintaining-the-CFG) [13.5 Liveness information](Liveness-information.html#Liveness-information) 14 Machine Descriptions - [14.1 Overview of How the Machine Description is Used](Overview.html#Overview) [14.2 Everything about Instruction Patterns](Patterns.html#Patterns) [14.3 Example of `define_insn`](Example.html#Example) [14.4 RTL Template](RTL-Template.html#RTL-Template) [14.5 Output Templates and Operand Substitution](Output-Template.html#Output-Template) [14.6 C Statements for Assembler Output](Output-Statement.html#Output-Statement) [14.7 Predicates](Predicates.html#Predicates) [14.7.1 Machine-Independent Predicates](Machine_002dIndependent-Predicates.html#Machine_002dIndependent-Predicates) [14.7.2 Defining Machine-Specific Predicates](Defining-Predicates.html#Defining-Predicates) [14.8 Operand Constraints](Constraints.html#Constraints) - [14.8.1 Simple Constraints](Simple-Constraints.html#Simple-Constraints) [14.8.2 Multiple Alternative Constraints](Multi_002dAlternative.html#Multi_002dAlternative) [14.8.3 Register Class Preferences](Class-Preferences.html#Class-Preferences) [14.8.4 Constraint Modifier Characters](Modifiers.html#Modifiers) [14.8.5 Constraints for Particular Machines](Machine-Constraints.html#Machine-Constraints) [14.8.6 Defining Machine-Specific Constraints](Define-Constraints.html#Define-Constraints) [14.8.7 Testing constraints from C](C-Constraint-Interface.html#C-Constraint-Interface) [14.9 Standard Pattern Names For Generation](Standard-Names.html#Standard-Names) [14.10 When the Order of Patterns Matters](Pattern-Ordering.html#Pattern-Ordering) [14.11 Interdependence of Patterns](Dependent-Patterns.html#Dependent-Patterns) [14.12 Defining Jump Instruction Patterns](Jump-Patterns.html#Jump-Patterns) [14.13 Defining Looping Instruction Patterns](Looping-Patterns.html#Looping-Patterns) [14.14 Canonicalization of Instructions](Insn-Canonicalizations.html#Insn-Canonicalizations) [14.15 Defining RTL Sequences for Code Generation](Expander-Definitions.html#Expander-Definitions) [14.16 Defining How to Split Instructions](Insn-Splitting.html#Insn-Splitting) [14.17 Including Patterns in Machine Descriptions.](Including-Patterns.html#Including-Patterns) - [14.17.1 RTL Generation Tool Options for Directory Search](Including-Patterns.html#Including-Patterns) [14.18 Machine-Specific Peephole Optimizers](Peephole-Definitions.html#Peephole-Definitions) - [14.18.1 RTL to Text Peephole Optimizers](define_005fpeephole.html#define_005fpeephole) [14.18.2 RTL to RTL Peephole Optimizers](define_005fpeephole2.html#define_005fpeephole2) [14.19 Instruction Attributes](Insn-Attributes.html#Insn-Attributes) - [14.19.1 Defining Attributes and their Values](Defining-Attributes.html#Defining-Attributes) [14.19.2 Attribute Expressions](Expressions.html#Expressions) [14.19.3 Assigning Attribute Values to Insns](Tagging-Insns.html#Tagging-Insns) [14.19.4 Example of Attribute Specifications](Attr-Example.html#Attr-Example) [14.19.5 Computing the Length of an Insn](Insn-Lengths.html#Insn-Lengths) [14.19.6 Constant Attributes](Constant-Attributes.html#Constant-Attributes) [14.19.7 Delay Slot Scheduling](Delay-Slots.html#Delay-Slots) [14.19.8 Specifying processor pipeline description](Processor-pipeline-description.html#Processor-pipeline-description) [14.20 Conditional Execution](Conditional-Execution.html#Conditional-Execution) [14.21 Constant Definitions](Constant-Definitions.html#Constant-Definitions) [14.22 Macros](Macros.html#Macros) - [14.22.1 Mode Macros](Mode-Macros.html#Mode-Macros) [14.22.1.1 Defining Mode Macros](Defining-Mode-Macros.html#Defining-Mode-Macros) [14.22.1.2 Substitution in Mode Macros](Substitutions.html#Substitutions) [14.22.1.3 Mode Macro Examples](Examples.html#Examples) [14.22.2 Code Macros](Code-Macros.html#Code-Macros) 15 Target Description Macros and Functions - [15.1 The Global `targetm` Variable](Target-Structure.html#Target-Structure) [15.2 Controlling the Compilation Driver, gcc](Driver.html#Driver) [15.3 Run-time Target Specification](Run_002dtime-Target.html#Run_002dtime-Target) [15.4 Defining data structures for per-function information.](Per_002dFunction-Data.html#Per_002dFunction-Data) [15.5 Storage Layout](Storage-Layout.html#Storage-Layout) [15.6 Layout of Source Language Data Types](Type-Layout.html#Type-Layout) [15.7 Register Usage](Registers.html#Registers) [15.7.1 Basic Characteristics of Registers](Register-Basics.html#Register-Basics) [15.7.2 Order of Allocation of Registers](Allocation-Order.html#Allocation-Order) [15.7.3 How Values Fit in Registers](Values-in-Registers.html#Values-in-Registers) [15.7.4 Handling Leaf Functions](Leaf-Functions.html#Leaf-Functions) [15.7.5 Registers That Form a Stack](Stack-Registers.html#Stack-Registers) [15.8 Register Classes](Register-Classes.html#Register-Classes) [15.9 Obsolete Macros for Defining Constraints](Old-Constraints.html#Old-Constraints) [15.10 Stack Layout and Calling Conventions](Stack-and-Calling.html#Stack-and-Calling) - [15.10.1 Basic Stack Layout](Frame-Layout.html#Frame-Layout) [15.10.2 Exception Handling Support](Exception-Handling.html#Exception-Handling) [15.10.3 Specifying How Stack Checking is Done](Stack-Checking.html#Stack-Checking) [15.10.4 Registers That Address the Stack Frame](Frame-Registers.html#Frame-Registers) [15.10.5 Eliminating Frame Pointer and Arg Pointer](Elimination.html#Elimination) [15.10.6 Passing Function Arguments on the Stack](Stack-Arguments.html#Stack-Arguments) [15.10.7 Passing Arguments in Registers](Register-Arguments.html#Register-Arguments) [15.10.8 How Scalar Function Values Are Returned](Scalar-Return.html#Scalar-Return) [15.10.9 How Large Values Are Returned](Aggregate-Return.html#Aggregate-Return) [15.10.10 Caller-Saves Register Allocation](Caller-Saves.html#Caller-Saves) [15.10.11 Function Entry and Exit](Function-Entry.html#Function-Entry) [15.10.12 Generating Code for Profiling](Profiling.html#Profiling) [15.10.13 Permitting tail calls](Tail-Calls.html#Tail-Calls) [15.10.14 Stack smashing protection](Stack-Smashing-Protection.html#Stack-Smashing-Protection) [15.11 Implementing the Varargs Macros](Varargs.html#Varargs) [15.12 Trampolines for Nested Functions](Trampolines.html#Trampolines) [15.13 Implicit Calls to Library Routines](Library-Calls.html#Library-Calls) [15.14 Addressing Modes](Addressing-Modes.html#Addressing-Modes) [15.15 Anchored Addresses](Anchored-Addresses.html#Anchored-Addresses) [15.16 Condition Code Status](Condition-Code.html#Condition-Code) [15.17 Describing Relative Costs of Operations](Costs.html#Costs) [15.18 Adjusting the Instruction Scheduler](Scheduling.html#Scheduling) [15.19 Dividing the Output into Sections (Texts, Data, ...)](Sections.html#Sections) [15.20 Position Independent Code](PIC.html#PIC) [15.21 Defining the Output Assembler Language](Assembler-Format.html#Assembler-Format) - [15.21.1 The Overall Framework of an Assembler File](File-Framework.html#File-Framework) [15.21.2 Output of Data](Data-Output.html#Data-Output) [15.21.3 Output of Uninitialized Variables](Uninitialized-Data.html#Uninitialized-Data) [15.21.4 Output and Generation of Labels](Label-Output.html#Label-Output) [15.21.5 How Initialization Functions Are Handled](Initialization.html#Initialization) [15.21.6 Macros Controlling Initialization Routines](Macros-for-Initialization.html#Macros-for-Initialization) [15.21.7 Output of Assembler Instructions](Instruction-Output.html#Instruction-Output) [15.21.8 Output of Dispatch Tables](Dispatch-Tables.html#Dispatch-Tables) [15.21.9 Assembler Commands for Exception Regions](Exception-Region-Output.html#Exception-Region-Output) [15.21.10 Assembler Commands for Alignment](Alignment-Output.html#Alignment-Output) [15.22 Controlling Debugging Information Format](Debugging-Info.html#Debugging-Info) - [15.22.1 Macros Affecting All Debugging Formats](All-Debuggers.html#All-Debuggers) [15.22.2 Specific Options for DBX Output](DBX-Options.html#DBX-Options) [15.22.3 Open-Ended Hooks for DBX Format](DBX-Hooks.html#DBX-Hooks) [15.22.4 File Names in DBX Format](File-Names-and-DBX.html#File-Names-and-DBX) [15.22.5 Macros for SDB and DWARF Output](SDB-and-DWARF.html#SDB-and-DWARF) [15.22.6 Macros for VMS Debug Format](VMS-Debug.html#VMS-Debug) [15.23 Cross Compilation and Floating Point](Floating-Point.html#Floating-Point) [15.24 Mode Switching Instructions](Mode-Switching.html#Mode-Switching) [15.25 Defining target-specific uses of `__attribute__`](Target-Attributes.html#Target-Attributes) [15.26 Defining coprocessor specifics for MIPS targets.](MIPS-Coprocessors.html#MIPS-Coprocessors) [15.27 Parameters for Precompiled Header Validity Checking](PCH-Target.html#PCH-Target) [15.28 C++ ABI parameters](C_002b_002b-ABI.html#C_002b_002b-ABI) [15.29 Miscellaneous Parameters](Misc.html#Misc) 16 Host Configuration - [16.1 Host Common](Host-Common.html#Host-Common) [16.2 Host Filesystem](Filesystem.html#Filesystem) [16.3 Host Misc](Host-Misc.html#Host-Misc) 17 Makefile Fragments - [17.1 Target Makefile Fragments](Target-Fragment.html#Target-Fragment) [17.2 Host Makefile Fragments](Host-Fragment.html#Host-Fragment) 18 `collect2` 19 Standard Header File Directories 20 Memory Management and Type Information - [20.1 The Inside of a `GTY(())`](GTY-Options.html#GTY-Options) [20.2 Marking Roots for the Garbage Collector](GGC-Roots.html#GGC-Roots) [20.3 Source Files Containing Type Information](Files.html#Files) Funding Free Software The GNU Project and GNU/Linux GNU GENERAL PUBLIC LICENSE - [Preamble](Copying.html#Copying) [Appendix: How to Apply These Terms to Your New Programs](Copying.html#Copying) GNU Free Documentation License - [ADDENDUM: How to use this License for your documents](GNU-Free-Documentation-License.html#GNU-Free-Documentation-License) Contributors to GCC Option Index Concept Index Next: [Contributing](Contributing.html#Contributing), Up: [(DIR)](../index.html#DIR) ## Introduction This manual documents the internals of the GNU compilers, including how to port them to new targets and some information about how to write front ends for new languages. It corresponds to GCC version 4.2.1. The use of the GNU compilers is documented in a separate manual. See [Introduction](../gcc/index.html#Top). This manual is mainly a reference manual rather than a tutorial. It discusses how to contribute to GCC (see [Contributing](Contributing.html#Contributing)), the characteristics of the machines supported by GCC as hosts and targets (see [Portability](Portability.html#Portability)), how GCC relates to the ABIs on such systems (see [Interface](Interface.html#Interface)), and the characteristics of the languages for which GCC front ends are written (see [Languages](Languages.html#Languages)). It then describes the GCC source tree structure and build system, some of the interfaces to GCC front ends, and how support for a target system is implemented in GCC. Additional tutorial information is linked to from [http://gcc.gnu.org/readings.html](http://gcc.gnu.org/readings.html).