Skip to contentSkip to conversation

doc: add capability to access physical addresses

PATCH Applied Dmitry Kozlyuk 2 participants 2 messages Jan 19, 2023 – Mar 28, 2023

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: add capability to access physical addresses

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")
---
 doc/guides/linux_gsg/enable_func.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
doc/guides/linux_gsg/enable_func.rst +2 -2
index 829084d80e..2344d97403 100644
@@ -55,12 +55,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::
Signature · 1 line
2.38.1
#1 lore raw

19/01/2023 22:24, Dmitry Kozlyuk:

Quoted 10 lines

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")

Applied, thanks.