Hi, > -----Original Message----- > From: dev <dev-boun...@dpdk.org> On Behalf Of Thomas Monjalon > Sent: Tuesday, March 3, 2020 1:09 AM > To: dev@dpdk.org > Cc: Adrian Chiris <adri...@mellanox.com>; Moshe Levi > <mosh...@mellanox.com>; Matan Azrad <ma...@mellanox.com>; Shahaf > Shuler <shah...@mellanox.com>; Slava Ovsiienko > <viachesl...@mellanox.com>; John McNamara > <john.mcnam...@intel.com>; Marko Kovacevic > <marko.kovace...@intel.com> > 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 <tho...@monjalon.net> Reviewed-by: Raslan Darwsheh <rasl...@mellanox.com> > --- > 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 > <dpdk-app> > + > +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
Patch applied to next-net-mlx, Kindest regards, Raslan Darawsheh
