From f0d1fbe6f391ee4dc446eabaf5350d0bc4c61374 Mon Sep 17 00:00:00 2001 From: Maxime Hadjinlian Date: Sun, 2 Mar 2014 19:21:41 +0100 Subject: docs: Move README file to root Move the README file from the subdirectory doc to the root. Signed-off-by: Maxime Hadjinlian Signed-off-by: Thomas Petazzoni --- README | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 000000000..944347dd6 --- /dev/null +++ b/README @@ -0,0 +1,59 @@ +To build and use the buildroot stuff, do the following: + +1) run 'make menuconfig' +2) select the packages you wish to compile +3) run 'make' +4) wait while it compiles +5) Use your shiny new root filesystem. Depending on which sort of + root filesystem you selected, you may want to loop mount it, + chroot into it, nfs mount it on your target device, burn it + to flash, or whatever is appropriate for your target system. + +You do not need to be root to build or run buildroot. Have fun! + +Offline build: +============== + +In order to do an offline-build (not connected to the net), fetch all +selected source by issuing a +$ make source + +before you disconnect. +If your build-host is never connected, then you have to copy buildroot +and your toplevel .config to a machine that has an internet-connection +and issue "make source" there, then copy the content of your dl/ dir to +the build-host. + +Building out-of-tree: +===================== + +Buildroot supports building out of tree with a syntax similar +to the Linux kernel. To use it, add O= to the +make command line, E.G.: + +$ make O=/tmp/build + +And all the output files (including .config) will be located under /tmp/build. + +More finegrained configuration: +=============================== + +You can specify a config-file for uClibc: +$ make UCLIBC_CONFIG_FILE=/my/uClibc.config + +And you can specify a config-file for busybox: +$ make BUSYBOX_CONFIG_FILE=/my/busybox.config + +To use a non-standard host-compiler (if you do not have 'gcc'), +make sure that the compiler is in your PATH and that the library paths are +setup properly, if your compiler is built dynamically: +$ make HOSTCC=gcc-4.3.orig HOSTCXX=gcc-4.3-mine + +Depending on your configuration, there are some targets you can use to +use menuconfig of certain packages. This includes: +$ make HOSTCC=gcc-4.3 linux-menuconfig +$ make HOSTCC=gcc-4.3 uclibc-menuconfig +$ make HOSTCC=gcc-4.3 busybox-menuconfig + +Please feed suggestions, bug reports, insults, and bribes back to the +buildroot mailing list: buildroot@buildroot.org -- cgit v1.2.3