aboutsummaryrefslogtreecommitdiff
path: root/README.markdown
blob: 9745ecd5c814fc06ab4e90b613165f82b2e15175 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
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 `md5sum`,
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 /usr/bin/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 /usr/bin/php

Run with both the `--chroot=PATH` and `--dry` options, `clubber` will perform a
"dry run" of the `chroot` library import, writing a summary of what it would do
on `stdout`.

    # clubber --chroot=/chroot/apache --dry /usr/bin/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