summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBruce Richardson <bruce.richardson@intel.com>2017-08-04 13:44:09 +0100
committerThomas Monjalon <thomas@monjalon.net>2017-08-06 12:26:57 +0200
commit0bc99caf5e34330de760fc7667991d9bfe7ae955 (patch)
tree64cc4689919da868b7c751c6955f16de82ae9f7e
parent15034c20e15a043efc4ff4a703e125beb1d4587f (diff)
downloaddpdk-0bc99caf5e34330de760fc7667991d9bfe7ae955.zip
dpdk-0bc99caf5e34330de760fc7667991d9bfe7ae955.tar.gz
dpdk-0bc99caf5e34330de760fc7667991d9bfe7ae955.tar.xz
doc: clarify restrictions to run as non-root
Since modern kernels don't allow unprivileged processes to read the pagemaps file, the instructions on running as non-root are out-of-date. Add a note clarifying that they will only work with earlier kernel versions. Signed-off-by: Bruce Richardson <bruce.richardson@intel.com> Acked-by: John McNamara <john.mcnamara@intel.com>
-rw-r--r--doc/guides/linux_gsg/enable_func.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/guides/linux_gsg/enable_func.rst b/doc/guides/linux_gsg/enable_func.rst
index e6c806b..5ac0184 100644
--- a/doc/guides/linux_gsg/enable_func.rst
+++ b/doc/guides/linux_gsg/enable_func.rst
@@ -87,6 +87,14 @@ The application can then determine what action to take, if any, if the HPET is n
Running DPDK Applications Without Root Privileges
--------------------------------------------------------
+.. note::
+
+ The instructions below will allow running DPDK as non-root with older
+ Linux kernel versions. However, since version 4.0, the kernel does not allow
+ unprivileged processes to read the physical address information from
+ the pagemaps file, making it impossible for those processes to use HW
+ devices which require physical addresses
+
Although applications using the DPDK use network ports and other hardware resources directly,
with a number of small permission adjustments it is possible to run these applications as a user other than "root".
To do so, the ownership, or permissions, on the following Linux file system objects should be adjusted to ensure that