This is the guide on using the Owl build environment. It is assumed
that you've read the CONCEPTS; if not, please do so before you proceed
with this document.
The build environment is pre-configured for the use of /usr/src/world (the HOME= setting in buildworld.conf and installworld.conf). It is recommended that you leave this default setting and either actually place the files in /usr/src/world or use a symlink if /usr/src is not on a suitable device (see below for the requirements).
When building natively (that is, on Owl), the directory is already there. Otherwise, you need to create the directory, add pseudo-user "build", preferably with UID 151 and GID 150 ("sources"), and make it the owner of the directory.
Place the CVS tree into /usr/src/world. The easiest way to do it is by extracting native.tar.gz available via the FTP mirrors. You will get the "native" directory, and a Makefile symlink.
For actually building from source, place the "sources" directory in /usr/src/world as well.
If you are not on an Owl system, yet, and want to install binary packages, create /usr/src/world/RPMS and place the packages for your architecture in there. Note that you need the CVS tree even for installing binary packages.
To (re-)build Owl from source, you'll need:
at least 1 GB free disk space under /usr/src/world for use during the builds;
at least 1 GB of virtual memory (RAM + swap, or OpenVZ privvmpages);
a few hours of CPU time, on a modern system (on a multi-core system, the total build time will be less than the CPU time - likely under an hour).
And, of course, you should be running the build on Owl. Building on another GNU/*/Linux system is sometimes possible, but tricky and requires that you slowly produce an Owl system with multiple iterations of "make buildworld" and "make installworld".
Here are some build times (hours:minutes) for Owl 3.0, so that you know what to expect:
Core 2 Duo E6550, 2.33 GHz, 2 GB 0:55
These are for the default set of tests ("RUN_TESTS=" in buildworld.conf commented out, missing, or set to an empty string). The build times happen to be about the same for i686 and x86_64 builds (when the machine supports both).
Some build times of Owl 2.0 (Owl 3.0 and Owl-current should take a bit longer and some packages will likely fail to build since we haven't been doing builds for these architectures for a long time):
UltraSparc IIi, 400 MHz, 256 MB 10:00 Alpha 21164PC (164SX-1MB), 533 MHz, 128 MB 14:00
(Yes, gcc is this hungry and slow on Alpha.)
The build times will increase as we add more packages and update to new versions of software already in Owl.
As user "build", change directory to /usr/src/world and type:
make clean && make buildworld
With the default buildworld.conf, packages will be built for a certain flavor of the build host's architecture (see ARCHITECTURES) and the build will attempt to use all system processors.
buildworld.conf (as well as other *.conf's) may be edited by copying it from native/Owl/build into /usr/src/world. You need to remove the symlink first, if one has previously been created for you.
All packages are built with whatever versions of libraries and build tools are installed on the system. Multiple iterations of buildworld and installworld (two are sufficient most of the time) should be used when there have been significant updates to packages used during the builds.
Installing binary packages.
"make installworld" will install packages found in /usr/src/world/RPMS onto the current system, or in a new root directory of your choice (as specified by the ROOT= setting in installworld.conf). By default, the packages will be installed into /owl.
"make installworld" should be run as root.
(Re-)building individual packages.
Individual packages may be built or re-built with "make PACKAGE=name", where "name" is the name of the source package. For foreign packages (SRPMs) built with the Owl build environment you also need to include the version number part in "name".
$Owl: Owl/doc/BUILD,v 1.46 2011/10/24 09:06:48 solar Exp $