visus
/
toolchain-gcc-arm-embedded
Volgen 1
Ster 0
Vork 0
Code Kwesties 0 Pull-aanvragen 0 Publicaties 0 Wiki Activiteit
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 Labels
${ item.name }
Maak branch ${ searchTerm }
van 'main'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/gccint/Host-Common.html

141 lines
6.6KB
Ruw Permalink Blame Geschiedenis 

  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>Host Common (GNU Compiler Collection (GCC) Internals)</title>

  26. 

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

  28. <meta name="keywords" content="Host Common (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="Host-Config.html#Host-Config" rel="up" title="Host Config">

  36. <link href="Filesystem.html#Filesystem" rel="next" title="Filesystem">

  37. <link href="Host-Config.html#Host-Config" rel="prev" title="Host Config">

  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="Host-Common"></a>

  71. <div class="header">

  72. <p>

  73. Next: <a href="Filesystem.html#Filesystem" accesskey="n" rel="next">Filesystem</a>, Up: <a href="Host-Config.html#Host-Config" accesskey="u" rel="up">Host Config</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="Host-Common-1"></a>

  77. <h3 class="section">19.1 Host Common</h3>

  78. <a name="index-host-hooks"></a>

  79. <a name="index-host-functions"></a>

  80. 

  81. <p>Some things are just not portable, even between similar operating systems,

  82. and are too difficult for autoconf to detect.  They get implemented using

  83. hook functions in the file specified by the <var>host_hook_obj</var>

  84. variable in <samp>config.gcc</samp>.

  85. </p>

  86. <dl>

  87. <dt><a name="index-HOST_005fHOOKS_005fEXTRA_005fSIGNALS"></a>Host Hook: <em>void</em> <strong>HOST_HOOKS_EXTRA_SIGNALS</strong> <em>(void)</em></dt>

  88. <dd><p>This host hook is used to set up handling for extra signals.  The most

  89. common thing to do in this hook is to detect stack overflow.

  90. </p></dd></dl>

  91. 

  92. <dl>

  93. <dt><a name="index-HOST_005fHOOKS_005fGT_005fPCH_005fGET_005fADDRESS"></a>Host Hook: <em>void *</em> <strong>HOST_HOOKS_GT_PCH_GET_ADDRESS</strong> <em>(size_t   <var>size</var>, int <var>fd</var>)</em></dt>

  94. <dd><p>This host hook returns the address of some space that is likely to be

  95. free in some subsequent invocation of the compiler.  We intend to load

  96. the PCH data at this address such that the data need not be relocated.

  97. The area should be able to hold <var>size</var> bytes.  If the host uses

  98. <code>mmap</code>, <var>fd</var> is an open file descriptor that can be used for

  99. probing.

  100. </p></dd></dl>

  101. 

  102. <dl>

  103. <dt><a name="index-HOST_005fHOOKS_005fGT_005fPCH_005fUSE_005fADDRESS"></a>Host Hook: <em>int</em> <strong>HOST_HOOKS_GT_PCH_USE_ADDRESS</strong> <em>(void * <var>address</var>,   size_t <var>size</var>, int <var>fd</var>, size_t <var>offset</var>)</em></dt>

  104. <dd><p>This host hook is called when a PCH file is about to be loaded.

  105. We want to load <var>size</var> bytes from <var>fd</var> at <var>offset</var>

  106. into memory at <var>address</var>.  The given address will be the result of

  107. a previous invocation of <code>HOST_HOOKS_GT_PCH_GET_ADDRESS</code>.

  108. Return -1 if we couldn&rsquo;t allocate <var>size</var> bytes at <var>address</var>.

  109. Return 0 if the memory is allocated but the data is not loaded.  Return 1

  110. if the hook has performed everything.

  111. </p>

  112. <p>If the implementation uses reserved address space, free any reserved

  113. space beyond <var>size</var>, regardless of the return value.  If no PCH will

  114. be loaded, this hook may be called with <var>size</var> zero, in which case

  115. all reserved address space should be freed.

  116. </p>

  117. <p>Do not try to handle values of <var>address</var> that could not have been

  118. returned by this executable; just return -1.  Such values usually

  119. indicate an out-of-date PCH file (built by some other GCC executable),

  120. and such a PCH file won&rsquo;t work.

  121. </p></dd></dl>

  122. 

  123. <dl>

  124. <dt><a name="index-HOST_005fHOOKS_005fGT_005fPCH_005fALLOC_005fGRANULARITY"></a>Host Hook: <em>size_t</em> <strong>HOST_HOOKS_GT_PCH_ALLOC_GRANULARITY</strong> <em>(void);</em></dt>

  125. <dd><p>This host hook returns the alignment required for allocating virtual

  126. memory.  Usually this is the same as getpagesize, but on some hosts the

  127. alignment for reserving memory differs from the pagesize for committing

  128. memory.

  129. </p></dd></dl>

  130. 

  131. <hr>

  132. <div class="header">

  133. <p>

  134. Next: <a href="Filesystem.html#Filesystem" accesskey="n" rel="next">Filesystem</a>, Up: <a href="Host-Config.html#Host-Config" accesskey="u" rel="up">Host Config</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>

  135. </div>

  136. 

  137. 

  138. 

  139. </body>

  140. </html>