visus
/
toolchain-gcc-arm-embedded
關註 1
收藏 0
複製 0
程式碼 問題管理 0 合併請求 0 版本發佈 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 Commit
1 分支
分支: main
分支列表 標籤列表
${ item.name }
Create branch ${ searchTerm }
from 'main'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/gccint/Profiling.html

136 line
6.5KB
原始文件 永久連結 Blame 文件歷史 

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

  26. 

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

  28. <meta name="keywords" content="Profiling (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="Stack-and-Calling.html#Stack-and-Calling" rel="up" title="Stack and Calling">

  36. <link href="Tail-Calls.html#Tail-Calls" rel="next" title="Tail Calls">

  37. <link href="Function-Entry.html#Function-Entry" rel="prev" title="Function Entry">

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

  71. <div class="header">

  72. <p>

  73. Next: <a href="Tail-Calls.html#Tail-Calls" accesskey="n" rel="next">Tail Calls</a>, Previous: <a href="Function-Entry.html#Function-Entry" accesskey="p" rel="prev">Function Entry</a>, Up: <a href="Stack-and-Calling.html#Stack-and-Calling" accesskey="u" rel="up">Stack and Calling</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="Generating-Code-for-Profiling"></a>

  77. <h4 class="subsection">18.9.12 Generating Code for Profiling</h4>

  78. <a name="index-profiling_002c-code-generation"></a>

  79. 

  80. <p>These macros will help you generate code for profiling.

  81. </p>

  82. <dl>

  83. <dt><a name="index-FUNCTION_005fPROFILER"></a>Macro: <strong>FUNCTION_PROFILER</strong> <em>(<var>file</var>, <var>labelno</var>)</em></dt>

  84. <dd><p>A C statement or compound statement to output to <var>file</var> some

  85. assembler code to call the profiling subroutine <code>mcount</code>.

  86. </p>

  87. <a name="index-mcount"></a>

  88. <p>The details of how <code>mcount</code> expects to be called are determined by

  89. your operating system environment, not by GCC.  To figure them out,

  90. compile a small program for profiling using the system&rsquo;s installed C

  91. compiler and look at the assembler code that results.

  92. </p>

  93. <p>Older implementations of <code>mcount</code> expect the address of a counter

  94. variable to be loaded into some register.  The name of this variable is

  95. &lsquo;<samp>LP</samp>&rsquo; followed by the number <var>labelno</var>, so you would generate

  96. the name using &lsquo;<samp>LP%d</samp>&rsquo; in a <code>fprintf</code>.

  97. </p></dd></dl>

  98. 

  99. <dl>

  100. <dt><a name="index-PROFILE_005fHOOK"></a>Macro: <strong>PROFILE_HOOK</strong></dt>

  101. <dd><p>A C statement or compound statement to output to <var>file</var> some assembly

  102. code to call the profiling subroutine <code>mcount</code> even the target does

  103. not support profiling.

  104. </p></dd></dl>

  105. 

  106. <dl>

  107. <dt><a name="index-NO_005fPROFILE_005fCOUNTERS"></a>Macro: <strong>NO_PROFILE_COUNTERS</strong></dt>

  108. <dd><p>Define this macro to be an expression with a nonzero value if the

  109. <code>mcount</code> subroutine on your system does not need a counter variable

  110. allocated for each function.  This is true for almost all modern

  111. implementations.  If you define this macro, you must not use the

  112. <var>labelno</var> argument to <code>FUNCTION_PROFILER</code>.

  113. </p></dd></dl>

  114. 

  115. <dl>

  116. <dt><a name="index-PROFILE_005fBEFORE_005fPROLOGUE"></a>Macro: <strong>PROFILE_BEFORE_PROLOGUE</strong></dt>

  117. <dd><p>Define this macro if the code for function profiling should come before

  118. the function prologue.  Normally, the profiling code comes after.

  119. </p></dd></dl>

  120. 

  121. <dl>

  122. <dt><a name="index-TARGET_005fKEEP_005fLEAF_005fWHEN_005fPROFILED"></a>Target Hook: <em>bool</em> <strong>TARGET_KEEP_LEAF_WHEN_PROFILED</strong> <em>(void)</em></dt>

  123. <dd><p>This target hook returns true if the target wants the leaf flag for the current function to stay true even if it calls mcount.  This might make sense for targets using the leaf flag only to determine whether a stack frame needs to be generated or not and for which the call to mcount is generated before the function prologue.

  124. </p></dd></dl>

  125. 

  126. <hr>

  127. <div class="header">

  128. <p>

  129. Next: <a href="Tail-Calls.html#Tail-Calls" accesskey="n" rel="next">Tail Calls</a>, Previous: <a href="Function-Entry.html#Function-Entry" accesskey="p" rel="prev">Function Entry</a>, Up: <a href="Stack-and-Calling.html#Stack-and-Calling" accesskey="u" rel="up">Stack and Calling</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>

  130. </div>

  131. 

  132. 

  133. 

  134. </body>

  135. </html>