path: root/devdocs/gcc~13/blackfin-function-attributes.html

<div class="subsection-level-extent" id="Blackfin-Function-Attributes"> <div class="nav-panel"> <p> Next: <a href="bpf-function-attributes" accesskey="n" rel="next">BPF Function Attributes</a>, Previous: <a href="avr-function-attributes" accesskey="p" rel="prev">AVR 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="Blackfin-Function-Attributes-1"><span>6.33.7 Blackfin Function Attributes<a class="copiable-link" href="#Blackfin-Function-Attributes-1"> ¶</a></span></h1> <p>These function attributes are supported by the Blackfin back end: </p> <dl class="table"> <dt>
 <span><code class="code">exception_handler</code><a class="copiable-link" href="#index-exception_005fhandler-function-attribute"> ¶</a></span>
</dt> <dd>
<p>Use this attribute on the Blackfin to indicate that the specified function is an exception handler. The compiler generates function entry and exit sequences suitable for use in an exception handler when this attribute is present. </p> </dd> <dt>
<span><code class="code">interrupt_handler</code><a class="copiable-link" href="#index-interrupt_005fhandler-function-attribute_002c-Blackfin"> ¶</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> </dd> <dt>
 <span><code class="code">kspisusp</code><a class="copiable-link" href="#index-kspisusp-function-attribute_002c-Blackfin"> ¶</a></span>
</dt> <dd>
<p>When used together with <code class="code">interrupt_handler</code>, <code class="code">exception_handler</code> or <code class="code">nmi_handler</code>, code is generated to load the stack pointer from the USP register in the function prologue. </p> </dd> <dt>
<span><code class="code">l1_text</code><a class="copiable-link" href="#index-l1_005ftext-function-attribute_002c-Blackfin"> ¶</a></span>
</dt> <dd>
<p>This attribute specifies a function to be placed into L1 Instruction SRAM. The function is put into a specific section named <code class="code">.l1.text</code>. With <samp class="option">-mfdpic</samp>, function calls with a such function as the callee or caller uses inlined PLT. </p> </dd> <dt>
<span><code class="code">l2</code><a class="copiable-link" href="#index-l2-function-attribute_002c-Blackfin"> ¶</a></span>
</dt> <dd>
<p>This attribute specifies a function to be placed into L2 SRAM. The function is put into a specific section named <code class="code">.l2.text</code>. With <samp class="option">-mfdpic</samp>, callers of such functions use an inlined PLT. </p> </dd> <dt>
  <span><code class="code">longcall</code><a class="copiable-link" href="#index-indirect-calls_002c-Blackfin"> ¶</a></span>
</dt> <dt><code class="code">shortcall</code></dt> <dd>
<p>The <code class="code">longcall</code> attribute indicates that the function might be far away from the call site and require a different (more expensive) calling sequence. The <code class="code">shortcall</code> attribute indicates that the function is always close enough for the shorter calling sequence to be used. These attributes override the <samp class="option">-mlongcall</samp> switch. </p> </dd> <dt>
 <span><code class="code">nesting</code><a class="copiable-link" href="#index-nesting-function-attribute_002c-Blackfin"> ¶</a></span>
</dt> <dd>
<p>Use this attribute together with <code class="code">interrupt_handler</code>, <code class="code">exception_handler</code> or <code class="code">nmi_handler</code> to indicate that the function entry code should enable nested interrupts or exceptions. </p> </dd> <dt>
 <span><code class="code">nmi_handler</code><a class="copiable-link" href="#index-nmi_005fhandler-function-attribute_002c-Blackfin"> ¶</a></span>
</dt> <dd>
<p>Use this attribute on the Blackfin to indicate that the specified function is an NMI handler. The compiler generates function entry and exit sequences suitable for use in an NMI handler when this attribute is present. </p> </dd> <dt>
 <span><code class="code">saveall</code><a class="copiable-link" href="#index-saveall-function-attribute_002c-Blackfin"> ¶</a></span>
</dt> <dd><p>Use this attribute to indicate that all registers except the stack pointer should be saved in the prologue regardless of whether they are used or not. </p></dd> </dl> </div>  <div class="nav-panel"> <p> Next: <a href="bpf-function-attributes">BPF Function Attributes</a>, Previous: <a href="avr-function-attributes">AVR Function Attributes</a>, Up: <a href="function-attributes">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><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/Blackfin-Function-Attributes.html" class="_attribution-link">https://gcc.gnu.org/onlinedocs/gcc-13.1.0/gcc/Blackfin-Function-Attributes.html</a>
  </p>
</div>