From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by dpdk.org (Postfix) with ESMTP id 44FDE1B1F5 for ; Thu, 31 Jan 2019 18:05:55 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga005.jf.intel.com ([10.7.209.41]) by fmsmga101.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 31 Jan 2019 09:05:54 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.56,545,1539673200"; d="scan'208";a="296206421" Received: from irvmail001.ir.intel.com ([163.33.26.43]) by orsmga005.jf.intel.com with ESMTP; 31 Jan 2019 09:05:52 -0800 Received: from sivswdev05.ir.intel.com (sivswdev05.ir.intel.com [10.243.17.64]) by irvmail001.ir.intel.com (8.14.3/8.13.6/MailSET/Hub) with ESMTP id x0VH5pp6017449; Thu, 31 Jan 2019 17:05:52 GMT Received: from sivswdev05.ir.intel.com (localhost [127.0.0.1]) by sivswdev05.ir.intel.com with ESMTP id x0VH5pAf027961; Thu, 31 Jan 2019 17:05:51 GMT Received: (from aburakov@localhost) by sivswdev05.ir.intel.com with LOCAL id x0VH5pZR027957; Thu, 31 Jan 2019 17:05:51 GMT From: Anatoly Burakov To: dev@dpdk.org Cc: John McNamara , Marko Kovacevic , thomas@monjalon.net Date: Thu, 31 Jan 2019 17:05:51 +0000 Message-Id: <93e6481f516c2549308e0745388a0bd80b44e783.1548954304.git.anatoly.burakov@intel.com> X-Mailer: git-send-email 1.7.0.7 Subject: [dpdk-dev] [PATCH] doc: document libnuma requirement for NUMA systems X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 31 Jan 2019 17:05:55 -0000 Since 18.05, libnuma is pretty much required on Linux when using non-legacy mode, because without it, we cannot know where our hugepages are located [1]. In legacy mode, libnuma is not required because we can still sort pages by sockets, as we use pagemap lookup method to figure out socket ID's for pages. So, document libnuma as required for NUMA systems and non-legacy mode. [1] https://mails.dpdk.org/archives/dev/2018-December/120490.html Signed-off-by: Anatoly Burakov --- doc/guides/linux_gsg/sys_reqs.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/guides/linux_gsg/sys_reqs.rst b/doc/guides/linux_gsg/sys_reqs.rst index 8ec3af491..23cfc27ab 100644 --- a/doc/guides/linux_gsg/sys_reqs.rst +++ b/doc/guides/linux_gsg/sys_reqs.rst @@ -70,6 +70,14 @@ Compilation of the DPDK * libnuma-dev in Debian/Ubuntu; + .. note:: + + On systems with NUMA support, `libnuma-dev` (aka `numactl-devel`) is a + recommended dependency when `--legacy-mem` switch is used, and a + *required* dependency if default memory mode is used. While DPDK will + compile and run without `libnuma` even on NUMA-enabled systems, both + usability and performance will be degraded. + * Python, version 2.7+ or 3.2+, to use various helper scripts included in the DPDK package. -- 2.17.1