[dpdk-dev,1/3] doc: clarify documentation on running as non-root
Checks
Commit Message
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>
---
doc/guides/linux_gsg/enable_func.rst | 8 ++++++++
1 file changed, 8 insertions(+)
Comments
> -----Original Message-----
> From: Richardson, Bruce
> Sent: Friday, August 4, 2017 1:44 PM
> To: Mcnamara, John <john.mcnamara@intel.com>
> Cc: dev@dpdk.org; Richardson, Bruce <bruce.richardson@intel.com>
> Subject: [PATCH 1/3] doc: clarify documentation on running 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>
@@ -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