doc: add IBM Power description to linux guide

This patch added IBM ppc_64 descriptions, including architecture
support, compiling requirements on Linux.

Signed-off-by: Chao Zhu <chaozhu@linux.vnet.ibm.com>
Acked-by: Bernard Iremonger <bernard.iremonger@intel.com>

diff --git a/doc/guides/linux_gsg/build_dpdk.rst b/doc/guides/linux_gsg/build_dpdk.rst
index 2342151..d09c69d 100644 (file)
--- a/doc/guides/linux_gsg/build_dpdk.rst
+++ b/doc/guides/linux_gsg/build_dpdk.rst
@@ -66,9 +66,9 @@ The format of a DPDK target is:
 
 where:
 
 
 where:
 

-*   ARCH can be:  i686, x86_64
+*   ARCH can be:  i686, x86_64, ppc_64

 
 

-*   MACHINE can be:  native, ivshmem
+*   MACHINE can be:  native, ivshmem, power8

 
 *   EXECENV can be:  linuxapp,  bsdapp
 
 
 *   EXECENV can be:  linuxapp,  bsdapp
 

diff --git a/doc/guides/linux_gsg/quick_start.rst b/doc/guides/linux_gsg/quick_start.rst
index 560ee31..a22d994 100644 (file)
--- a/doc/guides/linux_gsg/quick_start.rst
+++ b/doc/guides/linux_gsg/quick_start.rst
@@ -132,29 +132,31 @@ Some options in the script prompt the user for further data before proceeding.
 
     [7] x86_64-native-linuxapp-icc
 
 
     [7] x86_64-native-linuxapp-icc
 

+    [8] ppc_64-power8-linuxapp-gcc
+

     ------------------------------------------------------------------------
 
     Step 2: Setup linuxapp environment
 
     ------------------------------------------------------------------------
 
     ------------------------------------------------------------------------
 
     Step 2: Setup linuxapp environment
 
     ------------------------------------------------------------------------
 

-    [8] Insert IGB UIO module
+    [9] Insert IGB UIO module

 
 

-    [9] Insert VFIO module
+    [10] Insert VFIO module

 
 

-    [10] Insert KNI module
+    [11] Insert KNI module

 
 

-    [11] Setup hugepage mappings for non-NUMA systems
+    [12] Setup hugepage mappings for non-NUMA systems

 
 

-    [12] Setup hugepage mappings for NUMA systems
+    [13] Setup hugepage mappings for NUMA systems

 
 

-    [13] Display current Ethernet device settings
+    [14] Display current Ethernet device settings

 
 

-    [14] Bind Ethernet device to IGB UIO module
+    [15] Bind Ethernet device to IGB UIO module

 
 

-    [15] Bind Ethernet device to VFIO module
+    [16] Bind Ethernet device to VFIO module

 
 

-    [16] Setup VFIO permissions
+    [17] Setup VFIO permissions

 
     ------------------------------------------------------------------------
 
 
     ------------------------------------------------------------------------
 


@@ -162,9 +164,9 @@ Some options in the script prompt the user for further data before proceeding.
 
     ------------------------------------------------------------------------
 
 
     ------------------------------------------------------------------------
 

-    [17] Run test application ($RTE_TARGET/app/test)
+    [18] Run test application ($RTE_TARGET/app/test)

 
 

-    [18] Run testpmd application in interactive mode ($RTE_TARGET/app/testpmd)
+    [19] Run testpmd application in interactive mode ($RTE_TARGET/app/testpmd)

 
     ------------------------------------------------------------------------
 
 
     ------------------------------------------------------------------------
 


@@ -172,7 +174,7 @@ Some options in the script prompt the user for further data before proceeding.
 
     ------------------------------------------------------------------------
 
 
     ------------------------------------------------------------------------
 

-    [19] List hugepage info from /proc/meminfo
+    [20] List hugepage info from /proc/meminfo

 
     ------------------------------------------------------------------------
 
 
     ------------------------------------------------------------------------
 


@@ -180,19 +182,19 @@ Some options in the script prompt the user for further data before proceeding.
 
     ------------------------------------------------------------------------
 
 
     ------------------------------------------------------------------------
 

-    [20] Uninstall all targets
+    [21] Uninstall all targets

 
 

-    [21] Unbind NICs from IGB UIO driver
+    [22] Unbind NICs from IGB UIO driver

 
 

-    [22] Remove IGB UIO module
+    [23] Remove IGB UIO module

 
 

-    [23] Remove VFIO module
+    [24] Remove VFIO module

 
 

-    [24] Remove KNI module
+    [25] Remove KNI module

 
 

-    [25] Remove hugepage mappings
+    [26] Remove hugepage mappings

 
 

-    [26] Exit Script
+    [27] Exit Script

 
 Option:
 
 
 Option:
 

diff --git a/doc/guides/linux_gsg/sys_reqs.rst b/doc/guides/linux_gsg/sys_reqs.rst
index 17d1ebf..8e2307b 100644 (file)
--- a/doc/guides/linux_gsg/sys_reqs.rst
+++ b/doc/guides/linux_gsg/sys_reqs.rst
@@ -38,8 +38,8 @@ This chapter describes the packages required to compile the DPDK.
     If the DPDK is being used on an Intel® Communications Chipset 89xx Series platform,
     please consult the *Intel® Communications Chipset 89xx Series Software for Linux* Getting Started Guide*.
 
     If the DPDK is being used on an Intel® Communications Chipset 89xx Series platform,
     please consult the *Intel® Communications Chipset 89xx Series Software for Linux* Getting Started Guide*.
 

-BIOS Setting Prerequisite
--------------------------
+BIOS Setting Prerequisite on x86
+--------------------------------

 
 For the majority of platforms, no special BIOS settings are needed to use basic DPDK functionality.
 However, for additional HPET timer and power management functionality,
 
 For the majority of platforms, no special BIOS settings are needed to use basic DPDK functionality.
 However, for additional HPET timer and power management functionality,


@@ -61,18 +61,22 @@ Compilation of the DPDK
 
 *   coreutils:  cmp, sed, grep, arch
 
 
 *   coreutils:  cmp, sed, grep, arch
 

-*   gcc: versions 4.5.x or later is recommended.
-    On some distributions, some specific compiler flags and linker flags are enabled by default and
-    affect performance (- fstack-protector, for example).
-    Please refer to the documentation of your distribution and to gcc -dumpspecs.
+*   gcc: versions 4.5.x or later is recommended for i686/x86_64. versions 4.8.x or later is recommanded
+    for ppc_64. On some distributions, some specific compiler flags and linker flags are enabled by
+    default and affect performance (- fstack-protector, for example). Please refer to the documentation
+    of your distribution and to gcc -dumpspecs.

 
 

-*   libc headers (glibc-devel.i686 / libc6-dev-i386; glibc-devel.x86_64  for 64-bit compilation)
+*   libc headers (glibc-devel.i686 / libc6-dev-i386; glibc-devel.x86_64 for 64-bit compilation on Intel
+    architecture; glibc-devel.ppc64 for 64 bit IBM Power architecture;)

 
 

-*   Linux kernel headers or sources required to build kernel modules. (kernel- devel.x86_64)
+*   Linux kernel headers or sources required to build kernel modules. (kernel - devel.x86_64;
+    kernel - devel.ppc64)

 
 *   Additional packages required for 32-bit compilation on 64-bit systems are:
 
 
 *   Additional packages required for 32-bit compilation on 64-bit systems are:
 

-    glibc.i686, libgcc.i686, libstdc++.i686 and glibc-devel.i686
+    glibc.i686, libgcc.i686, libstdc++.i686 and glibc-devel.i686 for Intel i686/x86_64;
+
+    glibc.ppc64, libgcc.ppc64, libstdc++.ppc64 and glibc-devel.ppc64 for IBM ppc_64;

 
 *   Python, version 2.6 or 2.7, to use various helper scripts included in the DPDK package
 
 
 *   Python, version 2.6 or 2.7, to use various helper scripts included in the DPDK package
 


@@ -83,6 +87,10 @@ Compilation of the DPDK
     See the icc Installation Guide found in the Documentation directory under the compiler installation.
     This release has been tested using version 12.1.
 
     See the icc Installation Guide found in the Documentation directory under the compiler installation.
     This release has been tested using version 12.1.
 

+*   IBM® Advance ToolChain for Powerlinux. This is a set of open source development tools and runtime libraries
+    which allows users to take leading edge advantage of IBM's latest POWER hardware features on Linux. To install
+    it, see the IBM official installation document.
+

 *   libpcap headers and libraries (libpcap-devel) to compile and use the libpcap-based poll-mode driver.
     This driver is disabled by default and can be enabled by setting CONFIG_RTE_LIBRTE_PMD_PCAP=y in the build time config file.
 
 *   libpcap headers and libraries (libpcap-devel) to compile and use the libpcap-based poll-mode driver.
     This driver is disabled by default and can be enabled by setting CONFIG_RTE_LIBRTE_PMD_PCAP=y in the build time config file.
 


@@ -171,8 +179,9 @@ For example, to reserve 4G of hugepage memory in the form of four 1G pages, the
 
 .. note::
 
 
 .. note::
 

-    The hugepage sizes that a CPU supports can be determined from the CPU flags.
+    The hugepage sizes that a CPU supports can be determined from the CPU flags on Intel architecture.

     If pse exists, 2M hugepages are supported; if pdpe1gb exists, 1G hugepages are supported.
     If pse exists, 2M hugepages are supported; if pdpe1gb exists, 1G hugepages are supported.

+    On IBM Power architecture, the supported hugepage sizes are 16MB and 16GB.

 
 .. note::
 
 
 .. note::