= User's Guide =

 1. [#QuickStart Quick Start]
 2. [#Console Console]
 3. [#Shell Shell]
 4. [#KernelConsole Kernel Console]
 5. [#BuildingFromSource Building From Source]

== Quick Start == #QuickStart

To try out HelenOS, download the latest IA-32 ISO image from the [http://www.helenos.org/download download page]. Install [http://www.nongnu.org/qemu/ QEMU]. In the directory where you downloaded the ISO image run
{{{
qemu -m 32 -cdrom image.iso
}}}

You can also use a different emulator. Just make sure it is configured to emulate a Pentium 4 or later CPU or HelenOS won't boot and it will display a red error message.

== Console == #Console

== Shell == #Shell

== Kernel Console == #KernelConsole

== Building From Source == #BuildingFromSource

Checkout the latest sources
{{{
svn checkout svn://svn.helenos.org/HelenOS/trunk helenos-trunk
}}}

Use our script to install a supported cross-compiler toolchain
{{{
cd helenos-trunk/contrib/toolchain
./toolchain.ia32.sh
}}}

Go to the source root and start the build process
{{{
cd ../..
make
}}}

Load preconfigured defaults for the platform you want to build for and select ''Done''. HelenOS will now be built.

'''Important note''': If you don't compile using the supported toolchain, your build may well fail.