l4/pkg/bootstrap/server/src/README

   1
   2 bootstrap supports different boot modi.
   3
   4 For x86:
   5
   6   1)
   7      boostrap is started by a multiboot compliant bootloader and modules are
   8      attached as multiboot modules. GRUB example:
   9
  10        kernel bootstrap arg1 args2 ...
  11        module kernel
  12        module sigma0
  13        module roottask
  14        module task1
  15        ...
  16
  17    2)
  18       bootstrap is started by a multiboot compliant bootloader but includes
  19       all modules by itself. GRUB example:
  20
  21        kernel bootstrap_hello args...
  22
  23       For module specifications looks into modules.list
  24
  25    3)
  26       bootstrap can boot from real-mode, esp. with pxelinux, i.e. it can be
  27       booted via PXE. For that it also needs include all images.
  28       This should also work with syslinux (e.g. from CDs/DVDs). (Note, grub
  29       can also read is9660 filesystems.)
  30
  31    4)
  32       bootstrap starts from protected mode but isn't started by a multiboot
  33       compliant loader. Also needs to include all modules.
  34
  35 For arm:
  36
  37    Just the single image mode, i.e. all modules packed into bootstrap.
  38    Anything else doesn't make any sense (currently).
  39
  40
  41 Generating bootstrap in single-image-mode:
  42
  43  Call make with E=entryname, e.g.
  44
  45  $ make E=hello
  46
  47
  48 Local customization:
  49
  50  You can put a Makeconf.local file right into this directory
  51  (bootstrap/server/src) where you can specify your own search paths etc.
  52  Note that it is encouraged to have your local configuration in src/conf
  53  rather than in this bootstrap directory.
  54
  55  Makeconf.local could look like this:
  56
  57   BOOTSTRAP_SEARCH_PATH_x86 := ../stuff:/home/joe/dev/l4/kernel/fiasco/build-ia32
  58
  59   KERN_ARM := build-arm
  60
  61   ifneq ($(PXA),)
  62   KERN_ARM     := build-pxa
  63   ARM_DRV_TYPE  = pxa
  64   endif
  65
  66   KERN_PATH := /home/joe/dev/l4/kernel/fiasco/$(KERN_ARM)
  67   BOOTSTRAP_SEARCH_PATH_arm = ../stuff:$(KERN_PATH):../../../../../bin/arm_sa
  68
  69   BOOTSTRAP_SEARCH_PATH     = $(BOOTSTRAP_SEARCH_PATH_$(ARCH))
  70