visus
/
toolchain-gcc-arm-embedded
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 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 Commits
1 Branch
Tree: 898a39b5ab
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '898a39b5ab'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/gcc/Basic-PowerPC-Built_002din-...

195 lines
10KB
Raw Blame History 

  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>Basic PowerPC Built-in Functions Available on ISA 2.05 (Using the GNU Compiler Collection (GCC))</title>

  26. 

  27. <meta name="description" content="Basic PowerPC Built-in Functions Available on ISA 2.05 (Using the GNU Compiler Collection (GCC))">

  28. <meta name="keywords" content="Basic PowerPC Built-in Functions Available on ISA 2.05 (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="Basic-PowerPC-Built_002din-Functions.html#Basic-PowerPC-Built_002din-Functions" rel="up" title="Basic PowerPC Built-in Functions">

  36. <link href="Basic-PowerPC-Built_002din-Functions-Available-on-ISA-2_002e06.html#Basic-PowerPC-Built_002din-Functions-Available-on-ISA-2_002e06" rel="next" title="Basic PowerPC Built-in Functions Available on ISA 2.06">

  37. <link href="Basic-PowerPC-Built_002din-Functions-Available-on-all-Configurations.html#Basic-PowerPC-Built_002din-Functions-Available-on-all-Configurations" rel="prev" title="Basic PowerPC Built-in Functions Available on all Configurations">

  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="Basic-PowerPC-Built_002din-Functions-Available-on-ISA-2_002e05"></a>

  71. <div class="header">

  72. <p>

  73. Next: <a href="Basic-PowerPC-Built_002din-Functions-Available-on-ISA-2_002e06.html#Basic-PowerPC-Built_002din-Functions-Available-on-ISA-2_002e06" accesskey="n" rel="next">Basic PowerPC Built-in Functions Available on ISA 2.06</a>, Previous: <a href="Basic-PowerPC-Built_002din-Functions-Available-on-all-Configurations.html#Basic-PowerPC-Built_002din-Functions-Available-on-all-Configurations" accesskey="p" rel="prev">Basic PowerPC Built-in Functions Available on all Configurations</a>, Up: <a href="Basic-PowerPC-Built_002din-Functions.html#Basic-PowerPC-Built_002din-Functions" accesskey="u" rel="up">Basic PowerPC Built-in Functions</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="Basic-PowerPC-Built_002din-Functions-Available-on-ISA-2_002e05-1"></a>

  77. <h4 class="subsubsection">6.60.22.2 Basic PowerPC Built-in Functions Available on ISA 2.05</h4>

  78. 

  79. <p>The basic built-in functions described in this section are

  80. available on the PowerPC family of processors starting with ISA 2.05

  81. or later.  Unless specific options are explicitly disabled on the

  82. command line, specifying option <samp>-mcpu=power6</samp> has the effect of

  83. enabling the <samp>-mpowerpc64</samp>, <samp>-mpowerpc-gpopt</samp>,

  84. <samp>-mpowerpc-gfxopt</samp>, <samp>-mmfcrf</samp>, <samp>-mpopcntb</samp>,

  85. <samp>-mfprnd</samp>, <samp>-mcmpb</samp>, <samp>-mhard-dfp</samp>, and

  86. <samp>-mrecip-precision</samp> options.  Specify the

  87. <samp>-maltivec</samp> option explicitly in

  88. combination with the above options if desired.

  89. </p>

  90. <p>The following functions require option <samp>-mcmpb</samp>.

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

  92. <pre class="smallexample">unsigned long long __builtin_cmpb (unsigned long long int, unsigned long long int);

  93. unsigned int __builtin_cmpb (unsigned int, unsigned int);

  94. </pre></div>

  95. 

  96. <p>The <code>__builtin_cmpb</code> function

  97. performs a byte-wise compare on the contents of its two arguments,

  98. returning the result of the byte-wise comparison as the returned

  99. value.  For each byte comparison, the corresponding byte of the return

  100. value holds 0xff if the input bytes are equal and 0 if the input bytes

  101. are not equal.  If either of the arguments to this built-in function

  102. is wider than 32 bits, the function call expands into the form that

  103. expects <code>unsigned long long int</code> arguments

  104. which is only available on 64-bit targets.

  105. </p>

  106. <p>The following built-in functions are available

  107. when hardware decimal floating point

  108. (<samp>-mhard-dfp</samp>) is available:

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

  110. <pre class="smallexample">void __builtin_set_fpscr_drn(int);

  111. _Decimal64 __builtin_ddedpd (int, _Decimal64);

  112. _Decimal128 __builtin_ddedpdq (int, _Decimal128);

  113. _Decimal64 __builtin_denbcd (int, _Decimal64);

  114. _Decimal128 __builtin_denbcdq (int, _Decimal128);

  115. _Decimal64 __builtin_diex (long long, _Decimal64);

  116. _Decimal128 _builtin_diexq (long long, _Decimal128);

  117. _Decimal64 __builtin_dscli (_Decimal64, int);

  118. _Decimal128 __builtin_dscliq (_Decimal128, int);

  119. _Decimal64 __builtin_dscri (_Decimal64, int);

  120. _Decimal128 __builtin_dscriq (_Decimal128, int);

  121. long long __builtin_dxex (_Decimal64);

  122. long long __builtin_dxexq (_Decimal128);

  123. _Decimal128 __builtin_pack_dec128 (unsigned long long, unsigned long long);

  124. unsigned long long __builtin_unpack_dec128 (_Decimal128, int);

  125. 

  126. The <code>__builtin_set_fpscr_drn</code> builtin allows changing the three decimal

  127. floating point rounding mode bits.  The argument is a 3-bit value.  The

  128. argument can either be a <code>const int</code> or the value can be stored in

  129. a variable.

  130. The builtin uses the ISA 3.0 instruction <code>mffscdrn</code> if available.

  131. Otherwise the builtin reads the FPSCR, masks the current decimal rounding

  132. mode bits out and OR's in the new value.

  133. 

  134. </pre></div>

  135. 

  136. <p>The following functions require <samp>-mhard-float</samp>,

  137. <samp>-mpowerpc-gfxopt</samp>, and <samp>-mpopcntb</samp> options.

  138. </p>

  139. <div class="smallexample">

  140. <pre class="smallexample">double __builtin_recipdiv (double, double);

  141. float __builtin_recipdivf (float, float);

  142. double __builtin_rsqrt (double);

  143. float __builtin_rsqrtf (float);

  144. </pre></div>

  145. 

  146. <p>The <code>vec_rsqrt</code>, <code>__builtin_rsqrt</code>, and

  147. <code>__builtin_rsqrtf</code> functions generate multiple instructions to

  148. implement the reciprocal sqrt functionality using reciprocal sqrt

  149. estimate instructions.

  150. </p>

  151. <p>The <code>__builtin_recipdiv</code>, and <code>__builtin_recipdivf</code>

  152. functions generate multiple instructions to implement division using

  153. the reciprocal estimate instructions.

  154. </p>

  155. <p>The following functions require <samp>-mhard-float</samp> and

  156. <samp>-mmultiple</samp> options.

  157. </p>

  158. <p>The <code>__builtin_unpack_longdouble</code> function takes a

  159. <code>long double</code> argument and a compile time constant of 0 or 1.  If

  160. the constant is 0, the first <code>double</code> within the

  161. <code>long double</code> is returned, otherwise the second <code>double</code>

  162. is returned.  The <code>__builtin_unpack_longdouble</code> function is only

  163. available if <code>long double</code> uses the IBM extended double

  164. representation.

  165. </p>

  166. <p>The <code>__builtin_pack_longdouble</code> function takes two <code>double</code>

  167. arguments and returns a <code>long double</code> value that combines the two

  168. arguments.  The <code>__builtin_pack_longdouble</code> function is only

  169. available if <code>long double</code> uses the IBM extended double

  170. representation.

  171. </p>

  172. <p>The <code>__builtin_unpack_ibm128</code> function takes a <code>__ibm128</code>

  173. argument and a compile time constant of 0 or 1.  If the constant is 0,

  174. the first <code>double</code> within the <code>__ibm128</code> is returned,

  175. otherwise the second <code>double</code> is returned.

  176. </p>

  177. <p>The <code>__builtin_pack_ibm128</code> function takes two <code>double</code>

  178. arguments and returns a <code>__ibm128</code> value that combines the two

  179. arguments.

  180. </p>

  181. <p>Additional built-in functions are available for the 64-bit PowerPC

  182. family of processors, for efficient use of 128-bit floating point

  183. (<code>__float128</code>) values.

  184. </p>

  185. <hr>

  186. <div class="header">

  187. <p>

  188. Next: <a href="Basic-PowerPC-Built_002din-Functions-Available-on-ISA-2_002e06.html#Basic-PowerPC-Built_002din-Functions-Available-on-ISA-2_002e06" accesskey="n" rel="next">Basic PowerPC Built-in Functions Available on ISA 2.06</a>, Previous: <a href="Basic-PowerPC-Built_002din-Functions-Available-on-all-Configurations.html#Basic-PowerPC-Built_002din-Functions-Available-on-all-Configurations" accesskey="p" rel="prev">Basic PowerPC Built-in Functions Available on all Configurations</a>, Up: <a href="Basic-PowerPC-Built_002din-Functions.html#Basic-PowerPC-Built_002din-Functions" accesskey="u" rel="up">Basic PowerPC Built-in Functions</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>

  189. </div>

  190. 

  191. 

  192. 

  193. </body>

  194. </html>