patch 'doc: add Linux capability to access physical addresses' has been queued to stable release 20.11.8

[luca.boccassi at gmail.com]

Hi,

FYI, your patch has been queued to stable release 20.11.8

Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet.
It will be pushed if I get no objections before 03/31/23. So please
shout if anyone has objections.

Also note that after the patch there's a diff of the upstream commit vs the
patch applied to the branch. This will indicate if there was any rebasing
needed to apply to the stable branch. If there were code changes for rebasing
(ie: not only metadata diffs), please double check that the rebase was
correctly done.

Queued patches are on a temporary branch at:
https://github.com/bluca/dpdk-stable

This queued commit can be viewed at:
https://github.com/bluca/dpdk-stable/commit/63b77fc9ff6b16ec6834fb340daf1d4d5f1b9836

Thanks.

Luca Boccassi

---
>From 63b77fc9ff6b16ec6834fb340daf1d4d5f1b9836 Mon Sep 17 00:00:00 2001
From: Dmitry Kozlyuk <dmitry.kozliuk at gmail.com>
Date: Fri, 20 Jan 2023 00:24:24 +0300
Subject: [PATCH] doc: add Linux capability to access physical addresses

[ upstream commit 50b567c66da268bcc7206dab92f690148d57ad8f ]

DAC_READ_SEARCH or DAC_OVERRIDE capability is required to access
/proc/self/pagemap, but the Linux guide mentioned neither one.
Recommend DAC_READ_SEARCH as less impactful.

Fixes: 979bb5d493fb ("doc: add more instructions for running as non-root")

Reported-by: Boris Ouretskey <borisusun at gmail.com>
Reported-by: Isaac Boukris <iboukris at gmail.com>
Signed-off-by: Dmitry Kozlyuk <dmitry.kozliuk at gmail.com>
---
 doc/guides/linux_gsg/enable_func.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/guides/linux_gsg/enable_func.rst b/doc/guides/linux_gsg/enable_func.rst
index 7538d04d97..6e556bf51d 100644
--- a/doc/guides/linux_gsg/enable_func.rst
+++ b/doc/guides/linux_gsg/enable_func.rst
@@ -106,12 +106,12 @@ Refer to the `documentation <https://www.kernel.org/doc/Documentation/vm/hugetlb
 If the driver requires using physical addresses (PA),
 the executable file must be granted additional capabilities:
 
-* ``SYS_ADMIN`` to read ``/proc/self/pagemaps``
+* ``DAC_READ_SEARCH`` and ``SYS_ADMIN`` to read ``/proc/self/pagemaps``
 * ``IPC_LOCK`` to lock hugepages in memory
 
 .. code-block:: console
 
-   setcap cap_ipc_lock,cap_sys_admin+ep <executable>
+   setcap cap_dac_read_search,cap_ipc_lock,cap_sys_admin+ep <executable>
 
 If physical addresses are not accessible,
 the following message will appear during EAL initialization::
-- 
2.39.2

---
  Diff of the applied patch vs upstream commit (please double-check if non-empty:
---
--- -	2023-03-29 01:31:23.065174052 +0100
+++ 0010-doc-add-Linux-capability-to-access-physical-addresse.patch	2023-03-29 01:31:22.510040059 +0100
@@ -1 +1 @@
-From 50b567c66da268bcc7206dab92f690148d57ad8f Mon Sep 17 00:00:00 2001
+From 63b77fc9ff6b16ec6834fb340daf1d4d5f1b9836 Mon Sep 17 00:00:00 2001
@@ -5,0 +6,2 @@
+[ upstream commit 50b567c66da268bcc7206dab92f690148d57ad8f ]
+
@@ -11 +12,0 @@
-Cc: stable at dpdk.org
@@ -17 +17,0 @@
- .mailmap                             | 2 ++
@@ -19 +19 @@
- 2 files changed, 4 insertions(+), 2 deletions(-)
+ 1 file changed, 2 insertions(+), 2 deletions(-)
@@ -21,20 +20,0 @@
-diff --git a/.mailmap b/.mailmap
-index cac02a6f48..0859104404 100644
---- a/.mailmap
-+++ b/.mailmap
-@@ -171,6 +171,7 @@ Björn Töpel <bjorn.topel at intel.com>
- Bo Chen <box.c.chen at intel.com>
- Boleslav Stankevich <boleslav.stankevich at oktetlabs.ru>
- Boon Ang <bang at vmware.com>
-+Boris Ouretskey <borisusun at gmail.com>
- Boris Pismenny <borisp at mellanox.com>
- Brandon Lo <blo at iol.unh.edu>
- Brendan Ryan <brendan.ryan at intel.com>
-@@ -534,6 +535,7 @@ Ilya Maximets <i.maximets at ovn.org> <i.maximets at samsung.com>
- Ilya V. Matveychikov <matvejchikov at gmail.com>
- Ilyes Ben Hamouda <ilyes.ben_hamouda at 6wind.com>
- Intiyaz Basha <intiyaz.basha at caviumnetworks.com>
-+Isaac Boukris <iboukris at gmail.com>
- Itsuro Oda <oda at valinux.co.jp>
- Ivan Boule <ivan.boule at 6wind.com>
- Ivan Dyukov <i.dyukov at samsung.com>
@@ -42 +22 @@
-index 829084d80e..2344d97403 100644
+index 7538d04d97..6e556bf51d 100644
@@ -45 +25 @@
-@@ -55,12 +55,12 @@ Refer to the `documentation <https://www.kernel.org/doc/Documentation/vm/hugetlb
+@@ -106,12 +106,12 @@ Refer to the `documentation <https://www.kernel.org/doc/Documentation/vm/hugetlb