-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.