From: Chao Zhu Date: Sat, 13 Dec 2014 03:06:10 +0000 (+0800) Subject: doc: add IBM Power description to linux guide X-Git-Tag: spdx-start~9875 X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=df6aaab37f7364a5432506fb93406027f5524cbd;p=dpdk.git 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 Acked-by: Bernard Iremonger --- diff --git a/doc/guides/linux_gsg/build_dpdk.rst b/doc/guides/linux_gsg/build_dpdk.rst index 23421516f2..d09c69db54 100644 --- 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: -* 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 diff --git a/doc/guides/linux_gsg/quick_start.rst b/doc/guides/linux_gsg/quick_start.rst index 560ee31888..a22d994cb8 100644 --- 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 + [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: diff --git a/doc/guides/linux_gsg/sys_reqs.rst b/doc/guides/linux_gsg/sys_reqs.rst index 17d1ebf72b..8e2307b9b5 100644 --- 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*. -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, @@ -61,18 +61,22 @@ Compilation of the 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 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. +* 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::