summaryrefslogtreecommitdiff
path: root/devdocs/gcc~13/risc-v-function-attributes.html
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2024-04-07 13:41:34 -0500
committerCraig Jennings <c@cjennings.net>2024-04-07 13:41:34 -0500
commit754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 (patch)
treef1190704f78f04a2b0b4c977d20fe96a828377f1 /devdocs/gcc~13/risc-v-function-attributes.html
new repository
Diffstat (limited to 'devdocs/gcc~13/risc-v-function-attributes.html')
-rw-r--r--devdocs/gcc~13/risc-v-function-attributes.html14
1 files changed, 14 insertions, 0 deletions
diff --git a/devdocs/gcc~13/risc-v-function-attributes.html b/devdocs/gcc~13/risc-v-function-attributes.html
new file mode 100644
index 00000000..449d159c
--- /dev/null
+++ b/devdocs/gcc~13/risc-v-function-attributes.html
@@ -0,0 +1,14 @@
+<div class="subsection-level-extent" id="RISC-V-Function-Attributes"> <div class="nav-panel"> <p> Next: <a href="rl78-function-attributes" accesskey="n" rel="next">RL78 Function Attributes</a>, Previous: <a href="powerpc-function-attributes" accesskey="p" rel="prev">PowerPC Function Attributes</a>, Up: <a href="function-attributes" accesskey="u" rel="up">Declaring Attributes of Functions</a> [<a href="index#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="indices" title="Index" rel="index">Index</a>]</p> </div> <h1 class="subsection" id="RISC-V-Function-Attributes-1"><span>6.33.25 RISC-V Function Attributes<a class="copiable-link" href="#RISC-V-Function-Attributes-1"> ¶</a></span></h1> <p>These function attributes are supported by the RISC-V back end: </p> <dl class="table"> <dt>
+<span><code class="code">naked</code><a class="copiable-link" href="#index-naked-function-attribute_002c-RISC-V"> ¶</a></span>
+</dt> <dd>
+<p>This attribute allows the compiler to construct the requisite function declaration, while allowing the body of the function to be assembly code. The specified function will not have prologue/epilogue sequences generated by the compiler. Only basic <code class="code">asm</code> statements can safely be included in naked functions (see <a class="pxref" href="basic-asm">Basic Asm — Assembler Instructions Without Operands</a>). While using extended <code class="code">asm</code> or a mixture of basic <code class="code">asm</code> and C code may appear to work, they cannot be depended upon to work reliably and are not supported. </p> </dd> <dt>
+<span><code class="code">interrupt</code><a class="copiable-link" href="#index-interrupt-function-attribute_002c-RISC-V"> ¶</a></span>
+</dt> <dd>
+<p>Use this attribute to indicate that the specified function is an interrupt handler. The compiler generates function entry and exit sequences suitable for use in an interrupt handler when this attribute is present. </p> <p>You can specify the kind of interrupt to be handled by adding an optional parameter to the interrupt attribute like this: </p> <div class="example smallexample"> <pre class="example-preformatted" data-language="cpp">void f (void) __attribute__ ((interrupt ("user")));</pre>
+</div> <p>Permissible values for this parameter are <code class="code">user</code>, <code class="code">supervisor</code>, and <code class="code">machine</code>. If there is no parameter, then it defaults to <code class="code">machine</code>. </p>
+</dd> </dl> </div><div class="_attribution">
+ <p class="_attribution-p">
+ &copy; Free Software Foundation<br>Licensed under the GNU Free Documentation License, Version 1.3.<br>
+ <a href="https://gcc.gnu.org/onlinedocs/gcc-13.1.0/gcc/RISC-V-Function-Attributes.html" class="_attribution-link">https://gcc.gnu.org/onlinedocs/gcc-13.1.0/gcc/RISC-V-Function-Attributes.html</a>
+ </p>
+</div>