| Message ID | 20230809001017.293037-1-stephen@networkplumber.org (mailing list archive) |
|---|---|
| Headers |
Return-Path: <dev-bounces@dpdk.org> 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 6176143011; Wed, 9 Aug 2023 02:10:30 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 2D8AB40DFB; Wed, 9 Aug 2023 02:10:30 +0200 (CEST) Received: from mail-pl1-f180.google.com (mail-pl1-f180.google.com [209.85.214.180]) by mails.dpdk.org (Postfix) with ESMTP id F3F2E400D6 for <dev@dpdk.org>; Wed, 9 Aug 2023 02:10:28 +0200 (CEST) Received: by mail-pl1-f180.google.com with SMTP id d9443c01a7336-1bbf0f36ce4so41296955ad.0 for <dev@dpdk.org>; Tue, 08 Aug 2023 17:10:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20221208.gappssmtp.com; s=20221208; t=1691539828; x=1692144628; 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=H/xYw746bM5O6zcAQNQQJwENide3YNi+vVN9PxR+UlI=; b=dbW+3KTYO9L9Qya3xWdsI8xTfqAhzE63tgOPjVb4ijIs5Hc3o8HIsq5MRlIhOo8okf AA2K56fFzXE7BLftg15OYpGe6on37KIzhYDGLAAbbYF7D7iTKtxgEsg4WFyt4xzwh1Pi 2R7NAL6223zkkIaq+gKCq1j4GLNcAwUfq+NCQIHuJSJPqMinM/gBvK9lPcY3fMSLTWuX EM7JdC66FZhS9MTPh2VwrWeeNDBKJ8G2qjuusMnSotNON0c2W4gazXpNKlSEJlzamq0u u+3y6p+M/EKsEJpzDr/jIee+RMF+EIDpaZ8iP2I/FiEnxTvUXmBSl+AQdHHkfMCDDxTz Nt2g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691539828; x=1692144628; 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=H/xYw746bM5O6zcAQNQQJwENide3YNi+vVN9PxR+UlI=; b=dQ9hb8AAj68WVbf+JMEm2up9WedxBMCTo3nxK18o0cv8B3Zn0qPX9RSx850gNC57TT KgX8MVG6kbntFKfb3F0CNUWGluXGTGW95PhojPyhaiah3v1Vk8zuA3ERtPQokVZzgGHO pJ9tTfE34mc0VNHgybuhg4Kiyg252Y9qjaxV3bHHn1TO/ra8C9vMvQuFYEkFdbGApQ3s YMY+vf7pWOEhl11HeZlaqLNwwk4ItMIPaaF/FDNFB9L4sXmDc1fKgMBqL3VZgJrBnT4x q0M1SEaWme1SrvMrFz0IX7YlWlZJGHVdA4NJTzyDRCveVI3foaJYjcAs1cMgO7mr5wyr nFQg== X-Gm-Message-State: AOJu0Yy3RVp5BKbnjJeqchaWEsdCtCc0FZkd9MG6RU/xKXzNpL1PDLTt QEQt7UkGFhsYbE6wltqK9+UMqrbkvdSeGuoKhpgZNw== X-Google-Smtp-Source: AGHT+IFY/wzGJBMvbURZPm7zGwJ/AUfJdLjYv+o+gd6CNK3VVyvPNUlK+WdUiWouPvoUupnFSFp+Ew== X-Received: by 2002:a17:903:2387:b0:1bc:ee6:7f2e with SMTP id v7-20020a170903238700b001bc0ee67f2emr914443plh.53.1691539827688; Tue, 08 Aug 2023 17:10:27 -0700 (PDT) Received: from hermes.local (204-195-127-207.wavecable.com. [204.195.127.207]) by smtp.gmail.com with ESMTPSA id ix11-20020a170902f80b00b001bc676df6a9sm5745629plb.132.2023.08.08.17.10.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 08 Aug 2023 17:10:27 -0700 (PDT) From: Stephen Hemminger <stephen@networkplumber.org> To: dev@dpdk.org Cc: Stephen Hemminger <stephen@networkplumber.org> Subject: [PATCH v2 00/29] promote many API's to stable Date: Tue, 8 Aug 2023 17:09:48 -0700 Message-Id: <20230809001017.293037-1-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230808173527.186042-1-stephen@networkplumber.org> References: <20230808173527.186042-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 <dev.dpdk.org> List-Unsubscribe: <https://mails.dpdk.org/options/dev>, <mailto:dev-request@dpdk.org?subject=unsubscribe> List-Archive: <http://mails.dpdk.org/archives/dev/> List-Post: <mailto:dev@dpdk.org> List-Help: <mailto:dev-request@dpdk.org?subject=help> List-Subscribe: <https://mails.dpdk.org/listinfo/dev>, <mailto:dev-request@dpdk.org?subject=subscribe> Errors-To: dev-bounces@dpdk.org |
| Series |
promote many API's to stable
|
|
Message
Stephen Hemminger
Aug. 9, 2023, 12:09 a.m. UTC
Since 23.11 is an LTS release it is time to remove the experimental bandaid off many API's. There are about 850 API's marked with experimental on current main branch. This addresses the easy to remove ones and gets it down to about 690 places. The rule is any API that has been in since 22.11 needs to have experimental removed (or deleted). The experimental flag is intended to be temporary not a "get out of ABI stability for free" card. v2 - add more libraries to the mix - remove EXPERIMENTAL where tagged in MAINTAINERS Stephen Hemminger (29): bpf: make rte_bpf_dump and rte_bpf_convert stable API's cmdline: make experimental API's stable ethdev: mark rte_mtr API's as stable ethdev: mark rte_tm API's as stable pdump: make API's stable pcapng: mark API's as stable net: remove experimental from functions rcu: remove experimental from rte_rcu_qbsr lpm: remove experimental mbuf: remove experimental from create_extbuf hash: remove experimental from toeplitz hash timer: remove experimental from rte_timer_next_ticks sched: remove experimental dmadev: mark API's as not experimental meter: remove experimental warning from comments power: remove experimental from API's kvargs: remove experimental flag ip_frag: mark a couple of functions stable member: remove experimental tag security: remove experimental flag vhost: remove experimental from some API's bbdev: remove experimental tag ipsec: remove experimental from SA API compressdev: remove experimental flag regexdev: remove experimental tag node: remove experimental tag cryptodev: remove experimental from more API's table: remove experimental from API port: make API's stable MAINTAINERS | 10 +- doc/guides/rel_notes/deprecation.rst | 6 -- lib/bbdev/rte_bbdev.h | 4 - lib/bbdev/rte_bbdev_op.h | 2 - lib/bbdev/version.map | 18 ++-- lib/bpf/rte_bpf.h | 2 - lib/bpf/version.map | 9 +- lib/cmdline/cmdline.h | 1 - lib/cmdline/cmdline_parse.h | 4 - lib/cmdline/cmdline_rdline.h | 4 - lib/cmdline/version.map | 26 ++--- lib/compressdev/rte_comp.h | 6 -- lib/compressdev/rte_compressdev.h | 26 ----- lib/compressdev/rte_compressdev_pmd.h | 6 -- lib/compressdev/version.map | 2 +- lib/cryptodev/rte_crypto_sym.h | 1 - lib/cryptodev/rte_cryptodev.h | 32 ------ lib/cryptodev/version.map | 77 ++++++-------- lib/dmadev/rte_dmadev.h | 85 ---------------- lib/dmadev/version.map | 2 +- lib/ethdev/rte_mtr.h | 25 +---- lib/ethdev/rte_tm.h | 34 ------- lib/ethdev/version.map | 88 ++++++++-------- lib/hash/rte_thash.h | 44 -------- lib/hash/rte_thash_gfni.h | 8 -- lib/hash/rte_thash_x86_gfni.h | 8 -- lib/hash/version.map | 16 +-- lib/ip_frag/rte_ip_frag.h | 2 - lib/ip_frag/version.map | 9 +- lib/ipsec/rte_ipsec.h | 2 - lib/ipsec/version.map | 9 +- lib/kvargs/rte_kvargs.h | 4 - lib/kvargs/version.map | 8 +- lib/lpm/rte_lpm.h | 4 - lib/lpm/version.map | 7 +- lib/mbuf/rte_mbuf.h | 1 - lib/mbuf/version.map | 8 +- lib/member/rte_member.h | 54 ---------- lib/member/version.map | 12 +-- lib/meter/rte_meter.h | 12 --- lib/net/rte_ip.h | 19 ---- lib/node/rte_node_eth_api.h | 5 - lib/node/rte_node_ip4_api.h | 6 -- lib/node/rte_node_ip6_api.h | 6 -- lib/node/version.map | 2 +- lib/pcapng/rte_pcapng.h | 11 -- lib/pcapng/version.map | 6 +- lib/pdump/rte_pdump.h | 12 --- lib/pdump/version.map | 11 +- lib/pipeline/rte_port_in_action.h | 8 -- lib/pipeline/rte_swx_ctl.h | 57 ----------- lib/pipeline/rte_swx_pipeline.h | 29 ------ lib/pipeline/rte_table_action.h | 16 --- lib/pipeline/version.map | 140 ++++++++++++-------------- lib/port/version.map | 24 ++--- lib/power/rte_power.h | 4 - lib/power/rte_power_guest_channel.h | 4 - lib/power/rte_power_intel_uncore.h | 9 -- lib/power/rte_power_pmd_mgmt.h | 40 -------- lib/power/version.map | 33 ++---- lib/rcu/rte_rcu_qsbr.h | 20 ---- lib/rcu/version.map | 15 +-- lib/regexdev/rte_regexdev.h | 92 ----------------- lib/regexdev/version.map | 2 +- lib/sched/rte_pie.h | 8 -- lib/sched/rte_sched.h | 5 - lib/sched/version.map | 18 +--- lib/security/rte_security.h | 35 ------- lib/security/version.map | 17 ++-- lib/table/rte_swx_table_learner.h | 10 -- lib/table/rte_swx_table_selector.h | 6 -- lib/table/rte_table_hash_func.h | 9 -- lib/table/version.map | 18 +--- lib/timer/rte_timer.h | 4 - lib/timer/version.map | 7 +- lib/vhost/rte_vhost.h | 5 - lib/vhost/rte_vhost_async.h | 19 ---- lib/vhost/rte_vhost_crypto.h | 1 - lib/vhost/version.map | 51 ++++------ 79 files changed, 234 insertions(+), 1228 deletions(-)
Comments
Hello Stephen, On Wed, Aug 9, 2023 at 2:10 AM Stephen Hemminger <stephen@networkplumber.org> wrote: > > Since 23.11 is an LTS release it is time to remove the experimental > bandaid off many API's. There are about 850 API's marked with experimental > on current main branch. This addresses the easy to remove ones and > gets it down to about 690 places. > > The rule is any API that has been in since 22.11 needs to have > experimental removed (or deleted). The experimental flag is > intended to be temporary not a "get out of ABI stability for free" card. > > v2 - add more libraries to the mix > - remove EXPERIMENTAL where tagged in MAINTAINERS There were some API updates merged in -rc1. Could you please rebase this series? Thanks.
On Wed, Oct 18, 2023 at 9:14 PM David Marchand <david.marchand@redhat.com> wrote: > > Hello Stephen, > > On Wed, Aug 9, 2023 at 2:10 AM Stephen Hemminger > <stephen@networkplumber.org> wrote: > > > > Since 23.11 is an LTS release it is time to remove the experimental > > bandaid off many API's. There are about 850 API's marked with experimental > > on current main branch. This addresses the easy to remove ones and > > gets it down to about 690 places. > > > > The rule is any API that has been in since 22.11 needs to have > > experimental removed (or deleted). The experimental flag is > > intended to be temporary not a "get out of ABI stability for free" card. > > > > v2 - add more libraries to the mix > > - remove EXPERIMENTAL where tagged in MAINTAINERS > > There were some API updates merged in -rc1. > Could you please rebase this series? Some additional comments to this request. rte_compat.h is only needed for __rte_experimental and __rte_internal tags. There is probably some unnecessary #include <rte_compat.h> left behind after this series. About version.map content, I recommend using ./devtools/update-abi.sh $(cat ABI_VERSION) as it sorts the stable symbols for you (but leave experimental and internal sections untouched).