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 0E021A00C3; Thu, 14 May 2020 10:23:41 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 912691D6C0; Thu, 14 May 2020 10:23:40 +0200 (CEST) Received: from EUR03-AM5-obe.outbound.protection.outlook.com (mail-eopbgr30072.outbound.protection.outlook.com [40.107.3.72]) by dpdk.org (Postfix) with ESMTP id D8E461D6B7 for ; Thu, 14 May 2020 10:23:38 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ZDKCs7LeweG9Ske7DPETE8v+uu3/QK1yZk2nl+smVFxLmq8wB7Ks4SsASmJQvAkYf3mFLh1CoDFvFUNd7YUM8RWVaxENPNfj2OW6A05g5zdG11AUw23kctNx+/YlP1Hf2/BXSJCiDEPILZoUTvpYixEsMhc30XGKMZWrpfb4Vs2cRpMzsCnURUr4fJFNGnRq2su8fblV0x2zuURGeVhfhzge94XPdQP6OU9zyKm+1tYPsdIDy5RKqPFX4T5dP30J2uqUClcWyOhaGAXxg3RwILWs6dWlLSxgHj59ADAXIH/O3ySH45Bw3yRZWJyC585Mt6794+m2xlnlvBBuZdUC/Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=/HWNd3dwfMrXydJD/oHyK0Cebfi0mKKsIC5arpdX3fo=; b=duqX4AY6WHZDlSQr0ozCSsLEQV2zHf391Hrih4Vruf5WAHBGfQ1nGw916G6f4VvmnAFihjxPpQ9wRqQhEnkYObHM8dFEthHtcP5nE2iBEwstAjVWws0T0HAmfRwnXcggUF05OnGxLWinS+DYxJ6RJ/Cp6j5IE34EI/51v9zDW1kmizZ1DgV9N2WSXscJfZEotiimEJnoleoZ34BRnJmk3Ge5Xg2+TvmeD8QDil8NxcYgEInZHobiGALGfRnxBG95pIR1VCoRDf8Su9SviJC9DHlhbKvLoPOj1nqM7LTFE64ukIf71l+PKD3l+nRanEZwBIalv//m3PGm0xT0VkJcDA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=mellanox.com; dmarc=pass action=none header.from=mellanox.com; dkim=pass header.d=mellanox.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Mellanox.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=/HWNd3dwfMrXydJD/oHyK0Cebfi0mKKsIC5arpdX3fo=; b=qlwz10gbEYBVNqbhKQwESMr/i39jJoW9Iz1y5wYc5fYi4J2Me/mOKzIbya9LqW1K2G9tiliPfOvLUs9pAm0Ew6J/0U8R0wr21GEuU10JmMmQhZsENevpOF8Jk1VqPMWoeNohfvG/+DAqsyOXldspKww4w8bdfcb1zXfVnyQKCeU= Received: from AM0PR05MB6707.eurprd05.prod.outlook.com (2603:10a6:20b:15b::17) by AM0PR05MB6356.eurprd05.prod.outlook.com (2603:10a6:208:13c::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3000.26; Thu, 14 May 2020 08:23:37 +0000 Received: from AM0PR05MB6707.eurprd05.prod.outlook.com ([fe80::508:747b:cc12:5f6e]) by AM0PR05MB6707.eurprd05.prod.outlook.com ([fe80::508:747b:cc12:5f6e%5]) with mapi id 15.20.2979.033; Thu, 14 May 2020 08:23:37 +0000 From: Raslan Darawsheh To: Thomas Monjalon , "dev@dpdk.org" CC: Adrian Chiris , Moshe Levi , Matan Azrad , Shahaf Shuler , Slava Ovsiienko , John McNamara , Marko Kovacevic Thread-Topic: [dpdk-dev] [PATCH] doc: add required Linux capabilities in mlx5 guide Thread-Index: AQHV8OegxsmJ0YWeWk20M4R5Gl64Sqinr4Qw Date: Thu, 14 May 2020 08:23:37 +0000 Message-ID: References: <20200302230853.1628014-1-thomas@monjalon.net> In-Reply-To: <20200302230853.1628014-1-thomas@monjalon.net> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: monjalon.net; dkim=none (message not signed) header.d=none;monjalon.net; dmarc=none action=none header.from=mellanox.com; x-originating-ip: [188.161.229.217] x-ms-publictraffictype: Email x-ms-office365-filtering-ht: Tenant x-ms-office365-filtering-correlation-id: 7713729c-135d-4363-dbc6-08d7f7e019e3 x-ms-traffictypediagnostic: AM0PR05MB6356: x-ld-processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:4303; x-forefront-prvs: 040359335D x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: T2VgbFsxFY0ysX6qtfQoeVnJguZgb0t9cvf4tZAKt/TNrtPeXm+/nr/hNgXKkbZI4UpJiWsLQ4TydFJ8Yn8t9Af9zba2pSUAnka06TQO/cEZcO//y0xsASHfDQ9YQWjB6cQQWFJEEMed+FXQVVXiA2pclLu+38kHSfu2UhOCdoOG3D/2I9egk1WxIKmUCwcxv1sTrnc2h5+SM/d2p078aNpQZAwPGOzcQ8jq/6fShEWSCxLl2dD7TM9aKEVxasbZP4RnAikYQ7RzuKTd4BZNna3axzOYHAtGh7iDb6/m9vGfPXcjP6zavEF8rhJg9TgTVsx/VsPqA5eVpxFVYHa3NcEnzt7NNzUdJ79zOHVQ85h7nSUrZnEswA6sTqTALaqcuW51W4VisMB89StS+nTlDy16wKLytr7TqPgqZ794tdkMdf6SRouWJkjhlrWWtbKc x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM0PR05MB6707.eurprd05.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(376002)(366004)(136003)(346002)(39860400002)(396003)(4326008)(9686003)(54906003)(2906002)(110136005)(316002)(66446008)(66946007)(66556008)(66476007)(64756008)(76116006)(5660300002)(71200400001)(52536014)(186003)(26005)(6506007)(86362001)(53546011)(7696005)(478600001)(55016002)(8936002)(33656002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: Kj+i0HdoBvUKP9gswFy2Ehy2T/aphjI85kxONIKAk7Ss6hWanXqHib4lYpTxAljDT4DoDvcY1VI9mR4/IaSOQftuLIyP88CjfnEc6WCbpxiFu474214iAA3mCQfa99FPGEqREfMYuEPGHRiGb2lmQXByz1BUqLJX/Ty7wdUANjlHrQI19tEmzkN/OxbwF7uXuTHAR/I7kXNZSZ5z1wO1UIZsZL8r1HtwuUx5GQe1+MquE5o5VYHxMgNeZ3cZl36lF33GN7gLvYMcZPHXfNqfrDjTl2PAuc2RbBn4oLKBqQPGo7aGyCWlVbjxm4Hyr3aTvn99/s5JTR7wwvXvc4vRe1Qx5qhA85MS9r2mhKZe0eLk7DmPI55qW5Oun6PeLm7SwcdTo+wN9PSTlto55u7n9U7oUASZ4HzwgeokSdezl/XIUvIs4c69zpW/ODEebwOjQJu5V0neWPmvZpBPHszwXH/hEhkLCwKuKtUuukjCclRXEG3YLMTjiTIS19X+sIEh Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-Network-Message-Id: 7713729c-135d-4363-dbc6-08d7f7e019e3 X-MS-Exchange-CrossTenant-originalarrivaltime: 14 May 2020 08:23:37.4625 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: a652971c-7d2e-4d9b-a6a4-d149256f461b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: mx46fAfqhhQijR9xZ1cPPOEiQMWm0c4ZtT6/2v/hrfs5AaOWWCNKcykzHAMc8P1lwBkypkWhIxdj9uYPfDqHaA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR05MB6356 Subject: Re: [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" Hi, > -----Original Message----- > From: dev On Behalf Of Thomas Monjalon > Sent: Tuesday, March 3, 2020 1:09 AM > To: dev@dpdk.org > Cc: Adrian Chiris ; Moshe Levi > ; Matan Azrad ; Shahaf > Shuler ; Slava Ovsiienko > ; John McNamara > ; Marko Kovacevic > > Subject: [dpdk-dev] [PATCH] doc: add required Linux capabilities in mlx5 > guide >=20 > 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. >=20 > Signed-off-by: Thomas Monjalon Reviewed-by: Raslan Darwsheh > --- > doc/guides/nics/mlx5.rst | 26 ++++++++++++++++++++++++++ > 1 file changed, 26 insertions(+) >=20 > 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 >=20 > - **ethtool** operations on related kernel interfaces also affect the PM= D. >=20 > +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 >=3D 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] >=20 > A nonzero value enables the compression of CQE on RX side. This featur= e > -- > 2.25.1 Patch applied to next-net-mlx, Kindest regards, Raslan Darawsheh