doc: add capability to access physical addresses
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")
Signed-off-by Dmitry Kozlyuk <[email protected]>
Reported-by Boris Ouretskey <[email protected]>
Reported-by Isaac Boukris <[email protected]>
--- doc/guides/linux_gsg/enable_func.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
doc/guides/linux_gsg/enable_func.rst +2 -2
@@ -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
Thomas Monjalon
Applied19/01/2023 22:24, Dmitry Kozlyuk:
Quoted 10 lines
DAC_READ_SEARCHorDAC_OVERRIDEcapability is required to access/proc/self/pagemap, but the Linux guide mentioned neither one. RecommendDAC_READ_SEARCHas less impactful.Fixes 979bb5d493fb ("doc: add more instructions for running as non-root")Signed-off-by Dmitry Kozlyuk <[email protected]>Reported-by Boris Ouretskey <[email protected]>Reported-by Isaac Boukris <[email protected]>
Applied, thanks.