Mock

Mock creates chroots and builds packages in them. Its only task is to reliably populate a chroot and attempt to build a package in that chroot.

Status

Mock is currently being used for all Fedora builds. It is called by Plague (<=FC-6) and Koji (>=F-7) to build chroots and packages.

Download

https://fedorahosted.org/mock/ has all the latest builds. It can be installed with "yum install mock".

To check out the current code:

git clone git://git.fedorahosted.org/git/mock.git mock

Setup

All users that are to use mock must be added to the mock group.

Configuration files are in /etc/mock. Mock versions 0.8.0 and higher cache the downloaded rpm packages (via the yum_cache plugin), which speeds up subsequent builds by a considerable margin. Nevertheless, you may wish to change the default configuration to point to local repositories to speed up builds.

By default, builds are done in /var/lib/mock, so be sure you have room. Starting with mock 0.8.0 and higher, you can change this via the 'basedir' config option.

Using

Usage: 
    usage:
           mock [options] {init|clean}
           mock [options] [rebuild] /path/to/srpm(s)
           mock [options] {shell|chroot} <cmd>
           mock [options] installdeps {SRPM|RPM}
           mock [options] install PACKAGE
    commands: 
        rebuild     - build the specified SRPM(s) [default command]
        chroot      - run the specified command within the chroot
        shell       - run an interactive shell within specified chroot
        clean       - clean out the specified chroot
        init        - initialize the chroot, do not build anything
        installdeps - install build dependencies for a specified SRPM
        install     - install packages using yum

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -r CHROOT             chroot name/config file name default: default
  --no-clean            do not clean chroot before building
  --cleanup-after       Clean chroot after building. Use with --resultdir.
                        Only active for 'rebuild'.
  --no-cleanup-after    Dont clean chroot after building. If automatic cleanup
                        is enabled, use this to disable.
  --arch=ARCH           target build arch
  --resultdir=RESULTDIR
                        path for resulting files to be put
  --uniqueext=UNIQUEEXT
                        Arbitrary, unique extension to append to buildroot
                        directory name
  --configdir=CONFIGDIR
                        Change where config files are found
  --rpmbuild_timeout=RPMBUILD_TIMEOUT
                        Fail build if rpmbuild takes longer than 'timeout'
                        seconds
  --enable-plugin=ENABLED_PLUGINS
                        Enable plugin. Currently-available plugins: ('ccache',
                        'yum_cache', 'root_cache', 'bind_mount')
  --disable-plugin=DISABLED_PLUGINS
                        Disable plugin. Currently-available plugins:
                        ('ccache', 'yum_cache', 'root_cache', 'bind_mount')

For example, to rebuild a package for i386 on the development branch of Fedora:

mock rebuild -r fedora-devel-i386 /path/to/rpm

See /etc/mock for the available targets. If you have the bash-completion package installed, it will tab complete the targets for you.

Problems