numam-dpdk/doc/guides/tools
Robin Jarry 0ce3cf4afd usertools/pmdinfo: rewrite simpler script
dpdk-pmdinfo.py does not produce any parseable output. The -r/--raw flag
merely prints multiple independent JSON lines which cannot be fed
directly to any JSON parser. Moreover, the script complexity is rather
high for such a simple task: extracting PMD_INFO_STRING from .rodata ELF
sections. Rewrite it so that it can produce valid JSON.

Remove the PCI database parsing for PCI-ID to Vendor-Device names
conversion. This should be done by external scripts (if really needed).

The script passes flake8, black, isort and pylint checks.

I have tested this with a matrix of python/pyelftools versions:

                                 pyelftools
               0.22  0.23  0.24  0.25  0.26  0.27  0.28  0.29
        3.6      ok    ok    ok    ok    ok    ok    ok    ok
        3.7      ok    ok    ok    ok    ok    ok    ok    ok
 Python 3.8      ok    ok    ok    ok    ok    ok    ok    ok
        3.9      ok    ok    ok    ok    ok   *ok    ok    ok
        3.10   fail  fail  fail  fail    ok    ok    ok    ok

                                     * Also tested on FreeBSD

All failures with python 3.10 are related to the same issue:

  File "elftools/construct/lib/container.py", line 5, in <module>
    from collections import MutableMapping
  ImportError: cannot import name 'MutableMapping' from 'collections'

Python 3.10 support is only available since pyelftools 0.26. The script
will only work with Python 3.6 and later.

Update the minimal system requirements, docs and release notes.

Signed-off-by: Robin Jarry <rjarry@redhat.com>
Tested-by: Ferruh Yigit <ferruh.yigit@amd.com>
Tested-by: Olivier Matz <olivier.matz@6wind.com>
Acked-by: Bruce Richardson <bruce.richardson@intel.com>
2022-10-11 02:11:33 +02:00
..
img doc: update eventdev app guide for Tx adapter 2018-10-01 16:54:15 +02:00
comp_perf.rst eal: replace blacklist/whitelist options 2020-11-16 00:11:22 +01:00
cryptoperf.rst test/crypto-perf: support SDAP for PDCP operations 2022-06-21 20:04:49 +02:00
devbind.rst doc: prefer VFIO for device binding 2020-11-26 17:04:40 +01:00
dumpcap.rst doc: fix dumpcap interface parameter option 2022-10-10 02:18:03 +02:00
flow-perf.rst doc: fix indentation in flow-perf guide 2021-11-16 12:34:06 +01:00
hugepages.rst doc: fix spelling 2021-07-31 20:03:47 +02:00
index.rst app/dumpcap: add new packet capture application 2021-10-22 22:40:58 +02:00
pdump.rst doc: remove reference to make from tools guide 2020-10-22 22:54:05 +02:00
pmdinfo.rst usertools/pmdinfo: rewrite simpler script 2022-10-11 02:11:33 +02:00
proc_info.rst doc: remove reference to make from tools guide 2020-10-22 22:54:05 +02:00
testbbdev.rst app/bbdev: handle endianness of test data 2021-10-18 20:12:15 +02:00
testeventdev.rst app/eventdev: add Tx first option to pipeline mode 2022-06-13 07:59:42 +02:00
testregex.rst app/regex: add match mode option 2022-10-09 15:11:58 +02:00