xref: /OK3568_Linux_fs/buildroot/docs/manual/beyond-buildroot.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1// -*- mode:doc; -*-
2// vim: set syntax=asciidoc:
3
4== Beyond Buildroot
5
6=== Boot the generated images
7
8==== NFS boot
9
10To achieve NFS-boot, enable _tar root filesystem_ in the _Filesystem
11images_ menu.
12
13After a complete build, just run the following commands to setup the
14NFS-root directory:
15
16-------------------
17sudo tar -xavf /path/to/output_dir/rootfs.tar -C /path/to/nfs_root_dir
18-------------------
19
20Remember to add this path to +/etc/exports+.
21
22Then, you can execute a NFS-boot from your target.
23
24==== Live CD
25
26To build a live CD image, enable the _iso image_ option in the
27_Filesystem images_ menu. Note that this option is only available on
28the x86 and x86-64 architectures, and if you are building your kernel
29with Buildroot.
30
31You can build a live CD image with either IsoLinux, Grub or Grub 2 as
32a bootloader, but only Isolinux supports making this image usable both
33as a live CD and live USB (through the _Build hybrid image_ option).
34
35You can test your live CD image using QEMU:
36
37-------------------
38qemu-system-i386 -cdrom output/images/rootfs.iso9660
39-------------------
40
41Or use it as a hard-drive image if it is a hybrid ISO:
42
43-------------------
44qemu-system-i386 -hda output/images/rootfs.iso9660
45-------------------
46
47It can be easily flashed to a USB drive with +dd+:
48
49-------------------
50dd if=output/images/rootfs.iso9660 of=/dev/sdb
51-------------------
52
53=== Chroot
54
55If you want to chroot in a generated image, then there are few thing
56you 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.
67