aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGravatar Noé Rubinstein <nrubinstein@aldebaran.com>2015-01-19 20:52:57 +0100
committerGravatar Thomas Petazzoni <thomas.petazzoni@free-electrons.com>2015-07-10 19:15:40 +0200
commit618346836ede2f6945899209744aafbd38a84c82 (patch)
tree50de9b9fe29ff14f778e46e696058ab56d2c5a6c /docs
parent97b494b0d33eb8a38b4840eb384872d20bf48b70 (diff)
downloadbuildroot-618346836ede2f6945899209744aafbd38a84c82.tar.gz
buildroot-618346836ede2f6945899209744aafbd38a84c82.tar.bz2
docs/manual/beyond-buildroot: building and testing live-CDs
[Thomas: reworked a bit the phrasing, plus mention that Grub 2 is supported.] Signed-off-by: Noé Rubinstein <nrubinstein@aldebaran.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/manual/beyond-buildroot.txt29
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/manual/beyond-buildroot.txt b/docs/manual/beyond-buildroot.txt
index b8b1973c9f..63b0c1ffd3 100644
--- a/docs/manual/beyond-buildroot.txt
+++ b/docs/manual/beyond-buildroot.txt
@@ -21,6 +21,35 @@ Remember to add this path to +/etc/exports+.
Then, you can execute a NFS-boot from your target.
+==== Live CD
+
+To build a live CD image, enable the _iso image_ option in the
+_Filesystem images_ menu. Note that this option is only available on
+the x86 and x86-64 architectures, and if you are building your kernel
+with Buildroot.
+
+You can build a live CD image with either IsoLinux, Grub or Grub 2 as
+a bootloader, but only Isolinux supports making this image usable both
+as a live CD and live USB (through the _Build hybrid image_ option).
+
+You can test your live CD image using QEMU:
+
+-------------------
+qemu-system-i386 -cdrom output/images/rootfs.iso9660
+-------------------
+
+Or use it as a hard-drive image if it is an hybrid ISO:
+
+-------------------
+qemu-system-i386 -hda output/images/rootfs.iso9660
+-------------------
+
+It can be easily flashed to an USB drive with +dd+:
+
+-------------------
+dd if=output/images/rootfs.iso9660 of=/dev/sdb
+-------------------
+
=== Chroot
If you want to chroot in a generated image, then there are few thing