From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <jblunck@gmail.com>
Received: from mail-wm0-f66.google.com (mail-wm0-f66.google.com [74.125.82.66])
by dpdk.org (Postfix) with ESMTP id EFCDD2882
for <dev@dpdk.org>; Fri, 14 Jul 2017 23:12:33 +0200 (CEST)
Received: by mail-wm0-f66.google.com with SMTP id j85so12764362wmj.0
for <dev@dpdk.org>; Fri, 14 Jul 2017 14:12:33 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
h=sender:from:to:subject:date:message-id:in-reply-to:references;
bh=lsCwONM/P97MOZ8KT4hfzV/ZAaKYkjLwGi+/DV1g5o8=;
b=CRcLE+bnWyRt6I531HiafLGi5hAnUi/zhOBr3RR+a5/DA5eLzBk4SMPlJGqucP9oxc
qiONCQIDC4jNUAjOb63x1SiGNcHrTJjgXP8caJPFt5gJkHkR3lRLz8kSmzPo3cgN7xkw
x1zTKRP4P6fMUQWIkAtd21dYTfWb0pBy1kJpzhFOFSFjDkYuzcJQSY/XK98v935PswWc
R8EdiP3yHo0KgWw9iYsDSLOgZFseHpfkCO53ph6+iAFpiEOzAxji8to0vs7iSBiemoV7
6Ylplm0VaOGIZIc9GLr4jlCjJz2tZ2SNfMuutv/7tr5ViqzOam4tIbpzjU6fqMrUlPqC
YvjA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20161025;
h=x-gm-message-state:sender:from:to:subject:date:message-id
:in-reply-to:references;
bh=lsCwONM/P97MOZ8KT4hfzV/ZAaKYkjLwGi+/DV1g5o8=;
b=THephS8o18tR6ko7X0t2RpAKP2+ea1H3dBNbkzRjI75Avdjy383Y1ZfLYar6HJtRUz
ee7WTrBfOes+s/a2YVvNzBNuAkFgZ494RtLmblMEgljjejAyom2xc2a9kd9gKNABLRk6
ka+1kxPjlI8yoDgvxDH5XKEbaPBMwOvCxO2ngOy//Qm/uFW8o7oKbwfI/JsIU6vKnKML
E0FTuTu7JD3K1eEOqUQAkhPa23kBLYXVq+Pq43KBerS7O9gglhPR9BReMnLwOihXoyC/
x17Q8B/mVCG2y5xr1PS/fFIWiqsoQq2H737UwjQYcvaBZ7drRRwWSFz8WquRqtOIC57g
LYRQ==
X-Gm-Message-State: AIVw111wltOndpWnJVr0PgZuVR+71PanY/XIszgjMliGr/S+mrNwS0y9
W3gvy6WQtVNDeaHl
X-Received: by 10.80.145.174 with SMTP id g43mr8372116eda.179.1500066753580;
Fri, 14 Jul 2017 14:12:33 -0700 (PDT)
Received: from localhost.localdomain ([37.228.147.16])
by smtp.gmail.com with ESMTPSA id c11sm4892223eda.0.2017.07.14.14.12.31
for <dev@dpdk.org> (version=TLS1 cipher=AES128-SHA bits=128/128);
Fri, 14 Jul 2017 14:12:32 -0700 (PDT)
Sender: Jan Blunck <jblunck@gmail.com>
From: Jan Blunck <jblunck@infradead.org>
To: dev@dpdk.org
Date: Fri, 14 Jul 2017 17:12:02 -0400
Message-Id: <20170714211213.34436-5-jblunck@infradead.org>
X-Mailer: git-send-email 2.13.2
In-Reply-To: <20170714211213.34436-1-jblunck@infradead.org>
References: <20170711232512.54641-1-jblunck@infradead.org>
<20170714211213.34436-1-jblunck@infradead.org>
Subject: [dpdk-dev] [PATCH v2 04/15] devargs: deprecate enum rte_devtype
based functions
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
<mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
<mailto:dev-request@dpdk.org?subject=subscribe>
X-List-Received-Date: Fri, 14 Jul 2017 21:12:34 -0000
The enum rte_devtype will need to get extended every time we add a bus.
Mark all related functions as deprecated for 17.11.
Signed-off-by: Jan Blunck <jblunck@infradead.org>
---
doc/guides/rel_notes/deprecation.rst | 7 +++++++
lib/librte_eal/common/include/rte_devargs.h | 3 +++
2 files changed, 10 insertions(+)
diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 257dcba32..0c763d522 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -64,3 +64,10 @@ Deprecation Notices
be removed in 17.11:
- ``rte_eal_parse_devargs_str``, replaced by ``rte_eal_devargs_parse``
+
+* devargs: An API/ABI change is planed for 17.11 for ``struct rte_devargs`` to
+ remove ``enum rte_devtype`` so that starting from 17.08 the following
+ functions are deprecated:
+
+ - ``rte_eal_devargs_add``
+ - ``rte_eal_devargs_type_count``
diff --git a/lib/librte_eal/common/include/rte_devargs.h b/lib/librte_eal/common/include/rte_devargs.h
index 62dd67bff..41db817cc 100644
--- a/lib/librte_eal/common/include/rte_devargs.h
+++ b/lib/librte_eal/common/include/rte_devargs.h
@@ -53,6 +53,7 @@ extern "C" {
#include <rte_bus.h>
/**
+ * @deprecated
* Type of generic device
*/
enum rte_devtype {
@@ -139,6 +140,7 @@ rte_eal_devargs_parse(const char *dev,
struct rte_devargs *da);
/**
+ * @deprecated
* Add a device to the user device list
*
* For PCI devices, the format of arguments string is "PCI_ADDR" or
@@ -163,6 +165,7 @@ rte_eal_devargs_parse(const char *dev,
int rte_eal_devargs_add(enum rte_devtype devtype, const char *devargs_str);
/**
+ * @deprecated
* Count the number of user devices of a specified type
*
* @param devtype
--
2.13.2