From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 75238A056F; Tue, 3 Mar 2020 00:09:20 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 0A8971BFF2; Tue, 3 Mar 2020 00:09:20 +0100 (CET) Received: from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com [66.111.4.29]) by dpdk.org (Postfix) with ESMTP id EFF1D3B5 for ; Tue, 3 Mar 2020 00:09:18 +0100 (CET) Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailout.nyi.internal (Postfix) with ESMTP id 449EC223D1; Mon, 2 Mar 2020 18:09:18 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute7.internal (MEProxy); Mon, 02 Mar 2020 18:09:18 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; s=mesmtp; bh=tZHKEX6wJ/vuNGxl6tqNiS6 E5o17/Tk4RoDo3Jhgdh8=; b=nT+48QONlJ4ZpdX+30MmRnw2M16TfgA1Gi+mfbP h6pwhlD8vvywBwnzbIYmFnAZUVapwWYbWOUWILcX/bckcYau5r6Ldscvl2P3YyTs sGKh3smB8aY3ZSEm4ZO46lD4lay4RpaZ2/FN7TMhEoxP7Iqp68mekSm5AdH7OZpW jMhU= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :message-id:mime-version:subject:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; bh=tZHKEX6wJ/vuNGxl6 tqNiS6E5o17/Tk4RoDo3Jhgdh8=; b=a+q9v0Wf+8kgg/lniU3zZpvhwPgOHXRkz Y8bkkYH75b5nFGhdw9nnM+GkaWM89CmqCh/SJVFm0vTQR5tZ2aJt7vEc1/eHJm2Z zGCsIDAnX4wdZ8Gkr6cecB/7fSL4btAqYO2qETZylPOkWXJhl+i0RJ7ZLhC4+Tn9 aNhSpKksx3jlQsG8xHzXlSBwbhEteWB/jtWgCw+Dq6vxwp4OWTxA4TwYT2DgbS15 KBeK5m02YaJjfPuOFoMtd1Uod/qFItSfNvYs8YM1MVR7xUJebta/AzF4wq1rzYC2 cPu8l3Q7wyYA5Tyy1L/7YkBW/JziZ3dLu0E6k/LcN8oU1WwVjbe4g== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedugedruddthedgtddvucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvufffkffoggfgsedtkeertdertddtnecuhfhrohhmpefvhhhomhgrshcu ofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecukfhppe ejjedrudefgedrvddtfedrudekgeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgr mhepmhgrihhlfhhrohhmpehthhhomhgrshesmhhonhhjrghlohhnrdhnvght X-ME-Proxy: Received: from xps.monjalon.net (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id DD809328005E; Mon, 2 Mar 2020 18:09:16 -0500 (EST) From: Thomas Monjalon To: dev@dpdk.org Cc: adrianc@mellanox.com, moshele@mellanox.com, Matan Azrad , Shahaf Shuler , Viacheslav Ovsiienko , John McNamara , Marko Kovacevic Date: Tue, 3 Mar 2020 00:08:53 +0100 Message-Id: <20200302230853.1628014-1-thomas@monjalon.net> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH] doc: add required Linux capabilities in mlx5 guide 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" If running DPDK as non-root, some extra capabilities may be required. The Mellanox devices, using a bifurcated model with Linux drivers, have some specific requirements summarized in mlx5 PMD guide. Signed-off-by: Thomas Monjalon --- doc/guides/nics/mlx5.rst | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index afd11cd830..7650e57dd0 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -359,6 +359,32 @@ Run-time configuration - **ethtool** operations on related kernel interfaces also affect the PMD. +Run as non-root +^^^^^^^^^^^^^^^ + +In order to run as a non-root user, +some capabilities must be granted to the application:: + + setcap cap_sys_admin,cap_net_admin,cap_net_raw,cap_ipc_lock+ep + +Below are the reasons of the need for each capability: + +``cap_sys_admin`` + When using physical addresses (PA mode), with Linux >= 4.0, + for access to ``/proc/self/pagemap``. + +``cap_net_admin`` + For MTU and link state modifications. + +``cap_net_raw`` + For raw ethernet queue allocation through kernel driver. + +``cap_ipc_lock`` + For DMA memory pinning. + +Driver options +^^^^^^^^^^^^^^ + - ``rxq_cqe_comp_en`` parameter [int] A nonzero value enables the compression of CQE on RX side. This feature -- 2.25.1