From: Ralph Ronnquist Date: Tue, 25 Oct 2022 08:15:36 +0000 (+1100) Subject: editorial X-Git-Url: https://git.rrq.selfhost.au/?a=commitdiff_plain;h=2974a0209e941e1738a54e544bc4ad2cdf6f6b1e;p=rrq%2Fpathmap.git editorial --- diff --git a/libtarmap.so.8.adoc b/libtarmap.so.8.adoc index addc8a5..6fe8cff 100644 --- a/libtarmap.so.8.adoc +++ b/libtarmap.so.8.adoc @@ -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 diff --git a/tarmap.8.adoc b/tarmap.8.adoc index 3da611b..4464402 100644 --- a/tarmap.8.adoc +++ b/tarmap.8.adoc @@ -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