* [dpdk-dev] [PATCH] doc/windows_gsg: update section on driver installation
@ 2021-10-08 21:11 Dmitry Kozlyuk
2021-10-09 19:38 ` Kadam, Pallavi
2021-10-11 19:15 ` Thomas Monjalon
0 siblings, 2 replies; 6+ messages in thread
From: Dmitry Kozlyuk @ 2021-10-08 21:11 UTC (permalink / raw)
To: dev
Cc: William Tu, Dmitry Kozlyuk, Narcisa Ana Maria Vasile,
Dmitry Malloy, Pallavi Kadam
Windows GSG included a section only on virt2phys driver installation,
but not on NetUIO. The content of the section duplicated documentation
in dpdk-kmods, but contained no links to it, only a reference.
Add subsections for virt2phys and NetUIO, explaining their roles.
Refer to documenttion in dpdk-kmods as an authoritative source,
but leave specific diagnostic and usage hints in the GSG.
Signed-off-by: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>
---
doc/guides/windows_gsg/run_apps.rst | 48 ++++++++++++++---------------
1 file changed, 23 insertions(+), 25 deletions(-)
diff --git a/doc/guides/windows_gsg/run_apps.rst b/doc/guides/windows_gsg/run_apps.rst
index abaecc3793..70bb1da33f 100644
--- a/doc/guides/windows_gsg/run_apps.rst
+++ b/doc/guides/windows_gsg/run_apps.rst
@@ -27,40 +27,27 @@ See `Large-Page Support`_ in MSDN for details.
.. _Large-Page Support: https://docs.microsoft.com/en-us/windows/win32/memory/large-page-support
-Load virt2phys Driver
----------------------
+Install Drivers
+---------------
-Access to physical addresses is provided by a kernel-mode driver, virt2phys.
-It is mandatory at least for using hardware PMDs, but may also be required
-for mempools.
-
-Refer to documentation in ``dpdk-kmods`` repository for details on system
-setup, driver build and installation. This driver is not signed, so signature
-checking must be disabled to load it.
+Certain kernel-mode drivers are required to run DPDK applications.
+Refer to `Windows documentation <https://git.dpdk.org/dpdk-kmods/tree/windows>`_
+in ``dpdk-kmods`` repository for common instructions on system setup,
+driver build and installation. The drivers are not signed, so signature
+enforcement has to be disabled.
.. warning::
Disabling driver signature enforcement weakens OS security.
It is discouraged in production environments.
-Compiled package consists of ``virt2phys.inf``, ``virt2phys.cat``,
-and ``virt2phys.sys``. It can be installed as follows
-from Elevated Command Prompt:
-
-.. code-block:: console
-
- pnputil /add-driver Z:\path\to\virt2phys.inf /install
-On Windows Server additional steps are required:
+virt2phys
+~~~~~~~~~
-1. From Device Manager, Action menu, select "Add legacy hardware".
-2. It will launch the "Add Hardware Wizard". Click "Next".
-3. Select second option "Install the hardware that I manually select
- from a list (Advanced)".
-4. On the next screen, "Kernel bypass" will be shown as a device class.
-5. Select it, and click "Next".
-6. The previously installed drivers will now be installed for the
- "Virtual to physical address translator" device.
+Access to physical addresses is provided by a kernel-mode driver, virt2phys.
+It is mandatory for allocating physically-contiguous memory which is required
+by hardware PMDs.
When loaded successfully, the driver is shown in *Device Manager* as *Virtual
to physical address translator* device under *Kernel bypass* category.
@@ -74,6 +61,17 @@ on initialization (debug-level logs provide more details):
EAL: Cannot open virt2phys driver interface
+NetUIO
+~~~~~~
+
+NetUIO kernel-mode driver provides access to the device hardware resources.
+It is mandatory for all hardware PMDs, except for MLX5 PMD.
+
+Refer to `NetUIO documentation <https://git.dpdk.org/dpdk-kmods/tree/windows/netuio/README.rst>`_
+in ``dpdk-kmods`` repository for instructions to build and set up the driver.
+Devices supported by NetUIO are listed in ``netuio.inf``.
+The list can be extended in order to try running DPDK with new devices.
+
Run the ``helloworld`` Example
------------------------------
--
2.29.3
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] [PATCH] doc/windows_gsg: update section on driver installation
2021-10-08 21:11 [dpdk-dev] [PATCH] doc/windows_gsg: update section on driver installation Dmitry Kozlyuk
@ 2021-10-09 19:38 ` Kadam, Pallavi
2021-10-09 20:20 ` Dmitry Kozlyuk
2021-10-11 19:15 ` Thomas Monjalon
1 sibling, 1 reply; 6+ messages in thread
From: Kadam, Pallavi @ 2021-10-09 19:38 UTC (permalink / raw)
To: Dmitry Kozlyuk, dev; +Cc: William Tu, Narcisa Ana Maria Vasile, Dmitry Malloy
On 10/8/2021 2:11 PM, Dmitry Kozlyuk wrote:
> Windows GSG included a section only on virt2phys driver installation,
> but not on NetUIO. The content of the section duplicated documentation
> in dpdk-kmods, but contained no links to it, only a reference.
>
> Add subsections for virt2phys and NetUIO, explaining their roles.
> Refer to documenttion in dpdk-kmods as an authoritative source,
> but leave specific diagnostic and usage hints in the GSG.
>
> Signed-off-by: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>
> ---
> doc/guides/windows_gsg/run_apps.rst | 48 ++++++++++++++---------------
> 1 file changed, 23 insertions(+), 25 deletions(-)
>
> diff --git a/doc/guides/windows_gsg/run_apps.rst b/doc/guides/windows_gsg/run_apps.rst
> index abaecc3793..70bb1da33f 100644
> --- a/doc/guides/windows_gsg/run_apps.rst
> +++ b/doc/guides/windows_gsg/run_apps.rst
> @@ -27,40 +27,27 @@ See `Large-Page Support`_ in MSDN for details.
> .. _Large-Page Support: https://docs.microsoft.com/en-us/windows/win32/memory/large-page-support
>
>
> -Load virt2phys Driver
> ----------------------
> +Install Drivers
> +---------------
>
> -Access to physical addresses is provided by a kernel-mode driver, virt2phys.
> -It is mandatory at least for using hardware PMDs, but may also be required
> -for mempools.
> -
> -Refer to documentation in ``dpdk-kmods`` repository for details on system
> -setup, driver build and installation. This driver is not signed, so signature
> -checking must be disabled to load it.
> +Certain kernel-mode drivers are required to run DPDK applications.
> +Refer to `Windows documentation <https://git.dpdk.org/dpdk-kmods/tree/windows>`_
> +in ``dpdk-kmods`` repository for common instructions on system setup,
> +driver build and installation. The drivers are not signed, so signature
> +enforcement has to be disabled.
>
> .. warning::
>
> Disabling driver signature enforcement weakens OS security.
> It is discouraged in production environments.
>
> -Compiled package consists of ``virt2phys.inf``, ``virt2phys.cat``,
> -and ``virt2phys.sys``. It can be installed as follows
> -from Elevated Command Prompt:
> -
> -.. code-block:: console
> -
> - pnputil /add-driver Z:\path\to\virt2phys.inf /install
>
> -On Windows Server additional steps are required:
> +virt2phys
> +~~~~~~~~~
>
> -1. From Device Manager, Action menu, select "Add legacy hardware".
> -2. It will launch the "Add Hardware Wizard". Click "Next".
> -3. Select second option "Install the hardware that I manually select
> - from a list (Advanced)".
> -4. On the next screen, "Kernel bypass" will be shown as a device class.
> -5. Select it, and click "Next".
> -6. The previously installed drivers will now be installed for the
> - "Virtual to physical address translator" device.
> +Access to physical addresses is provided by a kernel-mode driver, virt2phys.
> +It is mandatory for allocating physically-contiguous memory which is required
> +by hardware PMDs.
Should we add specific link to virt2phys README in this section as well?
https://git.dpdk.org/dpdk-kmods/tree/windows/README.rst
>
> When loaded successfully, the driver is shown in *Device Manager* as *Virtual
> to physical address translator* device under *Kernel bypass* category.
> @@ -74,6 +61,17 @@ on initialization (debug-level logs provide more details):
> EAL: Cannot open virt2phys driver interface
>
>
> +NetUIO
> +~~~~~~
> +
> +NetUIO kernel-mode driver provides access to the device hardware resources.
> +It is mandatory for all hardware PMDs, except for MLX5 PMD.
> +
> +Refer to `NetUIO documentation <https://git.dpdk.org/dpdk-kmods/tree/windows/netuio/README.rst>`_
> +in ``dpdk-kmods`` repository for instructions to build and set up the driver.
> +Devices supported by NetUIO are listed in ``netuio.inf``.
> +The list can be extended in order to try running DPDK with new devices.
> +
>
> Run the ``helloworld`` Example
> ------------------------------
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] [PATCH] doc/windows_gsg: update section on driver installation
2021-10-09 19:38 ` Kadam, Pallavi
@ 2021-10-09 20:20 ` Dmitry Kozlyuk
2021-10-10 1:28 ` William Tu
2021-10-11 16:33 ` Kadam, Pallavi
0 siblings, 2 replies; 6+ messages in thread
From: Dmitry Kozlyuk @ 2021-10-09 20:20 UTC (permalink / raw)
To: Kadam, Pallavi; +Cc: dev, William Tu, Narcisa Ana Maria Vasile, Dmitry Malloy
2021-10-09 12:38 (UTC-0700), Kadam, Pallavi:
> On 10/8/2021 2:11 PM, Dmitry Kozlyuk wrote:
> > [...]
> > +virt2phys
> > +~~~~~~~~~
> >
> > -1. From Device Manager, Action menu, select "Add legacy hardware".
> > -2. It will launch the "Add Hardware Wizard". Click "Next".
> > -3. Select second option "Install the hardware that I manually select
> > - from a list (Advanced)".
> > -4. On the next screen, "Kernel bypass" will be shown as a device class.
> > -5. Select it, and click "Next".
> > -6. The previously installed drivers will now be installed for the
> > - "Virtual to physical address translator" device.
> > +Access to physical addresses is provided by a kernel-mode driver, virt2phys.
> > +It is mandatory for allocating physically-contiguous memory which is required
> > +by hardware PMDs.
>
> Should we add specific link to virt2phys README in this section as well?
>
> https://git.dpdk.org/dpdk-kmods/tree/windows/README.rst
This link is given above and I consider it general information for all
drivers. However, reading it carefully, I think docs in dpdk-kmods could be
restructured as well:
* Keep windows/README.rst unchanged, except for Device Manager steps,
which are actually specific to virt2phys.
* Create windows/virt2phys/README.rst with instructions above.
* Change windows/netuio/README.rst: remove the bulk of its content, as it
repeats generic instructions, keep netuio-specific Device Manager part.
Then a specific link for virt2phys here would make sense
and there will be even less duplication in dpdk-kmods.
If no one objects, I'll do this in v2.
Thanks!
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] [PATCH] doc/windows_gsg: update section on driver installation
2021-10-09 20:20 ` Dmitry Kozlyuk
@ 2021-10-10 1:28 ` William Tu
2021-10-11 16:33 ` Kadam, Pallavi
1 sibling, 0 replies; 6+ messages in thread
From: William Tu @ 2021-10-10 1:28 UTC (permalink / raw)
To: Dmitry Kozlyuk
Cc: Kadam, Pallavi, dpdk-dev, Narcisa Ana Maria Vasile, Dmitry Malloy
On Sat, Oct 9, 2021 at 1:20 PM Dmitry Kozlyuk <dmitry.kozliuk@gmail.com> wrote:
snip
> > > +Access to physical addresses is provided by a kernel-mode driver, virt2phys.
> > > +It is mandatory for allocating physically-contiguous memory which is required
> > > +by hardware PMDs.
> >
> > Should we add specific link to virt2phys README in this section as well?
> >
> > https://git.dpdk.org/dpdk-kmods/tree/windows/README.rst
>
> This link is given above and I consider it general information for all
> drivers. However, reading it carefully, I think docs in dpdk-kmods could be
> restructured as well:
> * Keep windows/README.rst unchanged, except for Device Manager steps,
> which are actually specific to virt2phys.
> * Create windows/virt2phys/README.rst with instructions above.
> * Change windows/netuio/README.rst: remove the bulk of its content, as it
> repeats generic instructions, keep netuio-specific Device Manager part.
> Then a specific link for virt2phys here would make sense
> and there will be even less duplication in dpdk-kmods.
> If no one objects, I'll do this in v2.
Looks good to me! Thanks
William
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] [PATCH] doc/windows_gsg: update section on driver installation
2021-10-09 20:20 ` Dmitry Kozlyuk
2021-10-10 1:28 ` William Tu
@ 2021-10-11 16:33 ` Kadam, Pallavi
1 sibling, 0 replies; 6+ messages in thread
From: Kadam, Pallavi @ 2021-10-11 16:33 UTC (permalink / raw)
To: Dmitry Kozlyuk; +Cc: dev, William Tu, Narcisa Ana Maria Vasile, Dmitry Malloy
On 10/9/2021 1:20 PM, Dmitry Kozlyuk wrote:
> 2021-10-09 12:38 (UTC-0700), Kadam, Pallavi:
>> On 10/8/2021 2:11 PM, Dmitry Kozlyuk wrote:
>>> [...]
>>> +virt2phys
>>> +~~~~~~~~~
>>>
>>> -1. From Device Manager, Action menu, select "Add legacy hardware".
>>> -2. It will launch the "Add Hardware Wizard". Click "Next".
>>> -3. Select second option "Install the hardware that I manually select
>>> - from a list (Advanced)".
>>> -4. On the next screen, "Kernel bypass" will be shown as a device class.
>>> -5. Select it, and click "Next".
>>> -6. The previously installed drivers will now be installed for the
>>> - "Virtual to physical address translator" device.
>>> +Access to physical addresses is provided by a kernel-mode driver, virt2phys.
>>> +It is mandatory for allocating physically-contiguous memory which is required
>>> +by hardware PMDs.
>> Should we add specific link to virt2phys README in this section as well?
>>
>> https://git.dpdk.org/dpdk-kmods/tree/windows/README.rst
> This link is given above and I consider it general information for all
> drivers. However, reading it carefully, I think docs in dpdk-kmods could be
> restructured as well:
> * Keep windows/README.rst unchanged, except for Device Manager steps,
> which are actually specific to virt2phys.
> * Create windows/virt2phys/README.rst with instructions above.
> * Change windows/netuio/README.rst: remove the bulk of its content, as it
> repeats generic instructions, keep netuio-specific Device Manager part.
> Then a specific link for virt2phys here would make sense
> and there will be even less duplication in dpdk-kmods.
> If no one objects, I'll do this in v2.
> Thanks!
Sounds good. Thanks, Dmitry!
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] [PATCH] doc/windows_gsg: update section on driver installation
2021-10-08 21:11 [dpdk-dev] [PATCH] doc/windows_gsg: update section on driver installation Dmitry Kozlyuk
2021-10-09 19:38 ` Kadam, Pallavi
@ 2021-10-11 19:15 ` Thomas Monjalon
1 sibling, 0 replies; 6+ messages in thread
From: Thomas Monjalon @ 2021-10-11 19:15 UTC (permalink / raw)
To: Dmitry Kozlyuk
Cc: dev, William Tu, Narcisa Ana Maria Vasile, Dmitry Malloy, Pallavi Kadam
08/10/2021 23:11, Dmitry Kozlyuk:
> Windows GSG included a section only on virt2phys driver installation,
> but not on NetUIO. The content of the section duplicated documentation
> in dpdk-kmods, but contained no links to it, only a reference.
>
> Add subsections for virt2phys and NetUIO, explaining their roles.
> Refer to documenttion in dpdk-kmods as an authoritative source,
> but leave specific diagnostic and usage hints in the GSG.
>
> Signed-off-by: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>
Applied, thanks.
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2021-10-11 19:15 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-10-08 21:11 [dpdk-dev] [PATCH] doc/windows_gsg: update section on driver installation Dmitry Kozlyuk
2021-10-09 19:38 ` Kadam, Pallavi
2021-10-09 20:20 ` Dmitry Kozlyuk
2021-10-10 1:28 ` William Tu
2021-10-11 16:33 ` Kadam, Pallavi
2021-10-11 19:15 ` Thomas Monjalon
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).