visus
/
toolchain-gcc-arm-embedded
Tarkkaile 1
Äänestä 0
Fork 0
Koodi Ongelmat 0 Pull-pyynnöt 0 Julkaisut 0 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2 Commitit
1 Haara
Haara: main
Branchit Tagit
${ item.name }
Create branch ${ searchTerm }
from 'main'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/gcc/ARC-Built_002din-Functions....

304 lines
13KB
Raaka Pysyvä linkki Blame Historia 

  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-2020 Free Software Foundation, Inc.

  4. 

  5. Permission is granted to copy, distribute and/or modify this document

  6. under the terms of the GNU Free Documentation License, Version 1.3 or

  7. any later version published by the Free Software Foundation; with the

  8. Invariant Sections being "Funding Free Software", the Front-Cover

  9. Texts being (a) (see below), and with the Back-Cover Texts being (b)

  10. (see below).  A copy of the license is included in the section entitled

  11. "GNU Free Documentation License".

  12. 

  13. (a) The FSF's Front-Cover Text is:

  14. 

  15. A GNU Manual

  16. 

  17. (b) The FSF's Back-Cover Text is:

  18. 

  19. You have freedom to copy and modify this GNU Manual, like GNU

  20.      software.  Copies published by the Free Software Foundation raise

  21.      funds for GNU development. -->

  22. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->

  23. <head>

  24. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  25. <title>ARC Built-in Functions (Using the GNU Compiler Collection (GCC))</title>

  26. 

  27. <meta name="description" content="ARC Built-in Functions (Using the GNU Compiler Collection (GCC))">

  28. <meta name="keywords" content="ARC Built-in Functions (Using the GNU Compiler Collection (GCC))">

  29. <meta name="resource-type" content="document">

  30. <meta name="distribution" content="global">

  31. <meta name="Generator" content="makeinfo">

  32. <link href="index.html#Top" rel="start" title="Top">

  33. <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">

  34. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">

  35. <link href="Target-Builtins.html#Target-Builtins" rel="up" title="Target Builtins">

  36. <link href="ARC-SIMD-Built_002din-Functions.html#ARC-SIMD-Built_002din-Functions" rel="next" title="ARC SIMD Built-in Functions">

  37. <link href="Altera-Nios-II-Built_002din-Functions.html#Altera-Nios-II-Built_002din-Functions" rel="prev" title="Altera Nios II Built-in Functions">

  38. <style type="text/css">

  39. <!--

  40. a.summary-letter {text-decoration: none}

  41. blockquote.indentedblock {margin-right: 0em}

  42. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}

  43. blockquote.smallquotation {font-size: smaller}

  44. div.display {margin-left: 3.2em}

  45. div.example {margin-left: 3.2em}

  46. div.lisp {margin-left: 3.2em}

  47. div.smalldisplay {margin-left: 3.2em}

  48. div.smallexample {margin-left: 3.2em}

  49. div.smalllisp {margin-left: 3.2em}

  50. kbd {font-style: oblique}

  51. pre.display {font-family: inherit}

  52. pre.format {font-family: inherit}

  53. pre.menu-comment {font-family: serif}

  54. pre.menu-preformatted {font-family: serif}

  55. pre.smalldisplay {font-family: inherit; font-size: smaller}

  56. pre.smallexample {font-size: smaller}

  57. pre.smallformat {font-family: inherit; font-size: smaller}

  58. pre.smalllisp {font-size: smaller}

  59. span.nolinebreak {white-space: nowrap}

  60. span.roman {font-family: initial; font-weight: normal}

  61. span.sansserif {font-family: sans-serif; font-weight: normal}

  62. ul.no-bullet {list-style: none}

  63. -->

  64. </style>

  65. 

  66. 

  67. </head>

  68. 

  69. <body lang="en">

  70. <a name="ARC-Built_002din-Functions"></a>

  71. <div class="header">

  72. <p>

  73. Next: <a href="ARC-SIMD-Built_002din-Functions.html#ARC-SIMD-Built_002din-Functions" accesskey="n" rel="next">ARC SIMD Built-in Functions</a>, Previous: <a href="Altera-Nios-II-Built_002din-Functions.html#Altera-Nios-II-Built_002din-Functions" accesskey="p" rel="prev">Altera Nios II Built-in Functions</a>, Up: <a href="Target-Builtins.html#Target-Builtins" accesskey="u" rel="up">Target Builtins</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>

  74. </div>

  75. <hr>

  76. <a name="ARC-Built_002din-Functions-1"></a>

  77. <h4 class="subsection">6.60.4 ARC Built-in Functions</h4>

  78. 

  79. <p>The following built-in functions are provided for ARC targets.  The

  80. built-ins generate the corresponding assembly instructions.  In the

  81. examples given below, the generated code often requires an operand or

  82. result to be in a register.  Where necessary further code will be

  83. generated to ensure this is true, but for brevity this is not

  84. described in each case.

  85. </p>

  86. <p><em>Note:</em> Using a built-in to generate an instruction not supported

  87. by a target may cause problems. At present the compiler is not

  88. guaranteed to detect such misuse, and as a result an internal compiler

  89. error may be generated.

  90. </p>

  91. <dl>

  92. <dt><a name="index-_005f_005fbuiltin_005farc_005faligned"></a>Built-in Function: <em>int</em> <strong>__builtin_arc_aligned</strong> <em>(void *<var>val</var>, int <var>alignval</var>)</em></dt>

  93. <dd><p>Return 1 if <var>val</var> is known to have the byte alignment given

  94. by <var>alignval</var>, otherwise return 0.

  95. Note that this is different from

  96. </p><div class="smallexample">

  97. <pre class="smallexample">__alignof__(*(char *)<var>val</var>) &gt;= alignval

  98. </pre></div>

  99. <p>because __alignof__ sees only the type of the dereference, whereas

  100. __builtin_arc_align uses alignment information from the pointer

  101. as well as from the pointed-to type.

  102. The information available will depend on optimization level.

  103. </p></dd></dl>

  104. 

  105. <dl>

  106. <dt><a name="index-_005f_005fbuiltin_005farc_005fbrk"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_brk</strong> <em>(void)</em></dt>

  107. <dd><p>Generates

  108. </p><div class="example">

  109. <pre class="example">brk

  110. </pre></div>

  111. </dd></dl>

  112. 

  113. <dl>

  114. <dt><a name="index-_005f_005fbuiltin_005farc_005fcore_005fread"></a>Built-in Function: <em>unsigned int</em> <strong>__builtin_arc_core_read</strong> <em>(unsigned int <var>regno</var>)</em></dt>

  115. <dd><p>The operand is the number of a register to be read.  Generates:

  116. </p><div class="example">

  117. <pre class="example">mov  <var>dest</var>, r<var>regno</var>

  118. </pre></div>

  119. <p>where the value in <var>dest</var> will be the result returned from the

  120. built-in.

  121. </p></dd></dl>

  122. 

  123. <dl>

  124. <dt><a name="index-_005f_005fbuiltin_005farc_005fcore_005fwrite"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_core_write</strong> <em>(unsigned int <var>regno</var>, unsigned int <var>val</var>)</em></dt>

  125. <dd><p>The first operand is the number of a register to be written, the

  126. second operand is a compile time constant to write into that

  127. register.  Generates:

  128. </p><div class="example">

  129. <pre class="example">mov  r<var>regno</var>, <var>val</var>

  130. </pre></div>

  131. </dd></dl>

  132. 

  133. <dl>

  134. <dt><a name="index-_005f_005fbuiltin_005farc_005fdivaw"></a>Built-in Function: <em>int</em> <strong>__builtin_arc_divaw</strong> <em>(int <var>a</var>, int <var>b</var>)</em></dt>

  135. <dd><p>Only available if either <samp>-mcpu=ARC700</samp> or <samp>-meA</samp> is set.

  136. Generates:

  137. </p><div class="example">

  138. <pre class="example">divaw  <var>dest</var>, <var>a</var>, <var>b</var>

  139. </pre></div>

  140. <p>where the value in <var>dest</var> will be the result returned from the

  141. built-in.

  142. </p></dd></dl>

  143. 

  144. <dl>

  145. <dt><a name="index-_005f_005fbuiltin_005farc_005fflag"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_flag</strong> <em>(unsigned int <var>a</var>)</em></dt>

  146. <dd><p>Generates

  147. </p><div class="example">

  148. <pre class="example">flag  <var>a</var>

  149. </pre></div>

  150. </dd></dl>

  151. 

  152. <dl>

  153. <dt><a name="index-_005f_005fbuiltin_005farc_005flr"></a>Built-in Function: <em>unsigned int</em> <strong>__builtin_arc_lr</strong> <em>(unsigned int <var>auxr</var>)</em></dt>

  154. <dd><p>The operand, <var>auxv</var>, is the address of an auxiliary register and

  155. must be a compile time constant.  Generates:

  156. </p><div class="example">

  157. <pre class="example">lr  <var>dest</var>, [<var>auxr</var>]

  158. </pre></div>

  159. <p>Where the value in <var>dest</var> will be the result returned from the

  160. built-in.

  161. </p></dd></dl>

  162. 

  163. <dl>

  164. <dt><a name="index-_005f_005fbuiltin_005farc_005fmul64"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_mul64</strong> <em>(int <var>a</var>, int <var>b</var>)</em></dt>

  165. <dd><p>Only available with <samp>-mmul64</samp>.  Generates:

  166. </p><div class="example">

  167. <pre class="example">mul64  <var>a</var>, <var>b</var>

  168. </pre></div>

  169. </dd></dl>

  170. 

  171. <dl>

  172. <dt><a name="index-_005f_005fbuiltin_005farc_005fmulu64"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_mulu64</strong> <em>(unsigned int <var>a</var>, unsigned int <var>b</var>)</em></dt>

  173. <dd><p>Only available with <samp>-mmul64</samp>.  Generates:

  174. </p><div class="example">

  175. <pre class="example">mulu64  <var>a</var>, <var>b</var>

  176. </pre></div>

  177. </dd></dl>

  178. 

  179. <dl>

  180. <dt><a name="index-_005f_005fbuiltin_005farc_005fnop"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_nop</strong> <em>(void)</em></dt>

  181. <dd><p>Generates:

  182. </p><div class="example">

  183. <pre class="example">nop

  184. </pre></div>

  185. </dd></dl>

  186. 

  187. <dl>

  188. <dt><a name="index-_005f_005fbuiltin_005farc_005fnorm"></a>Built-in Function: <em>int</em> <strong>__builtin_arc_norm</strong> <em>(int <var>src</var>)</em></dt>

  189. <dd><p>Only valid if the &lsquo;<samp>norm</samp>&rsquo; instruction is available through the

  190. <samp>-mnorm</samp> option or by default with <samp>-mcpu=ARC700</samp>.

  191. Generates:

  192. </p><div class="example">

  193. <pre class="example">norm  <var>dest</var>, <var>src</var>

  194. </pre></div>

  195. <p>Where the value in <var>dest</var> will be the result returned from the

  196. built-in.

  197. </p></dd></dl>

  198. 

  199. <dl>

  200. <dt><a name="index-_005f_005fbuiltin_005farc_005fnormw"></a>Built-in Function: <em>short int</em> <strong>__builtin_arc_normw</strong> <em>(short int <var>src</var>)</em></dt>

  201. <dd><p>Only valid if the &lsquo;<samp>normw</samp>&rsquo; instruction is available through the

  202. <samp>-mnorm</samp> option or by default with <samp>-mcpu=ARC700</samp>.

  203. Generates:

  204. </p><div class="example">

  205. <pre class="example">normw  <var>dest</var>, <var>src</var>

  206. </pre></div>

  207. <p>Where the value in <var>dest</var> will be the result returned from the

  208. built-in.

  209. </p></dd></dl>

  210. 

  211. <dl>

  212. <dt><a name="index-_005f_005fbuiltin_005farc_005frtie"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_rtie</strong> <em>(void)</em></dt>

  213. <dd><p>Generates:

  214. </p><div class="example">

  215. <pre class="example">rtie

  216. </pre></div>

  217. </dd></dl>

  218. 

  219. <dl>

  220. <dt><a name="index-_005f_005fbuiltin_005farc_005fsleep"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_sleep</strong> <em>(int <var>a</var></em></dt>

  221. <dd><p>Generates:

  222. </p><div class="example">

  223. <pre class="example">sleep  <var>a</var>

  224. </pre></div>

  225. </dd></dl>

  226. 

  227. <dl>

  228. <dt><a name="index-_005f_005fbuiltin_005farc_005fsr"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_sr</strong> <em>(unsigned int <var>auxr</var>, unsigned int <var>val</var>)</em></dt>

  229. <dd><p>The first argument, <var>auxv</var>, is the address of an auxiliary

  230. register, the second argument, <var>val</var>, is a compile time constant

  231. to be written to the register.  Generates:

  232. </p><div class="example">

  233. <pre class="example">sr  <var>auxr</var>, [<var>val</var>]

  234. </pre></div>

  235. </dd></dl>

  236. 

  237. <dl>

  238. <dt><a name="index-_005f_005fbuiltin_005farc_005fswap"></a>Built-in Function: <em>int</em> <strong>__builtin_arc_swap</strong> <em>(int <var>src</var>)</em></dt>

  239. <dd><p>Only valid with <samp>-mswap</samp>.  Generates:

  240. </p><div class="example">

  241. <pre class="example">swap  <var>dest</var>, <var>src</var>

  242. </pre></div>

  243. <p>Where the value in <var>dest</var> will be the result returned from the

  244. built-in.

  245. </p></dd></dl>

  246. 

  247. <dl>

  248. <dt><a name="index-_005f_005fbuiltin_005farc_005fswi"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_swi</strong> <em>(void)</em></dt>

  249. <dd><p>Generates:

  250. </p><div class="example">

  251. <pre class="example">swi

  252. </pre></div>

  253. </dd></dl>

  254. 

  255. <dl>

  256. <dt><a name="index-_005f_005fbuiltin_005farc_005fsync"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_sync</strong> <em>(void)</em></dt>

  257. <dd><p>Only available with <samp>-mcpu=ARC700</samp>.  Generates:

  258. </p><div class="example">

  259. <pre class="example">sync

  260. </pre></div>

  261. </dd></dl>

  262. 

  263. <dl>

  264. <dt><a name="index-_005f_005fbuiltin_005farc_005ftrap_005fs"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_trap_s</strong> <em>(unsigned int <var>c</var>)</em></dt>

  265. <dd><p>Only available with <samp>-mcpu=ARC700</samp>.  Generates:

  266. </p><div class="example">

  267. <pre class="example">trap_s  <var>c</var>

  268. </pre></div>

  269. </dd></dl>

  270. 

  271. <dl>

  272. <dt><a name="index-_005f_005fbuiltin_005farc_005funimp_005fs"></a>Built-in Function: <em>void</em> <strong>__builtin_arc_unimp_s</strong> <em>(void)</em></dt>

  273. <dd><p>Only available with <samp>-mcpu=ARC700</samp>.  Generates:

  274. </p><div class="example">

  275. <pre class="example">unimp_s

  276. </pre></div>

  277. </dd></dl>

  278. 

  279. <p>The instructions generated by the following builtins are not

  280. considered as candidates for scheduling.  They are not moved around by

  281. the compiler during scheduling, and thus can be expected to appear

  282. where they are put in the C code:

  283. </p><div class="example">

  284. <pre class="example">__builtin_arc_brk()

  285. __builtin_arc_core_read()

  286. __builtin_arc_core_write()

  287. __builtin_arc_flag()

  288. __builtin_arc_lr()

  289. __builtin_arc_sleep()

  290. __builtin_arc_sr()

  291. __builtin_arc_swi()

  292. </pre></div>

  293. 

  294. <hr>

  295. <div class="header">

  296. <p>

  297. Next: <a href="ARC-SIMD-Built_002din-Functions.html#ARC-SIMD-Built_002din-Functions" accesskey="n" rel="next">ARC SIMD Built-in Functions</a>, Previous: <a href="Altera-Nios-II-Built_002din-Functions.html#Altera-Nios-II-Built_002din-Functions" accesskey="p" rel="prev">Altera Nios II Built-in Functions</a>, Up: <a href="Target-Builtins.html#Target-Builtins" accesskey="u" rel="up">Target Builtins</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>

  298. </div>

  299. 

  300. 

  301. 

  302. </body>

  303. </html>