Usage

Synopsis

$ joot --images
     ubuntu.10-04.x86-32.20100820  http://getjoot.org/images/ubuntu.10-04.x86-32.20100820.qcow.bz2
     ubuntu.10-04.x86-64.20100927  http://getjoot.org/images/ubuntu.10-04.x86-64.20100927.qcow.bz2
     ubuntu.10-10.x86-32.20101010  http://getjoot.org/images/ubuntu.10-10.x86-32.20101010.qcow.bz2
     ubuntu.10-10.x86-64.20101010* http://getjoot.org/images/ubuntu.10-10.x86-64.20101010.qcow.bz2

$ joot --create foo ubuntu.10-10.x86-64.20101010
Password: 

$ touch /tmp/file-doesnt-exist-in-foo

$ joot foo

=>foo<= $ ls /tmp/file-doesnt-exist-in-foo
ls: /tmp/file-doesnt-exist-in-foo: No such file or directory

=>foo<= $ logout

$ ls /tmp/file-doesnt-exist-in-foo
/tmp/file-doesnt-exist-in-foo

$ joot --list
foo jaybuff [Tue Mar  8 22:41:23 2011] ubuntu.10-10.x86-64.20101010

$ joot --remove foo

Usage Summary

Usage:
    bin/joot <joot name> [--user <user>] [--cmd <cmd>] [--no-home] [--ro-home]
    bin/joot --create <name> <image>
    bin/joot --images
    bin/joot --list
    bin/joot --remove <name> [<name> ...]
    bin/joot --rename <old name> <new name>
    bin/joot --mount <name> [--read-only] [--always] [<dir> ...]
    bin/joot --umount <name> [<dir> ...]

Global options:
    --verbose
    --version
    --help

A note on permissions

For all commands except --list and --images joot needs root access. When joot sees that it is not running as root, it reruns itself by calling sudo for you. This is why when you run commands such as joot --create you may see a prompt for your password. This is actually sudo prompting you. You won't always need to entry your password because sudo will cache your credentials (usually for five minutes).

Alternatively, you could just make joot setuid and call it a day. However, that would mean that would effectively give everyone with an account the ability to run privileged calls (you must be root to make the chroot syscall). See the Cookbook for a description of how to use sudo to limit who is able to run joot.

Listing images

Joot will fetch all indexes listed in the image_sources and print a list of the available images. See Publishing Images for a description of the index files.

$ joot --images
     ubuntu.10-04.x86-32.20100820  http://getjoot.org/images/ubuntu.10-04.x86-32.20100820.qcow.bz2
     ubuntu.10-04.x86-64.20100927  http://getjoot.org/images/ubuntu.10-04.x86-64.20100927.qcow.bz2
     ubuntu.10-10.x86-32.20101010  http://getjoot.org/images/ubuntu.10-10.x86-32.20101010.qcow.bz2
     ubuntu.10-10.x86-64.20101010* http://getjoot.org/images/ubuntu.10-10.x86-64.20101010.qcow.bz2

On the left is the name of the name that you can pass to the joot --create call. The right is the full URL to the image. The asterisk denotes which images are locally cached and won't need to be downloaded.

Creating a joot

the rest of these sections are TODO

Entering and exiting joots

add note on $JOOT_NAME

Listing created joots

Renaming joots

Removing joots

Mounting and Unmounting directories in joot