From: Bruce Richardson Date: Fri, 4 Aug 2017 12:44:09 +0000 (+0100) Subject: doc: clarify restrictions to run as non-root X-Git-Tag: spdx-start~2209 X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=0bc99caf5e34330de760fc7667991d9bfe7ae955;hp=15034c20e15a043efc4ff4a703e125beb1d4587f;p=dpdk.git 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 Acked-by: John McNamara --- diff --git a/doc/guides/linux_gsg/enable_func.rst b/doc/guides/linux_gsg/enable_func.rst index e6c806b0d1..5ac0184a1e 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