RL78-Function-Attributes.html 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114
  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): RL78 Function Attributes</title>
  20. <meta name="description" content="Using the GNU Compiler Collection (GCC): RL78 Function Attributes">
  21. <meta name="keywords" content="Using the GNU Compiler Collection (GCC): RL78 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="RX-Function-Attributes.html#RX-Function-Attributes" rel="next" title="RX Function Attributes">
  31. <link href="PowerPC-Function-Attributes.html#PowerPC-Function-Attributes" rel="prev" title="PowerPC 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="RL78-Function-Attributes"></a>
  63. <div class="header">
  64. <p>
  65. Next: <a href="RX-Function-Attributes.html#RX-Function-Attributes" accesskey="n" rel="next">RX Function Attributes</a>, Previous: <a href="PowerPC-Function-Attributes.html#PowerPC-Function-Attributes" accesskey="p" rel="prev">PowerPC 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="RL78-Function-Attributes-1"></a>
  69. <h4 class="subsection">6.31.24 RL78 Function Attributes</h4>
  70. <p>These function attributes are supported by the RL78 back end:
  71. </p>
  72. <dl compact="compact">
  73. <dt><code>interrupt</code></dt>
  74. <dt><code>brk_interrupt</code></dt>
  75. <dd><a name="index-interrupt-function-attribute_002c-RL78"></a>
  76. <a name="index-brk_005finterrupt-function-attribute_002c-RL78"></a>
  77. <p>These attributes indicate
  78. that the specified function is an interrupt handler. The compiler generates
  79. function entry and exit sequences suitable for use in an interrupt handler
  80. when this attribute is present.
  81. </p>
  82. <p>Use <code>brk_interrupt</code> instead of <code>interrupt</code> for
  83. handlers intended to be used with the <code>BRK</code> opcode (i.e. those
  84. that must end with <code>RETB</code> instead of <code>RETI</code>).
  85. </p>
  86. </dd>
  87. <dt><code>naked</code></dt>
  88. <dd><a name="index-naked-function-attribute_002c-RL78"></a>
  89. <p>This attribute allows the compiler to construct the
  90. requisite function declaration, while allowing the body of the
  91. function to be assembly code. The specified function will not have
  92. prologue/epilogue sequences generated by the compiler. Only basic
  93. <code>asm</code> statements can safely be included in naked functions
  94. (see <a href="Basic-Asm.html#Basic-Asm">Basic Asm</a>). While using extended <code>asm</code> or a mixture of
  95. basic <code>asm</code> and C code may appear to work, they cannot be
  96. depended upon to work reliably and are not supported.
  97. </p></dd>
  98. </dl>
  99. </body>
  100. </html>