Add README.DJGPP

Contributed by Pali.

diff --git a/README b/README
index cc614501bceb9d13a24bdf2d381e27e3088091f3..0994368eaf7eb441cc4558604df7b2ef59d0cf8a 100644 (file)
--- a/README
+++ b/README
@@ -30,7 +30,7 @@ In runs on the following systems:
        BeOS            (via syscalls)
        Haiku           (via /dev/misc/poke)
        Darwin          (via IOKit)
-       DOS/DJGPP       (via i386 ports)
+       DOS/DJGPP       (via i386 ports, see README.DJGPP)
        SylixOS         (via /proc/pci)
        AmigaOS on PPC  (via Expansion library)
        RT-Thread Smart (via /proc/pci)

diff --git a/README.DJGPP b/README.DJGPP
new file mode 100644 (file)
index 0000000..684d594
--- /dev/null
+++ b/README.DJGPP
@@ -0,0 +1,33 @@
+DJGPP is a software development suite for Intel i386 PCs running DOS operating
+systems. Compiled binaries for DJGPP by gcc can be run on FreeDOS system.
+
+https://www.delorie.com/djgpp/
+https://www.freedos.org/
+
+DJGPP port of pciutils supports only direct hardware access methods.
+Currently available methods are: intel-conf1, intel-conf2 and ecam.
+More details about particular access method and caveats are described in
+the pcilib(8) manual page. Method ecam can access PCI Express registers.
+
+To compile this port, run following command:
+
+  make CROSS_COMPILE=i386-pc-msdosdjgpp- HOST=i386-djgpp DNS=no ZLIB=no IDSDIR="" COMPAT_GETOPT=yes
+
+This will produce statically linked pcituils exe binaries and static
+libpci.a library. Building of dynamic shared library is not supported.
+
+Ensure that i386-pc-msdosdjgpp-gcc cross compiler is in the PATH env.
+
+For optimizing executable sizes, following make options may be useful:
+
+  OPT="-Os -fomit-frame-pointer -ffunction-sections -fdata-sections"
+  LDFLAGS="-Os -fomit-frame-pointer -s -Wl,--gc-sections"
+
+Please note that for running these pciutils executables (like for any other DJPP
+binaries) it is needed to have installed DPMI server software on target system.
+The preferred one by DJGPP project is CWSDPMI but any other should work too
+(e.g. Windows-integrated or HX DPMI). CWSDPMI project is at address:
+https://sandmann.dotster.com/cwsdpmi/
+
+Pre-built DJGPP pcituils binaries are available at:
+https://mj.ucw.cz/download/linux/pci/windows/