From: Aaron Conole <aconole@redhat.com>
To: Gage Eads <gage.eads@intel.com>
Cc: dev@dpdk.org, jerinj@marvell.com, harry.van.haaren@intel.com,
nikhil.rao@intel.com, erik.g.carrillo@intel.com,
nhorman@tuxdriver.com,
Bruce Richardson <bruce.richardson@intel.com>,
Pablo de Lara <pablo.de.lara.guarch@intel.com>
Subject: Re: [dpdk-dev] [PATCH] eal: promote some service core functions to stable
Date: Thu, 20 Jun 2019 14:25:42 -0400 [thread overview]
Message-ID: <f7tv9x0ru55.fsf@dhcp-25.97.bos.redhat.com> (raw)
In-Reply-To: <20190620164206.3972-1-gage.eads@intel.com> (Gage Eads's message of "Thu, 20 Jun 2019 11:42:06 -0500")
Gage Eads <gage.eads@intel.com> writes:
> The functions rte_service_may_be_active(), rte_service_lcore_attr_get(),
> and rte_service_attr_reset_all() were introduced nearly a year ago in DPDK
> 18.08. They can be considered non-experimental for the 19.08 release.
>
> rte_service_may_be_active() is used by eventdev and the sw PMD, and this
> commit allows them to not need any experimental API.
>
> Signed-off-by: Gage Eads <gage.eads@intel.com>
> ---
> drivers/event/sw/Makefile | 1 -
> drivers/event/sw/meson.build | 1 -
> lib/librte_eal/common/include/rte_service.h | 15 +++------------
> lib/librte_eal/common/rte_service.c | 6 +++---
> lib/librte_eal/rte_eal_version.map | 6 +++---
> lib/librte_eventdev/Makefile | 1 -
> lib/librte_eventdev/meson.build | 1 -
> 7 files changed, 9 insertions(+), 22 deletions(-)
>
> diff --git a/drivers/event/sw/Makefile b/drivers/event/sw/Makefile
> index 81236a392..c6600e836 100644
> --- a/drivers/event/sw/Makefile
> +++ b/drivers/event/sw/Makefile
> @@ -7,7 +7,6 @@ include $(RTE_SDK)/mk/rte.vars.mk
> LIB = librte_pmd_sw_event.a
>
> # build flags
> -CFLAGS += -DALLOW_EXPERIMENTAL_API
> CFLAGS += -O3
> CFLAGS += $(WERROR_FLAGS)
> # for older GCC versions, allow us to initialize an event using
> diff --git a/drivers/event/sw/meson.build b/drivers/event/sw/meson.build
> index 30d221647..985012219 100644
> --- a/drivers/event/sw/meson.build
> +++ b/drivers/event/sw/meson.build
> @@ -1,7 +1,6 @@
> # SPDX-License-Identifier: BSD-3-Clause
> # Copyright(c) 2017 Intel Corporation
>
> -allow_experimental_apis = true
I don't think you can remove these. There are still some experimental
APIs (f.e. the rename for rte_cryptodev_sym_session_get_private_data
marked that function as experimental and it will cause build breakage).
Maybe I'm mis understanding it? It would be good to get verification
from Bruce whether that API should not be marked as experimental (it was
just a rename, so not sure...) - maybe that's a follow up for this
patch?
See: https://travis-ci.com/ovsrobot/dpdk/jobs/209722145 for an example
The odd thing is I only see it on the clang builds - perhaps it's a
missing definition for the clang compiler.
> sources = files('sw_evdev_scheduler.c',
> 'sw_evdev_selftest.c',
> 'sw_evdev_worker.c',
> diff --git a/lib/librte_eal/common/include/rte_service.h b/lib/librte_eal/common/include/rte_service.h
> index bf25aec35..d8701dd4c 100644
> --- a/lib/librte_eal/common/include/rte_service.h
> +++ b/lib/librte_eal/common/include/rte_service.h
> @@ -162,9 +162,6 @@ int32_t rte_service_runstate_set(uint32_t id, uint32_t runstate);
> int32_t rte_service_runstate_get(uint32_t id);
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
> - *
> * This function returns whether the service may be currently executing on
> * at least one lcore, or definitely is not. This function can be used to
> * determine if, after setting the service runstate to stopped, the service
> @@ -178,7 +175,7 @@ int32_t rte_service_runstate_get(uint32_t id);
> * @retval 0 Service is not running on any lcore
> * @retval -EINVAL Invalid service id
> */
> -int32_t __rte_experimental
> +int32_t
> rte_service_may_be_active(uint32_t id);
>
> /**
> @@ -389,9 +386,6 @@ int32_t rte_service_attr_reset_all(uint32_t id);
> #define RTE_SERVICE_LCORE_ATTR_LOOPS 0
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Get an attribute from a service core.
> *
> * @param lcore Id of the service core.
> @@ -401,14 +395,11 @@ int32_t rte_service_attr_reset_all(uint32_t id);
> * -EINVAL Invalid lcore, attr_id or attr_value was NULL.
> * -ENOTSUP lcore is not a service core.
> */
> -int32_t __rte_experimental
> +int32_t
> rte_service_lcore_attr_get(uint32_t lcore, uint32_t attr_id,
> uint64_t *attr_value);
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Reset all attribute values of a service core.
> *
> * @param lcore The service core to reset all the statistics of
> @@ -416,7 +407,7 @@ rte_service_lcore_attr_get(uint32_t lcore, uint32_t attr_id,
> * -EINVAL Invalid service id provided
> * -ENOTSUP lcore is not a service core.
> */
> -int32_t __rte_experimental
> +int32_t
> rte_service_lcore_attr_reset_all(uint32_t lcore);
>
> #ifdef __cplusplus
> diff --git a/lib/librte_eal/common/rte_service.c b/lib/librte_eal/common/rte_service.c
> index 5f75e5a53..c3653ebae 100644
> --- a/lib/librte_eal/common/rte_service.c
> +++ b/lib/librte_eal/common/rte_service.c
> @@ -378,7 +378,7 @@ service_run(uint32_t i, int lcore, struct core_state *cs, uint64_t service_mask)
> return 0;
> }
>
> -int32_t __rte_experimental
> +int32_t
> rte_service_may_be_active(uint32_t id)
> {
> uint32_t ids[RTE_MAX_LCORE] = {0};
> @@ -754,7 +754,7 @@ rte_service_attr_get(uint32_t id, uint32_t attr_id, uint64_t *attr_value)
> }
> }
>
> -int32_t __rte_experimental
> +int32_t
> rte_service_lcore_attr_get(uint32_t lcore, uint32_t attr_id,
> uint64_t *attr_value)
> {
> @@ -814,7 +814,7 @@ rte_service_attr_reset_all(uint32_t id)
> return 0;
> }
>
> -int32_t __rte_experimental
> +int32_t
> rte_service_lcore_attr_reset_all(uint32_t lcore)
> {
> struct core_state *cs;
> diff --git a/lib/librte_eal/rte_eal_version.map b/lib/librte_eal/rte_eal_version.map
> index 824edf0ff..fc26b9503 100644
> --- a/lib/librte_eal/rte_eal_version.map
> +++ b/lib/librte_eal/rte_eal_version.map
> @@ -292,6 +292,9 @@ DPDK_19.08 {
>
> rte_lcore_index;
> rte_lcore_to_socket_id;
> + rte_service_lcore_attr_get;
> + rte_service_lcore_attr_reset_all;
> + rte_service_may_be_active;
>
> } DPDK_19.05;
>
> @@ -383,9 +386,6 @@ EXPERIMENTAL {
> rte_mp_sendmsg;
> rte_option_register;
> rte_realloc_socket;
> - rte_service_lcore_attr_get;
> - rte_service_lcore_attr_reset_all;
> - rte_service_may_be_active;
>
> # added in 19.08
> rte_lcore_cpuset;
> diff --git a/lib/librte_eventdev/Makefile b/lib/librte_eventdev/Makefile
> index 53079f4c2..fdaec7d06 100644
> --- a/lib/librte_eventdev/Makefile
> +++ b/lib/librte_eventdev/Makefile
> @@ -11,7 +11,6 @@ LIB = librte_eventdev.a
> LIBABIVER := 6
>
> # build flags
> -CFLAGS += -DALLOW_EXPERIMENTAL_API
> CFLAGS += -O3
> CFLAGS += $(WERROR_FLAGS)
> ifeq ($(CONFIG_RTE_EXEC_ENV_LINUX),y)
> diff --git a/lib/librte_eventdev/meson.build b/lib/librte_eventdev/meson.build
> index 6cfe60e1f..f623d74f8 100644
> --- a/lib/librte_eventdev/meson.build
> +++ b/lib/librte_eventdev/meson.build
> @@ -2,7 +2,6 @@
> # Copyright(c) 2017 Intel Corporation
>
> version = 6
> -allow_experimental_apis = true
>
> if is_linux
> cflags += '-DLINUX'
next prev parent reply other threads:[~2019-06-20 18:26 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-06-20 16:42 Gage Eads
2019-06-20 18:25 ` Aaron Conole [this message]
2019-06-20 18:39 ` Eads, Gage
2019-06-20 19:45 ` David Marchand
2019-06-20 20:16 ` David Marchand
2019-06-21 12:45 ` David Marchand
2019-06-21 16:27 ` Neil Horman
2019-06-21 16:47 ` David Marchand
2019-06-21 17:40 ` Neil Horman
2019-06-21 19:58 ` David Marchand
2019-06-22 16:17 ` Neil Horman
2019-06-22 17:51 ` David Marchand
2019-06-22 19:33 ` Neil Horman
2019-06-20 19:02 ` [dpdk-dev] [PATCH v2] " Gage Eads
2019-06-27 12:48 ` David Marchand
2019-06-27 16:25 ` Eads, Gage
2019-07-08 10:23 ` Thomas Monjalon
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=f7tv9x0ru55.fsf@dhcp-25.97.bos.redhat.com \
--to=aconole@redhat.com \
--cc=bruce.richardson@intel.com \
--cc=dev@dpdk.org \
--cc=erik.g.carrillo@intel.com \
--cc=gage.eads@intel.com \
--cc=harry.van.haaren@intel.com \
--cc=jerinj@marvell.com \
--cc=nhorman@tuxdriver.com \
--cc=nikhil.rao@intel.com \
--cc=pablo.de.lara.guarch@intel.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).