INSTALL

   1 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
   2
   3              INSTALL howto for ZeX/OS
   4
   5 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
   6
   7 * For users *
   8
   9 1. You need to get some burning program
  10 2. In menu select something like 'burn image cd'
  11 3. Find file zexos-*-i386.iso (http://zexos.org/package/) and check it
  12 4. Burn ZeX/OS image
  13 5. Reboot your computer (need to set in BIOS booting from cd)
  14 6. When you see on the screen ZeX/OS title, press enter
  15 7. Have fun !
  16
  17 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  18
  19 * For developers *
  20
  21 1. You have to install git, nasm, gcc, make
  22 2. Then you can download source code by: git clone git://repo.or.cz/ZeXOS.git
  23 3. Now move to source directory: cd ZeXOS
  24 3. Lets compile whole OS and create *.iso : ./build.sh iso
  25    or make *.img image                    : ./build.sh img
  26    or install to floppy                   : ./build.sh floppy
  27 4. Last step, you'll need burn this image, start it under virtual machine or use floppy, e.g.
  28    for starting in Qemu just enter        : ./build.sh qemu
  29 5. Have a lot of fun !
  30
  31 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  32
  33 * Multiplatform howto *
  34
  35 Available architectures: i386, x86_64, arm
  36
  37 1. For compilation on ARM platform start: ARCH=arm ./build.sh
  38 2. When all was finished succefully, you can run it under virtual machine, e.g. Qemu.
  39    You'll need installed program qemu-system-arm, then start: ARCH=arm ./build.sh qemu
  40
  41 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  42
  43 * More docs *
  44
  45 ZeX/OS wiki pages at http://zexos.wiki.sourceforge.net/FAQ
  46 Forum is placed at http://forum.zexos.org
  47
  48 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  49
  50 * Utilities *
  51
  52 Kernel configure:
  53 1. Go to kernel source directory, probably it is "kernel": cd kernel
  54 2. Now you have to type for base-textual config: make config
  55                         for QT-based GUI config: make xconfig
  56                         for GTKbased GUI config: make gconfig
  57
  58 NOTE: You'll need clean source when you have compiled it: make clean
  59         Now you can config your kernel and then recompile it: make