Using the PBI Builder
Using the PBI Builder Software
This guide is intended to instruct developers, or simply the curious, on how to use the PBI Builder software, which compiles a FreeBSD port, and turns it into a fully-functional PBI file.
Installing the PBI Builder software relatively easy, simply download the tbz package from the [PBI Builder Homepage], and place it somewhere on your system with several GB of free space. Next run these commands (as root):
# tar xvjpf pbibuild*.tbz # ln -s `pwd`/pbi-build /pbi-build
Note: On regular FreeBSD systems, you will need to install "bash" for the builder to function, and link it to /bin/bash. This step is not required on PC-BSD.
# pkg_add -r bash # ln -s /usr/local/bin/bash /bin/bash
Using the PBI builder to convert a port into a PBI is very simple. First, you will need to copy a module directory into the /pbi-build/modules directory. Several examples are provided in /pbi-build/docs/module-examples, or you may copy a module from our [subversion repository]. After you have done this, simply run these commands:
# cd /pbi-build # ./buildpbi.sh
The first time you run the buildpbi.sh script, it will connect to CVS and download a copy of the ports tree. You may change the cvsup server it uses by editing /pbi-build/conf/ports-supfile. If you wish to update your ports tree, simply run "/pbi-build/cron/cvsup-nightly.sh". This script may be run from cron to ensure that your ports tree is always up to date.