From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <david.marchand@6wind.com>
Received: from mail-wm0-f49.google.com (mail-wm0-f49.google.com [74.125.82.49])
 by dpdk.org (Postfix) with ESMTP id 94F252BCE
 for <dev@dpdk.org>; Thu,  7 Apr 2016 17:33:22 +0200 (CEST)
Received: by mail-wm0-f49.google.com with SMTP id v188so60680743wme.1
 for <dev@dpdk.org>; Thu, 07 Apr 2016 08:33:22 -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;
 bh=H9UEHWqM/jGXjgtWQmafGpWPogQm1rEwy98TjjL1t+8=;
 b=UE5D8f4RKuw54QGSexbXFE3hkeHiFkGLVBDufPbgC4L3nPXYdqFoeSdxD364l0zKMO
 zFxlUF3WG7tEz3Bm3YXuMkfyhRBUYjqcYdnt9e7v1CoFGLfQoIw1lQS54yT9b7HKZZPq
 yvRyp/vCQ5l0wEafj9I+3K5EBYuZvvC7BovpxUuQQX3BS+PNDK8qsfp+7W/KREjl3raT
 LrzuDjlGe3zVzTq7UJMum0u0tH/iMr911Qxdb/0xB//pNVjoK3CWSPinJN/qe1/ejypI
 DNBW4lyY5NpEbzLRysiB9207s8XXddnYX334rej9czUCgOSe4eHG0/LnHwupr47GpCx0
 j2LA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20130820;
 h=x-gm-message-state:from:to:cc:subject:date:message-id;
 bh=H9UEHWqM/jGXjgtWQmafGpWPogQm1rEwy98TjjL1t+8=;
 b=UnEzVTdhCLbbrj4vy+28g0SOVdc1n4SiP1bcMo9stVE3YMCKAolykcCd0gYGtiCkER
 TYFU9zWS7t/n1coCo4/0W0lrYX0aSu0cOU/jDw7EobM63n1FE6+93N38WXMW0DymJzzt
 JF4sLzLMiLXYgaNMebyQ3fIBX95BC94t7bGYEO6xq9etrBCTFQc0wCv/iNRfX/Ju/qmQ
 ewvczd0Lf9XkIjOY5GhclMOI31Y9yEq0na8YxqYD4+34xqpRoKk6jFdNvLTx4fbtTGYv
 3u825e80kPI/nIVaIlCc5U/n8SDZcfOM/+rQ309NsmzSQhAeTznLtRuaPPqIuiQ9ZSgX
 lcSg==
X-Gm-Message-State: AD7BkJKb+Wo6ADZ68+W+rr7ugMGpDUIbIRqai5GIk0B+xZEMx5RsW4zif9fOpXIlWR+olYf5
X-Received: by 10.194.63.8 with SMTP id c8mr2210026wjs.89.1460043202369;
 Thu, 07 Apr 2016 08:33:22 -0700 (PDT)
Received: from gloops.dev.6wind.com (144.77.126.78.rev.sfr.net.
 [78.126.77.144])
 by smtp.gmail.com with ESMTPSA id z6sm9449644wme.9.2016.04.07.08.33.21
 (version=TLSv1/SSLv3 cipher=OTHER);
 Thu, 07 Apr 2016 08:33:21 -0700 (PDT)
From: David Marchand <david.marchand@6wind.com>
To: dev@dpdk.org
Cc: viktorin@rehivetech.com, olivier.matz@6wind.com, thomas.monjalon@6wind.com
Date: Thu,  7 Apr 2016 17:33:17 +0200
Message-Id: <1460043197-13707-1-git-send-email-david.marchand@6wind.com>
X-Mailer: git-send-email 1.9.1
Subject: [dpdk-dev] [PATCH] doc: announce API changes for device objects
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: patches and discussions about DPDK <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: Thu, 07 Apr 2016 15:33:22 -0000

Following discussions with Jan, here is a deprecation notice to prepare for
hotplug and rte_device changes to come in 16.07.

Signed-off-by: David Marchand <david.marchand@6wind.com>
---
 doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 98d5529..d749e5d 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -8,6 +8,18 @@ API and ABI deprecation notices are to be posted here.
 Deprecation Notices
 -------------------
 
+* The ethdev hotplug API is going to be moved to EAL with a notification
+  mechanism added to crypto and ethdev libraries so that hotplug is now
+  available to both of them. This API will be stripped of the device arguments
+  so that it only cares about hotplugging.
+
+* Structures embodying pci and vdev devices are going to be reworked to
+  integrate new common rte_device / rte_driver objects (see
+  http://dpdk.org/ml/archives/dev/2016-January/031390.html).
+  ethdev and crypto libraries will then only handle those objects so that they
+  do not need to care about the kind of devices that are being used, making it
+  easier to add new buses later.
+
 * The EAL function pci_config_space_set is deprecated in release 16.04
   and will be removed from 16.07.
   Macros CONFIG_RTE_PCI_CONFIG, CONFIG_RTE_PCI_EXTENDED_TAG and
-- 
1.9.1