From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 80B8E431EB; Tue, 24 Oct 2023 04:57:05 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id E515542E59; Tue, 24 Oct 2023 04:55:07 +0200 (CEST) Received: from mail-qk1-f182.google.com (mail-qk1-f182.google.com [209.85.222.182]) by mails.dpdk.org (Postfix) with ESMTP id 661E242E36 for ; Tue, 24 Oct 2023 04:54:56 +0200 (CEST) Received: by mail-qk1-f182.google.com with SMTP id af79cd13be357-77896da2118so261298885a.1 for ; Mon, 23 Oct 2023 19:54:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1698116095; x=1698720895; darn=dpdk.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=fxEnMR+/qMY6gI3fQCg2JKBAer68u5/98lSv43La7h8=; b=JYWf+ZY8bE8oYqv7oWg9ZHJAGXzt54MimF0cTrfF22ciB+mEe2jroZ3nd3Ns/3xw3r 6LkOKVYnxuKlbokWXg/VPVI5VBmzr89t5zF9y5hI2pbHiY1BJnKKeQvynvJEi3CtPm/K WQxJNEmXKT0PaytP3dZ23PTTeWjLHS9mQ+h6xq96ifCy1oNHlbYY2y2iR6M05OzrhLPv 5xgwO6/efzRHB1odennX9rfwc416fWmLWaFX5UxmSv++MQNzi9QmsIkwhTngAu5NTD/1 rxswiHgKbs6Gnowf8ZRXnywPnRsWh9JcE/1dqt1k6tJW/GWXq16tAS55yHdN0biuj3rt dsiQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1698116095; x=1698720895; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=fxEnMR+/qMY6gI3fQCg2JKBAer68u5/98lSv43La7h8=; b=MJPbs9mYmWoX4IORttaqY/8W1RajtV2H6OPAajlVp4p+gvuWzK/sRZoZ0wdEJrBVha zcbyZyb15cpFVJu1jfUEM8CizJPIdEyx08rJGSlIW3zLJTcKRRzZvoFW10tSMgkAxil+ IyNKmkwlpyKnaUkUzM+IL1Fl5uF7UG6G8Nx6DO1nuGJsk7uNBtELJE679i/0vj3Fsg65 8ME7r4x+/QmH3m3teIKZZYi+pHuVdohuQ4EhySAUNbDt3vEX9JpqRzyMGbFDICOXAB+H gNftGsEgR7pfZETbENkrp+tapz5SPZ0SSSqAsUISSZv/DCD46SJYmyeSM5TULp9Zd/WQ wmZg== X-Gm-Message-State: AOJu0YzuP9kJaz2mnfyASctHAYlBBt/kCscjHYL8hKkAFMIlQCNAo0Gi PDXWa1f+3uV8lrlFVZVfG7ZDAy5b8wHfw/jmGh7VaQ== X-Google-Smtp-Source: AGHT+IHBZZNdG9v3UtVyqEtDAwYzERcs2arb5+L8JqhCMuWwhMDvuX1Q1jaw1fKU/UgKnjUvdptUsg== X-Received: by 2002:a05:620a:2787:b0:776:fc7b:19a7 with SMTP id g7-20020a05620a278700b00776fc7b19a7mr9971634qkp.69.1698116095601; Mon, 23 Oct 2023 19:54:55 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id b22-20020aa79516000000b0069b772c4325sm6802348pfp.87.2023.10.23.19.54.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 23 Oct 2023 19:54:55 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Abhinandan Gujjar , Jerin Jacob , Naga Harish K S V , Erik Gabriel Carrillo Subject: [PATCH v7 24/25] eventdev: make many API's stable Date: Mon, 23 Oct 2023 19:54:21 -0700 Message-Id: <20231024025422.126021-25-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20231024025422.126021-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20231024025422.126021-1-stephen@networkplumber.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org All API's in eventdev up to 22.11 release should be made stable. Signed-off-by: Stephen Hemminger --- lib/eventdev/rte_event_crypto_adapter.h | 4 --- lib/eventdev/rte_event_eth_rx_adapter.h | 6 ----- lib/eventdev/rte_event_eth_tx_adapter.h | 3 --- lib/eventdev/rte_event_timer_adapter.h | 3 --- lib/eventdev/rte_eventdev.h | 4 --- lib/eventdev/version.map | 34 ++++++++++--------------- 6 files changed, 13 insertions(+), 41 deletions(-) diff --git a/lib/eventdev/rte_event_crypto_adapter.h b/lib/eventdev/rte_event_crypto_adapter.h index 4e1f1bb3a8e6..e07f159b7760 100644 --- a/lib/eventdev/rte_event_crypto_adapter.h +++ b/lib/eventdev/rte_event_crypto_adapter.h @@ -694,9 +694,6 @@ rte_event_crypto_adapter_runtime_params_get(uint8_t id, struct rte_event_crypto_adapter_runtime_params *params); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Retrieve vector limits for a given event dev and crypto dev pair. * @see rte_event_crypto_adapter_vector_limits * @@ -712,7 +709,6 @@ rte_event_crypto_adapter_runtime_params_get(uint8_t id, * - 0: Success. * - <0: Error code on failure. */ -__rte_experimental int rte_event_crypto_adapter_vector_limits_get( uint8_t dev_id, uint16_t cdev_id, struct rte_event_crypto_adapter_vector_limits *limits); diff --git a/lib/eventdev/rte_event_eth_rx_adapter.h b/lib/eventdev/rte_event_eth_rx_adapter.h index 842581e87e02..cf42c69b0d71 100644 --- a/lib/eventdev/rte_event_eth_rx_adapter.h +++ b/lib/eventdev/rte_event_eth_rx_adapter.h @@ -466,7 +466,6 @@ int rte_event_eth_rx_adapter_create(uint8_t id, uint8_t dev_id, * - 0: Success * - <0: Error code on failure */ -__rte_experimental int rte_event_eth_rx_adapter_create_with_params(uint8_t id, uint8_t dev_id, struct rte_event_port_conf *port_config, struct rte_event_eth_rx_adapter_params *rxa_params); @@ -711,7 +710,6 @@ int rte_event_eth_rx_adapter_vector_limits_get( * - 0: Success, Receive queue added correctly. * - <0: Error code on failure. */ -__rte_experimental int rte_event_eth_rx_adapter_queue_conf_get(uint8_t id, uint16_t eth_dev_id, uint16_t rx_queue_id, @@ -736,7 +734,6 @@ int rte_event_eth_rx_adapter_queue_conf_get(uint8_t id, * - 0: Success, queue buffer stats retrieved. * - <0: Error code on failure. */ -__rte_experimental int rte_event_eth_rx_adapter_queue_stats_get(uint8_t id, uint16_t eth_dev_id, @@ -759,7 +756,6 @@ rte_event_eth_rx_adapter_queue_stats_get(uint8_t id, * - 0: Success, queue buffer stats retrieved. * - <0: Error code on failure. */ -__rte_experimental int rte_event_eth_rx_adapter_queue_stats_reset(uint8_t id, uint16_t eth_dev_id, @@ -780,7 +776,6 @@ rte_event_eth_rx_adapter_queue_stats_reset(uint8_t id, * - <0: Error code on failure, if the adapter doesn't use a rte_service * function, this function returns -ESRCH. */ -__rte_experimental int rte_event_eth_rx_adapter_event_port_get(uint8_t id, uint8_t *event_port_id); @@ -801,7 +796,6 @@ rte_event_eth_rx_adapter_event_port_get(uint8_t id, uint8_t *event_port_id); * - 0: Success * - <0: Error code on failure */ -__rte_experimental int rte_event_eth_rx_adapter_instance_get(uint16_t eth_dev_id, uint16_t rx_queue_id, diff --git a/lib/eventdev/rte_event_eth_tx_adapter.h b/lib/eventdev/rte_event_eth_tx_adapter.h index 1ea9a153164d..b38b3fce979b 100644 --- a/lib/eventdev/rte_event_eth_tx_adapter.h +++ b/lib/eventdev/rte_event_eth_tx_adapter.h @@ -492,7 +492,6 @@ rte_event_eth_tx_adapter_service_id_get(uint8_t id, uint32_t *service_id); * - 0: Success * - <0: Error code on failure */ -__rte_experimental int rte_event_eth_tx_adapter_instance_get(uint16_t eth_dev_id, uint16_t tx_queue_id, @@ -527,7 +526,6 @@ rte_event_eth_tx_adapter_instance_get(uint16_t eth_dev_id, * - 0: Success * - <0: Error code on failure */ -__rte_experimental int rte_event_eth_tx_adapter_queue_start(uint16_t eth_dev_id, uint16_t tx_queue_id); @@ -546,7 +544,6 @@ rte_event_eth_tx_adapter_queue_start(uint16_t eth_dev_id, uint16_t tx_queue_id); * - 0: Success * - <0: Error code on failure */ -__rte_experimental int rte_event_eth_tx_adapter_queue_stop(uint16_t eth_dev_id, uint16_t tx_queue_id); diff --git a/lib/eventdev/rte_event_timer_adapter.h b/lib/eventdev/rte_event_timer_adapter.h index fbdddf8f91bd..686cf80a675f 100644 --- a/lib/eventdev/rte_event_timer_adapter.h +++ b/lib/eventdev/rte_event_timer_adapter.h @@ -689,9 +689,6 @@ rte_event_timer_cancel_burst(const struct rte_event_timer_adapter *adapter, } /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Get the number of ticks remaining until event timer expiry. * * @param adapter diff --git a/lib/eventdev/rte_eventdev.h b/lib/eventdev/rte_eventdev.h index 2ea98302b89f..ec9b02455d2e 100644 --- a/lib/eventdev/rte_eventdev.h +++ b/lib/eventdev/rte_eventdev.h @@ -785,7 +785,6 @@ rte_event_queue_attr_get(uint8_t dev_id, uint8_t queue_id, uint32_t attr_id, * - -ENOTSUP: device does not support setting the event attribute. * - <0: failed to set event queue attribute */ -__rte_experimental int rte_event_queue_attr_set(uint8_t dev_id, uint8_t queue_id, uint32_t attr_id, uint64_t attr_value); @@ -948,7 +947,6 @@ typedef void (*rte_eventdev_port_flush_t)(uint8_t dev_id, * @param args * Argument supplied to callback. */ -__rte_experimental void rte_event_port_quiesce(uint8_t dev_id, uint8_t port_id, rte_eventdev_port_flush_t release_cb, void *args); @@ -2465,7 +2463,6 @@ rte_event_dequeue_burst(uint8_t dev_id, uint8_t port_id, struct rte_event ev[], * * @see RTE_EVENT_DEV_CAP_MAINTENANCE_FREE */ -__rte_experimental static inline int rte_event_maintain(uint8_t dev_id, uint8_t port_id, int op) { @@ -2514,7 +2511,6 @@ rte_event_maintain(uint8_t dev_id, uint8_t port_id, int op) * - 0 on success. * - -EINVAL if *dev_id*, *port_id*, or *profile_id* is invalid. */ -__rte_experimental static inline uint8_t rte_event_port_profile_switch(uint8_t dev_id, uint8_t port_id, uint8_t profile_id) { diff --git a/lib/eventdev/version.map b/lib/eventdev/version.map index 42a2f7206e4e..3d5c6c2b835c 100644 --- a/lib/eventdev/version.map +++ b/lib/eventdev/version.map @@ -5,6 +5,7 @@ DPDK_24 { __rte_eventdev_trace_deq_burst; __rte_eventdev_trace_enq_burst; __rte_eventdev_trace_eth_tx_adapter_enqueue; + __rte_eventdev_trace_maintain; __rte_eventdev_trace_timer_arm_burst; __rte_eventdev_trace_timer_arm_tmo_tick_burst; __rte_eventdev_trace_timer_cancel_burst; @@ -20,6 +21,7 @@ DPDK_24 { rte_event_crypto_adapter_stats_get; rte_event_crypto_adapter_stats_reset; rte_event_crypto_adapter_stop; + rte_event_crypto_adapter_vector_limits_get; rte_event_dequeue_timeout_ticks; rte_event_dev_attr_get; rte_event_dev_close; @@ -42,9 +44,15 @@ DPDK_24 { rte_event_eth_rx_adapter_cb_register; rte_event_eth_rx_adapter_create; rte_event_eth_rx_adapter_create_ext; + rte_event_eth_rx_adapter_create_with_params; + rte_event_eth_rx_adapter_event_port_get; rte_event_eth_rx_adapter_free; + rte_event_eth_rx_adapter_instance_get; rte_event_eth_rx_adapter_queue_add; + rte_event_eth_rx_adapter_queue_conf_get; rte_event_eth_rx_adapter_queue_del; + rte_event_eth_rx_adapter_queue_stats_get; + rte_event_eth_rx_adapter_queue_stats_reset; rte_event_eth_rx_adapter_service_id_get; rte_event_eth_rx_adapter_start; rte_event_eth_rx_adapter_stats_get; @@ -56,8 +64,11 @@ DPDK_24 { rte_event_eth_tx_adapter_create_ext; rte_event_eth_tx_adapter_event_port_get; rte_event_eth_tx_adapter_free; + rte_event_eth_tx_adapter_instance_get; rte_event_eth_tx_adapter_queue_add; rte_event_eth_tx_adapter_queue_del; + rte_event_eth_tx_adapter_queue_start; + rte_event_eth_tx_adapter_queue_stop; rte_event_eth_tx_adapter_service_id_get; rte_event_eth_tx_adapter_start; rte_event_eth_tx_adapter_stats_get; @@ -68,10 +79,12 @@ DPDK_24 { rte_event_port_default_conf_get; rte_event_port_link; rte_event_port_links_get; + rte_event_port_quiesce; rte_event_port_setup; rte_event_port_unlink; rte_event_port_unlinks_in_progress; rte_event_queue_attr_get; + rte_event_queue_attr_set; rte_event_queue_default_conf_get; rte_event_queue_setup; rte_event_ring_create; @@ -100,27 +113,6 @@ DPDK_24 { EXPERIMENTAL { global: - # added in 21.11 - __rte_eventdev_trace_maintain; - rte_event_eth_rx_adapter_create_with_params; - rte_event_eth_rx_adapter_queue_conf_get; - rte_event_eth_rx_adapter_queue_stats_get; - rte_event_eth_rx_adapter_queue_stats_reset; - - # added in 22.03 - rte_event_eth_rx_adapter_event_port_get; - - # added in 22.07 - rte_event_crypto_adapter_vector_limits_get; - rte_event_port_quiesce; - rte_event_queue_attr_set; - - # added in 22.11 - rte_event_eth_rx_adapter_instance_get; - rte_event_eth_tx_adapter_instance_get; - rte_event_eth_tx_adapter_queue_start; - rte_event_eth_tx_adapter_queue_stop; - # added in 23.03 rte_event_crypto_adapter_runtime_params_get; rte_event_crypto_adapter_runtime_params_init; -- 2.39.2