manual: add QEMU demo to quick start
PATCH 1/1 manual: add QEMU demo to quick start
---
Your software is awesome, and many more people would see that if the quickstart actually told them how to quickstart and see something happen ;-)
docs/manual/quickstart.txt | 37 ++++++++++++++++++++++++++++++++----- 1 file changed, 32 insertions(+), 5 deletions(-)
docs/manual/quickstart.txt +32 -5
@@ -8,12 +8,39 @@ is no need to be root to configure and use Buildroot. By running all commands as a regular user, you protect your system against packages behaving badly during compilation and installation. -The first step when using Buildroot is to create a configuration. -Buildroot has a nice configuration tool similar to the one you can -find in the http://www.kernel.org/[Linux kernel] or in -http://www.busybox.net/[BusyBox]. +=== Try it out with QEMU -From the buildroot directory, run +If you just want to try to emulate a simple generic QEMU system to see +Buildroot at work immediately, run from the buildroot directory: + +-------------------- +make qemu_x86_64_defconfig +make BR2_JLEVEL="$(nproc)" +qemu-system-x86_64 \ + -M pc \ + -kernel output/images/bzImage \ + -drive file=output/images/rootfs.ext2,if=virtio,format=raw \ + -append "root=/dev/vda" \ + -net nic,model=virtio \ + -net user +-------------------- + +Once QEMU boots, login with +root+, and you are now left inside a minimal +BusyBox based Linux distribution. + +The initial build can several minutes to a few hours since we download and +compile GCC, the Linux kernel and other basic system components from +source. + +The QEMU command to use is also documented at: +board/qemu/x86/readme.txt+ + +=== Day-to-day workflow + +More commonly, in your day-to-day workflow, the first step when using +Buildroot is to create a custom configuration. Buildroot has a nice +configuration tool similar to the one you can find in the +http://www.kernel.org/[Linux kernel] or in +http://www.busybox.net/[BusyBox]: -------------------- $ make menuconfig
Signature · 1 line
2.19.0
PATCH 1/1 manual: add QEMU demo to quick start
Sorry, ignore this one.
Quoted 60 lines · Ciro Santilli
---
Your software is awesome, and many more people would see that if the quickstart actually told them how to quickstart and see something happen ;-)docs/manual/quickstart.txt | 37 ++++++++++++++++++++++++++++++++----- 1 file changed, 32 insertions(+), 5 deletions(-)docs/manual/quickstart.txt +32
-6@@ -8,12 +8,39 @@ is no need to be root to configure and use Buildroot. By running all commands as a regular user, you protect your system against packages behaving badly during compilation and installation. -The first step when using Buildroot is to create a configuration. -Buildroot has a nice configuration tool similar to the one you can -find in the http://www.kernel.org/[Linux kernel] or in -http://www.busybox.net/[BusyBox]. +=== Try it out with QEMU -From the buildroot directory, run +If you just want to try to emulate a simple generic QEMU system to see +Buildroot at work immediately, run from the buildroot directory: + +-------------------- +make qemu_x86_64_defconfig +make BR2_JLEVEL="$(nproc)" +qemu-system-x86_64 \ + -M pc \ + -kernel output/images/bzImage \ + -drive file=output/images/rootfs.ext2,if=virtio,format=raw \ + -append "root=/dev/vda" \ + -net nic,model=virtio \ + -net user +-------------------- + +Once QEMU boots, login with +root+, and you are now left inside a minimal +BusyBox based Linux distribution. + +The initial build can several minutes to a few hours since we download and +compile GCC, the Linux kernel and other basic system components from +source. + +The QEMU command to use is also documented at: +board/qemu/x86/readme.txt+ + +=== Day-to-day workflow + +More commonly, in your day-to-day workflow, the first step when using +Buildroot is to create a custom configuration. Buildroot has a nice +configuration tool similar to the one you can find in the +http://www.kernel.org/[Linux kernel] or in +http://www.busybox.net/[BusyBox]: -------------------- $ make menuconfig --2.19.0