From: Ralph Ronnquist Date: Tue, 25 Oct 2022 11:54:24 +0000 (+1100) Subject: fixup manpage naming X-Git-Url: https://git.rrq.selfhost.au/?a=commitdiff_plain;h=c0cd1573be8ffd01a3c2ab2719c011cbbe9f78fe;p=rrq%2Fpathmap.git fixup manpage naming --- diff --git a/libpathmap-0.so.8.adoc b/libpathmap-0.so.8.adoc new file mode 100644 index 0000000..78096fe --- /dev/null +++ b/libpathmap-0.so.8.adoc @@ -0,0 +1,67 @@ +libpathmap-0.so(8) +================== +:doctype: manpage +:revdate: {sys:date "+%Y-%m-%d %H:%M:%S"} +:COLON: : +:EQUALS: = + +NAME +---- +libpathmap-0.so - preload utility to redirect pathnames + +SYNOPSYS +-------- ++LD_PRELOAD=libpathmap-0.so+ _command_ + +DESCRIPTION +----------- + +This dynamic library, libpathmap-0.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. + ++libpathmap-0.so+ is "configured" by setting environment variable ++PATHMAPNOT+ to be the path prefixes, given as a colon separated list, +that +libpathmap-0.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=libpathmap-0.so prgrm +---- + +Note however that dynamically linked libraries are loaded via +statically linked function calls and they are therefore not handled +via libpathmap-0.so. + +ENVIRONMENT +----------- + +PATHMAPNOT:: + +This environment variable tells which path prefixes, given as a colon +separated list, +libpathmap-0.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+ + +---- +env PATHMAPNOT=/home/test:/proc:/dev:/lib:/usr:/bin \ + LD_PRELOAD=libpathmap-0.so \ + ls /extra +---- + +SEE ALSO +-------- + +libtarmap0.so, tarmap diff --git a/libpathmap0.so.8.adoc b/libpathmap0.so.8.adoc deleted file mode 100644 index ff8be3d..0000000 --- a/libpathmap0.so.8.adoc +++ /dev/null @@ -1,67 +0,0 @@ -libpathmap0.so(8) -================ -:doctype: manpage -:revdate: {sys:date "+%Y-%m-%d %H:%M:%S"} -:COLON: : -:EQUALS: = - -NAME ----- -libpathmap0.so - preload utility to redirect pathnames - -SYNOPSYS --------- -+LD_PRELOAD=libpathmap0.so+ _command_ - -DESCRIPTION ------------ - -This dynamic library, libpathmap0.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. - -+libpathmap0.so+ is "configured" by setting environment variable -+PATHMAPNOT+ to be the path prefixes, given as a colon separated list, -that +libpathmap0.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=libpathmap0.so prgrm ----- - -Note however that dynamically linked libraries are loaded via -statically linked function calls and they are therefore not handled -via libpathmap0.so. - -ENVIRONMENT ------------ - -PATHMAPNOT:: - -This environment variable tells which path prefixes, given as a colon -separated list, +libpathmap0.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+ - ----- -env PATHMAPNOT=/home/test:/proc:/dev:/lib:/usr:/bin \ - LD_PRELOAD=libpathmap0.so \ - ls /extra ----- - -SEE ALSO --------- - -libtarmap0.so, tarmap diff --git a/libtarmap-0.so.8.adoc b/libtarmap-0.so.8.adoc new file mode 100644 index 0000000..3bd07cf --- /dev/null +++ b/libtarmap-0.so.8.adoc @@ -0,0 +1,36 @@ +libtarmap-0.so(8) +================= +:doctype: manpage +:revdate: {sys:date "+%Y-%m-%d %H:%M:%S"} +:COLON: : +:EQUALS: = + +NAME +---- +libtarmap-0.so - preload utility to map pathnames into a tar file + +SYNOPSYS +-------- +LD_PRELOAD=libtarmap-0.so TARMAP=_tarfile_ _command_ + +DESCRIPTION +----------- + +This 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. In fact the command may be a bash script file within +the tarfile for executing that + +ENVIRONMENT +----------- + +TARMAP:: + +This environment variable tells which tarfile to use. Pathnames are +looked up in the tarfile first. + + +SEE ALSO +-------- + +tarmap, libpathmap diff --git a/libtarmap0.so.8.adoc b/libtarmap0.so.8.adoc deleted file mode 100644 index 107893b..0000000 --- a/libtarmap0.so.8.adoc +++ /dev/null @@ -1,36 +0,0 @@ -libtarmap0.so(8) -=============== -:doctype: manpage -:revdate: {sys:date "+%Y-%m-%d %H:%M:%S"} -:COLON: : -:EQUALS: = - -NAME ----- -libtarmap0.so - preload utility to map pathnames into a tar file - -SYNOPSYS --------- -LD_PRELOAD=libtarmap0.so TARMAP=_tarfile_ _command_ - -DESCRIPTION ------------ - -This 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. In fact the command may be a bash script file within -the tarfile for executing that - -ENVIRONMENT ------------ - -TARMAP:: - -This environment variable tells which tarfile to use. Pathnames are -looked up in the tarfile first. - - -SEE ALSO --------- - -tarmap, libpathmap