From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 39C98A0C4C; Tue, 23 Nov 2021 17:45:27 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id EC15040040; Tue, 23 Nov 2021 17:45:26 +0100 (CET) Received: from mail-il1-f180.google.com (mail-il1-f180.google.com [209.85.166.180]) by mails.dpdk.org (Postfix) with ESMTP id 5D9274003C for ; Tue, 23 Nov 2021 17:45:25 +0100 (CET) Received: by mail-il1-f180.google.com with SMTP id j7so15021444ilk.13 for ; Tue, 23 Nov 2021 08:45:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=ODuK/Yw6AQaVSTL4i1UkQdu9XETLezq0/WfckzKKHLk=; b=Ud98ogEr6r583TbYq3LY2nprIFSQ8EDx93hrQSxNyyzl/chm9BRlMRoYPh4/r/hSQv sXsS+FUubWQEjpv23pLpHYf+gpeYzhjgMQU98IEgc7N+0Pef/WZAOaheQfcl/JsTvju0 FNfw2MWuVwCYMMDT4xbfJ9an+/OukJ0+iuwhYhMT/wXs+xiYSKepz8a8PXYLKsQkCOsD b8z7mERW0oHRlWWRzSAqGK745sthdcAzPDysWtifqoLM2LMIYOIH10hLK0sORLhJ5JRf N/AV3I1ltVuYrXx81C9GsAQMvAX9dYSnHBqQkEB1FE5w9av/OsnGxkMLLAXhBoKB7NlC 4Riw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=ODuK/Yw6AQaVSTL4i1UkQdu9XETLezq0/WfckzKKHLk=; b=YOG//YMuo7XAf2P0HTxtq79UOV1pvTECqN50d6SjQxl6d6rRXXNMmtDymM899NfnbQ 5JN1x2X7+T6XfurEU/TV1nY/d0aBDEw5+xcEisI042zLBKDu2DogFS7E5fMaDB8sT99J lArYCXSIMh411ZjhVgm58gb7EjUQ5yOtKw2FE9UU3kQOP5faMt2WRXrM6lRKjvE3X+xu 7Gw0yxmsh+oXX+QEn02yvEdDQK6LrX8QNTYwHC06PYwpPrLZmFGV8ehc6hYdF5k2S4JD 2OI8jWAGcohw4gbEpoxADCVWvycFbfEf6ahylWwX81p3Jk5mwFP38s3xlIw8o0c9K6rf fHRQ== X-Gm-Message-State: AOAM530H5TTXqxUI+B2n/DfaxHuZ/wNYhrHde1x+z9Jz8WzqzPFIP41M TWzusVKrOhdGk/XSB0uI/njrP1tLqUghr6aq5G4= X-Google-Smtp-Source: ABdhPJx77l+wjfaP52kizzvtm86Hc4aokuhGf0wZJzCnCgFAmi8Os6jUBCJ/1QYzNsLGhIPDz6Rzclfdil7W1HtOB+8= X-Received: by 2002:a05:6e02:1b01:: with SMTP id i1mr6130138ilv.94.1637685924618; Tue, 23 Nov 2021 08:45:24 -0800 (PST) MIME-Version: 1.0 References: <20200227070301.11520-1-skori@marvell.com> <20211022074843.907766-1-skori@marvell.com> In-Reply-To: <20211022074843.907766-1-skori@marvell.com> From: Jerin Jacob Date: Tue, 23 Nov 2021 22:14:58 +0530 Message-ID: Subject: Re: [dpdk-dev] [PATCH v5 1/4] doc: add skeleton for eventdevs feature matrices To: Sunil Kumar Kori , Thomas Monjalon Cc: Jerin Jacob , Nikhil Rao , Pavan Nikhilesh , Hemant Agrawal , Nipun Gupta , "Van Haaren, Harry" , =?UTF-8?Q?Mattias_R=C3=B6nnblom?= , Liang Ma , dpdk-dev Content-Type: text/plain; charset="UTF-8" X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org On Fri, Oct 22, 2021 at 1:18 PM wrote: > > From: Sunil Kumar Kori > > Patch adds skeleton for feature matrices for event dev > and Rx/Tx adapters. > > Along with, .ini files are added for all supported PMDs. > > Signed-off-by: Sunil Kumar Kori Series Acked-by: Jerin Jacob Series without patch [10/10][1] applied to dpdk-next-net-eventdev/for-main. Thanks [1] http://patches.dpdk.org/project/dpdk/patch/20211123110743.2002557-10-skori@marvell.com/ @Thomas Monjalon Delegated above patch to you as it is for tooling. > --- > v5: > - Rebased to 21.11 > - Added feature matrix for cnxk. > v4: > - Rebased to 20.02 > v3: > - Removed .txt files to generate tables. > - Use conf.py script to generate tables. > - Add .ini file for all supported PMDs. > v2: > - Review comments incorporated > > .gitignore | 2 ++ > doc/guides/conf.py | 12 ++++++++- > doc/guides/eventdevs/features/cnxk.ini | 8 ++++++ > doc/guides/eventdevs/features/default.ini | 30 +++++++++++++++++++++ > doc/guides/eventdevs/features/dpaa.ini | 8 ++++++ > doc/guides/eventdevs/features/dpaa2.ini | 8 ++++++ > doc/guides/eventdevs/features/dsw.ini | 8 ++++++ > doc/guides/eventdevs/features/octeontx.ini | 8 ++++++ > doc/guides/eventdevs/features/octeontx2.ini | 8 ++++++ > doc/guides/eventdevs/features/opdl.ini | 8 ++++++ > doc/guides/eventdevs/features/sw.ini | 8 ++++++ > doc/guides/eventdevs/index.rst | 1 + > doc/guides/eventdevs/overview.rst | 19 +++++++++++++ > 13 files changed, 127 insertions(+), 1 deletion(-) > create mode 100644 doc/guides/eventdevs/features/cnxk.ini > create mode 100644 doc/guides/eventdevs/features/default.ini > create mode 100644 doc/guides/eventdevs/features/dpaa.ini > create mode 100644 doc/guides/eventdevs/features/dpaa2.ini > create mode 100644 doc/guides/eventdevs/features/dsw.ini > create mode 100644 doc/guides/eventdevs/features/octeontx.ini > create mode 100644 doc/guides/eventdevs/features/octeontx2.ini > create mode 100644 doc/guides/eventdevs/features/opdl.ini > create mode 100644 doc/guides/eventdevs/features/sw.ini > create mode 100644 doc/guides/eventdevs/overview.rst > > diff --git a/.gitignore b/.gitignore > index b19c0717e6..b3fc783945 100644 > --- a/.gitignore > +++ b/.gitignore > @@ -14,6 +14,8 @@ doc/guides/compressdevs/overview_feature_table.txt > doc/guides/regexdevs/overview_feature_table.txt > doc/guides/vdpadevs/overview_feature_table.txt > doc/guides/bbdevs/overview_feature_table.txt > +doc/guides/eventdevs/overview_feature_table.txt > +doc/guides/eventdevs/overview_adptr_feature_table.txt > > # ignore generated ctags/cscope files > cscope.out.po > diff --git a/doc/guides/conf.py b/doc/guides/conf.py > index 67d2dd62c7..9d8e20e5fc 100644 > --- a/doc/guides/conf.py > +++ b/doc/guides/conf.py > @@ -41,7 +41,7 @@ > master_doc = 'index' > > # Maximum feature description string length > -feature_str_len = 30 > +feature_str_len = 45 > > # Figures, tables and code-blocks automatically numbered if they have caption > numfig = True > @@ -388,6 +388,16 @@ def setup(app): > 'Features', > 'Features availability in bbdev drivers', > 'Feature') > + table_file = dirname(__file__) + '/eventdevs/overview_feature_table.txt' > + generate_overview_table(table_file, 1, > + 'Features', > + 'Features availability in eventdev drivers', > + 'Feature') > + table_file = dirname(__file__) + '/eventdevs/overview_adptr_feature_table.txt' > + generate_overview_table(table_file, 2, > + 'Adapter Features', > + 'Features availability for adapters', > + 'Feature') > > if LooseVersion(sphinx_version) < LooseVersion('1.3.1'): > print('Upgrade sphinx to version >= 1.3.1 for ' > diff --git a/doc/guides/eventdevs/features/cnxk.ini b/doc/guides/eventdevs/features/cnxk.ini > new file mode 100644 > index 0000000000..a461966d69 > --- /dev/null > +++ b/doc/guides/eventdevs/features/cnxk.ini > @@ -0,0 +1,8 @@ > +; > +; Supported features of the 'cnxk' eventdev driver. > +; > +; Refer to default.ini for the full list of available PMD features. > +; > +[Features] > + > +[Adapter Features] > diff --git a/doc/guides/eventdevs/features/default.ini b/doc/guides/eventdevs/features/default.ini > new file mode 100644 > index 0000000000..d007d7a69e > --- /dev/null > +++ b/doc/guides/eventdevs/features/default.ini > @@ -0,0 +1,30 @@ > +; > +; Features of a default eventdev driver. > +; > +; This file defines the features that are valid for inclusion in > +; the other driver files and also the order that they appear in > +; the features table in the documentation. > +; > +[Features] > +Event queue priority based scheduling = > +Event priority based scheduling = > +Event device distributed scheduling = > +Event device non sequential mode = > +Event queue all types = > +Burst mode enqueue/dequeue = > +Event port implicit release disable = > +Runtime event queue/port linking = > +Multi queue linking per port = > + > +; > +; Features of a default adapter. > +; > +[Adapter Features] > +Eth Rx/Tx adapter on internal port = > +Multiple event queues per ethdev = > +Override flow ID = > +Crypto adapter new event enqueue = > +Crypto adapter forwarded event enqueue = > +Crypto queue pair mapping to event queue = > +Crypto adapter session data store/retrieve = > +Timer adapter support in H/W = > diff --git a/doc/guides/eventdevs/features/dpaa.ini b/doc/guides/eventdevs/features/dpaa.ini > new file mode 100644 > index 0000000000..3cf172f408 > --- /dev/null > +++ b/doc/guides/eventdevs/features/dpaa.ini > @@ -0,0 +1,8 @@ > +; > +; Supported features of the 'dpaa' eventdev driver. > +; > +; Refer to default.ini for the full list of available PMD features. > +; > +[Features] > + > +[Adapter Features] > diff --git a/doc/guides/eventdevs/features/dpaa2.ini b/doc/guides/eventdevs/features/dpaa2.ini > new file mode 100644 > index 0000000000..822a82ef3e > --- /dev/null > +++ b/doc/guides/eventdevs/features/dpaa2.ini > @@ -0,0 +1,8 @@ > +; > +; Supported features of the 'dpaa2' eventdev driver. > +; > +; Refer to default.ini for the full list of available PMD features. > +; > +[Features] > + > +[Adapter Features] > diff --git a/doc/guides/eventdevs/features/dsw.ini b/doc/guides/eventdevs/features/dsw.ini > new file mode 100644 > index 0000000000..230737045b > --- /dev/null > +++ b/doc/guides/eventdevs/features/dsw.ini > @@ -0,0 +1,8 @@ > +; > +; Supported features of the 'distributed software' eventdev driver. > +; > +; Refer to default.ini for the full list of available PMD features. > +; > +[Features] > + > +[Adapter Features] > diff --git a/doc/guides/eventdevs/features/octeontx.ini b/doc/guides/eventdevs/features/octeontx.ini > new file mode 100644 > index 0000000000..d1b1fe6d62 > --- /dev/null > +++ b/doc/guides/eventdevs/features/octeontx.ini > @@ -0,0 +1,8 @@ > +; > +; Supported features of the 'octeontx' eventdev driver. > +; > +; Refer to default.ini for the full list of available PMD features. > +; > +[Features] > + > +[Adapter Features] > diff --git a/doc/guides/eventdevs/features/octeontx2.ini b/doc/guides/eventdevs/features/octeontx2.ini > new file mode 100644 > index 0000000000..96f1af0dca > --- /dev/null > +++ b/doc/guides/eventdevs/features/octeontx2.ini > @@ -0,0 +1,8 @@ > +; > +; Supported features of the 'octeontx2' eventdev driver. > +; > +; Refer to default.ini for the full list of available PMD features. > +; > +[Features] > + > +[Adapter Features] > diff --git a/doc/guides/eventdevs/features/opdl.ini b/doc/guides/eventdevs/features/opdl.ini > new file mode 100644 > index 0000000000..020808fced > --- /dev/null > +++ b/doc/guides/eventdevs/features/opdl.ini > @@ -0,0 +1,8 @@ > +; > +; Supported features of 'Ordered Packet Distribution Library' eventdev driver. > +; > +; Refer to default.ini for the full list of available PMD features. > +; > +[Features] > + > +[Adapter Features] > diff --git a/doc/guides/eventdevs/features/sw.ini b/doc/guides/eventdevs/features/sw.ini > new file mode 100644 > index 0000000000..a5789f56d4 > --- /dev/null > +++ b/doc/guides/eventdevs/features/sw.ini > @@ -0,0 +1,8 @@ > +; > +; Supported features of the 'software' eventdev driver. > +; > +; Refer to default.ini for the full list of available PMD features. > +; > +[Features] > + > +[Adapter Features] > diff --git a/doc/guides/eventdevs/index.rst b/doc/guides/eventdevs/index.rst > index 2143025390..b11657f7ae 100644 > --- a/doc/guides/eventdevs/index.rst > +++ b/doc/guides/eventdevs/index.rst > @@ -11,6 +11,7 @@ application through the eventdev API. > :maxdepth: 2 > :numbered: > > + overview > cnxk > dlb2 > dpaa > diff --git a/doc/guides/eventdevs/overview.rst b/doc/guides/eventdevs/overview.rst > new file mode 100644 > index 0000000000..5d34d2c57b > --- /dev/null > +++ b/doc/guides/eventdevs/overview.rst > @@ -0,0 +1,19 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(C) 2021 Marvell. > + > +Event Device Supported Functionality Matrices > +============================================= > + > +Event Device Supported Feature Flags > +------------------------------------ > + > +.. _table_eventdev_pmd_features: > + > +.. include:: overview_feature_table.txt > + > +Adapter Supported Feature Flags > +------------------------------- > + > +.. _table_adapter_features: > + > +.. include:: overview_adptr_feature_table.txt > -- > 2.25.1 >