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/PowerPC-AltiVec_002fVSX-Bui...

192 lines
9.7KB
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>PowerPC AltiVec/VSX Built-in Functions (Using the GNU Compiler Collection (GCC))</title>

  26. 

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

  28. <meta name="keywords" content="PowerPC AltiVec/VSX 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="PowerPC-AltiVec-Built_002din-Functions-on-ISA-2_002e05.html#PowerPC-AltiVec-Built_002din-Functions-on-ISA-2_002e05" rel="next" title="PowerPC AltiVec Built-in Functions on ISA 2.05">

  37. <link href="Basic-PowerPC-Built_002din-Functions-Available-on-ISA-3_002e0.html#Basic-PowerPC-Built_002din-Functions-Available-on-ISA-3_002e0" rel="prev" title="Basic PowerPC Built-in Functions Available on ISA 3.0">

  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="PowerPC-AltiVec_002fVSX-Built_002din-Functions"></a>

  71. <div class="header">

  72. <p>

  73. Next: <a href="PowerPC-Hardware-Transactional-Memory-Built_002din-Functions.html#PowerPC-Hardware-Transactional-Memory-Built_002din-Functions" accesskey="n" rel="next">PowerPC Hardware Transactional Memory Built-in Functions</a>, Previous: <a href="Basic-PowerPC-Built_002din-Functions.html#Basic-PowerPC-Built_002din-Functions" accesskey="p" rel="prev">Basic PowerPC 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="PowerPC-AltiVec_002fVSX-Built_002din-Functions-1"></a>

  77. <h4 class="subsection">6.60.23 PowerPC AltiVec/VSX Built-in Functions</h4>

  78. 

  79. <p>GCC provides an interface for the PowerPC family of processors to access

  80. the AltiVec operations described in Motorola&rsquo;s AltiVec Programming

  81. Interface Manual.  The interface is made available by including

  82. <code>&lt;altivec.h&gt;</code> and using <samp>-maltivec</samp> and

  83. <samp>-mabi=altivec</samp>.  The interface supports the following vector

  84. types.

  85. </p>

  86. <div class="smallexample">

  87. <pre class="smallexample">vector unsigned char

  88. vector signed char

  89. vector bool char

  90. 

  91. vector unsigned short

  92. vector signed short

  93. vector bool short

  94. vector pixel

  95. 

  96. vector unsigned int

  97. vector signed int

  98. vector bool int

  99. vector float

  100. </pre></div>

  101. 

  102. <p>GCC&rsquo;s implementation of the high-level language interface available from

  103. C and C++ code differs from Motorola&rsquo;s documentation in several ways.

  104. </p>

  105. <ul>

  106. <li> A vector constant is a list of constant expressions within curly braces.

  107. 

  108. </li><li> A vector initializer requires no cast if the vector constant is of the

  109. same type as the variable it is initializing.

  110. 

  111. </li><li> If <code>signed</code> or <code>unsigned</code> is omitted, the signedness of the

  112. vector type is the default signedness of the base type.  The default

  113. varies depending on the operating system, so a portable program should

  114. always specify the signedness.

  115. 

  116. </li><li> Compiling with <samp>-maltivec</samp> adds keywords <code>__vector</code>,

  117. <code>vector</code>, <code>__pixel</code>, <code>pixel</code>, <code>__bool</code> and

  118. <code>bool</code>.  When compiling ISO C, the context-sensitive substitution

  119. of the keywords <code>vector</code>, <code>pixel</code> and <code>bool</code> is

  120. disabled.  To use them, you must include <code>&lt;altivec.h&gt;</code> instead.

  121. 

  122. </li><li> GCC allows using a <code>typedef</code> name as the type specifier for a

  123. vector type, but only under the following circumstances:

  124. 

  125. <ul>

  126. <li> When using <code>__vector</code> instead of <code>vector</code>; for example,

  127. 

  128. <div class="smallexample">

  129. <pre class="smallexample">typedef signed short int16;

  130. __vector int16 data;

  131. </pre></div>

  132. 

  133. </li><li> When using <code>vector</code> in keyword-and-predefine mode; for example,

  134. 

  135. <div class="smallexample">

  136. <pre class="smallexample">typedef signed short int16;

  137. vector int16 data;

  138. </pre></div>

  139. 

  140. <p>Note that keyword-and-predefine mode is enabled by disabling GNU

  141. extensions (e.g., by using <code>-std=c11</code>) and including

  142. <code>&lt;altivec.h&gt;</code>.

  143. </p></li></ul>

  144. 

  145. </li><li> For C, overloaded functions are implemented with macros so the following

  146. does not work:

  147. 

  148. <div class="smallexample">

  149. <pre class="smallexample">  vec_add ((vector signed int){1, 2, 3, 4}, foo);

  150. </pre></div>

  151. 

  152. <p>Since <code>vec_add</code> is a macro, the vector constant in the example

  153. is treated as four separate arguments.  Wrap the entire argument in

  154. parentheses for this to work.

  155. </p></li></ul>

  156. 

  157. <p><em>Note:</em> Only the <code>&lt;altivec.h&gt;</code> interface is supported.

  158. Internally, GCC uses built-in functions to achieve the functionality in

  159. the aforementioned header file, but they are not supported and are

  160. subject to change without notice.

  161. </p>

  162. <p>GCC complies with the OpenPOWER 64-Bit ELF V2 ABI Specification,

  163. which may be found at

  164. <a href="https://openpowerfoundation.org/?resource_lib=64-bit-elf-v2-abi-specification-power-architecture">https://openpowerfoundation.org/?resource_lib=64-bit-elf-v2-abi-specification-power-architecture</a>.

  165. Appendix A of this document lists the vector API interfaces that must be

  166. provided by compliant compilers.  Programmers should preferentially use

  167. the interfaces described therein.  However, historically GCC has provided

  168. additional interfaces for access to vector instructions.  These are

  169. briefly described below.

  170. </p>

  171. <table class="menu" border="0" cellspacing="0">

  172. <tr><td align="left" valign="top">&bull; <a href="PowerPC-AltiVec-Built_002din-Functions-on-ISA-2_002e05.html#PowerPC-AltiVec-Built_002din-Functions-on-ISA-2_002e05" accesskey="1">PowerPC AltiVec Built-in Functions on ISA 2.05</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">

  173. </td></tr>

  174. <tr><td align="left" valign="top">&bull; <a href="PowerPC-AltiVec-Built_002din-Functions-Available-on-ISA-2_002e06.html#PowerPC-AltiVec-Built_002din-Functions-Available-on-ISA-2_002e06" accesskey="2">PowerPC AltiVec Built-in Functions Available on ISA 2.06</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">

  175. </td></tr>

  176. <tr><td align="left" valign="top">&bull; <a href="PowerPC-AltiVec-Built_002din-Functions-Available-on-ISA-2_002e07.html#PowerPC-AltiVec-Built_002din-Functions-Available-on-ISA-2_002e07" accesskey="3">PowerPC AltiVec Built-in Functions Available on ISA 2.07</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">

  177. </td></tr>

  178. <tr><td align="left" valign="top">&bull; <a href="PowerPC-AltiVec-Built_002din-Functions-Available-on-ISA-3_002e0.html#PowerPC-AltiVec-Built_002din-Functions-Available-on-ISA-3_002e0" accesskey="4">PowerPC AltiVec Built-in Functions Available on ISA 3.0</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">

  179. </td></tr>

  180. </table>

  181. 

  182. <hr>

  183. <div class="header">

  184. <p>

  185. Next: <a href="PowerPC-Hardware-Transactional-Memory-Built_002din-Functions.html#PowerPC-Hardware-Transactional-Memory-Built_002din-Functions" accesskey="n" rel="next">PowerPC Hardware Transactional Memory Built-in Functions</a>, Previous: <a href="Basic-PowerPC-Built_002din-Functions.html#Basic-PowerPC-Built_002din-Functions" accesskey="p" rel="prev">Basic PowerPC 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>

  186. </div>

  187. 

  188. 

  189. 

  190. </body>

  191. </html>