Difference between revisions of "Bering-uClibc 5.x - Developer Guide - Preparing the Build Environment"

From bering-uClibc
Jump to: navigation, search
m (fix navigation)
(Required Software on the Build Host)
Line 68: Line 68:
* autoconf
* autoconf
* automake
* automake
* bc
* binutils (for command <tt>strip</tt>)
* binutils (for command <tt>strip</tt>)
* bzip2 (for command <tt>bzcat</tt>)
* bzip2 (for command <tt>bzcat</tt>)

Revision as of 15:30, 23 August 2014

Preparing the Build Environment
Prev Bering-uClibc 5.x - Developer Guide Next




Compiling source code is a CPU- and RAM-intensive operation, so a reasonably powerful machine is advisable. Multiple CPU cores are a benefit - almost all packages are compiled using all cores.

Examples of build performance for "buildtool.pl build" (unpack and build all packages) are:

120 minutes 
AMD Athlon(tm) II X4 645 Processor (Quad Core) with 2GB DDR2 RAM, Gentoo (64-bit)

Disk Space

A fully built development environment with all of the Bering-uClibc 5.x Packages and all of the kernel variants occupies more than 10 Gigabytes of disk space.

The following statistics were reported on 2012-04-01 but note that the space requirements will gradually grow as more Packages are added:

  • For cloning the Git repository: 1.9GB
  • For building the default Toolchain a further: 3.6GB
  • For building all the Packages for the default Toolchain a further: 5.5GB
  • For building all the Images for the default Toolchain a further: 0.5GB

In total that is approximately 11.5GB.

For planning purpsoes assume that 15 Gigabytes are required. If building multiple Toolchains then allow an extra 10 Gigabytes for each additional Toolchain.

Operating System

The Bering-uClibc 5.x kernel and Packages can be built on any modern Linux distribution which has the necessary software development utilities installed. Examples of distributions which are known to work include:

  • Gentoo (64-bit)
  • Fedora 15 (64-bit)
  • Fedora 17 (64-bit)

Required Software on the Build Host

All of the "build" utilities (buildtool, buildpackage, buildimage) are written in Perl and require Perl version 5.6 or higher.
In addition there is a requirement for Perl modules which is not part of most standard Perl installations:
On distributions which use the "yum" package manager (Red Hat, Fedora etc.) the required RPM can usually be installed with:
sudo yum install 'perl(Config::General)' 'perl(Date::Format)' 'perl(parent)' 'perl(List::MoreUtils)' 'perl(Hash::Merge)'
On distributions which use the "dpkg" package manager (Debian, Ubuntu etc.) the required packages can usually be installed with:
aptitude install libconfig-general-perl libdatetime-perl liblist-moreutils-perl libhash-merge-perl
LEAF currently uses git for source code version control, so the git utility is required.
The patch utility is required to apply patches to upstream source distributions.
Required for the makeinfo utility used for some compilation steps, though the resulting .info files are not used.
Required to build e3.
zlib-devel (headers for zlib) 
Required to build toolchain (depmod with gzipped modules support).
Required to build the (TBC) Package.
Required to build the (TBC) Package.
Required when building Packages and disk Images, avoiding the need to actually run as the root user on the build host.
Required to build accel-ppp
Required to build avahi
Required to build toolchain - including "development" features. On Red Hat systems this normally means installing the RPM for gmp-devel
Required to build toolchain - including "development" features. On Red Hat systems this normally means installing the RPM for mpfr-devel
Required to build toolchain - including "development" features. On Red Hat systems this normally means installing the RPM for libmpc-devel

In addition, the following RPM or similar packages are also required on the build host but are normally a standard part of the base Linux distribution:

  • autoconf
  • automake
  • bc
  • binutils (for command strip)
  • bzip2 (for command bzcat)
  • cpio (for generating initrd.lrp)
  • file
  • flex
    • For cross-compiling linux-atm a static version of the build host's flex libfl.a is required. On Red Hat systems this normally means installing the RPM for flex-static.
  • gawk
  • gcc
  • gzip (for a gzip-compatible zcat)
  • libtool
    • Including "development" features. On Red Hat systems this normally means installing the RPM for libtool-ltdl-devel.
  • lzma
  • m4
  • make
  • sed
  • tar
  • wget
  • xz
  • lzop

SourceForge User Account


Cloning the Git Repository

The first step in building Bering-uClibc 5.x from source is to copy or "clone" the Git repository hosted by SourceForge. Further information on using Git can be found in Appendix Hints and Tips for using Git SCM but the basic steps are as follows:

  1. Change to the directory where you wish to do your Bering-uClibc 5.x development.
  2. Run the following command, replacing USERNAME with your SourceForge username:
    git clone ssh://USERNAME@git.code.sf.net/p/leaf/bering-uclibc bering-uclibc-master
    Note that this will take some time to run, since it has to download the build toolchain source as well as the source for the Bering-uClibc 5.x Packages.
    • If for some reason you do not want or need the full history of changes since this repository was created it is possible to omit the history by including "--depth 1" in the command arguments.

The arguments to the git glone command are as follows:

  • The string "ssh://USERNAME@git.code.sf.net/p/leaf/bering-uclibc" specifies the name of the Git repository to be cloned (including the access mechanism, ssh)
  • The string "bering-uclibc-master" specifies the name of the local directory to be created, under the current working directory, to hold the clone repository. By default the local directory name would match the name of the repository being cloned (i.e. "bering-uclibc").

Building the Build environment

With the source code for the build toolchain downloaded this now has to be compiled for your build host.

Change directory to the bering-uclibc-next directory created during the clone operation.

Run the following command:

./buildtool.pl build toolchain

This will take some considerable time. Build messages, including any errors, are written to file log/buildtoollog so you may wish to run the following command in another shell window to keep track of progress:

tail -f log/buildtoollog

Prev Up Next