manual: give QEMU quick demo on quick start
PATCH 1/1 manual: give QEMU quick demo on quick start
--- docs/manual/quickstart.txt | 36 +++++++++++++++++++++++++++++++----- 1 file changed, 31 insertions(+), 5 deletions(-)
docs/manual/quickstart.txt +31 -5
@@ -8,12 +8,38 @@ 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 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 take 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 + +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: give QEMU quick demo on quick start
Hi Ciro,
Nice addition...
Quoted 11 lines · Ciro Santilli
--- docs/manual/quickstart.txt | 36 +++++++++++++++++++++++++++++++----- 1 file changed, 31 insertions(+), 5 deletions(-)docs/manual/quickstart.txt +0
-0@@ -8,12 +8,38 @@ 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.
docs/manual/quickstart.txt is no need to be root to configure and use Buildroot. By running all · line 14
Quoted 10 lines
docs/manual/quickstart.txt +3
-5-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 emulate a simple generic QEMU system to see +Buildroot at work immediately, run from the buildroot directory:
I see where you're going with this, but still I think this section might fit
better at the end of this file instead of at the beginning. Yes, the idea is to see something running immediately, but on the other hand, just running the defconfig under qemu doesn't bring that much joy either...
docs/manual/quickstart.txt is no need to be root to configure and use Buildroot. By running all · line 18
Quoted 4 lines
docs/manual/quickstart.txt +4
-0+ +-------------------- +make qemu_x86_64_defconfig +make BR2_JLEVEL="$(nproc)"
The BR2_JLEVEL defaults to nproc + 1, I don't see a reason to use one less here...
docs/manual/quickstart.txt is no need to be root to configure and use Buildroot. By running all · line 31
Quoted 13 lines
docs/manual/quickstart.txt +13
-0+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 take several minutes to a few hours since we download
Several minutes? What kind of beast of a machine do you have that can build
even just the toolchain in a couple of minutes?
A few hours is also exaggerated...
But OK, the message is clear...
docs/manual/quickstart.txt is no need to be root to configure and use Buildroot. By running all · line 35
Quoted 4 lines
docs/manual/quickstart.txt +4
-0+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+
This last sentence could be extended a bit to refer to all architectures.
QEMU configurations exist and are tested for various architectures. The QEMU command to use is documentated in the +readme.txt+ file in the architecture's subdirectory in +board/qemu+.
All in all, just nitpicking, so if you respin you can add my
Regards,
Arnout
Quoted 11 lines
docs/manual/quickstart.txt +7
-0+ +=== Day-to-day workflow + +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 · 6 lines
Arnout Vandecappelle arnout at mind be Senior Embedded Software Architect +32-16-286500 Essensium/Mind http://www.mind.be G.Geenslaan 9, 3001 Leuven, Belgium BE 872 984 063 RPR Leuven LinkedIn profile: http://www.linkedin.com/in/arnoutvandecappelle GPG fingerprint: 7493 020B C7E3 8618 8DEC 222C 82EB F404 F9AC 0DDF