From: Kefu Chai <tchaikov@gmail.com>
Date: Sat, 26 Mar 2022 17:00:19 +0000 (+0800)
Subject: doc/dpdk: reword the root access part
X-Git-Tag: v18.0.0~1174^2
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F45661%2Fhead;p=ceph.git

doc/dpdk: reword the root access part

the root access to system is not a must have for running a DPDK
application. so reword the "Configuring OSD DPDKStack" section.

also, manually editing /etc/passwd is not encouraged, so use
"usermod" instead. to add a directory after user's command
interpreter in /etc/passwd does not make sense. see PASSWD(5).
so drop the paragraph on editing /etc/passwd.

Signed-off-by: Kefu Chai <tchaikov@gmail.com>
---

diff --git a/doc/dev/dpdk.rst b/doc/dev/dpdk.rst
index 7c87931b4055..cdc31a7c6525 100644
--- a/doc/dev/dpdk.rst
+++ b/doc/dev/dpdk.rst
@@ -48,11 +48,13 @@ Binding NICs to DPDK Applications:
 Configuring OSD DPDKStack
 ==========================
 
-The DPDK RTE initialization process requires the root privileges.
-Therefore, you need to grant the root permission to ceph.
-modify ``/etc/passwd`` to give ceph user root privilege and ``/var/run`` folder write::
+By default, the DPDK RTE initialization process requires the root privileges
+for accessing various resources in system. To grant the root access to
+the ``ceph`` user:
 
-  ceph:x:0:0:Ceph storage service:/var/lib/ceph:/bin/false:/var/run
+.. prompt:: bash #
+
+   usermod -G root ceph
 
 The OSD selects the NICs using ``ms_dpdk_devs_allowlist``: