X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Flinux_gsg%2Fsys_reqs.rst;h=ebed418d15b50119bd85fc46487bc6bf57154d49;hb=4d4ebca430474180cdc5cb14edfda04ee4189d19;hp=17d1ebf72bab274636ca842cebe6bc26a6712af6;hpb=2e486e26328cd2b6c78412f69f5609a278bf78f9;p=dpdk.git diff --git a/doc/guides/linux_gsg/sys_reqs.rst b/doc/guides/linux_gsg/sys_reqs.rst index 17d1ebf72b..ebed418d15 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,20 +61,31 @@ 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 recommended + for ppc_64 and x86_x32 ABI. 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; + +.. note:: + + x86_x32 ABI is currently supported with distribution packages only on Ubuntu + higher than 13.10 or recent Debian distribution. The only supported compiler is gcc 4.8+. + +.. note:: -* 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 **Optional Tools:** @@ -83,6 +94,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. @@ -106,7 +121,7 @@ System Software For details of the patches needed to use the DPDK with earlier kernel versions, see the DPDK FAQ included in the *DPDK Release Notes*. -Note also that Redhat* Linux* 6.2 and 6.3 uses a 2.6.32 kernel that already has all the necessary patches applied. +Note also that Red hat* Linux* 6.2 and 6.3 uses a 2.6.32 kernel that already has all the necessary patches applied. * glibc >= 2.7 (for features related to cpuset) @@ -124,7 +139,7 @@ Note also that Redhat* Linux* 6.2 and 6.3 uses a 2.6.32 kernel that already has * Kernel configuration - In the Fedora* OS and other common distributions, such as Ubuntu*, or RedHat Enterprise Linux*, + In the Fedora* OS and other common distributions, such as Ubuntu*, or Red Hat Enterprise Linux*, the vendor supplied kernel configurations can be used to run most DPDK applications. For other kernel builds, options which should be enabled for DPDK include: @@ -171,8 +186,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::