Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  BUILDTOOL (1)


buildtool - build infrastructure for source packages


User’s Reference
     Reading documentation
     Configuring the sources
     Building the sources
     Testing the build
     Installing the results


buildtool [-h] target [target_args]


This manual page is intended as a reference document only, addressed to users who want to build source packages. If you are interested in development (and a more detailed description of what is explained here), please read the available online, together with more documentation, at the official documentation page:

Thank you for choosing buildtool.


This section provides a quick reference on how to build source packages. After unpacking the source distribution file, enter the new directory and follow the instructions provided in the next sections.

    Reading documentation

To get started, issue the following command, which will show several information useful to build that specific package:
$ buildtool doc

    Configuring the sources

For a standard, automated setup, type this command:
$ buildtool config

which configures the source package to build cleanly on the host system. However, this uses all default settings, which may be not suitable for your system.

To change the installation prefix (which defaults to /usr/local), do:

$ buildtool config --prefix=/opt

Aside from the prefix, you can customize where things get installed on a directory basis and enable or disable specific features. The commands:

$ buildtool config --help
$ buildtool config --help 2Gt]&1 | less

show a list of all directories and features that can be tuned, together with their default values (use the later for a paged output).

To change the value of a customizable directory, use the --dir flag, as in the following example:

$ buildtool config --dir-bin=/usr/local/bin-test

To change the value of a customizable feature, use one of the --feature , --enable or --disable flags, as in the following examples:

$ buildtool config --feature-developer=yes
$ buildtool config --enable-developer
$ buildtool config --disable-developer

Short options are available too. All examples shown above use long options because they are easier to remember.

    Building the sources

Assuming the configuration step finished successfully, issue the following command to build the entire source tree:
$ buildtool build

You can run this command in a specific subdirectory to only build that part of the tree.

    Testing the build

After a successful build of the sources, you might want to run some tests to check that the program behaves properly in your system. To run the test suite, simply do:
$ buildtool test

Note that these checks are specific to each package, and are only available if the developer took care to write them.

    Installing the results

Issue the following command to install the binaries generated by the build step:
$ buildtool install

You can run this command in a specific subdirectory to only install that part of the tree.


If you want to keep the source tree around, you may want to clean all object files and work stuff to reduce the amount of space it uses. The commands:
$ buildtool clean
$ buildtool cleandir

will clean all the tree, the later beeing more aggressive than the former.

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.