From 61ed434ad1dc60e770f95477a990d162b414e44d Mon Sep 17 00:00:00 2001 From: Thomas Monjalon Date: Thu, 22 Nov 2018 11:32:23 +0100 Subject: [PATCH] doc: announce kvargs API change After processing a kvlist in rte_kvargs_process(), it may be needed to loop again over kvlist in order to know whether the key is matched or not. In order to simplify implementation of kvargs checks, a new pointer parameter may be used to get the match count. The change of the function prototype would be as below: int rte_kvargs_process(const struct rte_kvargs *kvlist, const char *key_match, + int *match_count, arg_handler_t handler, void *opaque_arg) Signed-off-by: Thomas Monjalon Acked-by: Olivier Matz Acked-by: Ferruh Yigit Acked-by: Jerin Jacob --- doc/guides/rel_notes/deprecation.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 024f4b2d2a..edcd71d4ce 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -11,6 +11,9 @@ API and ABI deprecation notices are to be posted here. Deprecation Notices ------------------- +* kvargs: The function ``rte_kvargs_process`` will get a new parameter + for returning key match count. It will ease handling of no-match case. + * eal: function ``rte_bsf64`` in ``rte_bitmap.h`` has been renamed to ``rte_bsf64_safe`` and moved to ``rte_common.h``. A new ``rte_bsf64`` function will be added in the next release in ``rte_common.h`` that follows convention -- 2.20.1