[v3,4/4] doc/prog_guide: add reference to virtio-user from KNI doc

Message ID 20220610153535.659076-5-bruce.richardson@intel.com (mailing list archive)
State Accepted, archived
Delegated to: Maxime Coquelin
Headers
Series Enhance docs on virtio-user as KNI replacement |

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation success Compilation OK
ci/intel-Testing success Testing PASS
ci/github-robot: build success github build: passed
ci/iol-mellanox-Performance success Performance Testing PASS
ci/iol-intel-Functional success Functional Testing PASS
ci/iol-aarch64-unit-testing success Testing PASS
ci/iol-intel-Performance success Performance Testing PASS
ci/iol-x86_64-compile-testing success Testing PASS
ci/iol-aarch64-compile-testing success Testing PASS
ci/iol-x86_64-unit-testing success Testing PASS
ci/iol-abi-testing success Testing PASS

Commit Message

Bruce Richardson June 10, 2022, 3:35 p.m. UTC
  To help encourage use of virtio-user in place of KNI, put a reference to
the relevant howto section at the top of the KNI doc.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/prog_guide/kernel_nic_interface.rst | 6 ++++++
 1 file changed, 6 insertions(+)
  

Comments

Chenbo Xia June 15, 2022, 1:47 a.m. UTC | #1
> -----Original Message-----
> From: Richardson, Bruce <bruce.richardson@intel.com>
> Sent: Friday, June 10, 2022 11:36 PM
> To: dev@dpdk.org
> Cc: Maxime Coquelin <maxime.coquelin@redhat.com>; Xia, Chenbo
> <chenbo.xia@intel.com>; Richardson, Bruce <bruce.richardson@intel.com>
> Subject: [PATCH v3 4/4] doc/prog_guide: add reference to virtio-user from
> KNI doc
> 
> To help encourage use of virtio-user in place of KNI, put a reference to
> the relevant howto section at the top of the KNI doc.
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> ---
>  doc/guides/prog_guide/kernel_nic_interface.rst | 6 ++++++
>  1 file changed, 6 insertions(+)
> 
> diff --git a/doc/guides/prog_guide/kernel_nic_interface.rst
> b/doc/guides/prog_guide/kernel_nic_interface.rst
> index 5248f9622b..e021cc69b6 100644
> --- a/doc/guides/prog_guide/kernel_nic_interface.rst
> +++ b/doc/guides/prog_guide/kernel_nic_interface.rst
> @@ -6,6 +6,12 @@
>  Kernel NIC Interface
>  ====================
> 
> +.. note::
> +
> +   For an alternative to KNI, that does not require any out-of-tree Linux
> kernel modules,
> +   or a custom library, see :ref:`virtio_user_as_exception_path`.
> +
> +
>  The DPDK Kernel NIC Interface (KNI) allows userspace applications access
> to the Linux* control plane.
> 
>  The benefits of using the DPDK KNI are:
> --
> 2.34.1

Acked-by: Chenbo Xia <chenbo.xia@intel.com>
  
Maxime Coquelin July 7, 2022, 3:52 p.m. UTC | #2
On 6/10/22 17:35, Bruce Richardson wrote:
> To help encourage use of virtio-user in place of KNI, put a reference to
> the relevant howto section at the top of the KNI doc.
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> ---
>   doc/guides/prog_guide/kernel_nic_interface.rst | 6 ++++++
>   1 file changed, 6 insertions(+)
> 
> diff --git a/doc/guides/prog_guide/kernel_nic_interface.rst b/doc/guides/prog_guide/kernel_nic_interface.rst
> index 5248f9622b..e021cc69b6 100644
> --- a/doc/guides/prog_guide/kernel_nic_interface.rst
> +++ b/doc/guides/prog_guide/kernel_nic_interface.rst
> @@ -6,6 +6,12 @@
>   Kernel NIC Interface
>   ====================
>   
> +.. note::
> +
> +   For an alternative to KNI, that does not require any out-of-tree Linux kernel modules,
> +   or a custom library, see :ref:`virtio_user_as_exception_path`.
> +
> +
>   The DPDK Kernel NIC Interface (KNI) allows userspace applications access to the Linux* control plane.
>   
>   The benefits of using the DPDK KNI are:

Reviewed-by: Maxime Coquelin <maxime.coquelin@redhat.com>

Thanks,
Maxime
  

Patch

diff --git a/doc/guides/prog_guide/kernel_nic_interface.rst b/doc/guides/prog_guide/kernel_nic_interface.rst
index 5248f9622b..e021cc69b6 100644
--- a/doc/guides/prog_guide/kernel_nic_interface.rst
+++ b/doc/guides/prog_guide/kernel_nic_interface.rst
@@ -6,6 +6,12 @@ 
 Kernel NIC Interface
 ====================
 
+.. note::
+
+   For an alternative to KNI, that does not require any out-of-tree Linux kernel modules,
+   or a custom library, see :ref:`virtio_user_as_exception_path`.
+
+
 The DPDK Kernel NIC Interface (KNI) allows userspace applications access to the Linux* control plane.
 
 The benefits of using the DPDK KNI are: