1 files changed, 469 insertions, 0 deletions

diff --git a/doc/book-enea-linux-release-info/doc/about_release.xml b/doc/book-enea-linux-release-info/doc/about_release.xml
new file mode 100644
index 0000000..15d676c
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/about_release.xml
@@ -0,0 +1,469 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+<chapter id="relinfo-about-release">
+  <title>About This Release</title>
+
+  <para>This release of Enea Linux <xi:include
+  href="../../s_docsrc_common/pardoc-distro.xml"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xpointer="element(EneaLinux_REL_VER/1)" /> provides a publicly available
+  Enea Linux distribution for a selected set of targets. This release is
+  generated from the yocto distribution using the branch <xi:include
+  href="../../s_docsrc_common/pardoc-distro.xml"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xpointer="element(Yocto_NAME/1)" />.<remark>INFO Yocto distro autopicked
+  from poky.ent as DISTRO_NAME_NO_CAP</remark></para>
+
+  <section id="relinfo-provided-contents">
+    <title>Provided Contents</title>
+
+    <informaltable>
+      <tgroup cols="1">
+        <thead>
+          <row>
+            <entry>Item</entry>
+          </row>
+        </thead>
+
+        <tbody>
+          <row>
+            <entry><para>Source code, recipes, scripts, etc for building the
+            distro and SDKs. See <xref
+            linkend="relinfo-getting-enea-linux" />.</para></entry>
+          </row>
+
+          <row>
+            <entry><para>Documentation. See <xref
+            linkend="relinfo-documentation" />.</para></entry>
+          </row>
+
+          <row>
+            <entry>Pre-built binaries (kernel image, dtb &amp; rootfs)</entry>
+          </row>
+
+          <row>
+            <entry>Pre-built packages (RPM)</entry>
+          </row>
+
+          <row>
+            <entry>Eclipse executable plus development tools for command line
+            and Eclipse</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </informaltable>
+  </section>
+
+  <section id="relinfo-supported-targets">
+    <title>Supported Targets</title>
+
+    <informaltable>
+      <tgroup cols="3">
+        <colspec align="left" colname="c1" colwidth="1*" />
+
+        <colspec align="left" colname="c2" colwidth="1*" />
+
+        <colspec align="left" colname="c3" colwidth="1*" />
+
+        <thead valign="bottom">
+          <row>
+            <entry>Target</entry>
+
+            <entry>Architecture</entry>
+
+            <entry>Specification</entry>
+          </row>
+        </thead>
+
+        <tbody>
+          <row>
+            <entry>P2041RDB</entry>
+
+            <entry><para>Power, e500mc</para></entry>
+
+            <entry>See <ulink
+            url="http://www.nxp.com/products/microcontrollers-and-processors/power-architecture-processors/qoriq-power-architecture-processors/p2041-qoriq-reference-design-board:RDP2041BOARD">link
+            to NXP's datasheet</ulink></entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </informaltable>
+
+    <para><remark>FIXME should autocreate a list of targets, hopefully from
+    the generated README file, by using MAKEFILE to update pardoc-distro
+    AND/OR also auto-create an XML file to include here with description text
+    for each target etc..</remark></para>
+  </section>
+
+  <section id="relinfo-supported-host-environment">
+    <title>Supported Host Environment</title>
+
+    <itemizedlist>
+      <listitem>
+        <para>Ubuntu 14.04 LTS, 64-bit<remark>was
+        EneaLinux_HOST_VER</remark></para>
+      </listitem>
+    </itemizedlist>
+  </section>
+
+  <section id="relinfo-supported-versions">
+    <title>Supported Versions</title>
+
+    <informaltable>
+      <tgroup cols="2">
+        <thead valign="bottom">
+          <row>
+            <entry>Item</entry>
+
+            <entry>Version</entry>
+          </row>
+        </thead>
+
+        <tbody>
+          <row>
+            <entry><para>Yocto</para></entry>
+
+            <entry><xi:include href="../../s_docsrc_common/pardoc-distro.xml"
+            xmlns:xi="http://www.w3.org/2001/XInclude"
+            xpointer="element(Yocto_VER/1)" /> (<xi:include
+            href="../../s_docsrc_common/pardoc-distro.xml"
+            xmlns:xi="http://www.w3.org/2001/XInclude"
+            xpointer="element(Yocto_NAME/1)" />)<remark>INFO: Auto-fetched
+            from poky.ent via pardoc-distro.xml</remark></entry>
+          </row>
+
+          <row>
+            <entry>Poky source</entry>
+
+            <entry><xi:include href="../../s_docsrc_common/pardoc-distro.xml"
+            xmlns:xi="http://www.w3.org/2001/XInclude"
+            xpointer="element(Poky_VER/1)" /><remark>INFO: Auto-fetched from
+            poky.ent via pardoc-distro.xml</remark></entry>
+          </row>
+
+          <row>
+            <entry>GCC version</entry>
+
+            <entry>5.3<remark>was EneaLinux_GCC_VER Not in poky.ent
+            </remark></entry>
+          </row>
+
+          <row>
+            <entry>Linux kernel version<remark>was EneaLinux_KERNEL_VER Not in
+            poky.ent</remark></entry>
+
+            <entry><para>3.12 (P2041RDB &amp; LS1021a-IoT)</para><para>4.4
+            (QEmu targets)</para></entry>
+          </row>
+
+          <row>
+            <entry>Eclipse</entry>
+
+            <entry>4.5 (Mars)<remark>was Eclipse_VER and was Eclipse_NAME Not
+            in poky.ent</remark></entry>
+          </row>
+
+          <row>
+            <entry>Packages</entry>
+
+            <entry>See <xref linkend="relinfo-packages" /></entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </informaltable>
+  </section>
+
+  <section id="relinfo-packages">
+    <title>Provided Packages</title>
+
+    <para><informaltable>
+        <tgroup cols="2">
+          <colspec align="left" colname="c1" colwidth="3*" />
+
+          <colspec align="left" colname="c2" colwidth="6*" />
+
+          <thead valign="bottom">
+            <row>
+              <entry>Type of Packages and Provider</entry>
+
+              <entry>Reference</entry>
+            </row>
+          </thead>
+
+          <tbody>
+            <row>
+              <entry>Packages in Enea Linux images</entry>
+
+              <entry><para>See the <olink
+              targetdoc="book_enea_linux_open_source"
+              targetptr="book_enea_linux_open_source"><trademark
+              class="registered">Enea</trademark> Linux Open Source
+              Report</olink></para></entry>
+            </row>
+
+            <row>
+              <entry>Tools in the Eclipse tarball provided with Enea
+              Linux</entry>
+
+              <entry><para>See the <olink
+              targetdoc="book_enea_linux_eclipse_open_source"
+              targetptr="book_enea_linux_eclipse_open_source"><trademark
+              class="registered">Enea</trademark> Linux Eclipse Open Source
+              Report</olink></para></entry>
+            </row>
+
+            <row>
+              <entry>Packages provided by Yocto</entry>
+
+              <entry><para>See the Yocto "Release Notes" <xi:include
+              href="../../docsrc_common/pardoc-distro.xml"
+              xmlns:xi="http://www.w3.org/2001/XInclude"
+              xpointer="element(ULINK_YOCTO_RELEASE_NOTES/1)" /></para></entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </informaltable></para>
+  </section>
+
+  <section id="relinfo-provided-sdk">
+    <title>Provided Toolchain/s (SDK)</title>
+
+    <para>The SDK contains toolchains supporting cross-compilation of
+    applications for the targets on an x86_64 host. See the <olink
+    targetdoc="book_enea_linux_app_dev_guide"
+    targetptr="book_enea_linux_app_dev_guide"><trademark
+    class="registered">Enea</trademark> Linux Application Development
+    Guide</olink> for information on how to build and install a
+    toolchain.</para>
+  </section>
+
+  <section id="relinfo-provided-drivers">
+    <title>Supported Drivers</title>
+
+    <informaltable>
+      <tgroup cols="2">
+        <colspec align="left" colwidth="3*" />
+
+        <colspec align="center" colwidth="2*" />
+
+        <thead>
+          <row>
+            <entry>Driver</entry>
+
+            <entry>P2041RDB</entry>
+          </row>
+        </thead>
+
+        <tbody>
+          <row>
+            <entry>Ethernet</entry>
+
+            <entry>X</entry>
+          </row>
+
+          <row>
+            <entry>I2C</entry>
+
+            <entry>X</entry>
+          </row>
+
+          <row>
+            <entry>SPI</entry>
+
+            <entry>X</entry>
+          </row>
+
+          <row>
+            <entry>PCI Express</entry>
+
+            <entry>X</entry>
+          </row>
+
+          <row>
+            <entry>USB</entry>
+
+            <entry>X</entry>
+          </row>
+
+          <row>
+            <entry>Flash</entry>
+
+            <entry>X</entry>
+          </row>
+
+          <row>
+            <entry>SD/SDHC/SDXC</entry>
+
+            <entry>X</entry>
+          </row>
+
+          <row>
+            <entry>RTC</entry>
+
+            <entry>X</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </informaltable>
+  </section>
+
+  <section id="relinfo-documentation">
+    <title>Provided Documentation</title>
+
+    <para>The following Enea Linux manuals are available:</para>
+
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>README.htm - top page of the documentation<remark>FIXME Needs to
+        be fixed (= created and added to make dist). OR remove this
+        line?</remark></para>
+      </listitem>
+
+      <listitem>
+        <para>README - text files describing various details like build- and
+        boot-commands - the commands are also seen in <xref
+        linkend="relinfo-build-boot" />.</para>
+      </listitem>
+
+      <listitem>
+        <para><trademark class="registered">Enea</trademark> Linux Release
+        Information (this document)</para>
+      </listitem>
+
+      <listitem>
+        <para><olink targetdoc="book_enea_linux_open_source"
+        targetptr="book_enea_linux_open_source"><trademark
+        class="registered">Enea</trademark> Linux Open Source
+        Report</olink></para>
+      </listitem>
+
+      <listitem>
+        <para><olink targetdoc="book_enea_linux_eclipse_open_source"
+        targetptr="book_enea_linux_eclipse_open_source"><trademark
+        class="registered">Enea</trademark> Linux Eclipse Open Source
+        Report</olink></para>
+      </listitem>
+
+      <listitem>
+        <para><olink targetdoc="book_enea_linux_platforms_dev_guide"
+        targetptr="book_enea_linux_platforms_dev_guide"><trademark
+        class="registered">Enea</trademark> Linux Platforms Development
+        Guide</olink> - Generic version included in this distribution</para>
+      </listitem>
+
+      <listitem>
+        <para><olink targetdoc="book_enea_linux_app_dev_guide"
+        targetptr="book_enea_linux_app_dev_guide"><trademark
+        class="registered">Enea</trademark> Linux Application Development
+        Guide</olink> - Generic version included in this distribution</para>
+      </listitem>
+
+      <listitem>
+        <para><emphasis role="bold"><trademark
+        class="registered">Enea</trademark> Linux Real-Time Guide</emphasis>
+        can be read at <ulink
+        url="http://linuxrealtime.org">http://linuxrealtime.org</ulink>.</para>
+      </listitem>
+    </itemizedlist>
+
+    <para>In addition to the local versions of the generic guides reached via
+    the above links, you can also read the latest versions via the direct
+    online links below. When accessing them via the links below, you need to
+    logon to the portal.enea.com. These online versions may be
+    updated/improved asynchronously with the releases.<remark>INFO: Should be
+    accessable to all customer's with Enea Linux 6 or later</remark>
+    <remark>INFO: On portal, generic guides can NOT link TO the distro
+    specific guides, but the distro specific guides can link to the generic -
+    HOWEVER these links (found above) will go to the versions inside the
+    delivery, instead of to the latest versions.</remark></para>
+
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para><ulink
+        url="https://portal.enea.com/wp-content/uploads/_mediavault/book-enea-linux-application-dev-guide.pdf">Enea
+        Linux Application Development Guide</ulink> - Latest generic version
+        online</para>
+      </listitem>
+
+      <listitem>
+        <para><ulink
+        url="https://portal.enea.com/wp-content/uploads/_mediavault/book-enea-linux-platforms-dev-guide.pdf">Enea
+        Linux Platforms Development Guide</ulink> - Latest generic version
+        online</para>
+      </listitem>
+    </itemizedlist>
+
+    <para>How to use Eclipse is described inside the Enea Linux user's guides.
+    Eclipse's own documentation is available in directory
+    <filename>eclipse/readme</filename>.</para>
+  </section>
+
+  <section id="relinfo-provided-other">
+    <title>Other Provided Functionality</title>
+
+    <para>The functionality in a distribution depends on included packages in
+    the default image. In addition to the supported features, the following
+    functionality is also available, among other:</para>
+
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>On target T4240RDB:</para>
+
+        <itemizedlist spacing="compact">
+          <listitem>
+            <para>SRIO support in user space (NWRITE, NREAD, msg,
+            doorbell)</para>
+          </listitem>
+
+          <listitem>
+            <para>USDPAA</para>
+          </listitem>
+        </itemizedlist>
+      </listitem>
+
+      <listitem>
+        <para>Smart Package Management</para>
+      </listitem>
+
+      <listitem>
+        <para>Eclipse ADT (excl. QEMU) and plug-ins for application
+        development: LTTng, Perf, LatencyTOP, PowerTOP, SystemTap</para>
+      </listitem>
+    </itemizedlist>
+  </section>
+
+  <section id="relinfo-security-fixes">
+    <title>Security Fixes</title>
+
+    <para>See <ulink
+    url="http://www.enea.com/solutions/Enea-Linux/Security/CVEs-list">List of
+    CVEs addressed in Enea Linux</ulink> and <ulink
+    url="http://www.enea.com/solutions/Enea-Linux/Security#how-to-get-security-updates">How
+    to Get Security Updates</ulink>.</para>
+  </section>
+
+  <section id="relinfo-excluded">
+    <title>Intentional Limitations</title>
+
+    <para>The following functionality supported in other Enea Linux releases
+    has been excluded in this release:<itemizedlist spacing="compact">
+        <listitem>
+          <para>Eclipse plug-ins for image creation (HOB)</para>
+        </listitem>
+
+        <listitem>
+          <para>Networking features: DPDK vSwitch, DPDK</para>
+        </listitem>
+
+        <listitem>
+          <para>Real-time features: Fully Preemptible Kernel (FPK) from the
+          PREEMPT_RT patch</para>
+        </listitem>
+
+        <listitem>
+          <para>Memory features: NUMA</para>
+        </listitem>
+      </itemizedlist></para>
+  </section>
+</chapter>
\ No newline at end of file