From patchwork Fri Aug 4 12:44:09 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bruce Richardson X-Patchwork-Id: 27444 Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id E3920374C; Fri, 4 Aug 2017 15:32:17 +0200 (CEST) Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by dpdk.org (Postfix) with ESMTP id 48965330D for ; Fri, 4 Aug 2017 15:32:16 +0200 (CEST) Received: from orsmga005.jf.intel.com ([10.7.209.41]) by orsmga104.jf.intel.com with ESMTP; 04 Aug 2017 06:32:15 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.41,321,1498546800"; d="scan'208";a="133590789" Received: from silpixa00399126.ir.intel.com (HELO silpixa00399126.ger.corp.intel.com) ([10.237.223.223]) by orsmga005.jf.intel.com with ESMTP; 04 Aug 2017 06:32:14 -0700 From: Bruce Richardson To: john.mcnamara@intel.com Cc: dev@dpdk.org, Bruce Richardson Date: Fri, 4 Aug 2017 13:44:09 +0100 Message-Id: <20170804124411.238646-2-bruce.richardson@intel.com> X-Mailer: git-send-email 2.13.3 In-Reply-To: <20170804124411.238646-1-bruce.richardson@intel.com> References: <20170804124411.238646-1-bruce.richardson@intel.com> Subject: [dpdk-dev] [PATCH 1/3] doc: clarify documentation on running as non-root X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" 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 --- doc/guides/linux_gsg/enable_func.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/guides/linux_gsg/enable_func.rst b/doc/guides/linux_gsg/enable_func.rst index e6c806b0d..5ac0184a1 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