docs/manual/beyond-buildroot.txt

   1 // -*- mode:doc; -*-
   2 // vim: set syntax=asciidoc:
   3
   4 == Beyond Buildroot
   5
   6 === Boot the generated images
   7
   8 ==== NFS boot
   9
  10 To achieve NFS-boot, enable _tar root filesystem_ in the _Filesystem
  11 images_ menu.
  12
  13 After a complete build, just run the following commands to setup the
  14 NFS-root directory:
  15
  16 -------------------
  17 sudo tar -xavf /path/to/output_dir/rootfs.tar -C /path/to/nfs_root_dir
  18 -------------------
  19
  20 Remember to add this path to +/etc/exports+.
  21
  22 Then, you can execute a NFS-boot from your target.
  23
  24 ==== Live CD
  25
  26 To build a live CD image, enable the _iso image_ option in the
  27 _Filesystem images_ menu. Note that this option is only available on
  28 the x86 and x86-64 architectures, and if you are building your kernel
  29 with Buildroot.
  30
  31 You can build a live CD image with either IsoLinux, Grub or Grub 2 as
  32 a bootloader, but only Isolinux supports making this image usable both
  33 as a live CD and live USB (through the _Build hybrid image_ option).
  34
  35 You can test your live CD image using QEMU:
  36
  37 -------------------
  38 qemu-system-i386 -cdrom output/images/rootfs.iso9660
  39 -------------------
  40
  41 Or use it as a hard-drive image if it is a hybrid ISO:
  42
  43 -------------------
  44 qemu-system-i386 -hda output/images/rootfs.iso9660
  45 -------------------
  46
  47 It can be easily flashed to a USB drive with +dd+:
  48
  49 -------------------
  50 dd if=output/images/rootfs.iso9660 of=/dev/sdb
  51 -------------------
  52
  53 === Chroot
  54
  55 If you want to chroot in a generated image, then there are few thing
  56 you should be aware of:
  57
  58 * you should setup the new root from the _tar root filesystem_ image;
  59
  60 * either the selected target architecture is compatible with your host
  61   machine, or you should use some +qemu-*+ binary and correctly set it
  62   within the +binfmt+ properties to be able to run the binaries built
  63   for the target on your host machine;
  64
  65 * Buildroot does not currently provide +host-qemu+ and +binfmt+
  66   correctly built and set for that kind of use.