From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <gaetan.rivet@6wind.com>
Received: from mail-wr0-f193.google.com (mail-wr0-f193.google.com
[209.85.128.193]) by dpdk.org (Postfix) with ESMTP id 2FE6D728E
for <dev@dpdk.org>; Thu, 29 Mar 2018 23:24:21 +0200 (CEST)
Received: by mail-wr0-f193.google.com with SMTP id u46so6556519wrc.11
for <dev@dpdk.org>; Thu, 29 Mar 2018 14:24:21 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=6wind-com.20150623.gappssmtp.com; s=20150623;
h=from:to:cc:subject:date:message-id:in-reply-to:references
:in-reply-to:references;
bh=6eZGoRLBzWwv3l2iaVF6qtwccKDlyB5ZmUHYY78ogm0=;
b=r5Zsa86303gilb/KMkqtXAWc3TlxfWzTHLV546hBudc9AyIlI3XcfP7SSJfhRuD538
sMrK24rNYOqnDaN3aAiNSxPfaSso65sH3ey19OY9gRgYxzbgEm/XJPK5REPl/yVnGcen
+PFrrU1fonGyPv32PMT+6zOPK/hi3txaZsAFlbUepoIzvK40fm8w0LRZablkf2IqgCS8
TZM3MPW3HM2YWjv6IRa6qDbkOKxCtx44h6JW38PtqDdiAs6WEcdfJ9VRPfPqN4Spomeh
A9a3B1W+umuiDQntM6pUOHLN4dGI8IBMOqANifCdRY05+Kpg/egvzVvyBO9067zU7wv1
tVvw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20161025;
h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to
:references:in-reply-to:references;
bh=6eZGoRLBzWwv3l2iaVF6qtwccKDlyB5ZmUHYY78ogm0=;
b=JQdldloHRIGmnQXvWQK4nVpMuivEsF8RGnPW+ynUluydwRZjFKRbuhzbRD1qJtejwV
prECDWEAte7l/kZ7idL2LTdUgTAO5fGFNwzljeVoajMQHz5EPY27+UTrqsC9IK5OVR5B
aWOsHIbWEXzvas5RT0J6LLkcan8W6cUGRAOFJa++414BPUmMnipgH3ju/cujhKZzML/0
t+2IIK80qQOnywJGlD5WEj1+oEgWQeudAZCtuhq+3GDT61ncQ5wv8zVSEajaVP5H4zSn
XVg4haUL6KEKiTRZJIFIp3Mj/b4xnTbjKg7MoXVK07/4DiW021DJ7Bdxo0gAw2LyAzHR
vs5g==
X-Gm-Message-State: AElRT7GqR+lWEORcuuq8lkkDPasNbx+0/0/FiyyjROmk66VRbqB0RYoZ
mMltsyvQxEuvjPxgbO1kAcJIB/wJ
X-Google-Smtp-Source: AIpwx4/UX7E01M5QQL9DcLEqJT3JPywqtFp0g8yqV9J+KSPnkMUDjej38aiopEcLXeLunANAJFwGYA==
X-Received: by 10.223.144.195 with SMTP id i61mr8281003wri.227.1522358660418;
Thu, 29 Mar 2018 14:24:20 -0700 (PDT)
Received: from bidouze.dev.6wind.com. (host.78.145.23.62.rev.coltfrance.com.
[62.23.145.78])
by smtp.gmail.com with ESMTPSA id m35sm11907457wrm.59.2018.03.29.14.24.19
(version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
Thu, 29 Mar 2018 14:24:19 -0700 (PDT)
From: Gaetan Rivet <gaetan.rivet@6wind.com>
To: dev@dpdk.org
Cc: Gaetan Rivet <gaetan.rivet@6wind.com>
Date: Thu, 29 Mar 2018 23:23:30 +0200
Message-Id: <cc3e4c0a56a00aeca48fb21b11f64626fe832a5e.1522358421.git.gaetan.rivet@6wind.com>
X-Mailer: git-send-email 2.11.0
In-Reply-To: <cover.1522358419.git.gaetan.rivet@6wind.com>
References: <cover.1522105876.git.gaetan.rivet@6wind.com>
<cover.1522358419.git.gaetan.rivet@6wind.com>
In-Reply-To: <cover.1522358419.git.gaetan.rivet@6wind.com>
References: <cover.1522358419.git.gaetan.rivet@6wind.com>
Subject: [dpdk-dev] [PATCH v4 06/20] eal/dev: add device iterator interface
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://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: <https://dpdk.org/ml/listinfo/dev>,
<mailto:dev-request@dpdk.org?subject=subscribe>
X-List-Received-Date: Thu, 29 Mar 2018 21:24:21 -0000
A device iterator allows iterating over a set of devices.
This set is defined by the two descriptions offered,
* rte_bus
* rte_class
Only one description can be provided, or both. It is not allowed to
provide no description at all.
Each layer of abstraction then performs a filter based on the
description provided. This filtering allows iterating on their internal
set of devices, stopping when a match is valid and returning the current
iteration context.
This context allows starting the next iteration from the same point and
going forward.
Signed-off-by: Gaetan Rivet <gaetan.rivet@6wind.com>
---
lib/librte_eal/common/include/rte_dev.h | 47 +++++++++++++++++++++++++++++++++
1 file changed, 47 insertions(+)
diff --git a/lib/librte_eal/common/include/rte_dev.h b/lib/librte_eal/common/include/rte_dev.h
index b688f1efd..937ff6079 100644
--- a/lib/librte_eal/common/include/rte_dev.h
+++ b/lib/librte_eal/common/include/rte_dev.h
@@ -263,6 +263,53 @@ __attribute__((used)) = str
static const char DRV_EXP_TAG(name, kmod_dep_export)[] \
__attribute__((used)) = str
+/**
+ * Iteration context.
+ *
+ * This context carries over the current iteration state.
+ */
+struct rte_dev_iterator {
+ const char *devstr; /**< device string. */
+ const char *busstr; /**< bus-related part of device string. */
+ const char *clsstr; /**< class-related part of device string. */
+ struct rte_bus *bus; /**< bus handle. */
+ struct rte_class *cls; /**< class handle. */
+ struct rte_device *device; /**< current position. */
+ void *class_device; /**< additional specialized context. */
+};
+
+/**
+ * Device iteration function.
+ *
+ * Find the next device matching properties passed in parameters.
+ * The function takes an additional ``start`` parameter, that is
+ * used as starting context when relevant.
+ *
+ * The function returns the current element in the iteration.
+ * This return value will potentially be used as a start parameter
+ * in subsequent calls to the function.
+ *
+ * The additional iterator parameter is only there if a specific
+ * implementation needs additional context. It must not be modified by
+ * the iteration function itself.
+ *
+ * @param start
+ * Starting iteration context.
+ *
+ * @param devstr
+ * Device description string.
+ *
+ * @param it
+ * Device iterator.
+ *
+ * @return
+ * The address of the current element matching the device description
+ * string.
+ */
+typedef void *(*rte_dev_iterate_t)(const void *start,
+ const char *devstr,
+ const struct rte_dev_iterator *it);
+
#ifdef __cplusplus
}
#endif
--
2.11.0