From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id C1770C433E0 for ; Mon, 8 Jun 2020 15:54:01 +0000 (UTC) Received: from dpdk.org (dpdk.org [92.243.14.124]) by mail.kernel.org (Postfix) with ESMTP id 7B1FD206A4 for ; Mon, 8 Jun 2020 15:54:01 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b="bgyHbI0c" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 7B1FD206A4 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=redhat.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=dev-bounces@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 0CEF32C15; Mon, 8 Jun 2020 17:53:57 +0200 (CEST) Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) by dpdk.org (Postfix) with ESMTP id EFA512BFA for ; Mon, 8 Jun 2020 17:53:55 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1591631635; 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=NrW0C08SBhb+35NvsPAYNCAyvxqlsG7GGKc7RWx6ayM=; b=bgyHbI0c5FqISGyLdixx/gtIItaXXI5XU7w4X8GoUIovsgPFXJRJuxDpA3RJcTLlNfebPp LgiuzoDFIJzbD2GPw+81fxyX0/sSYQz+yCTEIEirdQXVqJRhjuGDyKEhey7ltW4UkhCMMA aNosH0yt3YS5FM4/8UeB1MoF01Cv3wA= 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-447-tb2bmaA2NqO4CkNwkSQQTA-1; Mon, 08 Jun 2020 11:53:51 -0400 X-MC-Unique: tb2bmaA2NqO4CkNwkSQQTA-1 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 321051005512; Mon, 8 Jun 2020 15:53:49 +0000 (UTC) Received: from localhost.localdomain (unknown [10.36.110.37]) by smtp.corp.redhat.com (Postfix) with ESMTP id 5D0927BA10; Mon, 8 Jun 2020 15:53:47 +0000 (UTC) From: Maxime Coquelin To: dev@dpdk.org, david.marchand@redhat.com, wenzhuo.lu@intel.com, beilei.xing@intel.com, bernard.iremonger@intel.com, grive@u256.net Cc: Maxime Coquelin Date: Mon, 8 Jun 2020 17:53:29 +0200 Message-Id: <20200608155330.163874-2-maxime.coquelin@redhat.com> In-Reply-To: <20200608155330.163874-1-maxime.coquelin@redhat.com> References: <20200608155330.163874-1-maxime.coquelin@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH 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 --- 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 0bee924255..47151eac0b 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -138,3 +138,8 @@ Deprecation Notices driver probe scheme. The legacy virtio support will be available through the existing VFIO/UIO based kernel driver scheme. More details at https://patches.dpdk.org/patch/69351/ + +* eal: Change ``rte_dev_probe`` API to return a pointer on the probed + rte_device or NULL instead of 0 or an error code in DPDK v20.11. This + change will help calling application in avoiding to iterate the devices + list when willing to call rte_dev_remove() later. -- 2.26.2