From patchwork Thu Jun 25 08:04:29 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Maxime Coquelin X-Patchwork-Id: 72170 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 60536A0350; Thu, 25 Jun 2020 10:04:57 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id EB6081B75C; Thu, 25 Jun 2020 10:04:51 +0200 (CEST) Received: from us-smtp-delivery-1.mimecast.com (us-smtp-1.mimecast.com [205.139.110.61]) by dpdk.org (Postfix) with ESMTP id CBAF11B5E1 for ; Thu, 25 Jun 2020 10:04:50 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1593072290; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=t+I+uUPEURxHm7aFn6vjMooRstSLyqRfRTUiHB5HTN0=; b=Nkx5Gppd+t1/+0F+EpWhcLYso/IbM6UXFHCbElscW2xgCqA91Zk44EUu0qy34YDzYi/105 iaf1QD/8Wg3sfc20RajzLgzf6H/+Hio2IZdiGHCopSM1qNeq85GHeYtbEO7WbQSVEUCJQw EDoQwhoidDBxnI5XWJwa7SlOUSn6fjc= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-200-4a2t7N11MuaVRMmLsHJO-g-1; Thu, 25 Jun 2020 04:04:46 -0400 X-MC-Unique: 4a2t7N11MuaVRMmLsHJO-g-1 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 4205E804002; Thu, 25 Jun 2020 08:04:45 +0000 (UTC) Received: from localhost.localdomain (unknown [10.36.110.7]) by smtp.corp.redhat.com (Postfix) with ESMTP id 5D48B1017E27; Thu, 25 Jun 2020 08:04:43 +0000 (UTC) From: Maxime Coquelin To: dev@dpdk.org, grive@u256.net, david.marchand@redhat.com, wenzhuo.lu@intel.com, beilei.xing@intel.com, bernard.iremonger@intel.com Cc: Maxime Coquelin Date: Thu, 25 Jun 2020 10:04:29 +0200 Message-Id: <20200625080430.1392037-2-maxime.coquelin@redhat.com> In-Reply-To: <20200625080430.1392037-1-maxime.coquelin@redhat.com> References: <20200625080430.1392037-1-maxime.coquelin@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Subject: [dpdk-dev] [PATCH v2 1/2] doc: announce rte_dev_probe() API change X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" In order to simplify the use of rte_dev_probe() and rte_dev_remove() by applications, rte_dev_probe() will return a reference on the rte_device stating DPDK v20.11. Signed-off-by: Maxime Coquelin Acked-by: Bruce Richardson Acked-by: Gaetan Rivet Acked-by: David Marchand Acked-by: Jerin Jacob --- doc/guides/rel_notes/deprecation.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index d1034f60fd..8661a673b5 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -130,3 +130,8 @@ Deprecation Notices Python 2 support will be completely removed in 20.11. In 20.08, explicit deprecation warnings will be displayed when running scripts with Python 2. + +* eal: Change ``rte_dev_probe`` API in DPDK v20.11 to return a pointer on the + probed rte_device or NULL instead of 0 or an error code. This change will + allow applications avoid iterating on devices after a probe to get access to + the new rte_device.