From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
by inbox.dpdk.org (Postfix) with ESMTP id 9027D431AE;
Thu, 19 Oct 2023 18:56:25 +0200 (CEST)
Received: from mails.dpdk.org (localhost [127.0.0.1])
by mails.dpdk.org (Postfix) with ESMTP id A2EAF40ED0;
Thu, 19 Oct 2023 18:56:15 +0200 (CEST)
Received: from mail-oo1-f47.google.com (mail-oo1-f47.google.com
[209.85.161.47]) by mails.dpdk.org (Postfix) with ESMTP id E2AAA40150
for <dev@dpdk.org>; Thu, 19 Oct 2023 18:56:11 +0200 (CEST)
Received: by mail-oo1-f47.google.com with SMTP id
006d021491bc7-583f571a213so538534eaf.3
for <dev@dpdk.org>; Thu, 19 Oct 2023 09:56:11 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697734571;
x=1698339371; 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=tys2+Rbas78abmp2lZkxnmA5eQ/E9vQyCtq1vgD2nPg=;
b=F+zFgMFOpd16aSCNBrpEmfpln8V3h9g1GPsXXQmwYzHGaTIiMv9XKM+mMObDVw1aq3
mlHPhs6LaIukNm4xvkWVmmv039vwpH/2reWXEZkNWCtDexMts3vi0AXHJfAmacXz/blD
73Z1bD38SQE39k4Sds4tMfTBC8j3FR5FIVr2LKXwfsO6j/mlvdVP6TqcHIuoSBWLYTTP
45owetS6I23bYWX2efU2N357kPuqQgGXQt6XKiDNenZZNfFVJZZJI+vOxbig+GtANKnr
xRu1RxTwS4xYLs68sKleBXu9WePa6j21WwNwb6VVI3FCrWI8tsVfpklqa3aJZxOV5Rbf
jinw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20230601; t=1697734571; x=1698339371;
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=tys2+Rbas78abmp2lZkxnmA5eQ/E9vQyCtq1vgD2nPg=;
b=dznXiqIkDjWSpfnvO8jVLmP3i74ntS6jzTVVY6x+OcS78vqwBLsF3ZiUvW7rmvUUdU
QZHdH4b98Eldf7JNgSD6qS+woik/O6wvPNRuekSaohDxBAQUpph5zdAyxMyXlfjfr1YV
4mRBWATn3r7tEd/2QlQK+pEPSHd7+kp/qrDLWvlrm4nOBbRGigaz3HvgWPgje9x1s11X
9bmDvGSQu4zAhB/jVAvpeooKW2L3IxNL4P8PmjlD9+qstcAI+zpCzHxet+ZSyeVtK2SQ
BjV78Xl9whXpiKK+lwhL8q6cNKcMX57FlFHDP1+zjakvIDWAUmoZtNX1kmav+VYoZlsO
1TaA==
X-Gm-Message-State: AOJu0Yxzs8GBLX/JZLDiQIDE/9dAsO7GgQpO1cf7ytcmDYKq3hgoue+P
+T1sY0S4bvkFet/PSbfnF50BISSlMZrBEB/MIUxMXA==
X-Google-Smtp-Source: AGHT+IHXjbQzw2yNuj7TEAzJyXzwhCrjbJmOxDA/qpidsMYDkED6H3wNMv/EUgYES977Gu3kTD2wxA==
X-Received: by 2002:a05:6358:9f85:b0:130:e0a9:a7b4 with SMTP id
fy5-20020a0563589f8500b00130e0a9a7b4mr2596479rwb.13.1697734570875;
Thu, 19 Oct 2023 09:56:10 -0700 (PDT)
Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68])
by smtp.gmail.com with ESMTPSA id
y22-20020aa79436000000b00672ea40b8a9sm13988pfo.170.2023.10.19.09.56.10
(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
Thu, 19 Oct 2023 09:56:10 -0700 (PDT)
From: Stephen Hemminger <stephen@networkplumber.org>
To: dev@dpdk.org
Cc: Stephen Hemminger <stephen@networkplumber.org>,
Bruce Richardson <bruce.richardson@intel.com>
Subject: [PATCH v3 02/29] cmdline: make experimental API's stable
Date: Thu, 19 Oct 2023 09:55:31 -0700
Message-Id: <20231019165559.115742-3-stephen@networkplumber.org>
X-Mailer: git-send-email 2.39.2
In-Reply-To: <20231019165559.115742-1-stephen@networkplumber.org>
References: <20230808173527.186042-1-stephen@networkplumber.org>
<20231019165559.115742-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
These API's have all ben around for several releases.
Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
Acked-by: Bruce Richardson <bruce.richardson@intel.com>
---
lib/cmdline/cmdline.h | 1 -
lib/cmdline/cmdline_parse.h | 4 ----
lib/cmdline/cmdline_rdline.h | 4 ----
lib/cmdline/version.map | 26 ++++++++------------------
4 files changed, 8 insertions(+), 27 deletions(-)
diff --git a/lib/cmdline/cmdline.h b/lib/cmdline/cmdline.h
index 992c84591456..dd41e1054378 100644
--- a/lib/cmdline/cmdline.h
+++ b/lib/cmdline/cmdline.h
@@ -39,7 +39,6 @@ void cmdline_printf(const struct cmdline *cl, const char *fmt, ...)
int cmdline_in(struct cmdline *cl, const char *buf, int size);
int cmdline_write_char(struct rdline *rdl, char c);
-__rte_experimental
struct rdline *
cmdline_get_rdline(struct cmdline *cl);
diff --git a/lib/cmdline/cmdline_parse.h b/lib/cmdline/cmdline_parse.h
index a852ac411c59..41b4db1f76f9 100644
--- a/lib/cmdline/cmdline_parse.h
+++ b/lib/cmdline/cmdline_parse.h
@@ -155,9 +155,6 @@ typedef cmdline_parse_inst_t *cmdline_parse_ctx_t;
int cmdline_parse(struct cmdline *cl, const char *buf);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Try to parse a buffer according to the specified context, but do not
* perform any function calls if parse is successful.
*
@@ -166,7 +163,6 @@ int cmdline_parse(struct cmdline *cl, const char *buf);
* CMDLINE_PARSE_BAD_ARGS on error and returns the parsed line length (>=0)
* on successful parse.
*/
-__rte_experimental
int cmdline_parse_check(struct cmdline *cl, const char *buf);
/**
diff --git a/lib/cmdline/cmdline_rdline.h b/lib/cmdline/cmdline_rdline.h
index 1b4cc7ce5773..c6bb6bbbb36a 100644
--- a/lib/cmdline/cmdline_rdline.h
+++ b/lib/cmdline/cmdline_rdline.h
@@ -58,7 +58,6 @@ typedef int (rdline_complete_t)(struct rdline *rdl, const char *buf,
*
* \return New rdline object on success, NULL on failure.
*/
-__rte_experimental
struct rdline *rdline_new(rdline_write_char_t *write_char,
rdline_validate_t *validate,
rdline_complete_t *complete,
@@ -70,7 +69,6 @@ struct rdline *rdline_new(rdline_write_char_t *write_char,
* \param rdl A pointer to an initialized struct rdline.
* If NULL, this function is a no-op.
*/
-__rte_experimental
void rdline_free(struct rdline *rdl);
/**
@@ -163,13 +161,11 @@ char *rdline_get_history_item(struct rdline *rdl, unsigned int i);
/**
* Get maximum history buffer size.
*/
-__rte_experimental
size_t rdline_get_history_buffer_size(struct rdline *rdl);
/**
* Get the opaque pointer supplied on struct rdline creation.
*/
-__rte_experimental
void *rdline_get_opaque(struct rdline *rdl);
#ifdef __cplusplus
diff --git a/lib/cmdline/version.map b/lib/cmdline/version.map
index 97166789016c..88174e39bcb7 100644
--- a/lib/cmdline/version.map
+++ b/lib/cmdline/version.map
@@ -30,11 +30,13 @@ DPDK_24 {
cmdline_get_help_num;
cmdline_get_help_portlist;
cmdline_get_help_string;
+ cmdline_get_rdline;
cmdline_in;
cmdline_interact;
cmdline_isendoftoken;
cmdline_new;
cmdline_parse;
+ cmdline_parse_check;
cmdline_parse_etheraddr;
cmdline_parse_ipaddr;
cmdline_parse_num;
@@ -51,37 +53,25 @@ DPDK_24 {
cmdline_token_portlist_ops;
cmdline_token_string_ops;
cmdline_write_char;
+
rdline_add_history;
rdline_char_in;
rdline_clear_history;
+ rdline_free;
rdline_get_buffer;
+ rdline_get_history_buffer_size;
rdline_get_history_item;
+ rdline_get_opaque;
+ rdline_new;
rdline_newline;
rdline_quit;
rdline_redisplay;
rdline_reset;
rdline_restart;
rdline_stop;
+
vt100_init;
vt100_parser;
local: *;
};
-
-EXPERIMENTAL {
- global:
-
- # added in 20.11
- cmdline_get_rdline;
-
- # added in 21.11
- rdline_new;
- rdline_free;
- rdline_get_history_buffer_size;
- rdline_get_opaque;
-
- # added in 22.07
- cmdline_parse_check;
-
- local: *;
-};
--
2.39.2