cape-chroot(1)

NAME
cape-chroot - manage and execute programs in a chroot

SYNOPSIS
cape-chroot [options] chroot-distro
cape-chroot [options] chroot-distro [command...]
cape-chroot --update chroot-distro [install-pkgs...]
cape-chroot --build|--binary chroot-distro source-pkgs...

DESCRIPTION
The purpose of cape-chroot is to easily execute user applications in a chroot. The cape-chroot binary is setuid, and can only be used by users who are explicitly a member of a ``cape-chroot'' group. All privileges are dropped when entering the chroot. This avoids the need to sudo just to run commands in the chroot and makes it very easy to build aliases that do so for shell scripts when you need a program that is not native to your current distro. When executing an application in a chroot, you can either login to the chroot or run a command. Logging in simply does a ``bash -l''. There is a common configuration file in /etc/cape-chroot.conf. The chroots are managed in /var/lib/cape-chroot by default. A special case exists if you explicitly ``sudo'' to run cape-chroot. In this case you enter the chroot as the root user. This is useful if you need to sudo in the chroot and forgot to install sudo.

OPTIONS

--arch=cpu
    Used to specify foreign architecture chroots. Requires qemu static user mode binaries to work. This also effects the name of the chroot directory, as architecture will be appended to it.

--build
    Use chroot environment to build from source packages

--binary
    Use chroot environment to build architecture specific packages only

--clean
    Cleans package archive and chroot environment

--force
    Used to force copying of system files into the chroot even if they already are up to date.

--qemu=name
    Static qemu binary to install.

--help
    Outputs help screen for the user.

--jobs=number
    Used to specify parallel builds.

--setup
    Creates and mounts, then exists. Used for testing only.

--update
    Update packages in chroot. May specify packages to install.

--verbose
    Outputs activity to console on entry and exit.

AUTHOR
cape-chroot was written by David Sugar <dyfet@gnutelephony.org>.

REPORTING BUGS
Report bugs to dyfet@gnutelephony.org.

COPYRIGHT
Copyright © 2012 David Sugar, Tycho Softworks.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.