visus
/
toolchain-gcc-arm-embedded
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2 Commits
1 Branch
Branch: main
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'main'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/gccint/PCH-Target.html

130 lines
6.3KB
Raw Permalink Blame History 

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

  2. <html>

  3. <!-- Copyright (C) 1988-2020 Free Software Foundation, Inc.

  4. 

  5. Permission is granted to copy, distribute and/or modify this document

  6. under the terms of the GNU Free Documentation License, Version 1.3 or

  7. any later version published by the Free Software Foundation; with the

  8. Invariant Sections being "Funding Free Software", the Front-Cover

  9. Texts being (a) (see below), and with the Back-Cover Texts being (b)

  10. (see below).  A copy of the license is included in the section entitled

  11. "GNU Free Documentation License".

  12. 

  13. (a) The FSF's Front-Cover Text is:

  14. 

  15. A GNU Manual

  16. 

  17. (b) The FSF's Back-Cover Text is:

  18. 

  19. You have freedom to copy and modify this GNU Manual, like GNU

  20.      software.  Copies published by the Free Software Foundation raise

  21.      funds for GNU development. -->

  22. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->

  23. <head>

  24. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  25. <title>PCH Target (GNU Compiler Collection (GCC) Internals)</title>

  26. 

  27. <meta name="description" content="PCH Target (GNU Compiler Collection (GCC) Internals)">

  28. <meta name="keywords" content="PCH Target (GNU Compiler Collection (GCC) Internals)">

  29. <meta name="resource-type" content="document">

  30. <meta name="distribution" content="global">

  31. <meta name="Generator" content="makeinfo">

  32. <link href="index.html#Top" rel="start" title="Top">

  33. <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">

  34. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">

  35. <link href="Target-Macros.html#Target-Macros" rel="up" title="Target Macros">

  36. <link href="C_002b_002b-ABI.html#C_002b_002b-ABI" rel="next" title="C++ ABI">

  37. <link href="MIPS-Coprocessors.html#MIPS-Coprocessors" rel="prev" title="MIPS Coprocessors">

  38. <style type="text/css">

  39. <!--

  40. a.summary-letter {text-decoration: none}

  41. blockquote.indentedblock {margin-right: 0em}

  42. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}

  43. blockquote.smallquotation {font-size: smaller}

  44. div.display {margin-left: 3.2em}

  45. div.example {margin-left: 3.2em}

  46. div.lisp {margin-left: 3.2em}

  47. div.smalldisplay {margin-left: 3.2em}

  48. div.smallexample {margin-left: 3.2em}

  49. div.smalllisp {margin-left: 3.2em}

  50. kbd {font-style: oblique}

  51. pre.display {font-family: inherit}

  52. pre.format {font-family: inherit}

  53. pre.menu-comment {font-family: serif}

  54. pre.menu-preformatted {font-family: serif}

  55. pre.smalldisplay {font-family: inherit; font-size: smaller}

  56. pre.smallexample {font-size: smaller}

  57. pre.smallformat {font-family: inherit; font-size: smaller}

  58. pre.smalllisp {font-size: smaller}

  59. span.nolinebreak {white-space: nowrap}

  60. span.roman {font-family: initial; font-weight: normal}

  61. span.sansserif {font-family: sans-serif; font-weight: normal}

  62. ul.no-bullet {list-style: none}

  63. -->

  64. </style>

  65. 

  66. 

  67. </head>

  68. 

  69. <body lang="en">

  70. <a name="PCH-Target"></a>

  71. <div class="header">

  72. <p>

  73. Next: <a href="C_002b_002b-ABI.html#C_002b_002b-ABI" accesskey="n" rel="next">C++ ABI</a>, Previous: <a href="MIPS-Coprocessors.html#MIPS-Coprocessors" accesskey="p" rel="prev">MIPS Coprocessors</a>, Up: <a href="Target-Macros.html#Target-Macros" accesskey="u" rel="up">Target Macros</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>

  74. </div>

  75. <hr>

  76. <a name="Parameters-for-Precompiled-Header-Validity-Checking"></a>

  77. <h3 class="section">18.27 Parameters for Precompiled Header Validity Checking</h3>

  78. <a name="index-parameters_002c-precompiled-headers"></a>

  79. 

  80. <dl>

  81. <dt><a name="index-TARGET_005fGET_005fPCH_005fVALIDITY"></a>Target Hook: <em>void *</em> <strong>TARGET_GET_PCH_VALIDITY</strong> <em>(size_t *<var>sz</var>)</em></dt>

  82. <dd><p>This hook returns a pointer to the data needed by

  83. <code>TARGET_PCH_VALID_P</code> and sets

  84. &lsquo;<samp>*<var>sz</var></samp>&rsquo; to the size of the data in bytes.

  85. </p></dd></dl>

  86. 

  87. <dl>

  88. <dt><a name="index-TARGET_005fPCH_005fVALID_005fP"></a>Target Hook: <em>const char *</em> <strong>TARGET_PCH_VALID_P</strong> <em>(const void *<var>data</var>, size_t <var>sz</var>)</em></dt>

  89. <dd><p>This hook checks whether the options used to create a PCH file are

  90. compatible with the current settings.  It returns <code>NULL</code>

  91. if so and a suitable error message if not.  Error messages will

  92. be presented to the user and must be localized using &lsquo;<samp>_(<var>msg</var>)</samp>&rsquo;.

  93. </p>

  94. <p><var>data</var> is the data that was returned by <code>TARGET_GET_PCH_VALIDITY</code>

  95. when the PCH file was created and <var>sz</var> is the size of that data in bytes.

  96. It&rsquo;s safe to assume that the data was created by the same version of the

  97. compiler, so no format checking is needed.

  98. </p>

  99. <p>The default definition of <code>default_pch_valid_p</code> should be

  100. suitable for most targets.

  101. </p></dd></dl>

  102. 

  103. <dl>

  104. <dt><a name="index-TARGET_005fCHECK_005fPCH_005fTARGET_005fFLAGS"></a>Target Hook: <em>const char *</em> <strong>TARGET_CHECK_PCH_TARGET_FLAGS</strong> <em>(int <var>pch_flags</var>)</em></dt>

  105. <dd><p>If this hook is nonnull, the default implementation of

  106. <code>TARGET_PCH_VALID_P</code> will use it to check for compatible values

  107. of <code>target_flags</code>.  <var>pch_flags</var> specifies the value that

  108. <code>target_flags</code> had when the PCH file was created.  The return

  109. value is the same as for <code>TARGET_PCH_VALID_P</code>.

  110. </p></dd></dl>

  111. 

  112. <dl>

  113. <dt><a name="index-TARGET_005fPREPARE_005fPCH_005fSAVE"></a>Target Hook: <em>void</em> <strong>TARGET_PREPARE_PCH_SAVE</strong> <em>(void)</em></dt>

  114. <dd><p>Called before writing out a PCH file.  If the target has some

  115. garbage-collected data that needs to be in a particular state on PCH loads,

  116. it can use this hook to enforce that state.  Very few targets need

  117. to do anything here.

  118. </p></dd></dl>

  119. 

  120. <hr>

  121. <div class="header">

  122. <p>

  123. Next: <a href="C_002b_002b-ABI.html#C_002b_002b-ABI" accesskey="n" rel="next">C++ ABI</a>, Previous: <a href="MIPS-Coprocessors.html#MIPS-Coprocessors" accesskey="p" rel="prev">MIPS Coprocessors</a>, Up: <a href="Target-Macros.html#Target-Macros" accesskey="u" rel="up">Target Macros</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>

  124. </div>

  125. 

  126. 

  127. 

  128. </body>

  129. </html>