|
|
<?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_review_source">
|
|
|
<title>Look at the source, Luke</title>
|
|
|
|
|
|
<para>So if this is a code porting activity, where is the source? All the
|
|
|
source code we need to look at is in the GCC source trees. You can either git
|
|
|
(<link xlink:href="https://gcc.gnu.org/wiki/GitMirror">https://gcc.gnu.org/wiki/GitMirro</link>)
|
|
|
the gcc source or download one of the
|
|
|
recent AT source tars (for example:
|
|
|
<link xlink:href="ftp://ftp.unicamp.br/pub/linuxpatch/toolchain/at/ubuntu/dists/xenial/at10.0/">ftp://ftp.unicamp.br/pub/linuxpatch/toolchain/at/ubuntu/dists/xenial/at10.0/</link>).
|
|
|
You will find the intrinsic headers in the ./gcc/config/i386/
|
|
|
sub-directory.</para>
|
|
|
|
|
|
<para>If you have an Intel Linux workstation or laptop with GCC installed,
|
|
|
you already have these headers, if you want to take a look:
|
|
|
<screen><prompt>$ </prompt><userinput>find /usr/lib -name '*mmintrin.h'</userinput>
|
|
|
/usr/lib/gcc/x86_64-redhat-linux/4.4.4/include/wmmintrin.h
|
|
|
/usr/lib/gcc/x86_64-redhat-linux/4.4.4/include/mmintrin.h
|
|
|
/usr/lib/gcc/x86_64-redhat-linux/4.4.4/include/xmmintrin.h
|
|
|
/usr/lib/gcc/x86_64-redhat-linux/4.4.4/include/emmintrin.h
|
|
|
/usr/lib/gcc/x86_64-redhat-linux/4.4.4/include/tmmintrin.h
|
|
|
...
|
|
|
<prompt>$ </prompt></screen></para>
|
|
|
|
|
|
<para>But depending on the vintage of the distro, these may not be the
|
|
|
latest versions of the headers. Looking at the header source will tell you a
|
|
|
few things: the include structure (what other headers are implicitly
|
|
|
included), the types that are used at the API, and finally, how the API is
|
|
|
implemented.</para>
|
|
|
|
|
|
<para><literallayout>smmintrin.h (SSE4.1) includes tmmintrin,h
|
|
|
tmmintrin.h (SSSE3) includes pmmintrin.h
|
|
|
pmmintrin.h (SSE3) includes emmintrin,h
|
|
|
emmintrin.h (SSE2) includes xmmintrin.h
|
|
|
xmmintrin.h (SSE) includes mmintrin.h and mm_malloc.h
|
|
|
mmintrin.h (MMX)</literallayout></para>
|
|
|
|
|
|
<xi:include href="sec_intel_intrinsic_includes.xml"/>
|
|
|
<xi:include href="sec_intel_intrinsic_types.xml"/>
|
|
|
<xi:include href="sec_api_implemented.xml"/>
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|