From patchwork Thu Apr 7 15:33:17 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: David Marchand X-Patchwork-Id: 11975 Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id 9BE1A2BD9; Thu, 7 Apr 2016 17:33:23 +0200 (CEST) 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 ; Thu, 7 Apr 2016 17:33:22 +0200 (CEST) Received: by mail-wm0-f49.google.com with SMTP id v188so60680743wme.1 for ; 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 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" 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 Acked-by: Jan Viktorin Acked-by: Olivier Matz Acked-by: Thomas Monjalon --- 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