|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
<!--
|
|
|
Copyright (c) 2017 OpenPOWER Foundation
|
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
you may not use this file except in compliance with the License.
|
|
|
You may obtain a copy of the License at
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
See the License for the specific language governing permissions and
|
|
|
limitations under the License.
|
|
|
|
|
|
-->
|
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
|
version="5.0"
|
|
|
xml:id="sec_prepare">
|
|
|
<title>Prepare yourself</title>
|
|
|
|
|
|
<para>To port Intel intrinsics to POWER you will need to prepare yourself
|
|
|
with knowledge of PowerISA vector facilities and how to access the associated
|
|
|
documentation.</para>
|
|
|
|
|
|
<itemizedlist spacing="compact">
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<link xlink:href="https://gcc.gnu.org/onlinedocs/gcc-6.3.0/gcc/Vector-Extensions.html#Vector-Extensions"><emphasis role="italic">GCC vector extension</emphasis></link>
|
|
|
syntax and usage. This is one of a set of GCC
|
|
|
"<link xlink:href="https://gcc.gnu.org/onlinedocs/gcc-6.3.0/gcc/C-Extensions.html#C-Extensions"><emphasis role="italic">Extensions to the C language Family</emphasis></link>”
|
|
|
that the intrinsic header implementation depends
|
|
|
on. As many of the GCC intrinsics for x86 are implemented via C vector
|
|
|
extensions, reading and understanding of this code is an important part of the
|
|
|
porting process. </para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>Intel (x86) intrinsic and type naming conventions and how to find
|
|
|
more information. The intrinsic name encodes some information about the
|
|
|
vector size and type of the data, but the pattern is not always obvious.
|
|
|
Using the online
|
|
|
<link xlink:href="https://software.intel.com/sites/landingpage/IntrinsicsGuide/#">Intel
|
|
|
Intrinsic Guide</link> to look up the intrinsic by name is a good first
|
|
|
step.</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>PowerISA Vector facilities. The Vector facilities of POWER8 are
|
|
|
extensive and cover the usual types and usual operations. However it has a
|
|
|
different history and organization from Intel. Both (Intel and PowerISA) have
|
|
|
their quirks and in some cases the mapping may not be obvious. So familiarizing
|
|
|
yourself with the PowerISA Vector (VMX) and Vector Scalar Extensions (VSX) is
|
|
|
important.</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
<xi:include href="sec_gcc_vector_extensions.xml"/>
|
|
|
<xi:include href="sec_intel_intrinsic_functions.xml"/>
|
|
|
<xi:include href="sec_powerisa_vector_facilities.xml"/>
|
|
|
<xi:include href="sec_more_examples.xml"/>
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|