NDS32-Function-Attributes.html 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166
  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): NDS32 Function Attributes</title>
  20. <meta name="description" content="Using the GNU Compiler Collection (GCC): NDS32 Function Attributes">
  21. <meta name="keywords" content="Using the GNU Compiler Collection (GCC): NDS32 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="Nios-II-Function-Attributes.html#Nios-II-Function-Attributes" rel="next" title="Nios II Function Attributes">
  31. <link href="MSP430-Function-Attributes.html#MSP430-Function-Attributes" rel="prev" title="MSP430 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="NDS32-Function-Attributes"></a>
  63. <div class="header">
  64. <p>
  65. Next: <a href="Nios-II-Function-Attributes.html#Nios-II-Function-Attributes" accesskey="n" rel="next">Nios II Function Attributes</a>, Previous: <a href="MSP430-Function-Attributes.html#MSP430-Function-Attributes" accesskey="p" rel="prev">MSP430 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="NDS32-Function-Attributes-1"></a>
  69. <h4 class="subsection">6.31.20 NDS32 Function Attributes</h4>
  70. <p>These function attributes are supported by the NDS32 back end:
  71. </p>
  72. <dl compact="compact">
  73. <dt><code>exception</code></dt>
  74. <dd><a name="index-exception-function-attribute"></a>
  75. <a name="index-exception-handler-functions_002c-NDS32"></a>
  76. <p>Use this attribute on the NDS32 target to indicate that the specified function
  77. is an exception handler. The compiler will generate corresponding sections
  78. for use in an exception handler.
  79. </p>
  80. </dd>
  81. <dt><code>interrupt</code></dt>
  82. <dd><a name="index-interrupt-function-attribute_002c-NDS32"></a>
  83. <p>On NDS32 target, this attribute indicates that the specified function
  84. is an interrupt handler. The compiler generates corresponding sections
  85. for use in an interrupt handler. You can use the following attributes
  86. to modify the behavior:
  87. </p><dl compact="compact">
  88. <dt><code>nested</code></dt>
  89. <dd><a name="index-nested-function-attribute_002c-NDS32"></a>
  90. <p>This interrupt service routine is interruptible.
  91. </p></dd>
  92. <dt><code>not_nested</code></dt>
  93. <dd><a name="index-not_005fnested-function-attribute_002c-NDS32"></a>
  94. <p>This interrupt service routine is not interruptible.
  95. </p></dd>
  96. <dt><code>nested_ready</code></dt>
  97. <dd><a name="index-nested_005fready-function-attribute_002c-NDS32"></a>
  98. <p>This interrupt service routine is interruptible after <code>PSW.GIE</code>
  99. (global interrupt enable) is set. This allows interrupt service routine to
  100. finish some short critical code before enabling interrupts.
  101. </p></dd>
  102. <dt><code>save_all</code></dt>
  103. <dd><a name="index-save_005fall-function-attribute_002c-NDS32"></a>
  104. <p>The system will help save all registers into stack before entering
  105. interrupt handler.
  106. </p></dd>
  107. <dt><code>partial_save</code></dt>
  108. <dd><a name="index-partial_005fsave-function-attribute_002c-NDS32"></a>
  109. <p>The system will help save caller registers into stack before entering
  110. interrupt handler.
  111. </p></dd>
  112. </dl>
  113. </dd>
  114. <dt><code>naked</code></dt>
  115. <dd><a name="index-naked-function-attribute_002c-NDS32"></a>
  116. <p>This attribute allows the compiler to construct the
  117. requisite function declaration, while allowing the body of the
  118. function to be assembly code. The specified function will not have
  119. prologue/epilogue sequences generated by the compiler. Only basic
  120. <code>asm</code> statements can safely be included in naked functions
  121. (see <a href="Basic-Asm.html#Basic-Asm">Basic Asm</a>). While using extended <code>asm</code> or a mixture of
  122. basic <code>asm</code> and C code may appear to work, they cannot be
  123. depended upon to work reliably and are not supported.
  124. </p>
  125. </dd>
  126. <dt><code>reset</code></dt>
  127. <dd><a name="index-reset-function-attribute_002c-NDS32"></a>
  128. <a name="index-reset-handler-functions"></a>
  129. <p>Use this attribute on the NDS32 target to indicate that the specified function
  130. is a reset handler. The compiler will generate corresponding sections
  131. for use in a reset handler. You can use the following attributes
  132. to provide extra exception handling:
  133. </p><dl compact="compact">
  134. <dt><code>nmi</code></dt>
  135. <dd><a name="index-nmi-function-attribute_002c-NDS32"></a>
  136. <p>Provide a user-defined function to handle NMI exception.
  137. </p></dd>
  138. <dt><code>warm</code></dt>
  139. <dd><a name="index-warm-function-attribute_002c-NDS32"></a>
  140. <p>Provide a user-defined function to handle warm reset exception.
  141. </p></dd>
  142. </dl>
  143. </dd>
  144. </dl>
  145. <hr>
  146. <div class="header">
  147. <p>
  148. Next: <a href="Nios-II-Function-Attributes.html#Nios-II-Function-Attributes" accesskey="n" rel="next">Nios II Function Attributes</a>, Previous: <a href="MSP430-Function-Attributes.html#MSP430-Function-Attributes" accesskey="p" rel="prev">MSP430 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>
  149. </div>
  150. </body>
  151. </html>