README

   1 How to build
   2 ============
   3
   4 1) Before configuring and building the kernel make sure that
   5 you have the following packages installed on your system:
   6  * flex
   7  * bison
   8  * gperf
   9
  10 2) Configure the kernel:
  11   % make config - Configure the kernel using simple text-based config
  12    or
  13   % make menuconfig - Configure the kernel with GUI configuration tool.
  14                       NOTE: menuconfig requires libncurses.
  15
  16 3) And finally build the kernel itself:
  17   % make
  18
  19 After step [3] you'll see vmuielf and muielf files in your build directory.
  20  vmuielf is a MuString kernel raw binaries.
  21  muielf is a MuString kernel in ELF binary format.
  22
  23 4) Step four is optional. If you want to run microkernel on emulator, type:
  24   % make image
  25
  26 After this command you'll see boot.img in your build directory.
  27 It can be launched via bochs, kvm or quemu.
  28
  29 Building the kernel with toolchain
  30 ==================================
  31
  32 Steps 1 and 2 are the same as above. Step three is a bit different.
  33 You have to specify the path to your toolchain binaries via TOOLCHAIN
  34 variable. For example let suppose that you have any architecture distinguishing
  35 from amd64 and you really want to build amd64 kernel.
  36 For this purpose you must have a working x86_64 toolchain(if you don't have one
  37 try crosstool to build it[http://www.kegel.com/crosstool/]).
  38
  39 So let suppose that your toolchain sits in /opt/crosstool. Make:
  40  % make TOOLCHAIN=/opt/crosstool/gcc-3.4.4-glibc-2.3.4/x86_64-unknown-linux-gnu/bin/x86_64-unknown-linux-gnu-
  41
  42 Still have building problems?
  43 =============================
  44
  45 Try to set VERBOSE variable to 'y'. It should show you useful more output from GNU make.
  46 For example:
  47  % make VERBOSE=y
  48
  49 If it didn't help you, report a bug with detailed description of how to reproduce it.
  50
  51 FYI
  52 ===
  53
  54 1) type "make help" to see all available building options.
  55 2) If you found out a BUG or have a question, mail us: jarios-dev@lists.jarios.org