From c81ae36acf4899e3d7a4b5591db5bbb28e06543b Mon Sep 17 00:00:00 2001 From: Tom Ryder Date: Tue, 29 May 2012 16:21:01 +1200 Subject: Add README with summary of what I expect of this --- README.markdown | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 README.markdown diff --git a/README.markdown b/README.markdown new file mode 100644 index 0000000..99cee34 --- /dev/null +++ b/README.markdown @@ -0,0 +1,44 @@ +Clubber +======= + +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. + +Usage +----- + +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 +on `stdout`. + + # 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 + +License +------- + +Copyright (c) [Tom Ryder][1]. Distributed under an [MIT License][2]. Buy me a +beer sometime. + +[1]: http://www.sanctum.geek.nz/about/tom-ryder +[2]: http://www.opensource.org/licenses/MIT + -- cgit v1.2.3