From fe1f70d5f729e331facf481ec45cc1c64e095d85 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Mon, 23 Feb 2015 23:28:58 +0000 Subject: Add s6-hiercopy (based on skalibs) Version: rc for 2.0.2.0 --- INSTALL | 2 +- doc/index.html | 6 ++-- doc/s6-hiercopy.html | 66 ++++++++++++++++++++++++++++++++++++ doc/upgrade.html | 8 +++++ package/deps.mak | 3 ++ package/info | 2 +- package/modes | 1 + package/targets.mak | 1 + src/skaembutils/deps-exe/s6-hiercopy | 1 + src/skaembutils/s6-hiercopy.c | 17 ++++++++++ 10 files changed, 103 insertions(+), 4 deletions(-) create mode 100644 doc/s6-hiercopy.html create mode 100644 src/skaembutils/deps-exe/s6-hiercopy create mode 100644 src/skaembutils/s6-hiercopy.c diff --git a/INSTALL b/INSTALL index 00d050d..083a780 100644 --- a/INSTALL +++ b/INSTALL @@ -6,7 +6,7 @@ Build Instructions - A POSIX-compliant C development environment - GNU make version 4.0 or later - - skalibs version 2.2.0.0 or later: http://skarnet.org/software/skalibs/ + - skalibs version 2.3.1.0 or later: http://skarnet.org/software/skalibs/ This software will run on any operating system that implements POSIX.1-2008, available at: diff --git a/doc/index.html b/doc/index.html index 5d00821..95b4372 100644 --- a/doc/index.html +++ b/doc/index.html @@ -60,7 +60,9 @@ the package is now used to host specific utilities such as

A POSIX-compliant system with a standard C development environment

GNU make, version 4.0 or later

skalibs version -2.2.0.0 or later

+2.3.1.0 or later. It's a build-time requirement. It's also a run-time +requirement if you link against the shared version of the skalibs +library.

Licensing

@@ -74,7 +76,7 @@ the package is now used to host specific utilities such as

The current released version of s6-portable-utils is -2.0.1.0.

2.0.2.0

Alternatively, you can checkout a copy of the s6-portable-utils git repository:
```
 git clone git://git.skarnet.org/s6-portable-utils 
```

diff --git a/doc/s6-hiercopy.html b/doc/s6-hiercopy.html new file mode 100644 index 0000000..a4c12f0 --- /dev/null +++ b/doc/s6-hiercopy.html @@ -0,0 +1,66 @@ + + + + + s6-portable-utils: the s6-hiercopy program + + + + + + +

+s6-portable-utils
+Software
+skarnet.org +

+ +

The `s6-hiercopy` program

+ +

+s6-hiercopy copies a directory structure recursively. +

+ +

Interface

+ +

+     s6-hiercopy source destination
+

+ +

s6-hiercopy recursively copies source to +destination, which is created if it doesn't exist. +The permissions are preserved. The owner and group are preserved +if the user is the superuser.
It exits 0 on success and 111 on temporary failure.

+ +

Notes

+ +

Copying files and browsing through directories is one of Unix's +weakest points, and s6-hiercopy is not meant to work around +the problem; it's only a quick hack that I needed to boot my embedded +platform. I originally planned to write the ultimate cp utility, +portable and reliable and featureful and everything - while needing +approximately a hundred times less resources than GNU cp does, +of course. But I eventually dropped the idea: it's impossible to +design, much less write, such a utility. Notably, + you cannot make it reliable because Unix's set of filesystem +management primitives is just too weak. It lacks a lot of atomic +operations, and filesystem transactions. As a result, s6-hiercopy +is a walking race condition and should absolutely not +be considered instant when used in a multitasking environment. +But then, cp shouldn't either.
There is no standard way of creating device nodes on a +filesystem, so any cp-like utility is inherently +non-portable. Fortunately, most systems still agree on the non-portable usages of +mknod +specification, so things should work in practice. Consequently, +the s6-hiercopy utility has been moved from +s6-linux-utils +to s6-portable-utils.

+ + + diff --git a/doc/upgrade.html b/doc/upgrade.html index 70d8b07..26bb1a8 100644 --- a/doc/upgrade.html +++ b/doc/upgrade.html @@ -17,6 +17,14 @@

What has changed in s6-portable-utils

in 2.0.2.0

+ +

skalibs dependency bumped to 2.3.1.0.
s6-hiercopy now belongs to this package. (It formely belonged +to s6-linux-utils, but it is actually portable in practice.)

in 2.0.1.0

+#include +#include + +#define USAGE "s6-hiercopy src dst" + +int main (int argc, char const *const *argv) +{ + PROG = "s6-hiercopy" ; + if (argc < 3) strerr_dieusage(100, USAGE) ; + umask(0) ; + if (!hiercopy(argv[1], argv[2])) + strerr_diefu4sys(111, "copy hierarchy from ", argv[1], " to ", argv[2]) ; + return 0 ; +} -- cgit v1.3.1