editorial
authorRalph Ronnquist <ralph.ronnquist@gmail.com>
Tue, 25 Oct 2022 08:15:36 +0000 (19:15 +1100)
committerRalph Ronnquist <ralph.ronnquist@gmail.com>
Tue, 25 Oct 2022 08:15:36 +0000 (19:15 +1100)
libtarmap.so.8.adoc
tarmap.8.adoc

index addc8a5b828af7b607de2c7ebc3bd0f720c75ed1..6fe8cff10227ab16e20a20e96eee90c3ae5f26c9 100644 (file)
@@ -29,9 +29,8 @@ TARMAP::
 This environment variable tells which tarfile to use. Pathnames are
 looked up in the tarfile first.
 
-EXAMPLES
---------
 
 SEE ALSO
 --------
 
+tarmap, libpathmap
index 3da611bd048181ec48d91a303d94713841c27727..446440240cfd74eed4d8c05c3d264ec6457eef47 100644 (file)
@@ -11,7 +11,7 @@ tarmap - run command with libtarmap.so preloading
 
 SYNOPSYS
 --------
-+tarmap+ _tarfile_ _command_
+tarmap _tarfile_ _command_
 
 DESCRIPTION
 -----------
@@ -20,54 +20,7 @@ The given command is executed by "/bin/bash" with an LD_PRELOAD
 setting to use libtarmap.so for resolving pathnames into the given tar
 file before the filesystem. See libtarmap.so for more details.
 
-TBD
-
-This dynamic library, libtarmap.so, is 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.so+ is "configured" by setting environment variable
-+PATHMAPNOT+ to be the path prefixes, given as a colon separated list,
-that +libtarmap.so+ should be concerned with. The first of them is
-then used as the prefix to add to the program's pathnames (when
-opening files) except to those pathnames that start with any of the
-prefixes in the list, including the first.
-
-For example, if the prefix +/elsewhere+ should be added to all
-pathnames for a program +prgrm+ then the command line might be:
-
-----
-PATHMAPNOT=/elsewhere LD_PRELOAD=libtarmap.so prgrm
-----
-
-However, if +prgrm+ is a dynamically linked executable, then all
-libraries
-
-ENVIRONMENT
------------
-
-PATHMAPNOT::
-
-This environment variable tells which path prefixes, given as a colon
-separated list, +libtarmap.so+ should be concerned with. The first
-prefix is the one to add to all pathnames except to those of any of
-the prefixes in the list.
-
-EXAMPLES
---------
-
-Assume there is a directory +/home/test/extra+
-
 SEE ALSO
 --------
 
-libtarmap.so::
-
-a
-
-libpathmap.so::
-
-b
-
+libtarmap.so, libpathmap.so