From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <stable-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
	by inbox.dpdk.org (Postfix) with ESMTP id DB7BA423DA
	for <public@inbox.dpdk.org>; Sat, 14 Jan 2023 23:58:21 +0100 (CET)
Received: from mails.dpdk.org (localhost [127.0.0.1])
	by mails.dpdk.org (Postfix) with ESMTP id D668740E0F;
	Sat, 14 Jan 2023 23:58:21 +0100 (CET)
Received: from mail-lf1-f43.google.com (mail-lf1-f43.google.com
 [209.85.167.43])
 by mails.dpdk.org (Postfix) with ESMTP id F1A7740042;
 Sat, 14 Jan 2023 23:58:19 +0100 (CET)
Received: by mail-lf1-f43.google.com with SMTP id o20so6016345lfk.5;
 Sat, 14 Jan 2023 14:58:19 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=content-transfer-encoding:mime-version:message-id:date:subject:cc
 :to:from:from:to:cc:subject:date:message-id:reply-to;
 bh=8MsWvqLS3J++1eVnmvzw0PYCUW/UT17gqXGgJMdEF1E=;
 b=nNgoTKxNIrpV5vhjxkmJeobA4zTZhWGUFZkTIszeNmrGcaao2fTLd4+DRNW3dfM2MU
 rvEXzVhjObVUjpYEl/IQjgpX6jaDsCofkUdwjcStYrxn7JnmT3+TZkGGgsIgo0e8Osjo
 S4w5TVX3D5jx7IU9RQF/Zs/97qQiYfYeT7YYV6c3rdrmUmB5LzibOJ93ucuRDr/foyXd
 JP4qDd3V2Ih8zafTHypFBShM1WFUCriEc28mxQ37OusN7+wnZ/bPKKl8hZK7/JDRwX/q
 Bpkf0UBrL0hZklD84xBNlq5nbx0EYT8caPY/U+suUacb1tpacXRfK+Fghrt+4l2FcDua
 9Q/A==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=content-transfer-encoding:mime-version:message-id:date:subject:cc
 :to:from:x-gm-message-state:from:to:cc:subject:date:message-id
 :reply-to;
 bh=8MsWvqLS3J++1eVnmvzw0PYCUW/UT17gqXGgJMdEF1E=;
 b=Tcwip2uBHr+EAWAP5VRSQOYzwhXpneYkNOietkaMbxjc7GkfB+EcUUMGDbGpVa3lZD
 FokGNz0ySqDo2S3Ve8hG+ZgDwsmFW+O5GLV6J47odMbZymicBMoAfPURsb7qFi4VguWv
 spfnnM3jWh6E4CyzSae7blZC1cHLsomJfJjuMrM27gpvvEJdZYSU+YgrmJ8RQCYJVqQu
 XFdqACL5TRl1n1ILbNEF9ghezSIjf1VXjecY5U17zl5A9EXVPHp/rT3lWMl9nRskbtEp
 AjbPd9NgvIB68NIl49kQu0VbqvK6IfE/vMpWTh3WX/9yPMnO/SqC7Rv11LTZn+jW1scK
 2S5w==
X-Gm-Message-State: AFqh2kr0P3ADpr6GEs7CtOJj8/kWeHMl+boRKmHSe7ba6Gx1GjmRcxWs
 TRhLYiOkp3nrCqCgEIAxri6RHLxsO7c=
X-Google-Smtp-Source: AMrXdXvtLb1txpTMwoqPN1HiCKFd6fe3SNWP8BfB3BGwBv75KlpUKrT+mE9wO+kWzIFAlFsowBT6FQ==
X-Received: by 2002:a05:6512:92f:b0:4b6:e8fa:a48d with SMTP id
 f15-20020a056512092f00b004b6e8faa48dmr1378877lft.5.1673737099090; 
 Sat, 14 Jan 2023 14:58:19 -0800 (PST)
Received: from sovereign.. (broadband-37-110-65-23.ip.moscow.rt.ru.
 [37.110.65.23]) by smtp.gmail.com with ESMTPSA id
 o20-20020a05651205d400b004cb34b81150sm4459570lfo.282.2023.01.14.14.58.18
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Sat, 14 Jan 2023 14:58:18 -0800 (PST)
From: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>
To: dev@dpdk.org
Cc: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>, stable@dpdk.org,
 Boris Ouretskey <borisusun@gmail.com>, Isaac Boukris <iboukris@gmail.com>,
 Bruce Richardson <bruce.richardson@intel.com>
Subject: [PATCH] doc: add capability to access physical addresses
Date: Sun, 15 Jan 2023 01:58:02 +0300
Message-Id: <20230114225802.136625-1-dmitry.kozliuk@gmail.com>
X-Mailer: git-send-email 2.38.1
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-BeenThere: stable@dpdk.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: patches for DPDK stable branches <stable.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/stable>,
 <mailto:stable-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/stable/>
List-Post: <mailto:stable@dpdk.org>
List-Help: <mailto:stable-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/stable>,
 <mailto:stable-request@dpdk.org?subject=subscribe>
Errors-To: stable-bounces@dpdk.org

CAP_DAC_OVERRIDE capability is required to access /proc/self/pagemap,
but it was missing from the Linux guide, causing issues for users.

Fixes: 979bb5d493fb ("doc: add more instructions for running as non-root")
Cc: stable@dpdk.org

Signed-off-by: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>
Reported-by: Boris Ouretskey <borisusun@gmail.com>
Reported-by: Isaac Boukris <iboukris@gmail.com>
---
Mail threads:
* https://inbox.dpdk.org/users/CAG4AAQ21hn_Ogi0-gfUjXVhtWU19Bk634BT6Ue1bpYZjRXFJjg@mail.gmail.com
* https://inbox.dpdk.org/users/CAC-fF8ShK_n1dhPK2KwV7nRx7535simb=fN77yrZR1+fV2j28A@mail.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 829084d80e..b0e123cb7e 100644
--- a/doc/guides/linux_gsg/enable_func.rst
+++ b/doc/guides/linux_gsg/enable_func.rst
@@ -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``
+* ``CAP_DAC_OVERRIDE`` 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_override,cap_ipc_lock,cap_sys_admin+ep <executable>
 
 If physical addresses are not accessible,
 the following message will appear during EAL initialization::
-- 
2.38.1