smock: Document how to use it without httpd
[fedora-mingw.git] / smock / README
1  SMOCK - Simpler Mock
2  ====================
3 by Dan Berrange and Richard W.M. Jones.
4 License: GPLv2+
5
6 Smock is a thin wrapper around mock to let you build up a whole set of
7 dependant RPMs against an external distro. Mock needs access to the
8 repositories created by smock. This can happen either using httpd or direct
9 file access.
10
11  - Create directory $HOME/public_html/smock
12
13  - Optional: Copy smock.httpd.conf to /etc/httpd/conf.d/smock.conf, changing the
14    /home/[USERNAME]/ to your user
15
16  - Optional: Start or restart httpd
17
18  - Insert smock.mock.extra to all your repos in /etc/mock/ changing the
19    USERNAME and distro name to match. If you do not want to use the http
20    server, use the direct file access baseurl instead of the http based one.
21
22  - Disable SELinux (/usr/sbin/setenforce Permissive) and you may
23    need to do 'chmod 0755 ~' to allow the web server to access your
24    home directory.
25
26 Now you can run
27
28     ./smock.pl --arch=i386 --arch=x86_64 --distro=fedora-9 list of srpms
29
30 And it'll build the all the SRPMs listed on the command line, using
31 previously built SRPMs as dependencies for later ones.  You don't need
32 to list them in the proper order - the build order is worked out using
33 the dependencies.
34
35 The resulting src RPMs, binary RPMs and build logs wil be put into
36 $HOME/public_html/smock, and a Yum repo created.  Further RPMs you
37 build using smock will resolve the BuildRequires against this local
38 repo.