No Description

Yann E. MORIN 3c40c9ee57 doc/asciidoc: allow documents to pass a global asciidoc configuration 9 years ago
arch d60489a6e5 arch: remove BR2_arm10t 9 years ago
board 7417616e09 configs/qemu-sparc-ss10: enable tmpfs 9 years ago
boot b5bd127857 grub2: modify kernel location to /boot/zImage 9 years ago
configs 7417616e09 configs/qemu-sparc-ss10: enable tmpfs 9 years ago
docs 3d2a49f78f docs/asciidoc: make it possible to use $(@D) in hooks 9 years ago
fs f268f7131b .mk files: bulk aligment and whitespace cleanup of assignments 9 years ago
linux f268f7131b .mk files: bulk aligment and whitespace cleanup of assignments 9 years ago
package 3c40c9ee57 doc/asciidoc: allow documents to pass a global asciidoc configuration 9 years ago
support f268f7131b .mk files: bulk aligment and whitespace cleanup of assignments 9 years ago
system 4952dddbf9 system: move tz setup outside of default skeleton clause 10 years ago
toolchain b8f9e5771a toolchain: external 3.17 headers typo fix 9 years ago
.defconfig b24c3215c1 buildroot: get rid of s390 support 15 years ago
.gitignore 145508473c update gitignore 11 years ago
CHANGES fcd720dfcf Update for 2014.08 9 years ago
COPYING 1aeaae4990 clarify license and fix website license link 15 years ago
Config.in 8515ef0256 BR2_DEPRECATED: update option label and help 9 years ago
Config.in.legacy b581bba9c4 package/linux-firmware: install Xceive/Cresta xc4000 and xc5000c 9 years ago
Makefile ab6a6212b0 docs: rename the GENDOC infrastructure 9 years ago
Makefile.legacy af97c94b70 Makefile.legacy: fix recursive invocation with BUILDROOT_DL_DIR and _CONFIG 10 years ago
README f0d1fbe6f3 docs: Move README file to root 10 years ago

README

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