editorial
authorRalph Ronnquist <rrq@rrq.au>
Thu, 28 Aug 2025 04:39:50 +0000 (14:39 +1000)
committerRalph Ronnquist <rrq@rrq.au>
Thu, 28 Aug 2025 04:39:50 +0000 (14:39 +1000)
README.md

index fc2410b1d11502115d786f698879e5ddae16f592..85a8119d51a09b7a70b57391f3b74e246205c17e 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,12 +1,14 @@
-The fstrap interpreter
-======================
+pathmap
+=======
 
-The fstrap interpreter is intended to be a prefix to a tar file, for
-executing scripts in that tar file. More specifically, it sets up a
-file access overlay for using path names via the tar file where
-available, and referring to the file system otherwise.
+This project has preload libraries that wrap filesystem accesses.
 
-The actual work is done through the libfstrap.so dynamic library which
-is set as LD_PRELOAD library whilst invoking the first tar file entry
-for execution.
+libpathmap-0.so is a dynamic library intended to be used as a
+"preload" library for programs for which pathnames are to be mapped to
+a different common prefix. The effect is somewhat similar to +chroot+
+in that absolute pathnames, which normally are from the root of the
+file system, get mapped to be relative to the choosen prefix point.
 
+libtarmap-0.so is a dynamic library that is intended to be used as an
+LD_PRELOAD library for programs for which pathnames are to be mapped
+into a tarfile first.