[PATCH v3 0/4] rework and expand EAL lcore options

[Bruce Richardson <bruce.richardson@intel.com>]

Following discussion earlier on this thread on the previous RFCs and
patches submitted [1], this series is a slightly different take on
solving the same fundamental problem - making it easy to use CPU cores
with ids >= RTE_MAX_LCORE, without having massive amounts of code
complexity internally. As previously discussed[2] this patchset
implements proposal "2a" and does the following:

* 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".
* a new flag, with long/short versions, is added as "-L" to allow the
  user to just specify a range or set of physical CPU core ids to be
  used by the app, and have them automatically mapped internally to a
  set of lcore ids starting at 0. This provides the "easy solution" to
  the original problem stated above.

For completeness, since it's in the same area, the previously separate
documentation patch, adding examples for the "--lcores" parameter, is
rolled into this series as patch 3.

[1] https://patches.dpdk.org/project/dpdk/list/?series=34911&state=*
[2] https://inbox.dpdk.org/dev/Z_PIBLQIT3eu6Ab3@bricha3-mobl1.ger.corp.intel.com/#t

Bruce Richardson (4):
  eal: deprecate old coremask-based EAL parameters
  eal: merge corelist and core mapping options
  doc: provide examples of using lcores EAL parameter
  eal: add option for auto-mapping cpu ids to low lcore ids

 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     |  61 ++++--
 .../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           | 202 +++++++-----------
 lib/eal/common/eal_options.h                  |   6 +-
 lib/eal/windows/include/sched.h               |   1 +
 18 files changed, 168 insertions(+), 182 deletions(-)

--
2.45.2