[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

[PATCH 2/2] doc: use common description of EAL parameters

[David Marchand]

Rather than have a subset of the EAL parameters described in the sample
apps documentation, prefer referring to the full list.

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

diff --git a/doc/guides/freebsd_gsg/build_sample_apps.rst b/doc/guides/freebsd_gsg/build_sample_apps.rst
index 5212c1a0b4..db01b16e18 100644
--- a/doc/guides/freebsd_gsg/build_sample_apps.rst
+++ b/doc/guides/freebsd_gsg/build_sample_apps.rst
@@ -57,38 +57,7 @@ Running a Sample Application
     Abstraction Layer (EAL) library, which provides some options that are generic
     to every DPDK application.
 
-A large number of options can be given to the EAL when running an
-application. A full list of options can be got by passing `--help` to a
-DPDK application. Some of the EAL options for FreeBSD are as follows:
-
-*   ``-l CORELIST``:
-    A comma-separated list of the cores, or ranges of cores to run on.
-    For example, ``-l 0,1,4-6`` will run on cores 0, 1, 4, 5 and 6.
-    Note that core numbering can change between platforms and should be determined beforehand.
-
-*   ``-b <domain:bus:devid.func>``:
-    Blocklisting of ports; prevent EAL from using specified PCI device
-    (multiple ``-b`` options are allowed).
-
-*   ``-v``:
-    Display version information on startup.
-
-*   ``-m MB``:
-    Memory to allocate from hugepages, regardless of processor socket.
-
-Other options, specific to Linux and are not supported under FreeBSD are as follows:
-
-*   ``socket-mem``:
-    Memory to allocate from hugepages on specific sockets.
-
-*   ``--huge-dir``:
-    The directory where hugetlbfs is mounted.
-
-*   ``--mbuf-pool-ops-name``:
-    Pool ops name for mbuf to use.
-
-*   ``--file-prefix``:
-    The prefix text used for hugepage filenames.
+You can refer to :doc:`freebsd_eal_parameters` for the list of EAL options.
 
 .. _running_non_root:
 
diff --git a/doc/guides/linux_gsg/build_sample_apps.rst b/doc/guides/linux_gsg/build_sample_apps.rst
index aed184fc33..49f88357da 100644
--- a/doc/guides/linux_gsg/build_sample_apps.rst
+++ b/doc/guides/linux_gsg/build_sample_apps.rst
@@ -29,80 +29,7 @@ Running a Sample Application
 The application is linked with the DPDK target environment's Environmental Abstraction Layer (EAL) library,
 which provides some options that are generic to every DPDK application.
 
-The following is the list of options that can be given to the EAL:
-
-.. code-block:: console
-
-    ./rte-app [-l CORELIST] [-n NUM] [-b <domain:bus:devid.func>] \
-              [--numa-mem=MB,...] [-d LIB.so|DIR] [-m MB] [-r NUM] [-v] [--file-prefix] \
-	      [--proc-type <primary|secondary|auto>]
-
-The EAL options are as follows:
-
-* ``-l CORELIST``:
-  A comma-separated list of the cores, or ranges of cores to run on.
-  For example, ``-l 0,1,4-6`` will run on cores 0, 1, 4, 5 and 6.
-  Note that core numbering can change between platforms and should be determined beforehand.
-
-* ``-n NUM``:
-  Number of memory channels per processor socket.
-
-* ``-b <domain:bus:devid.func>``:
-  Blocklisting of ports; prevent EAL from using specified PCI device
-  (multiple ``-b`` options are allowed).
-
-* ``--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
-  application closes).
-
-* ``--numa-limit``:
-  Limit maximum memory available for allocation on each socket. Does not support
-  legacy memory mode.
-
-* ``-d``:
-  Add a driver or driver directory to be loaded.
-  The application should use this option to load the PMDs
-  that are built as shared libraries.
-
-* ``-m MB``:
-  Memory to allocate from hugepages, regardless of processor socket. It is
-  recommended that ``--numa-mem`` be used instead of this option.
-
-* ``-r NUM``:
-  Number of memory ranks.
-
-* ``-v``:
-  Display version information on startup.
-
-* ``--huge-dir``:
-  The directory where hugetlbfs is mounted.
-
-* ``--mbuf-pool-ops-name``:
-  Pool ops name for mbuf to use.
-
-* ``--file-prefix``:
-  The prefix text used for hugepage filenames.
-
-* ``--proc-type``:
-  The type of process instance.
-
-* ``--vmware-tsc-map``:
-  Use VMware TSC map instead of native RDTSC.
-
-* ``--base-virtaddr``:
-  Specify base virtual address.
-
-* ``--vfio-intr``:
-  Specify interrupt type to be used by VFIO (has no effect if VFIO is not used).
-
-* ``--legacy-mem``:
-  Run DPDK in legacy memory mode (disable memory reserve/unreserve at runtime,
-  but provide more IOVA-contiguous memory).
-
-* ``--single-file-segments``:
-  Store memory segments in fewer files (dynamic memory mode only - does not
-  affect legacy memory mode).
+You can refer to :doc:`linux_eal_parameters` for the list of EAL options.
 
 Copy the DPDK application binary to your target, then run the application as follows
 (assuming the platform has four memory channels per processor socket,
-- 
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>

Re: [PATCH 2/2] doc: use common description of EAL parameters

[Bruce Richardson]

On Thu, Jul 17, 2025 at 01:46:04PM +0200, David Marchand wrote:
> Rather than have a subset of the EAL parameters described in the sample
> apps documentation, prefer referring to the full list.
> 
> Signed-off-by: David Marchand <david.marchand@redhat.com>
> ---
Acked-by: Bruce Richardson <bruce.richardson@intel.com>

Re: [PATCH 2/2] doc: use common description of EAL parameters

[Thomas Monjalon]

17/07/2025 14:15, Bruce Richardson:
> On Thu, Jul 17, 2025 at 01:46:04PM +0200, David Marchand wrote:
> > Rather than have a subset of the EAL parameters described in the sample
> > apps documentation, prefer referring to the full list.
> > 
> > Signed-off-by: David Marchand <david.marchand@redhat.com>
> > ---
> Acked-by: Bruce Richardson <bruce.richardson@intel.com>

Series applied, thanks.