Skip to content
This repository was archived by the owner on Dec 29, 2018. It is now read-only.

Compiling

Jump to bottom
baddog edited this page Sep 13, 2010 · 24 revisions

Because dux is in beta, there are no stable releases yet. However, you can test dux on your system in two ways:

  • compiling dux yourself
  • downloading a prebuilt iso image
    Both methods give you a CD image, which you can burn to a CD or run via QEMU and similar emulators (a bochsrc is provided for those using bochs in the iso/ directory) . All compiling is done primarily on Linux. Compiling on Windows is untested; however, it may be possible with Cygwin

Prerequisites

Before you begin, you need to know what is required, depending on which option you chose.

If you wish to simply download a prebuilt ISO image, it is recommended that you have QEMU or similar installed.

Packages

You will need some packages to compile dux from source, including:

  • git
  • clang
  • scons
  • nasm
  • genisoimage (mkisofs)
    Consult your os/distribution package manager as to what these packages are called. Some examples:

Ubuntu:

sudo apt-get install git-core build-essential scons nasm genisoimage clang

Arch Linux:

pacman -S git scons nasm cdrkit binutils clang

Compiling

Compiling dux is very simple, requiring only two commands. However, you will need recent versions (newer than 6 months old) of gcc, lc, nasm, and scons (Python 2.5+) in order for it to work properly. While we have not tested on older systems, it may work, but it is completely untested.

To get the latest dux and compile it, run the following:

git git://github.com/RockerMONO/dux.git
scons

Assuming no errors, this will result in a file named ‘Dux.iso’.

You then need to clean the install after you compile if you want to recompile dux at a later time:

scons -c

Prebuilt (currently unavailable)

If you cannot or do not want to compile dux, there is another option. You can use one of our recently updated prebuilt ISO images, which you can burn or use in a virtual machine (Thanks for the build bot, danopia!). Simply head over to the Duxchives where you can find previous compiles as well as archives known to work with certain operating systems (although its best to use latest versions).

Downloads:

wget http://mostlynothing.info/dux/dux-latest.iso
wget http://mostlynothing.info/dux/dux-weekly.iso
Clone this wiki locally