From: Martin Mareš <mj@ucw.cz>
Date: Sun, 5 Apr 2026 16:50:29 +0000 (+0200)
Subject: Add README.DJGPP
X-Git-Url: http://mj.ucw.cz/gitweb/?a=commitdiff_plain;h=a59af98bb3e89bf69c63d8c3bb4de555b5d9d98a;p=pciutils.git

Add README.DJGPP

Contributed by Pali.
---

diff --git a/README b/README
index cc61450..0994368 100644
--- 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
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/