numam-dpdk/doc/guides/linux_gsg
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
..
build_dpdk.rst doc: expand list of directories in Linux guide 2022-03-15 19:37:25 +01:00
build_sample_apps.rst fix PMD wording 2021-11-26 11:28:34 +01:00
cross_build_dpdk_for_arm64.rst doc: add arm64 cross file example 2022-03-16 20:23:30 +01:00
cross_build_dpdk_for_loongarch.rst eal/loongarch: support LoongArch architecture 2022-10-06 12:45:05 +02:00
cross_build_dpdk_for_riscv.rst eal/riscv: support RISC-V architecture 2022-06-08 11:26:20 +02:00
doc_roadmap.include.rst doc: make doc roadmap common for Linux and BSD guides 2022-06-26 23:36:39 +02:00
eal_args.include.rst eal/linux: allocate worker lcore stacks in hugepages 2022-06-23 22:36:33 +02:00
enable_func.rst doc: add more instructions for running as non-root 2022-06-27 02:24:17 +02:00
index.rst eal/loongarch: support LoongArch architecture 2022-10-06 12:45:05 +02:00
intro.rst doc: make doc roadmap common for Linux and BSD guides 2022-06-26 23:36:39 +02:00
linux_drivers.rst replace Mellanox with NVIDIA 2022-10-03 16:01:56 +02:00
linux_eal_parameters.rst eal: extend --huge-unlink for hugepage file reuse 2022-02-08 21:32:53 +01:00
nic_perf_intel_platform.rst doc: add SPDX license tag header to Intel performance guide 2020-11-26 16:13:42 +01:00
sys_reqs.rst usertools/pmdinfo: rewrite simpler script 2022-10-11 02:11:33 +02:00