path: root/README
diff options
authorGravatar Maxime Hadjinlian <maxime.hadjinlian@gmail.com>2014-03-02 19:21:41 +0100
committerGravatar Thomas Petazzoni <thomas.petazzoni@free-electrons.com>2014-03-03 21:28:39 +0100
commitf0d1fbe6f391ee4dc446eabaf5350d0bc4c61374 (patch)
tree9bcc27a4687303fdbe0ee32f8b3c3a5ae2d1e970 /README
parent71516ab9e86e5fde0060bf7b84ead24665763283 (diff)
docs: Move README file to root
Move the README file from the subdirectory doc to the root. Signed-off-by: Maxime Hadjinlian <maxime.hadjinlian@gmail.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Diffstat (limited to 'README')
1 files changed, 59 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000000..944347dd61
--- /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=<directory> 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