1.1 The codebase

Most of the package building magic occurs under the /var/portbuild directory. Unless otherwise specified, all paths will be relative to this location. ${arch} will be used to specify one of the package architectures (e.g., amd64, arm, i386™, ia64, powerpc, SPARC64®), and ${branch} will be used to specify the build branch (e.g., 7, 7-exp, 8, 8-exp, 9, 9-exp, 10, 10-exp). The set of branches that portmgr currently supports is the same as those that the FreeBSD security team supports.

The scripts that control all of this live in /var/portbuild/scripts/. These are the checked-out copies from the Subversion repository at base/projects/portbuild/scripts/ .

Typically, incremental builds are done that use previous packages as dependencies; this takes less time, and puts less load on the mirrors. Full builds are usually only done:

• right after release time, for the -STABLE branches

• periodically to test changes to -CURRENT

• for experimental ("exp-") builds

Packages from experimental builds are not uploaded.

1.2 Notes on the codebase

Until mid-2010, the scripts were completely specific to pointyhat.FreeBSD.org as the head (dispatch) node. During the summer of 2010, a significant rewrite was done in order to allow for other hosts to be head nodes. Among the changes were:

• removal of the hard-coding of the string pointyhat

• factoring out all configuration constants (which were previously scattered throughout the code) into configuration files (see below)

• appending the hostname to the directories specified by buildid (this will allow directories to be unambigious when copied between machines.)

• making the scripts more robust in terms of setting up directories and symlinks

• where necessary, changing certain script invocations to make all the above easier

This document was originally written before these changes were made. Where things such as script invocations have changed, they were denoted as new codebase: as opposed to old codebase:.