From patchwork Fri Oct 20 20:57:58 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 133103 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id C1816431BE; Fri, 20 Oct 2023 23:01:43 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 00FDB42E48; Fri, 20 Oct 2023 22:58:45 +0200 (CEST) Received: from mail-pl1-f169.google.com (mail-pl1-f169.google.com [209.85.214.169]) by mails.dpdk.org (Postfix) with ESMTP id D2DC4402DD for ; Fri, 20 Oct 2023 22:58:35 +0200 (CEST) Received: by mail-pl1-f169.google.com with SMTP id d9443c01a7336-1cace3e142eso6355385ad.3 for ; Fri, 20 Oct 2023 13:58:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697835515; x=1698440315; 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=Gh5vMLTxl7jc78RzUYoQO8xfUoVWGBHEIB0IjUQN62qXA76Zyv3So5VC4v5QoV/8YU ZK05A2IiVIOPsYqd4lkz//TJwibY+cUyzoBan4JGkQSMJO2h3/tYCX+a3wWNmboG4u+5 T4xvRzbiCxp9zZqq8TtWVLOHZCRK4eBSdB0VExLOgNro0/wgwchz8DaYfkd1nfJj8i5X Kf920oWrhkq/VYvMW5LfwWqMyhQtusvyeLy+vCiK29thJykSZ1U4vXf36Kt7zHEgFSoB RIoI/yR2leTaXaFA+DV466UEMXGJdZwFhLb3It/4nOtHD29tPCffXw5jbqs1BF6cm1zT 38Qg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697835515; x=1698440315; 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=G/17hxTIA99DPCIpwQTGa3qoCLDS5gv75gdVEinkCz/kUAyUBIa1CZn3mcxRFw8uEU 51OW2GzjOu290065K5GnVgEabuvwZ7UbjvpGWk0yJNh2AM6yxe+TwixnfL1Ej0y3Gc6p 4EK+TJs92MVfx6PXEbi3XImhzsEXDVGpf+SBh74b39KGLda5Xr73FTP1SrQ68LH983WJ +3iyzeUUY78zEWng8u2S/vwfktHU9nrlKrv9d+ec/4bx4K379v2CZfq2P2qBvQ4nJJ6U GCN/3DHxBYfzAKqyb+e2aHfHMem59qaqDS2ym1mviCJBTJVsq2jA2aDRv++BZ9i2+br1 fN1g== X-Gm-Message-State: AOJu0YwsLCjm2XVo2AthryhVSK+krjlhVUmQoBEhj1Aep7uYI1ZhnBlO trV80zKuYx/Co8znMs0x6VrcmRp1xmFwetyIW4LSRg== X-Google-Smtp-Source: AGHT+IFQgjb6ZuRK1RJ02odzjqtY+wtByhvM9U1OlbTZOdHZ5cC4bEEMZx7hRG3xUb7CkDcSODSRMg== X-Received: by 2002:a17:902:fb88:b0:1c7:49dd:2df with SMTP id lg8-20020a170902fb8800b001c749dd02dfmr2930879plb.32.1697835514819; Fri, 20 Oct 2023 13:58:34 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id u17-20020a170902e5d100b001c61512f2a6sm1930961plf.220.2023.10.20.13.58.34 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Oct 2023 13:58:34 -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 v5 25/26] eventdev: make many API's stable Date: Fri, 20 Oct 2023 13:57:58 -0700 Message-Id: <20231020205759.195126-26-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20231020205759.195126-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20231020205759.195126-1-stephen@networkplumber.org> MIME-Version: 1.0 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;