From mboxrd@z Thu Jan 1 00:00:00 1970 From: Kevin Traynor Subject: Re: [PATCH] doc: document libnuma requirement for NUMA systems Date: Thu, 31 Jan 2019 18:14:51 +0000 Message-ID: References: <93e6481f516c2549308e0745388a0bd80b44e783.1548954304.git.anatoly.burakov@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Cc: John McNamara , Marko Kovacevic , thomas@monjalon.net, "stable@dpdk.org" To: Anatoly Burakov , dev@dpdk.org Return-path: In-Reply-To: <93e6481f516c2549308e0745388a0bd80b44e783.1548954304.git.anatoly.burakov@intel.com> Content-Language: en-US List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" On 01/31/2019 05:05 PM, Anatoly Burakov wrote: > 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 > Might as well add to the stable docs also. Picking this commit as it's where both mode are available Fixes: 6b42f75632f0 ("eal: enable non-legacy memory mode") Cc: stable@dpdk.org > 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. > > > Acked-by: Kevin Traynor