[thirdparty/pciutils.git] / README.Windows

Since 2.1.99-test5, pciutils should also be compilable on Windows. Thanks
to Alexander Stock for contributing the port.

Updated after version 2.2.6 to compile again, and with MinGW, even (only?)
cross-compiling. (Hopefully it works with MSVC too.)

To use this port, you need to install WinIO.dll first. You can get it here:

	https://github.com/starofrainnight/winio
	https://github.com/vaptu/winio

However, you need to use win32/config.{h,mk} instead of the automatically
generated lib/config.{h,mk} as lib/configure does not run on Windows.

================================================================================
BEWARE: The current implementation pokes I/O ports to access the PCI devices
directly. This leads to several problems: some devices are invisible, extended
PCIe configuration space is not available, and there are many potential race
conditions. Instead, libpci should use the proper Windows drivers.

Unfortunately, the Windows port currently lacks a maintainer. If you are willing
to step up and fix the issues, please let me know.  -- Martin Mares
================================================================================
Commit	Line	Data
ee7d8384 MM	1	Since 2.1.99-test5, pciutils should also be compilable on Windows. Thanks
ee7d8384 MM	2	to Alexander Stock for contributing the port.
c0eece92	3
09156b3b MM	4	Updated after version 2.2.6 to compile again, and with MinGW, even (only?)
	5	cross-compiling. (Hopefully it works with MSVC too.)
	6
bbc4a88c MM	7	To use this port, you need to install WinIO.dll first. You can get it here:
	8
	9	https://github.com/starofrainnight/winio
	10	https://github.com/vaptu/winio
1c5cc9b5	11
09156b3b MM	12	However, you need to use win32/config.{h,mk} instead of the automatically
09156b3b MM	13	generated lib/config.{h,mk} as lib/configure does not run on Windows.
b5847329 MM	14
	15	================================================================================
	16	BEWARE: The current implementation pokes I/O ports to access the PCI devices
	17	directly. This leads to several problems: some devices are invisible, extended
	18	PCIe configuration space is not available, and there are many potential race
	19	conditions. Instead, libpci should use the proper Windows drivers.
	20
	21	Unfortunately, the Windows port currently lacks a maintainer. If you are willing
	22	to step up and fix the issues, please let me know. -- Martin Mares
	23	================================================================================