Using the PBI Builder

From PC-BSD Wiki
Revision as of 13:34, 20 January 2009 by Krismoore (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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.

Installation

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 


Usage Instructions

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.