File	Date	Author	Commit
include	2012-04-16	Alfeiks Kaanoken (madtirra)	[d21859] fixes to run on non-SMP systems (should be test...
kconfig	2009-11-27	Alfeiks Kaanoken (madtirra)	[5f7477] applied path from Narender Kumar
kernel	2012-04-16	Alfeiks Kaanoken (madtirra)	[c5a998] returning value fixed in message read;
scripts	2012-05-11	Alfeiks Kaanoken (madtirra)	[397365] added script for Grub2 image creation;
server	2011-08-04	Alfeiks Kaanoken (madtirra)	[e286a4] Fixed elf loader, rwdata is now copied instead ...
tests	2011-04-21	Alfeiks Kaanoken (madtirra)	[330137] Changed comments credentials: updated web address,
.gitignore	2010-11-15	Alfeiks Kaanoken (madtirra)	[a3978f] moved some files to gitignore to stop annoying ...
Changlelog-0.1.2	2011-09-29	Alfeiks Kaanoken (madtirra)	[cc6ec0] chanhelog updated version 0.1.2 is ready
Changlelog-0.1.3	2012-04-16	Alfeiks Kaanoken (madtirra)	[b21be0] changelog updates
Makefile	2012-05-11	Alfeiks Kaanoken (madtirra)	[397365] added script for Grub2 image creation;
README	2009-06-30	Dan Kruchinin	[383a65] Fixed stupid typos
TODO	2011-05-10	Alfeiks Kaanoken (madtirra)	[e6601b] version changed, TODO updated
rules.mak	2009-06-16	Dan Kruchinin	[83dd8f] Merging in progress

Read Me

How to build
============

1) Before configuring and building the kernel make sure that
you have the following packages installed on your system:
 * flex
 * bison
 * gperf

2) Configure the kernel:
  % make config - Configure the kernel using simple text-based config
   or
  % make menuconfig - Configure the kernel with GUI configuration tool.
                      NOTE: menuconfig requires libncurses.

3) And finally build the kernel itself:
  % make

After step [3] you'll see vmuielf and muielf files in your build directory.
 vmuielf is a MuString kernel raw binaries.
 muielf is a MuString kernel in ELF binary format.

4) Step four is optional. If you want to run microkernel on emulator, type:
  % make image

After this command you'll see boot.img in your build directory.
It can be launched via bochs, kvm or quemu.

Building the kernel with toolchain
==================================

Steps 1 and 2 are the same as above. Step three is a bit different.
You have to specify the path to your toolchain binaries via TOOLCHAIN
variable. For example let suppose that you have any architecture distinguishing
from amd64 and you really want to build amd64 kernel.
For this purpose you must have a working x86_64 toolchain(if you don't have one
try crosstool to build it[http://www.kegel.com/crosstool/]).

So let suppose that your toolchain sits in /opt/crosstool. Make:
 % make TOOLCHAIN=/opt/crosstool/gcc-3.4.4-glibc-2.3.4/x86_64-unknown-linux-gnu/bin/x86_64-unknown-linux-gnu-

Still have building problems?
=============================

Try to set VERBOSE variable to 'y'. It should show you useful more output from GNU make.
For example:
 % make VERBOSE=y

If it didn't help you, report a bug with detailed description of how to reproduce it.

FYI
===

1) type "make help" to see all available building options.
2) If you found out a BUG or have a question, mail us: jarios-dev@lists.jarios.org