From patchwork Tue Jul 11 23:25:02 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jan Blunck X-Patchwork-Id: 26821 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 4FD045A98; Wed, 12 Jul 2017 01:25:43 +0200 (CEST) Received: from mail-wr0-f196.google.com (mail-wr0-f196.google.com [209.85.128.196]) by dpdk.org (Postfix) with ESMTP id E54B8377E for ; Wed, 12 Jul 2017 01:25:36 +0200 (CEST) Received: by mail-wr0-f196.google.com with SMTP id x23so1757483wrb.0 for ; Tue, 11 Jul 2017 16:25:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:subject:date:message-id:in-reply-to:references; bh=lsCwONM/P97MOZ8KT4hfzV/ZAaKYkjLwGi+/DV1g5o8=; b=tDKsQqf02vDZsai1sD/pwQcTHHLdfntfKsMqwbHhzvNN1eoBq6OqcD5g+DzJqriCVI mLSpsP/u0fz9s1jFlBDImYC8TIx6sx3BJDitEtyU8lm0yTWYy4BbQd05qF/C68lRdHxk opn5tkea3RNkqan7k943OHK80UvwuejbCVnIFzig4Lb92UIXCwbqbtpc5PQUyX96yfWn tPfgqYHnYVxOENbu/uSxHNP5FhEYF3Hak6g/P0NuY7oRlE7CC2NTMCyYRf5exWdPXAfd luEMLuwcNbzb7RBeCofwcdCuBK9roYNA6t/QfQor6YWNpEJpGEwBs33ci0mFGc4Txq9m RZhA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:subject:date:message-id :in-reply-to:references; bh=lsCwONM/P97MOZ8KT4hfzV/ZAaKYkjLwGi+/DV1g5o8=; b=LtA3juWYmgjksADzOIrY3k5+3iJELGPh0HFKc2RbDB1mcuMLQaVo7u5gI5myv/+0lv gRY+t4Sb5p2y3vcyJNhNxs4alSJ4YrtXDGKiWex6Fqw1Cg9GVlWSrNB/CEJmQF5Xp/1a lNo2XAn3vPgBbuir0buTJlfaDe01aDON7aZN+5naSUkmY6whQZddAw/yh1ki5FNZXvsI DMgjvoNQyi9ojZ0pCkoY1cxth9Y95wN58sqGen7hyTfkJzZLOnXXdBvIHpaAcm5Cj7U7 FkCqVKjYDvVsMYGn4C5kdmUrQ5s2OE2iPd4cGMRi+SBApudCojdD2Z0kDceVvlNQ+AUA mPOw== X-Gm-Message-State: AIVw112Dt/R8GtPgN46yxL03Ynh0GubThncH8yjyh+kgxm2o/rrqwsYy OLcOizoJfWIfQfun X-Received: by 10.80.183.98 with SMTP id g89mr4113181ede.105.1499815536553; Tue, 11 Jul 2017 16:25:36 -0700 (PDT) Received: from localhost.localdomain ([37.228.147.16]) by smtp.gmail.com with ESMTPSA id k45sm311516ede.16.2017.07.11.16.25.35 for (version=TLS1 cipher=AES128-SHA bits=128/128); Tue, 11 Jul 2017 16:25:35 -0700 (PDT) From: Jan Blunck To: dev@dpdk.org Date: Tue, 11 Jul 2017 19:25:02 -0400 Message-Id: <20170711232512.54641-4-jblunck@infradead.org> X-Mailer: git-send-email 2.13.2 In-Reply-To: <20170711232512.54641-1-jblunck@infradead.org> References: <20170711232512.54641-1-jblunck@infradead.org> Subject: [dpdk-dev] [PATCH 03/13] devargs: deprecate enum rte_devtype based functions 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" The enum rte_devtype will need to get extended every time we add a bus. Mark all related functions as deprecated for 17.11. Signed-off-by: Jan Blunck --- doc/guides/rel_notes/deprecation.rst | 7 +++++++ lib/librte_eal/common/include/rte_devargs.h | 3 +++ 2 files changed, 10 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 257dcba32..0c763d522 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -64,3 +64,10 @@ Deprecation Notices be removed in 17.11: - ``rte_eal_parse_devargs_str``, replaced by ``rte_eal_devargs_parse`` + +* devargs: An API/ABI change is planed for 17.11 for ``struct rte_devargs`` to + remove ``enum rte_devtype`` so that starting from 17.08 the following + functions are deprecated: + + - ``rte_eal_devargs_add`` + - ``rte_eal_devargs_type_count`` diff --git a/lib/librte_eal/common/include/rte_devargs.h b/lib/librte_eal/common/include/rte_devargs.h index 62dd67bff..41db817cc 100644 --- a/lib/librte_eal/common/include/rte_devargs.h +++ b/lib/librte_eal/common/include/rte_devargs.h @@ -53,6 +53,7 @@ extern "C" { #include /** + * @deprecated * Type of generic device */ enum rte_devtype { @@ -139,6 +140,7 @@ rte_eal_devargs_parse(const char *dev, struct rte_devargs *da); /** + * @deprecated * Add a device to the user device list * * For PCI devices, the format of arguments string is "PCI_ADDR" or @@ -163,6 +165,7 @@ rte_eal_devargs_parse(const char *dev, int rte_eal_devargs_add(enum rte_devtype devtype, const char *devargs_str); /** + * @deprecated * Count the number of user devices of a specified type * * @param devtype