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 0652DA00C3; Sat, 16 May 2020 23:03:39 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 8C51F1D6C5; Sat, 16 May 2020 23:03:39 +0200 (CEST) Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05on2059.outbound.protection.outlook.com [40.107.21.59]) by dpdk.org (Postfix) with ESMTP id 40D721DA26 for ; Thu, 14 May 2020 19:29:32 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Ry6m1K2xR28+zm2dFDfy5436ltwnPCWWmKAYdJxv7eDU+6v16EPan3jUEZh9neg84fv00TIcOkU0k7F/CIQMqywQF3dQfnJpz0/pcENU1UyRU4dCm/o09YBdgm8GTWXnljweMwiNGSUm/oyTRRT0l2dusOgrGHfrs3fky9oOjANkEQN1wOneATRxCkEF8HTP3rG1n1xzQyjw/7pMqDmxh3EbPyLiVHXDPObQxmvMaWU0Tkk9dX+w+seteiolf76WbrZzqrHnX290GD2jwKYlYc5u4RTbSiIK6yH4ecCuRcFAqIaWbvq+j+DmMGmIt9rVT2CEWxUqOp9JVWrItrY7tw== 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=F4preLT1qh+2s8gyZ4lYWOxmUMkxCKEAiWckedSwXKc=; b=SDgzyu4S60sLYIeZTA3Zt0pKfrwERVqqlNF59zM8llyE7+jBXqwcTiPAsCvZ2d75AT+CEnSHTzdEbiDwSpax3oY6bBSHcJWyqSC2+UMF0essHi4P5/t/JCk+9uZCyILUHM7aDOOUJdNpeIFvEuPD+0c9YEBhd439cth8ZPfZt8I1oi7lGLIgtD56IASpNUrAwuzZleayCTImaFzPO9wzWAiB6IPdufBiU43BKlocS3PussP5tyGBfvfcbze73ajmoaMnzcIUjiOxjyERfm225mFY7X/FUeQBJteQMcRH4RwZ0FnEikW79cOhQ58CueD5nPsbSSfS8AAtbcmxKYl1bA== 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=F4preLT1qh+2s8gyZ4lYWOxmUMkxCKEAiWckedSwXKc=; b=cHcqZ45h9AoNEokzIHJg+u4Q/7x2LTxG5k6dZyxSwJMLxXFzlFilTpkJgu1Jn5BfCIvJin14vzmvfsxCZOXVstelMjTCCzdGWQr3JA3Rlhox2oo8vXsiZY+lQFu6NWgVN02m8HgWvCjzVpH3nKpPmP5HZRy2r7uTMsz4I/OLDfM= Received: from AM6PR05MB5425.eurprd05.prod.outlook.com (2603:10a6:20b:5d::11) by AM6PR05MB4344.eurprd05.prod.outlook.com (2603:10a6:209:42::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2979.27; Thu, 14 May 2020 17:29:30 +0000 Received: from AM6PR05MB5425.eurprd05.prod.outlook.com ([fe80::1d10:2aad:248b:1b28]) by AM6PR05MB5425.eurprd05.prod.outlook.com ([fe80::1d10:2aad:248b:1b28%7]) with mapi id 15.20.2979.033; Thu, 14 May 2020 17:29:30 +0000 From: Moshe Levi To: Raslan Darawsheh , Thomas Monjalon , "dev@dpdk.org" CC: Adrian Chiris , 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: AQHV8OegxsmJ0YWeWk20M4R5Gl64Sqinr4QwgACU9FA= Date: Thu, 14 May 2020 17:29:30 +0000 Message-ID: References: <20200302230853.1628014-1-thomas@monjalon.net> In-Reply-To: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: mellanox.com; dkim=none (message not signed) header.d=none;mellanox.com; dmarc=none action=none header.from=mellanox.com; x-originating-ip: [31.210.181.200] x-ms-publictraffictype: Email x-ms-office365-filtering-ht: Tenant x-ms-office365-filtering-correlation-id: 9b569054-b317-456d-4ae6-08d7f82c5c23 x-ms-traffictypediagnostic: AM6PR05MB4344:|AM6PR05MB4344: x-ld-processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr,ExtFwd x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:3631; x-forefront-prvs: 040359335D x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: KdnovYSYI3gy6asUFBkgnl9wju71IQmUozCuxrkiLEvSo9zDoC0of+zmYj9B7oOIHAS/HgvnQjShh8fLCr4Hq2DyK32j+jxc0Deftq78FK8dyOLtE2SCAQ+fBUbfdaBUNxLvESZu76wsZ3k5kvwi2SshnFrsyk6DKkJkAztAmzbUxy5kb7SiW8UUZDFiBmmKjZAip3tH1q8oHAvaeWn9b3YqsWRl8qQR2BHcnZ5JlmVhN6+8/NgoAhqGrPFCDWN0lIwgve5EcnvHVRq+h3Vu8SFQ5Vygv5hp7OooQtm4eakiHA5jV63jLkDl1neSj3DwNH0aI/4vyu2QL1ikUcjHpyNRj31HTfjNCaljjOC23btfHr4gtXyHwKnm6tZzM7F46XX9I+NP2g9dqtndjaqCdOI0j2DNxU9iwXz6ouo3nSLG3Q6GiAzSQB1jTIedp0dacQ/RbOt72/yWkDhaIdEeXvw9eAePSOK8yFqVXzWeuw9RvkrSs873W2/fP6hyOZqxCsxEwCayPhF55lWqUOG+PQ== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM6PR05MB5425.eurprd05.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(346002)(39860400002)(376002)(136003)(366004)(396003)(86362001)(5660300002)(33656002)(55016002)(66446008)(316002)(66946007)(64756008)(71200400001)(66476007)(9686003)(76116006)(4326008)(66556008)(110136005)(54906003)(53546011)(7696005)(6506007)(26005)(186003)(52536014)(2906002)(8936002)(478600001)(966005); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: 9HYENBc7ZpLMU5GFzlAiw2N1Zbe0wsyl1oRtTSVqXDT77KbK4erv4Dc8lS5MHih0NQUi6OPPcriXS6vju3xnFRWs2yIbosu1EQG53OLR0u77IXOyXf22BBPXun4Tuai1dPNcypQIVYN+Lx5KRK6lyMQlKm1uUiX/nwbuoNZ4eFEm3Y3cdzjo67Pm02+yJ9xLbllZuWisHLIACNnjZFY6kXNsWiT4iRLpMnLivj6Y2b9Y1oeE5I930Je9Wi23Kef3aRBjprwifG4bna80VBmXEJtEv/SUqDcYrP9KYic0y1WWGpOJKl1/qmcFgI4XMJR0plcfARDFH9Fe/bNg0AL+kjfHHeFO2P7qhIeY44zeDP2hmWtFKJWasnt7cd0GfCRR+/4BVMnc5ORXMPCnaJkJZawX7Z8OsDKmUznzV4th/i/mf50quSzLwO6vch/iClJuYt1jHKrV2W5/EkoFSAa0ELQd+9qJ5zthgLBvm9FA69c5pOC+RMkNP4ZwzE6cKurb 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: 9b569054-b317-456d-4ae6-08d7f82c5c23 X-MS-Exchange-CrossTenant-originalarrivaltime: 14 May 2020 17:29:30.2341 (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: W4C2j3LyGUTZWWXlKXZKQB66hsjIhPh/UJk7zIbtaxjvJBxXsQ4sx9eAnp0lHDcVp0+lwmTb3IjbhroOP+hNOQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM6PR05MB4344 X-Mailman-Approved-At: Sat, 16 May 2020 23:03:39 +0200 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 Raslan,=20 PSB > -----Original Message----- > From: Raslan Darawsheh > Sent: Thursday, May 14, 2020 11:24 AM > To: Thomas Monjalon ; dev@dpdk.org > Cc: Adrian Chiris ; Moshe Levi > ; Matan Azrad ; Shahaf > Shuler ; Slava Ovsiienko > ; John McNamara > ; Marko Kovacevic > > Subject: RE: [dpdk-dev] [PATCH] doc: add required Linux capabilities in m= lx5 > guide >=20 > Hi, >=20 > > -----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 > > > > 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 > Reviewed-by: Raslan Darwsheh > > --- > > 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 >=3D 4.0, > > + for access to ``/proc/self/pagemap``. > > + > > +``cap_net_admin`` > > + For MTU and link state modifications It more than that like change mac address . maybe better to write for inter= face configuration=20 You can see the full list in [1] look for CAP_NET_ADMIN [1] - http://man7.org/linux/man-pages/man7/capabilities.7.html . > > + > > +``cap_net_raw`` > > + For raw ethernet queue allocation through kernel driver. Maybe can you add a note that for containers the net_raw is enabled by defa= ult see [1] and you don't need to specify it.=20 [1] - https://docs.docker.com/engine/reference/run/#runtime-privilege-and-= linux-capabilities=20 > > + > > +``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 >=20 >=20 > Patch applied to next-net-mlx, >=20 > Kindest regards, > Raslan Darawsheh