[v4,0/3] lcore options cleanup

This v4 scales back some of the work done in the previous versions, since
more options need to be looked at for the core handling. For now, then
this patchset is reduced to some basic cleanup before any more serious work
is done.

* marks the old coremask parameter (-c) and service core mask (-s) as
  deprecated, so they can be dropped in future. Everything should now be
  done using core lists where possible.
* consolidates the, previously separate but similar, "-l" and "--lcores"
  flags into just short and long versions of the same thing. This does
  not affect the "--lcores" flag at all, but expands the scope of what
  was possible with "-l".
* Adds documentation of examples of use of the -l/--lcores parameter

Bruce Richardson (3):
  eal: deprecate old coremask-based EAL parameters
  eal: merge corelist and core mapping options
  doc: provide examples of using lcores EAL parameter

 doc/guides/eventdevs/dlb2.rst                 |   6 +-
 doc/guides/faq/faq.rst                        |   8 +-
 doc/guides/linux_gsg/build_sample_apps.rst    |   7 +-
 doc/guides/linux_gsg/eal_args.include.rst     |  45 ++++--
 .../prog_guide/env_abstraction_layer.rst      |   3 +-
 doc/guides/prog_guide/meson_ut.rst            |   2 +-
 doc/guides/prog_guide/multi_proc_support.rst  |   2 +-
 doc/guides/prog_guide/service_cores.rst       |   8 +-
 doc/guides/rel_notes/deprecation.rst          |  10 ++
 doc/guides/sample_app_ug/ip_frag.rst          |   7 +-
 doc/guides/sample_app_ug/ip_reassembly.rst    |   7 +-
 doc/guides/sample_app_ug/multi_process.rst    |  14 +-
 doc/guides/sample_app_ug/qos_scheduler.rst    |   2 +-
 doc/guides/sample_app_ug/test_pipeline.rst    |   2 +-
 doc/guides/tools/testbbdev.rst                |   2 +-
 lib/eal/common/eal_common_options.c           | 141 +++---------------
 lib/eal/common/eal_options.h                  |   4 +-
 17 files changed, 91 insertions(+), 179 deletions(-)

--
2.45.2
  

On Tue, May 13, 2025 at 05:17:07PM +0100, Bruce Richardson wrote:
> This v4 scales back some of the work done in the previous versions, since
> more options need to be looked at for the core handling. For now, then
> this patchset is reduced to some basic cleanup before any more serious work
> is done.
> 
> * marks the old coremask parameter (-c) and service core mask (-s) as
>   deprecated, so they can be dropped in future. Everything should now be
>   done using core lists where possible.
> * consolidates the, previously separate but similar, "-l" and "--lcores"
>   flags into just short and long versions of the same thing. This does
>   not affect the "--lcores" flag at all, but expands the scope of what
>   was possible with "-l".
> * Adds documentation of examples of use of the -l/--lcores parameter
> 
> Bruce Richardson (3):
>   eal: deprecate old coremask-based EAL parameters
>   eal: merge corelist and core mapping options
>   doc: provide examples of using lcores EAL parameter
> 
>  doc/guides/eventdevs/dlb2.rst                 |   6 +-
>  doc/guides/faq/faq.rst                        |   8 +-
>  doc/guides/linux_gsg/build_sample_apps.rst    |   7 +-
>  doc/guides/linux_gsg/eal_args.include.rst     |  45 ++++--
>  .../prog_guide/env_abstraction_layer.rst      |   3 +-
>  doc/guides/prog_guide/meson_ut.rst            |   2 +-
>  doc/guides/prog_guide/multi_proc_support.rst  |   2 +-
>  doc/guides/prog_guide/service_cores.rst       |   8 +-
>  doc/guides/rel_notes/deprecation.rst          |  10 ++
>  doc/guides/sample_app_ug/ip_frag.rst          |   7 +-
>  doc/guides/sample_app_ug/ip_reassembly.rst    |   7 +-
>  doc/guides/sample_app_ug/multi_process.rst    |  14 +-
>  doc/guides/sample_app_ug/qos_scheduler.rst    |   2 +-
>  doc/guides/sample_app_ug/test_pipeline.rst    |   2 +-
>  doc/guides/tools/testbbdev.rst                |   2 +-
>  lib/eal/common/eal_common_options.c           | 141 +++---------------
>  lib/eal/common/eal_options.h                  |   4 +-
>  17 files changed, 91 insertions(+), 179 deletions(-)
> 
Recheck-request: iol-unit-amd64-testing