Development FAQ

See also the OpenWrt development center website. There you can browse the source code and send reproducible bugs with the ticket system (in trac).

Requirements for compiling OpenWrt

Please read:

  1. about the Toolchain
  2. about it's installation OpenWrt Buildroot – Installation
  3. about it's usage OpenWrt Buildroot – Usage

Approximately required disc space for compiling OpenWrt:

Branch Min. Max.
Stable Source 1.5 GB 3.5 GB
Development ? 3.8 GB
Development+feeds ? >5 GB
all feeds/pkgs >30 GB

Compiling also tested on some Windows OS under AndLinux (coLinux + Ubuntu)

Build-time is highly dependable on the number of Cores/Jobs and can be shrunk to less than 30 minutes (from 90 minutes). (make -j 4)

Should I report bugs related to the OpenWrt Buildroot

Yes, of course. If you find any bugs, please use our ticket system or send a report to openwrt-devel@openwrt.org . You can send patches for the bugs as well.

/!\ NOTE: Changes to the buildroot system or the associated

Makefiles
could break the compile process. Please do not submit bug reports against modified copies of buildroot. Thanks!

How do I create a package?

How can I help or contribute ?

see: http://wiki.openwrt.org/about/start?#how.can.i.contribute

see: https://dev.openwrt.org/wiki/SupportDonate

Development

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: https://home.comcast.net/~sdwalker/uscan/index.html

Testing/Review

The mailing list: https://lists.openwrt.org/pipermail/openwrt-devel/ generates Patchwork entries: http://patchwork.openwrt.org/

How can I speed up build process ?

  • Use -j switch to enable parallel builds
  • Use local mirror to avoid downloads (advanced build options)


CONFIG_LOCALMIRROR="file:///home/username/mirror"

Common errors

Unclean buildroot

- 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

Back to top

doc/faq/development.txt · Last modified: 2014/01/03 15:37 by theoradicus