X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=README.Windows;h=7a5ccab1917ce549b71a7dc46fa86a41865cc9dd;hb=327b6e8a1660e1c937b7987fa31f972af393521b;hp=14c11e47ae129da1c90e8720d6d10544a11cfa74;hpb=1c5cc9b5b323c84179cad9d90e86600d3c0cdfb6;p=pciutils.git diff --git a/README.Windows b/README.Windows index 14c11e4..7a5ccab 100644 --- a/README.Windows +++ b/README.Windows @@ -1,8 +1,38 @@ Since 2.1.99-test5, pciutils should also be compilable on Windows. Thanks to Alexander Stock for contributing the port. -To build this port, you need to install WinIO.dll first. You can get it -from http://www.internals.com/. +Updated after version 2.2.6 to compile again, and with MinGW, even (only?) +cross-compiling. (Hopefully it works with MSVC too.) -However, you need to use win32/config.h instead of the automatically -generated lib/config.h as lib/configure does not run on Windows. +For simple listing PCI devices in system with basic information, there is no +special requirement. To list PCI resources on Windows 8 and higher versions, +it is necessary to have architecture-native version (e.g. AMD64 version on +AMD64 systems). + +To access config space on NT-based systems, it is required to have SeTcbPrivilege +(Act as part of the operating system privilege), which can be enabled in User +Accounts settings (take effect after next login). By default this privilege is +not enabled for any non-system user. Or alternatively it is required to be in +local Administrators group and on Windows 2000 SP4 or higher systems to have +SeImpersonatePrivilege (Impersonate a client after authentication privilege) +which is by default enabled for all local Administrators accounts. There is no +special requirement for DOS-based systems. 64-bit systems do not have to allow +users to access config space even with SeTcbPrivilege. + +To compile this port, run following command: + + make CROSS_COMPILE=i586-mingw32msvc- HOST=i586-windows ZLIB=no IDSDIR="" + +To build 64-bit version, run: + + make CROSS_COMPILE=x86_64-w64-mingw32- HOST=x86_64-windows ZLIB=no IDSDIR="" + +Sometimes compilation may fail due to broken or missing getopt implementation. +In this case try to compile with additional make option: COMPAT_GETOPT=yes + +================================================================================ +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. +================================================================================