You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
253 lines
12 KiB
HTML
253 lines
12 KiB
HTML
4 years ago
|
<html lang="en">
|
||
|
|
<head>
|
||
|
|
<title>ARC Built-in Functions - Using the GNU Compiler Collection (GCC)</title>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html">
|
||
|
|
<meta name="description" content="Using the GNU Compiler Collection (GCC)">
|
||
|
|
<meta name="generator" content="makeinfo 4.13">
|
||
|
|
<link title="Top" rel="start" href="index.html#Top">
|
||
|
|
<link rel="up" href="Target-Builtins.html#Target-Builtins" title="Target Builtins">
|
||
|
|
<link rel="prev" href="Altera-Nios-II-Built_002din-Functions.html#Altera-Nios-II-Built_002din-Functions" title="Altera Nios II Built-in Functions">
|
||
|
|
<link rel="next" href="ARC-SIMD-Built_002din-Functions.html#ARC-SIMD-Built_002din-Functions" title="ARC SIMD Built-in Functions">
|
||
|
|
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
|
||
|
|
<!--
|
||
|
|
Copyright (C) 1988-2015 Free Software Foundation, Inc.
|
||
|
|
|
||
|
|
Permission is granted to copy, distribute and/or modify this document
|
||
|
|
under the terms of the GNU Free Documentation License, Version 1.3 or
|
||
|
|
any later version published by the Free Software Foundation; with the
|
||
|
|
Invariant Sections being ``Funding Free Software'', the Front-Cover
|
||
|
|
Texts being (a) (see below), and with the Back-Cover Texts being (b)
|
||
|
|
(see below). A copy of the license is included in the section entitled
|
||
|
|
``GNU Free Documentation License''.
|
||
|
|
|
||
|
|
(a) The FSF's Front-Cover Text is:
|
||
|
|
|
||
|
|
A GNU Manual
|
||
|
|
|
||
|
|
(b) The FSF's Back-Cover Text is:
|
||
|
|
|
||
|
|
You have freedom to copy and modify this GNU Manual, like GNU
|
||
|
|
software. Copies published by the Free Software Foundation raise
|
||
|
|
funds for GNU development.-->
|
||
|
|
<meta http-equiv="Content-Style-Type" content="text/css">
|
||
|
|
<style type="text/css"><!--
|
||
|
|
pre.display { font-family:inherit }
|
||
|
|
pre.format { font-family:inherit }
|
||
|
|
pre.smalldisplay { font-family:inherit; font-size:smaller }
|
||
|
|
pre.smallformat { font-family:inherit; font-size:smaller }
|
||
|
|
pre.smallexample { font-size:smaller }
|
||
|
|
pre.smalllisp { font-size:smaller }
|
||
|
|
span.sc { font-variant:small-caps }
|
||
|
|
span.roman { font-family:serif; font-weight:normal; }
|
||
|
|
span.sansserif { font-family:sans-serif; font-weight:normal; }
|
||
|
|
--></style>
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<div class="node">
|
||
|
|
<a name="ARC-Built-in-Functions"></a>
|
||
|
|
<a name="ARC-Built_002din-Functions"></a>
|
||
|
|
<p>
|
||
|
|
Next: <a rel="next" accesskey="n" href="ARC-SIMD-Built_002din-Functions.html#ARC-SIMD-Built_002din-Functions">ARC SIMD Built-in Functions</a>,
|
||
|
|
Previous: <a rel="previous" accesskey="p" href="Altera-Nios-II-Built_002din-Functions.html#Altera-Nios-II-Built_002din-Functions">Altera Nios II Built-in Functions</a>,
|
||
|
|
Up: <a rel="up" accesskey="u" href="Target-Builtins.html#Target-Builtins">Target Builtins</a>
|
||
|
|
<hr>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h4 class="subsection">6.58.4 ARC Built-in Functions</h4>
|
||
|
|
|
||
|
|
<p>The following built-in functions are provided for ARC targets. The
|
||
|
|
built-ins generate the corresponding assembly instructions. In the
|
||
|
|
examples given below, the generated code often requires an operand or
|
||
|
|
result to be in a register. Where necessary further code will be
|
||
|
|
generated to ensure this is true, but for brevity this is not
|
||
|
|
described in each case.
|
||
|
|
|
||
|
|
<p><em>Note:</em> Using a built-in to generate an instruction not supported
|
||
|
|
by a target may cause problems. At present the compiler is not
|
||
|
|
guaranteed to detect such misuse, and as a result an internal compiler
|
||
|
|
error may be generated.
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: int <b>__builtin_arc_aligned</b> (<var>void *val, int alignval</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005faligned-4081"></a></var><br>
|
||
|
|
<blockquote><p>Return 1 if <var>val</var> is known to have the byte alignment given
|
||
|
|
by <var>alignval</var>, otherwise return 0.
|
||
|
|
Note that this is different from
|
||
|
|
<pre class="smallexample"> __alignof__(*(char *)<var>val</var>) >= alignval
|
||
|
|
</pre>
|
||
|
|
<p>because __alignof__ sees only the type of the dereference, whereas
|
||
|
|
__builtin_arc_align uses alignment information from the pointer
|
||
|
|
as well as from the pointed-to type.
|
||
|
|
The information available will depend on optimization level.
|
||
|
|
</p></blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_brk</b> (<var>void</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fbrk-4082"></a></var><br>
|
||
|
|
<blockquote><p>Generates
|
||
|
|
<pre class="example"> brk
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: unsigned int <b>__builtin_arc_core_read</b> (<var>unsigned int regno</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fcore_005fread-4083"></a></var><br>
|
||
|
|
<blockquote><p>The operand is the number of a register to be read. Generates:
|
||
|
|
<pre class="example"> mov <var>dest</var>, r<var>regno</var>
|
||
|
|
</pre>
|
||
|
|
<p>where the value in <var>dest</var> will be the result returned from the
|
||
|
|
built-in.
|
||
|
|
</p></blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_core_write</b> (<var>unsigned int regno, unsigned int val</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fcore_005fwrite-4084"></a></var><br>
|
||
|
|
<blockquote><p>The first operand is the number of a register to be written, the
|
||
|
|
second operand is a compile time constant to write into that
|
||
|
|
register. Generates:
|
||
|
|
<pre class="example"> mov r<var>regno</var>, <var>val</var>
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: int <b>__builtin_arc_divaw</b> (<var>int a, int b</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fdivaw-4085"></a></var><br>
|
||
|
|
<blockquote><p>Only available if either <samp><span class="option">-mcpu=ARC700</span></samp> or <samp><span class="option">-meA</span></samp> is set.
|
||
|
|
Generates:
|
||
|
|
<pre class="example"> divaw <var>dest</var>, <var>a</var>, <var>b</var>
|
||
|
|
</pre>
|
||
|
|
<p>where the value in <var>dest</var> will be the result returned from the
|
||
|
|
built-in.
|
||
|
|
</p></blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_flag</b> (<var>unsigned int a</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fflag-4086"></a></var><br>
|
||
|
|
<blockquote><p>Generates
|
||
|
|
<pre class="example"> flag <var>a</var>
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: unsigned int <b>__builtin_arc_lr</b> (<var>unsigned int auxr</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005flr-4087"></a></var><br>
|
||
|
|
<blockquote><p>The operand, <var>auxv</var>, is the address of an auxiliary register and
|
||
|
|
must be a compile time constant. Generates:
|
||
|
|
<pre class="example"> lr <var>dest</var>, [<var>auxr</var>]
|
||
|
|
</pre>
|
||
|
|
<p>Where the value in <var>dest</var> will be the result returned from the
|
||
|
|
built-in.
|
||
|
|
</p></blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_mul64</b> (<var>int a, int b</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fmul64-4088"></a></var><br>
|
||
|
|
<blockquote><p>Only available with <samp><span class="option">-mmul64</span></samp>. Generates:
|
||
|
|
<pre class="example"> mul64 <var>a</var>, <var>b</var>
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_mulu64</b> (<var>unsigned int a, unsigned int b</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fmulu64-4089"></a></var><br>
|
||
|
|
<blockquote><p>Only available with <samp><span class="option">-mmul64</span></samp>. Generates:
|
||
|
|
<pre class="example"> mulu64 <var>a</var>, <var>b</var>
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_nop</b> (<var>void</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fnop-4090"></a></var><br>
|
||
|
|
<blockquote><p>Generates:
|
||
|
|
<pre class="example"> nop
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: int <b>__builtin_arc_norm</b> (<var>int src</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fnorm-4091"></a></var><br>
|
||
|
|
<blockquote><p>Only valid if the ‘<samp><span class="samp">norm</span></samp>’ instruction is available through the
|
||
|
|
<samp><span class="option">-mnorm</span></samp> option or by default with <samp><span class="option">-mcpu=ARC700</span></samp>.
|
||
|
|
Generates:
|
||
|
|
<pre class="example"> norm <var>dest</var>, <var>src</var>
|
||
|
|
</pre>
|
||
|
|
<p>Where the value in <var>dest</var> will be the result returned from the
|
||
|
|
built-in.
|
||
|
|
</p></blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: short int <b>__builtin_arc_normw</b> (<var>short int src</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fnormw-4092"></a></var><br>
|
||
|
|
<blockquote><p>Only valid if the ‘<samp><span class="samp">normw</span></samp>’ instruction is available through the
|
||
|
|
<samp><span class="option">-mnorm</span></samp> option or by default with <samp><span class="option">-mcpu=ARC700</span></samp>.
|
||
|
|
Generates:
|
||
|
|
<pre class="example"> normw <var>dest</var>, <var>src</var>
|
||
|
|
</pre>
|
||
|
|
<p>Where the value in <var>dest</var> will be the result returned from the
|
||
|
|
built-in.
|
||
|
|
</p></blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_rtie</b> (<var>void</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005frtie-4093"></a></var><br>
|
||
|
|
<blockquote><p>Generates:
|
||
|
|
<pre class="example"> rtie
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_sleep</b> (<var>int a<a name="index-g_t_005f_005fbuiltin_005farc_005fsleep-4094"></a></var><br>
|
||
|
|
<blockquote><p>Generates:
|
||
|
|
<pre class="example"> sleep <var>a</var>
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_sr</b> (<var>unsigned int auxr, unsigned int val</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fsr-4095"></a></var><br>
|
||
|
|
<blockquote><p>The first argument, <var>auxv</var>, is the address of an auxiliary
|
||
|
|
register, the second argument, <var>val</var>, is a compile time constant
|
||
|
|
to be written to the register. Generates:
|
||
|
|
<pre class="example"> sr <var>auxr</var>, [<var>val</var>]
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: int <b>__builtin_arc_swap</b> (<var>int src</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fswap-4096"></a></var><br>
|
||
|
|
<blockquote><p>Only valid with <samp><span class="option">-mswap</span></samp>. Generates:
|
||
|
|
<pre class="example"> swap <var>dest</var>, <var>src</var>
|
||
|
|
</pre>
|
||
|
|
<p>Where the value in <var>dest</var> will be the result returned from the
|
||
|
|
built-in.
|
||
|
|
</p></blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_swi</b> (<var>void</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fswi-4097"></a></var><br>
|
||
|
|
<blockquote><p>Generates:
|
||
|
|
<pre class="example"> swi
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_sync</b> (<var>void</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005fsync-4098"></a></var><br>
|
||
|
|
<blockquote><p>Only available with <samp><span class="option">-mcpu=ARC700</span></samp>. Generates:
|
||
|
|
<pre class="example"> sync
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_trap_s</b> (<var>unsigned int c</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005ftrap_005fs-4099"></a></var><br>
|
||
|
|
<blockquote><p>Only available with <samp><span class="option">-mcpu=ARC700</span></samp>. Generates:
|
||
|
|
<pre class="example"> trap_s <var>c</var>
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<div class="defun">
|
||
|
|
— Built-in Function: void <b>__builtin_arc_unimp_s</b> (<var>void</var>)<var><a name="index-g_t_005f_005fbuiltin_005farc_005funimp_005fs-4100"></a></var><br>
|
||
|
|
<blockquote><p>Only available with <samp><span class="option">-mcpu=ARC700</span></samp>. Generates:
|
||
|
|
<pre class="example"> unimp_s
|
||
|
|
</pre>
|
||
|
|
</blockquote></div>
|
||
|
|
|
||
|
|
<p>The instructions generated by the following builtins are not
|
||
|
|
considered as candidates for scheduling. They are not moved around by
|
||
|
|
the compiler during scheduling, and thus can be expected to appear
|
||
|
|
where they are put in the C code:
|
||
|
|
<pre class="example"> __builtin_arc_brk()
|
||
|
|
__builtin_arc_core_read()
|
||
|
|
__builtin_arc_core_write()
|
||
|
|
__builtin_arc_flag()
|
||
|
|
__builtin_arc_lr()
|
||
|
|
__builtin_arc_sleep()
|
||
|
|
__builtin_arc_sr()
|
||
|
|
__builtin_arc_swi()
|
||
|
|
</pre>
|
||
|
|
</body></html>
|
||
|
|
|