[v3,1/3] doc: add skeleton for eventdevs feature matrices
Checks
Commit Message
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 <skori@marvell.com>
---
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/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 +++++++++++++
12 files changed, 119 insertions(+), 1 deletion(-)
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
@@ -9,6 +9,8 @@ doc/guides/cryptodevs/overview_auth_table.txt
doc/guides/cryptodevs/overview_aead_table.txt
doc/guides/cryptodevs/overview_asym_table.txt
doc/guides/compressdevs/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
@@ -47,7 +47,7 @@
master_doc = 'index'
# Maximum feature description string length
-feature_str_len = 25
+feature_str_len = 45
# Figures, tables and code-blocks automatically numbered if they have caption
numfig = True
@@ -401,6 +401,16 @@ def setup(app):
'Features',
'Features availability in compression 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 '
new file mode 100644
@@ -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 =
new file mode 100644
@@ -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]
new file mode 100644
@@ -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]
new file mode 100644
@@ -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]
new file mode 100644
@@ -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]
new file mode 100644
@@ -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]
new file mode 100644
@@ -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]
new file mode 100644
@@ -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]
@@ -11,6 +11,7 @@ application trough the eventdev API.
:maxdepth: 2
:numbered:
+ overview
dpaa
dpaa2
dsw
new file mode 100644
@@ -0,0 +1,19 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright(C) 2019 Marvell International Ltd.
+
+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