See also the OpenWrt development center website. There you can browse the source code and send reproducible bugs with the ticket system (in trac).
other articles worth reading:
Almost every software in OpenWrt is available as a package. OpenWrt *downloads* code (using archive, git …) compiles it and includes in the final image. Every archive lands in "dl" directory". Every code (from archive or git) is available in build_dir.
A mirror of package sources is maintained at http://mirror2.openwrt.org/sources/.
Approximately required disc space for compiling OpenWrt:
|typical, Stable||1.5 GB||3.5 GB|
|all feeds/pkgs||x||~45 GB|
Typical: Compile an Image that is working on typical consumer routers that have 4MB or 8MB flash.
OpenWrt Buildroot needs a case sensitive file system.
It should work on almost any Linux Distribution. Tested: Debian (6, 7, Unstable(2014)), Ubuntu, Fedora 19,20 , Arch Linux, OpenSuse 13.3 Exotic Linux variants might have some bugs regarding headers (Alpine Linux). BSD (FreeBSD), MacOSX are somewhat untested. Cygwin (Windows) has possible issues with file system being not case sensitive.
Recommended: Build older versions with older Linux versions in a VM.
Build-time is highly dependable on the number of Cores/Jobs and can be shrunk to less than 30 minutes (from 90 minutes). Build time with single core can take several hours.
see Hints to reduce build time
|make jobs||time needed||source|
|2 all,local feed. mirrots||3h40min|
|4, all,local feed, mirrors||2h17min|
Typical: select packages fitting into 8MB flash, build on HDD, ar71xx or brcm47xx target
Test SSD vs. HDD
Yes, of course. If you find any bugs, please use our ticket system or send a report to email@example.com . You can send patches for the bugs as well.
/!\ NOTE: Changes to the buildroot system or the associated
Makefilescould break the compile process. Please do not submit bug reports against modified copies of buildroot. Thanks!
See Creating Packages.
The OpenWrt build bots provide a list of broken packages: http://buildbot.openwrt.org:8010/broken_packages/
There is a comparison of OpenWrt and upstream package versions available: http://sdwalker.github.io/uscan/
The mailing list: https://lists.openwrt.org/pipermail/openwrt-devel/ generates Patchwork entries: http://patchwork.ozlabs.org/project/openwrt/list/
Build may FAIL
The build process can be accelerated by running multiple concurrent job processes using the
make -j 3
<your number of CPU cores + 1>
If the build fails with errors that include "[s-attrib] Killed" and "[all-gcc] Error 2" while compiling gcc, this indicates you are out of disk space or RAM. This could be likely if you are building within a virtual machine with < 1 Gb RAM allocated and no swap.
./scripts/feeds install <package>
Makefileof the package to find out.
cat feeds/<feedname>/<package>/MakefileYou are looking for this:
define Package/<package>/Default SUBMENU:=Firewall SECTION:=net CATEGORY:=Network
<buildroot_dir>/tmpdirectory and then running
cd ~/openwrt/trunk rm -rf tmp make menuconfigAlso try refreshing your package indexes:
./scripts/feeds update -iThe
-iis important if you're not using the latest revisions of any packages, as this flag prevents updates from the feed sources.
Example ppp :luci automatically selects ppp. This is not always needed.
- Files inside the buildroot are specific to host systems.
Build dependency: Please install GNU find # old files in staging_dir/host
- remove untracked files with the help of svn or git
- use make targets depending on what you don't want
make clean make dirclean make distclean make target/linux/clean * rm -rf tmp/ rm .config .config.old* Kernel Config change is not triggering rebuild, see: openwrt-devel
If you are running a buildroot inside a VM with many threads you might experience random build failures.
Setup: Host: i7 16GB RAM, VM on Harddisk, Win 7 64bit, VMWare Player Guest: Lubuntu 13.04 64bit 4GB RAM ext4 partition make -j 8
Errors: Build fails like
mv: cannot stat '.deps/dlog.Tpo': No such file or directory or ../libtool: line 46: -c: command not found libtool: Version mismatch error. This is libtool 2.4, but the libtool: definition of this LT_INIT comes from libtool 2.2.6. libtool: You should recreate aclocal.m4 with macros from libtool 2.4 libtool: and run autoconf again.cleaning up buildroot helps sometimes, reduce concurrency