From bea0037dbdd979603fb0b5be8b43f5478c1f6fec Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Fri, 19 Sep 2014 02:53:32 +0000 Subject: initial commit --- doc/s6-update-symlinks.html | 83 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 doc/s6-update-symlinks.html (limited to 'doc/s6-update-symlinks.html') diff --git a/doc/s6-update-symlinks.html b/doc/s6-update-symlinks.html new file mode 100644 index 0000000..96cc15b --- /dev/null +++ b/doc/s6-update-symlinks.html @@ -0,0 +1,83 @@ + + + + + s6-portable-utils: the s6-update-symlinks program + + + + + + +

+s6
+Software
+skarnet.org +

+ +

The `s6-update-symlinks` program

+ +

+ s6-update-symlinks links the content of several similar directory trees +under a single tree. Its main use is to replace search paths like $PATH +or $MANPATH, by creating a unique access tree based on the source trees. +Name conflicts are solved by giving precedence to the last named directory. +Subdirectories are created exactly as needed ; what can be shared is +shared. +

+ +

+s6-update-symlinks is useful when one wants to combine +a logical package system, like Dan Bernstein's +/package and +/command, with +physical filesystem constraints, like /, /usr and +/usr/local on separate filesystems. +

+ +

Interface

+ +

+     s6-update-symlinks d src1 src2 ...
+

+ +

d is the destination directory. It will be created if it doesn't +exist.
src1, src2, ... are the directory containing the files +to be linked.
d and srcn must be +absolute paths, else s6-update-symlinks refuses to run. Using +relative paths doesn't make sense here, anyway.
If src2 is empty, then d becomes a link to src1.
If src1 is empty or entirely overridden by src2, then +d becomes a link to src2.
If src1/file exists but not src2/file, then d +becomes a real directory and d/file a link to src1/file. +Then if src2/file2 exists, d/file2 links to it.
And so on with other src directories, and subdirs.
If s6-update-symlinks manages to performs all the requested +tasks, it exits 0. If it encounters a hard error, it exits 111. If it is +unable to resolve a conflict between given sources, it exits 100.

+ +

Examples

+ +

+s6-update-symlinks /command /bin /sbin /usr/bin /usr/sbin /usr/local/bin /usr/local/sbin +
makes all files under /bin, ..., /usr/local/sbin +available under /command. The programs linked are the same as the ones +that would be accessed with PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin". +
+s6-update-symlinks /package /initrd/package /slash/package /usr/package /usr/local/package +
builds a /package hierarchy with what it finds in the listed +directories. This allows oddities like, for instance, having the daemontools +sources in /usr/package/admin/daemontools/src, and the daemontools +binaries in /initrd/package/admin/daemontools/bin, but accessing +both through /package/admin/daemontools/.

+ + + -- cgit v1.3.1

The s6-update-symlinks program

Interface

Examples

The `s6-update-symlinks` program