[PATCH 1/2] doc: remove reference to device selection option

[PATCH 1/2] doc: remove reference to device selection option

[David Marchand]

--use-device was replaced with -a / --vdev options in v1.6
with commit cac6d08c8bde ("devargs: replace --use-device option by
--pci-whitelist and --vdev").

It was reintroduced in the doc in v1.8 when the rst documentation
was imported in .rst format.

Fixes: 1ab07743b21b ("doc: getting started guide for linux")
Fixes: dacdbfa45752 ("doc: getting started guide for freebsd")
Cc: stable@dpdk.org

Signed-off-by: David Marchand <david.marchand@redhat.com>
---
 doc/guides/freebsd_gsg/build_sample_apps.rst | 4 ----
 doc/guides/linux_gsg/build_sample_apps.rst   | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/doc/guides/freebsd_gsg/build_sample_apps.rst b/doc/guides/freebsd_gsg/build_sample_apps.rst
index 1f054f2152..5212c1a0b4 100644
--- a/doc/guides/freebsd_gsg/build_sample_apps.rst
+++ b/doc/guides/freebsd_gsg/build_sample_apps.rst
@@ -70,10 +70,6 @@ DPDK application. Some of the EAL options for FreeBSD are as follows:
     Blocklisting of ports; prevent EAL from using specified PCI device
     (multiple ``-b`` options are allowed).
 
-*   ``--use-device``:
-    Use the specified Ethernet device(s) only.  Use comma-separate
-    ``[domain:]bus:devid.func`` values. Cannot be used with ``-b`` option.
-
 *   ``-v``:
     Display version information on startup.
 
diff --git a/doc/guides/linux_gsg/build_sample_apps.rst b/doc/guides/linux_gsg/build_sample_apps.rst
index f2b92187a6..aed184fc33 100644
--- a/doc/guides/linux_gsg/build_sample_apps.rst
+++ b/doc/guides/linux_gsg/build_sample_apps.rst
@@ -51,10 +51,6 @@ The EAL options are as follows:
   Blocklisting of ports; prevent EAL from using specified PCI device
   (multiple ``-b`` options are allowed).
 
-* ``--use-device``:
-  use the specified Ethernet device(s) only. Use comma-separate
-  ``[domain:]bus:devid.func`` values. Cannot be used with ``-b`` option.
-
 * ``--numa-mem``:
   Memory to allocate from hugepages on specific sockets. In dynamic memory mode,
   this memory will also be pinned (i.e. not released back to the system until
-- 
2.50.0

Re: [PATCH 1/2] doc: remove reference to device selection option

[Bruce Richardson]

On Thu, Jul 17, 2025 at 01:46:03PM +0200, David Marchand wrote:
> --use-device was replaced with -a / --vdev options in v1.6
> with commit cac6d08c8bde ("devargs: replace --use-device option by
> --pci-whitelist and --vdev").
> 
> It was reintroduced in the doc in v1.8 when the rst documentation
> was imported in .rst format.
> 

Those are some really, really old release versions! This issue has been
around a very long time, it seems!

> Fixes: 1ab07743b21b ("doc: getting started guide for linux")
> Fixes: dacdbfa45752 ("doc: getting started guide for freebsd")
> Cc: stable@dpdk.org
> 
> Signed-off-by: David Marchand <david.marchand@redhat.com>
Acked-by: Bruce Richardson <bruce.richardson@intel.com>