pci: keep API compatibility with mmap values
authorThomas Monjalon <thomas@monjalon.net>
Fri, 10 Jul 2020 09:47:37 +0000 (11:47 +0200)
committerThomas Monjalon <thomas@monjalon.net>
Sat, 11 Jul 2020 09:48:13 +0000 (11:48 +0200)
commit9d2b24593724a98d03f16c18c1e40622911572be
tree7bcaa3f2fce144845e1ed5b24a1da2fd10b5b11f
parent3596a037ab44a1ad588fb388d5d4ee8f3d2a1ca7
pci: keep API compatibility with mmap values

The function pci_map_resource() returns MAP_FAILED in case of error.
When replacing the call to mmap() by rte_mem_map(),
the error code became NULL, breaking the API.
This function is probably not used outside of DPDK,
but it is still a problem for two reasons:
- the deprecation process was not followed
- the Linux function pci_vfio_mmap_bar() is broken for i40e

The error code is reverted to the Unix value MAP_FAILED.
Windows needs to define this special value (-1 as in Unix).
After proper deprecation process, the API could be changed again
if really needed.

Because of the switch from mmap() to rte_mem_map(),
another part of the API was changed: "int additional_flags"
are defined as "additional flags for the mapping range"
without mentioning it was directly used in mmap().
Currently it is directly used in rte_mem_map(),
that's why the values rte_map_flags must be mapped (sic) on the mmap ones
in case of Unix OS.

These are side effects of a badly defined API using Unix values.

Bugzilla ID: 503
Fixes: 2fd3567e5425 ("pci: use OS generic memory mapping functions")

Reported-by: David Marchand <david.marchand@redhat.com>
Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
Acked-by: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>
Tested-by: Lihong Ma <lihongx.ma@intel.com>
drivers/bus/pci/bsd/pci.c
drivers/bus/pci/linux/pci_uio.c
drivers/bus/pci/linux/pci_vfio.c
drivers/bus/pci/pci_common_uio.c
lib/librte_eal/include/rte_eal_paging.h
lib/librte_eal/windows/include/rte_os.h
lib/librte_pci/rte_pci.c
lib/librte_pci/rte_pci.h