|author||Tom Ryder <firstname.lastname@example.org>||2012-05-29 16:21:01 +1200|
|committer||Tom Ryder <email@example.com>||2012-05-29 16:21:01 +1200|
|parent||Add placeholder script, nothing written yet (diff)|
Add README with summary of what I expect of this
1 files changed, 44 insertions, 0 deletions
diff --git a/README.markdown b/README.markdown
new file mode 100644
@@ -0,0 +1,44 @@
+Clubber is a Perl script to make forming `chroot` environments less of a task
+that makes you want to cry and kill yourself. It requires `ldd`, and should be
+run interactively as `root`, *never* as an automated or unattended task.
+Run with one or more binaries as parameters and no other options, `clubber`
+will run `ldd` over each, converge the list of libraries used by all of them,
+and print them to `stdout`.
+ # clubber php
+Run with the `--chroot=PATH` option, pointing to an existing directory intended
+as the root of a `chroot` jail, `clubber` will also create required library
+paths if they do not exist and copy the libraries into that environment if they
+do not yet exist, or if they differ from the host system libraries.
+ # clubber --chroot=/chroot/apache php
+Run with both the `--chroot=PATH` and `--dry` options, `clubber` will perform a
+"dry run" of the `chroot` library import, writing the commands it would execute
+ # clubber --chroot=/chroot/apache --dry php
+Run with both the `--chroot=PATH` and `--verify` options, Clubber will check
+all of the libraries expected for the program are in place within the `chroot`
+environment, and will report any discrepancies.
+ # clubber --chroot=/chroot/apache --verify php
+Copyright (c) [Tom Ryder]. Distributed under an [MIT License]. Buy me a