From 6f24f4acd132670fd7edcaf2d87c4d465ae359ef Mon Sep 17 00:00:00 2001
From: midipix <writeonce@midipix.org>
Date: Tue, 20 Apr 2021 22:15:00 +0000
Subject: internals: added tpax_getdents() and related PORTING document.

---
 PORTING | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 PORTING

(limited to 'PORTING')

diff --git a/PORTING b/PORTING
new file mode 100644
index 0000000..90dccc1
--- /dev/null
+++ b/PORTING
@@ -0,0 +1,21 @@
+PORTING
+=======
+
+* tpax relies on a modern getdents interface. This interface is invoked
+  via a static inlined wrapper named tpax_getdents(), which is provided
+  by the tpax_getdents_impl.h internal header.
+
+  If your system is not currently covered, you can still easily build
+  and use tpax by (1) providing your own version of tpax_getdents() in
+  a linker archive of any name; and (2) adding -DTPAX_GETDENTS_PORTED
+  to CFLAGS, and the full path to the above archive to LDFLAGS_LAST.
+
+  The wrapper's signature shall then be:
+
+  long tpax_getdents(int, struct dirent *, size_t);
+
+  And your ./configure invocation would then look like:
+
+  CFLAGS=-DTPAX_GETDENTS_PORTED                   \\
+	LDFLAGS_LAST=/path/to/tpax_getdents_impl.a \\
+	./configure
-- 
cgit v1.2.3