ARC-Function-Attributes.html 5.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130
  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-2017 Free Software Foundation, Inc.
  4. Permission is granted to copy, distribute and/or modify this document
  5. under the terms of the GNU Free Documentation License, Version 1.3 or
  6. any later version published by the Free Software Foundation; with the
  7. Invariant Sections being "Funding Free Software", the Front-Cover
  8. Texts being (a) (see below), and with the Back-Cover Texts being (b)
  9. (see below). A copy of the license is included in the section entitled
  10. "GNU Free Documentation License".
  11. (a) The FSF's Front-Cover Text is:
  12. A GNU Manual
  13. (b) The FSF's Back-Cover Text is:
  14. You have freedom to copy and modify this GNU Manual, like GNU
  15. software. Copies published by the Free Software Foundation raise
  16. funds for GNU development. -->
  17. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  18. <head>
  19. <title>Using the GNU Compiler Collection (GCC): ARC Function Attributes</title>
  20. <meta name="description" content="Using the GNU Compiler Collection (GCC): ARC Function Attributes">
  21. <meta name="keywords" content="Using the GNU Compiler Collection (GCC): ARC Function Attributes">
  22. <meta name="resource-type" content="document">
  23. <meta name="distribution" content="global">
  24. <meta name="Generator" content="makeinfo">
  25. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  26. <link href="index.html#Top" rel="start" title="Top">
  27. <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
  28. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  29. <link href="Function-Attributes.html#Function-Attributes" rel="up" title="Function Attributes">
  30. <link href="ARM-Function-Attributes.html#ARM-Function-Attributes" rel="next" title="ARM Function Attributes">
  31. <link href="AArch64-Function-Attributes.html#AArch64-Function-Attributes" rel="prev" title="AArch64 Function Attributes">
  32. <style type="text/css">
  33. <!--
  34. a.summary-letter {text-decoration: none}
  35. blockquote.smallquotation {font-size: smaller}
  36. div.display {margin-left: 3.2em}
  37. div.example {margin-left: 3.2em}
  38. div.indentedblock {margin-left: 3.2em}
  39. div.lisp {margin-left: 3.2em}
  40. div.smalldisplay {margin-left: 3.2em}
  41. div.smallexample {margin-left: 3.2em}
  42. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  43. div.smalllisp {margin-left: 3.2em}
  44. kbd {font-style:oblique}
  45. pre.display {font-family: inherit}
  46. pre.format {font-family: inherit}
  47. pre.menu-comment {font-family: serif}
  48. pre.menu-preformatted {font-family: serif}
  49. pre.smalldisplay {font-family: inherit; font-size: smaller}
  50. pre.smallexample {font-size: smaller}
  51. pre.smallformat {font-family: inherit; font-size: smaller}
  52. pre.smalllisp {font-size: smaller}
  53. span.nocodebreak {white-space:nowrap}
  54. span.nolinebreak {white-space:nowrap}
  55. span.roman {font-family:serif; font-weight:normal}
  56. span.sansserif {font-family:sans-serif; font-weight:normal}
  57. ul.no-bullet {list-style: none}
  58. -->
  59. </style>
  60. </head>
  61. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  62. <a name="ARC-Function-Attributes"></a>
  63. <div class="header">
  64. <p>
  65. Next: <a href="ARM-Function-Attributes.html#ARM-Function-Attributes" accesskey="n" rel="next">ARM Function Attributes</a>, Previous: <a href="AArch64-Function-Attributes.html#AArch64-Function-Attributes" accesskey="p" rel="prev">AArch64 Function Attributes</a>, Up: <a href="Function-Attributes.html#Function-Attributes" accesskey="u" rel="up">Function Attributes</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>
  66. </div>
  67. <hr>
  68. <a name="ARC-Function-Attributes-1"></a>
  69. <h4 class="subsection">6.31.3 ARC Function Attributes</h4>
  70. <p>These function attributes are supported by the ARC back end:
  71. </p>
  72. <dl compact="compact">
  73. <dt><code>interrupt</code></dt>
  74. <dd><a name="index-interrupt-function-attribute_002c-ARC"></a>
  75. <p>Use this attribute to indicate
  76. that the specified function is an interrupt handler. The compiler generates
  77. function entry and exit sequences suitable for use in an interrupt handler
  78. when this attribute is present.
  79. </p>
  80. <p>On the ARC, you must specify the kind of interrupt to be handled
  81. in a parameter to the interrupt attribute like this:
  82. </p>
  83. <div class="smallexample">
  84. <pre class="smallexample">void f () __attribute__ ((interrupt (&quot;ilink1&quot;)));
  85. </pre></div>
  86. <p>Permissible values for this parameter are: <code>ilink1</code><!-- /@w --> and
  87. <code>ilink2</code><!-- /@w -->.
  88. </p>
  89. </dd>
  90. <dt><code>long_call</code></dt>
  91. <dt><code>medium_call</code></dt>
  92. <dt><code>short_call</code></dt>
  93. <dd><a name="index-long_005fcall-function-attribute_002c-ARC"></a>
  94. <a name="index-medium_005fcall-function-attribute_002c-ARC"></a>
  95. <a name="index-short_005fcall-function-attribute_002c-ARC"></a>
  96. <a name="index-indirect-calls_002c-ARC"></a>
  97. <p>These attributes specify how a particular function is called.
  98. These attributes override the
  99. <samp>-mlong-calls</samp> and <samp>-mmedium-calls</samp> (see <a href="ARC-Options.html#ARC-Options">ARC Options</a>)
  100. command-line switches and <code>#pragma long_calls</code> settings.
  101. </p>
  102. <p>For ARC, a function marked with the <code>long_call</code> attribute is
  103. always called using register-indirect jump-and-link instructions,
  104. thereby enabling the called function to be placed anywhere within the
  105. 32-bit address space. A function marked with the <code>medium_call</code>
  106. attribute will always be close enough to be called with an unconditional
  107. branch-and-link instruction, which has a 25-bit offset from
  108. the call site. A function marked with the <code>short_call</code>
  109. attribute will always be close enough to be called with a conditional
  110. branch-and-link instruction, which has a 21-bit offset from
  111. the call site.
  112. </p></dd>
  113. </dl>
  114. </body>
  115. </html>