flow_classify: mark library as deprecated
Subsystems (2)
PATCH 1/1 flow_classify: mark library as deprecated
This library has no maintainer and, for now, nobody expressed interest in taking over.
Mark this experimental library as deprecated and announce plan for removal in v23.11.
--- MAINTAINERS | 3 +-- doc/guides/prog_guide/flow_classify_lib.rst | 9 +++++++++ doc/guides/rel_notes/deprecation.rst | 6 ++++++ lib/flow_classify/rte_flow_classify.c | 3 +++ lib/meson.build | 5 ++++- meson_options.txt | 2 +- 6 files changed, 24 insertions(+), 4 deletions(-)
MAINTAINERS +1 -2
@@ -1448,8 +1448,7 @@ F: doc/guides/prog_guide/ipsec_lib.rst M: Vladimir Medvedkin <[email protected]> F: app/test-sad/ -Flow Classify - EXPERIMENTAL -M: Bernard Iremonger <[email protected]> +Flow Classify - EXPERIMENTAL - UNMAINTAINED F: lib/flow_classify/ F: app/test/test_flow_classify* F: doc/guides/prog_guide/flow_classify_lib.rst
doc/guides/prog_guide/flow_classify_lib.rst +9 -0
@@ -4,6 +4,15 @@ Flow Classification Library =========================== +.. note:: + + The Flow Classification library is deprecated and will be removed in future. + See :doc:`../rel_notes/deprecation`. + + It is disabled by default in the DPDK build. + To re-enable the library, remove 'flow_classify' from the "disable_libs" + meson option when configuring a build. + DPDK provides a Flow Classification library that provides the ability to classify an input packet by matching it against a set of Flow rules.
doc/guides/rel_notes/deprecation.rst +6 -0
@@ -96,3 +96,9 @@ Deprecation Notices to have another parameter ``qp_id`` to return the queue pair ID which got error interrupt to the application, so that application can reset that particular queue pair. + +* flow_classify: The flow_classify library and example have no maintainer. + The library is experimental and, as such, it could be removed from DPDK. + Its removal has been postponed to let potential users report interest + in maintaining it. + In the absence of such interest, this library will be removed in DPDK 23.11.
lib/flow_classify/rte_flow_classify.c +3 -0
@@ -259,6 +259,9 @@ rte_flow_classifier_create(struct rte_flow_classifier_params *params)struct rte_flow_classifier *cls;int ret; +RTE_FLOW_CLASSIFY_LOG (WARNING , +"WARNING: flow_classify is deprecated and will be removed in DPDK 23.11\n" ); +/* Check input parameters */ ret =rte_flow_classifier_check_params (params);if (ret !=0 ) {
lib/meson.build +4 -1
@@ -85,7 +85,10 @@ optional_libs = [ 'vhost', ] -dpdk_libs_deprecated += ['kni'] +dpdk_libs_deprecated += [ + 'flow_classify', + 'kni', +] disabled_libs = [] opt_disabled_libs = run_command(list_dir_globs, get_option('disable_libs'),
meson_options.txt +1 -1
@@ -8,7 +8,7 @@ option('developer_mode', type: 'feature', description: 'turn on additional build checks relevant for DPDK developers') option('disable_drivers', type: 'string', value: '', description: 'Comma-separated list of drivers to explicitly disable.') -option('disable_libs', type: 'string', value: 'kni', description: +option('disable_libs', type: 'string', value: 'flow_classify,kni', description: 'Comma-separated list of libraries to explicitly disable. [NOTE: not all libs can be disabled]') option('drivers_install_subdir', type: 'string', value: 'dpdk/pmds-<VERSION>', description: 'Subdirectory of libdir where to install PMDs. Defaults to using a versioned subdirectory.')
Signature · 1 line
2.37.3
Quoted 6 lines · David Marchand
This library has no maintainer and, for now, nobody expressed interest in taking over.
Mark this experimental library as deprecated and announce plan for removal in v23.11.Signed-off-by David Marchand<[email protected]>
Quoted 10 lines
This library has no maintainer and, for now, nobody expressed interest in taking over.
Mark this experimental library as deprecated and announce plan for removal in v23.11.Signed-off-by David Marchand <[email protected]>---
Quoted 2 lines
--
2.37.3
27/10/2022 11:46, David Marchand:
Quoted 6 lines
This library has no maintainer and, for now, nobody expressed interest in taking over.
Mark this experimental library as deprecated and announce plan for removal in v23.11.Signed-off-by David Marchand <[email protected]>
It adds enough warnings to reach potential users.
David Marchand
AppliedQuoted 8 lines · Thomas Monjalon
Quoted 6 lines
This library has no maintainer and, for now, nobody expressed interest in taking over.
Mark this experimental library as deprecated and announce plan for removal in v23.11.Signed-off-by David Marchand <[email protected]>Acked-by Thomas Monjalon <[email protected]>
Applied, thanks.
Signature · 1 line
David Marchand