As of December 2011, this is the current version. If a different version is reported, then you will need to build and install jam from source.
jam -v Jam 2.5-haiku-20111222. OS=LINUX. Copyright 1993-2002 Christopher Seiwald.
cd /path/haiku/buildtools/jam/ make <jam-install-command>
To install jam you can use one of two commands:
The first requires administrative privilege, as jam will be installed to '/usr/local/bin/'
- sudo ./jam0 install
- ./jam0 -sBINDIR=$HOME/bin install
Note, you may need to use `gmake` instead of `make`
Only some of the options are being discussed here. See jam -h for a full listing of available options.
Typically jam will attempt to build all targets, even if an error is encountered. '-q' instructs jam to quit immediately upon encountering an error. This is preferred, as it helps to find the actual cause for build failure.
Where # represents the number of threads to use. This is useful when building on SMP or multi-core machines.Jam suffers from a bug that might make your build fail when using this option.
Build all targets, even if they are current. Normally, this is not necessary.
You may need to do this once in a while because some of the jam rules are not perfect and does not set the dependencies between files properly. The most frequent case is when we update our copy of Freetype : this will prevent anyone to build without the -a switch.
You can also use this switch if something does not seem to get updated after some change you made. This is the case when you modify a jamfile : Jam does not check for that and will not rebuild things that should be affected by the changes.
Set variable x=y, overriding environment. One example is :
jam -sHAIKU_IGNORE_USER_BUILD_CONFIG=1 -q @alpha-raw
This will ensure that the alpha-* targets are built to the exact specifications of Haiku's DefaultBuildProfiles.
Enables debug output, where X can be one of the following:
- (m)make tree
- (0-9) debug levels
Don't actually execute the updating actions. This seems to be useful for testing Jamfiles.
One way of finding possible targets, is by looking at the various "NotFile" statements. A "NotFile" statement is usually used to create a build target with a more user-friendly name.
Official Release Targets
The following targets are defined in build/jam/DefaultBuildProfiles
Builds a pre-alpha image as a raw image. This can be written directly to disk or used with Qemu
Builds a pre-alpha image for use with VMWare. This can also be used with VirtualBox.
A single track ISO CD. `mkisofs` is needed to build this.
A custom file that can be burned to CD or written directly to disk or used with Qemu.
It is comprised of an Master Boot Record (MBR), El Torito boot image, and a BFS raw image.
The MBR occupies the first 512 bytes of the El Torito image, which is usually empty.
The BFS image is simply concatenated at the end. Inside the MBR is a partition table entry, which maps to the BFS image.
A PPC Boot CD. As of r31228, it compiles. Uncertain how far it boots.
The default raw hdd image of Haiku.
Boot Floppy. Unsure what targets this is functional for.
There are numerous other targets such as 'haiku-cd', that need to be documented. Targets such as these should be viewed as a minimal base.
You should not be using the sudo command when running jam.
First of all, any and all files in $(HAIKU_OUTPUT_DIR)--typically /path/haiku/haiku/generated/ will only be accessible to root. To fix this, it is necessary to run chown -R <user>:<group> <path>. Secondly, user-errors become much more damaging when `sudo jam` is used, as you could easily overwrite the wrong partition.
The preferred method is to apply permissions to your device first.
sudo chmod o+r /dev/sda sudo chmod o+rw /dev/sda2 jam -q @walter-sda2