[dpdk-dev] doc: Add IBM Power description to linux guides
Commit Message
This patch added IBM ppc_64 descriptions, including architecture
support, compiling requirements on Linux.
Signed-off-by: Chao Zhu <chaozhu@linux.vnet.ibm.com>
---
doc/guides/linux_gsg/build_dpdk.rst | 4 +-
doc/guides/linux_gsg/quick_start.rst | 40 +++++++++++++++++----------------
doc/guides/linux_gsg/sys_reqs.rst | 29 ++++++++++++++++--------
3 files changed, 42 insertions(+), 31 deletions(-)
Comments
> -----Original Message-----
> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Chao Zhu
> Sent: Saturday, December 13, 2014 3:06 AM
> To: dev@dpdk.org
> Subject: [dpdk-dev] [PATCH] doc: Add IBM Power description to linux guides
>
> 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>
I have applied the patch to my tree next/dpdk-doc.
@@ -66,9 +66,9 @@ The format of a Intel® DPDK target is:
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
@@ -132,29 +132,31 @@ Some options in the script prompt the user for further data before proceeding.
[7] x86_64-native-linuxapp-icc
+ [8] ppc_64-power8-linuxapp-gcc
+
------------------------------------------------------------------------
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:
@@ -38,8 +38,8 @@ This chapter describes the packages required to compile the Intel® DPDK.
If the Intel® 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 Intel® DPDK functionality.
However, for additional HPET timer and power management functionality,
@@ -61,18 +61,22 @@ Compilation of the Intel® DPDK
* 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:
- 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 Intel® DPDK package
@@ -83,6 +87,10 @@ Compilation of the Intel® DPDK
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.
@@ -171,8 +179,9 @@ For example, to reserve 4G of hugepage memory in the form of four 1G pages, the
.. 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.
+ On IBM Power architecture, the supported hugepage sizes are 16MB and 16GB.
.. note::