1\input texinfo @c -*-texinfo-*- 2@c %**start of header 3@setfilename gccint.info 4@c INTERNALS is used by md.texi to determine whether to include the 5@c whole of that file, in the internals manual, or only the part 6@c dealing with constraints, in the user manual. 7@set INTERNALS 8 9@c See miscellaneous notes in gcc.texi on checks/things to do. 10 11@include gcc-common.texi 12 13@settitle GNU Compiler Collection (GCC) Internals 14 15@c Create a separate index for command line options. 16@defcodeindex op 17@c Merge the standard indexes into a single one. 18@syncodeindex fn cp 19@syncodeindex vr cp 20@syncodeindex ky cp 21@syncodeindex pg cp 22@syncodeindex tp cp 23 24@paragraphindent 1 25 26@c %**end of header 27 28@copying 29Copyright @copyright{} 1988-2020 Free Software Foundation, Inc. 30 31Permission is granted to copy, distribute and/or modify this document 32under the terms of the GNU Free Documentation License, Version 1.3 or 33any later version published by the Free Software Foundation; with the 34Invariant Sections being ``Funding Free Software'', the Front-Cover 35Texts being (a) (see below), and with the Back-Cover Texts being (b) 36(see below). A copy of the license is included in the section entitled 37``GNU Free Documentation License''. 38 39(a) The FSF's Front-Cover Text is: 40 41 A GNU Manual 42 43(b) The FSF's Back-Cover Text is: 44 45 You have freedom to copy and modify this GNU Manual, like GNU 46 software. Copies published by the Free Software Foundation raise 47 funds for GNU development. 48@end copying 49@ifnottex 50@dircategory Software development 51@direntry 52* gccint: (gccint). Internals of the GNU Compiler Collection. 53@end direntry 54This file documents the internals of the GNU compilers. 55@sp 1 56@insertcopying 57@sp 1 58@end ifnottex 59 60@setchapternewpage odd 61@titlepage 62@title GNU Compiler Collection Internals 63@versionsubtitle 64@author Richard M. Stallman and the @sc{GCC} Developer Community 65@page 66@vskip 0pt plus 1filll 67@insertcopying 68@end titlepage 69@summarycontents 70@contents 71@page 72 73@node Top, Contributing 74@top Introduction 75@cindex introduction 76 77This manual documents the internals of the GNU compilers, including 78how to port them to new targets and some information about how to 79write front ends for new languages. It corresponds to the compilers 80@ifset VERSION_PACKAGE 81@value{VERSION_PACKAGE} 82@end ifset 83version @value{version-GCC}. The use of the GNU compilers is documented in a 84separate manual. @xref{Top,, Introduction, gcc, Using the GNU 85Compiler Collection (GCC)}. 86 87This manual is mainly a reference manual rather than a tutorial. It 88discusses how to contribute to GCC (@pxref{Contributing}), the 89characteristics of the machines supported by GCC as hosts and targets 90(@pxref{Portability}), how GCC relates to the ABIs on such systems 91(@pxref{Interface}), and the characteristics of the languages for 92which GCC front ends are written (@pxref{Languages}). It then 93describes the GCC source tree structure and build system, some of the 94interfaces to GCC front ends, and how support for a target system is 95implemented in GCC@. 96 97Additional tutorial information is linked to from 98@uref{http://gcc.gnu.org/readings.html}. 99 100@menu 101* Contributing:: How to contribute to testing and developing GCC. 102* Portability:: Goals of GCC's portability features. 103* Interface:: Function-call interface of GCC output. 104* Libgcc:: Low-level runtime library used by GCC. 105* Languages:: Languages for which GCC front ends are written. 106* Source Tree:: GCC source tree structure and build system. 107* Testsuites:: GCC testsuites. 108* Options:: Option specification files. 109* Passes:: Order of passes, what they do, and what each file is for. 110* poly_int:: Representation of runtime sizes and offsets. 111* GENERIC:: Language-independent representation generated by Front Ends 112* GIMPLE:: Tuple representation used by Tree SSA optimizers 113* Tree SSA:: Analysis and optimization of GIMPLE 114* RTL:: Machine-dependent low-level intermediate representation. 115* Control Flow:: Maintaining and manipulating the control flow graph. 116* Loop Analysis and Representation:: Analysis and representation of loops 117* Machine Desc:: How to write machine description instruction patterns. 118* Target Macros:: How to write the machine description C macros and functions. 119* Host Config:: Writing the @file{xm-@var{machine}.h} file. 120* Fragments:: Writing the @file{t-@var{target}} and @file{x-@var{host}} files. 121* Collect2:: How @code{collect2} works; how it finds @code{ld}. 122* Header Dirs:: Understanding the standard header file directories. 123* Type Information:: GCC's memory management; generating type information. 124* Plugins:: Extending the compiler with plugins. 125* LTO:: Using Link-Time Optimization. 126 127* Match and Simplify:: How to write expression simplification patterns for GIMPLE and GENERIC 128* Static Analyzer:: Working with the static analyzer. 129* User Experience Guidelines:: Guidelines for implementing diagnostics and options. 130* Funding:: How to help assure funding for free software. 131* GNU Project:: The GNU Project and GNU/Linux. 132 133* Copying:: GNU General Public License says 134 how you can copy and share GCC. 135* GNU Free Documentation License:: How you can copy and share this manual. 136* Contributors:: People who have contributed to GCC. 137 138* Option Index:: Index to command line options. 139* Concept Index:: Index of concepts and symbol names. 140@end menu 141 142@include contribute.texi 143@include portability.texi 144@include interface.texi 145@include libgcc.texi 146@include languages.texi 147@include sourcebuild.texi 148@include options.texi 149@include passes.texi 150@include poly-int.texi 151@include generic.texi 152@include gimple.texi 153@include tree-ssa.texi 154@include rtl.texi 155@include cfg.texi 156@include loop.texi 157@include md.texi 158@include tm.texi 159@include hostconfig.texi 160@include fragments.texi 161@include collect2.texi 162@include headerdirs.texi 163@include gty.texi 164@include plugins.texi 165@include lto.texi 166@include match-and-simplify.texi 167@include analyzer.texi 168@include ux.texi 169 170@include funding.texi 171@include gnu.texi 172@include gpl_v3.texi 173 174@c --------------------------------------------------------------------- 175@c GFDL 176@c --------------------------------------------------------------------- 177 178@include fdl.texi 179 180@include contrib.texi 181 182@c --------------------------------------------------------------------- 183@c Indexes 184@c --------------------------------------------------------------------- 185 186@node Option Index 187@unnumbered Option Index 188 189GCC's command line options are indexed here without any initial @samp{-} 190or @samp{--}. Where an option has both positive and negative forms 191(such as @option{-f@var{option}} and @option{-fno-@var{option}}), 192relevant entries in the manual are indexed under the most appropriate 193form; it may sometimes be useful to look up both forms. 194 195@printindex op 196 197@node Concept Index 198@unnumbered Concept Index 199 200@printindex cp 201 202@c --------------------------------------------------------------------- 203@c Epilogue 204@c --------------------------------------------------------------------- 205 206@bye 207