|
|
| (12 intermediate revisions by 3 users not shown) |
| Line 1: |
Line 1: |
| − | == Using the PBI Builder Software ==
| + | #REDIRECT [[PBI Module Builder Guide]] |
| − | | + | |
| − | 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 [[http://www.pcbsd.org/content/view/45/30/ 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 [[http://trac.pcbsd.org/browser/pbibuild/modules/ 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.
| + | |
