From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wm0-f65.google.com (mail-wm0-f65.google.com [74.125.82.65]) by dpdk.org (Postfix) with ESMTP id A0F941B35F for ; Wed, 7 Feb 2018 10:26:30 +0100 (CET) Received: by mail-wm0-f65.google.com with SMTP id j21-v6so21714835wmh.1 for ; Wed, 07 Feb 2018 01:26:30 -0800 (PST) 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=CMtK0ucaU6N5/6FefMbRNeH38/GACjckiVj/HW/AFV8=; b=gWiWeYzdqJQLMTVNzDszgcJ/gWzsq1fYm/SN7C3TD9XA+8ivIiH9A37nQ+Hj/HxjPU obM2WPFfB74AJkj7nCVQ8j/YdugCzm3oiGPTeqczEuxRAqjqrFBKXnaA1iAaL4TCDM/L p8IUx3gMEjsnxDMHSC+hpHe8MjlIz8NBcreHOTOND0rN77qkDkIO/K7aioDZ9cEgjj2j YB0yGaPbetsb0zgLlIipCdWrg44XdUYBA8zUfHdjQVxOCYEVYc0cxNw/hoIFG9zxBJj3 xnNWir4wG1CESjufbUK12CYL+LqC/8VOcV1FGqfnfD5K3kGRa3EuQMadLjAaYe7ArcTg Plog== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=CMtK0ucaU6N5/6FefMbRNeH38/GACjckiVj/HW/AFV8=; b=Ab2VjZaJpmQJQ6g3KgT8yf4UWlohiC+SB57/XNQnYqyXBfA2InzBAiS6xb2TKwBhi1 mcLoeuvNnbE8Ka/dhynk43BOE+7wRCkMFGfClAN6HzydQyGoj++pjtSdW65cCXRVMuMq XIxeNp0Nu6qZapW/qtH8D02OvUnNeRXmJ8gqoteeR46n46zc+KaA59IohW0xZ0txLU2K uzMyxUlnXA1hehYXh8DWXh4U5UxExX0975PTwEXTBTrFyTF3ErntDeQTY8++ZnLZVwjq gj1zYtD8yI78LmNOHz2XSkTMi9TguIMI93jzrG0AmMhZAv/2PgGLkoPPfetbcaztrdZx b0MQ== X-Gm-Message-State: APf1xPC45sAVMOBcAEPtWboriIP19riv2Ec1jn0NKql7QjhkAkBAKD40 jvWuF3LywHaKbIf32+klEbfMwDIK X-Google-Smtp-Source: AH8x227ZC+0WkgPjPrsdgjEspCDIlZ0L5X9qtGnCa4k+ZtE148NbyRi/H88PIi5jh9yE6vHTVCBB+Q== X-Received: by 10.28.58.208 with SMTP id h199mr4659821wma.79.1517995589842; Wed, 07 Feb 2018 01:26:29 -0800 (PST) Received: from bidouze.dev.6wind.com. (host.78.145.23.62.rev.coltfrance.com. [62.23.145.78]) by smtp.gmail.com with ESMTPSA id l9sm3746973wrl.1.2018.02.07.01.26.28 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 07 Feb 2018 01:26:28 -0800 (PST) From: Gaetan Rivet To: dev@dpdk.org Cc: Gaetan Rivet Date: Wed, 7 Feb 2018 10:26:10 +0100 Message-Id: <20180207092610.6593-1-gaetan.rivet@6wind.com> X-Mailer: git-send-email 2.11.0 Subject: [dpdk-dev] [PATCH v1] doc: update deprecation notice of rte_devargs 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: , X-List-Received-Date: Wed, 07 Feb 2018 09:26:30 -0000 The declaration and identification of devices will change in v18.05. Remove the precedent deprecation notice Add new one reflecting the planned changes more accurately, updated for v18.05. Signed-off-by: Gaetan Rivet --- doc/guides/rel_notes/deprecation.rst | 27 ++++++++++++++++----------- 1 file changed, 16 insertions(+), 11 deletions(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index d59ad5988..07312f59a 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -8,18 +8,23 @@ API and ABI deprecation notices are to be posted here. Deprecation Notices ------------------- -* eal: several API and ABI changes are planned for ``rte_devargs`` in v18.02. - The format of device command line parameters will change. The bus will need - to be explicitly stated in the device declaration. The enum ``rte_devtype`` - was used to identify a bus and will disappear. - The structure ``rte_devargs`` will change. - The ``rte_devargs_list`` will be made private. - The following functions are deprecated starting from 17.08 and will either be - modified or removed in 18.02: +* eal: both declaring and identifying devices will be streamlined in v18.05. + New functions will appear to query a specific port from buses, classes of + device and device drivers. Device declaration will be made coherent with the + new scheme of device identification. + As such, ``rte_devargs`` device representation will change. - - ``rte_eal_devargs_add`` - - ``rte_eal_devargs_type_count`` - - ``rte_eal_parse_devargs_str``, replaced by ``rte_eal_devargs_parse`` + - removal of ``name`` and ``args`` fields. + - The enum ``rte_devtype`` was used to identify a bus and will disappear. + - The ``rte_devargs_list`` will be made private. + - Functions previously deprecated will change or disappear: + + + ``rte_eal_devargs_add`` + + ``rte_eal_devargs_type_count`` + + ``rte_eal_parse_devargs_str``, replaced by ``rte_eal_devargs_parse`` + + ``rte_eal_devargs_parse`` will change its format and use. + + all ``rte_devargs`` related functions will be renamed, changing the + ``rte_eal_devargs_`` prefix to ``rte_devargs_``. * pci: Several exposed functions are misnamed. The following functions are deprecated starting from v17.11 and are replaced: -- 2.11.0