• monotone (Required for downloading from an OpenEmbedded Repository)

Most of the development tools (e.g. make, m4) should already be installed by the Gentoo base system. The only needed packages that don't get installed by the base system are psyco, ccache, openjade, cvs, and subversion. Install them with the following:

You might want to use emerge -p psyco ccache openjade cvs subversion first to verify which of the packages are already installed.

Note that the Debian section on this page has been obsoleted by the "make setup-host-debian" target in the nslu2-linux Master Makefile.

Most of the development tools (e.g. make, m4) should already be installed by the Gentoo base system

• Unzip

• Python (Version 2.3.0 or later)
• GNU patch(Version 2.5.9 or later)
• GNU m4
• GNU make (Version 3.80 or later for hh.org kernels)

• wget or curl
• cvs
• bk -- a.k.a. BitKeeper
• subversion
• bzip2

• Psyco JIT Compiler is recommended to increase performance
• ccache

• Jade or OpenJade

• Docbook DTDs and DSSSL stylesheets
• sgmltools, called "sgmltools-lite", too
• docbook-utils

• GNU sed 4.x
• GNU Bison
• A recent GCC (a recent 3.x is prefered)

For subversion, you could build & install it from the source or try one of the Debian unstable packages (both found here).

You can also download (and install) this package which depends on all required programs (suggests docbook and bc).

Follow the Debian instructions, only using urpmi instead of apt-get install. Also, ccache is not an official Mandrake package. You can find it in the contrib section of any Mandrake mirror or seach for it using the Mandrake Club RPM database.

FreeBSD instructions

SuSE 9.1 instructions

 perl-XML-RegExp-0.03-475.i586.rpm

Note: As Gentoo package BitKeeper depends on X11 (the installer is graphical), so unless you want to install this, it is better to install it manually. Go to http://www.bitkeeper.com, do a registered download and run the binary file with target directory set, e.g. /usr/libexec, rather than running the installer.

There are two basic approaches on Windows XP: Cygwin and coLinux. I've (bobtm) had limited success with the former, possibly due to lack of RAM, but the latter works. Below is a rough outline on how to do the build with Gentoo on coLinux.

1. You have a choice between: The SourceForge stable release 0.6.1 based on kernel 2.4 (http://sourceforge.net/project/showfiles.php?group_id=98788) or CVS development snapshots based on kernel 2.6 either from from colinux.org or those provided by Henry Nestler. I used the second option, but the third also seem to work (I have not completed the build).

You need also subversion, bzip2 and BitKeeper!

 apt-get install make  for Make
 apt-get install libc6-dev  for glibc headers
 apt-get install cvs  for cvs
 apt-get install g++  for g++

 emerge subversion (May be blocked by apache2. If so, do USE="apache2" emerge subversion. -repvik)

SuSE? 9.1 instructions

Or download/install the following packages

 bison-1.875-51.i586.rpm
 blt-2.4z-200.i586.rpm
 ccache-2.3-83.i586.rpm
 cvs-1.11.14-20.i586.rpm
 docbook2x-0.8.2-38.i586.rpm
 libapr0-2.0.49-23.i586.rpm
 neon-0.24.4-66.i586.rpm
 openjade-1.3.2-208.i586.rpm
 opensp-1.5.1-76.i586.rpm
 perl-HTML-Parser-3.35-31.i586.rpm
 perl-HTML-Tagset-3.03-550.i586.rpm
 perl-libwww-perl-5.76-30.i586.rpm
 perl-libxml-perl-0.07-478.i586.rpm
 perl-URI-1.30-29.i586.rpm
 perl-XML-DOM-1.43-28.i586.rpm
 perl-XML-RegExp?-0.03-475.i586.rpm
 python-devel-2.3.3-85.i586.rpm
 python-tk-2.3.3-85.i586.rpm
 sgml-skel-0.6-259.noarch.rpm
 sgmltool-1.0.9-908.i586.rpm
 subversion-1.0.0-51.i586.rpm
 texinfo-4.6-61.i586.rpm
 tidy-020428-259.i586.rpm

 apt-get install python python-dev  for Python

1. You have a choice between: The the SourceForge? stable release 0.6.1 based on kernel 2.4 (http://sourceforge.net/project/showfiles.php?group_id=98788) or CVS development snapshots based on kernel 2.6 [either from from colinux.org (http://www.colinux.org/snapshots/) or those provided by Henry Nestler (http://www.henrynestler.com/colinux/autobuild/)]. I used the second option, but the third also seem to work (I have not completed the build).

Some of the development tools (e.g. make, m4) should already be installed by the gentoo base system

Windows XP instructions

There are two basic approaches on Windows XP: Cygwin and coLinux. I've (bobtm) had limited success with the former, possibly due to lack of RAM, but the latter works. Below is a sketch on how to do the build with Gentoo on coLinux.

1. Go to http://www.colinux.org and read through the FAQ to get an idea of how it works.
2. You have a choice between: The the SourceForge? stable release 0.6.1 based on kernel 2.4 (http://sourceforge.net/project/showfiles.php?group_id=98788) or CVS development snapshots based on kernel 2.6 [either from from colinux.org (http://www.colinux.org/snapshots/) or those provided by Henry Nestler (http://www.henrynestler.com/colinux/binary/)]. I used the second option, but the third also seem to work (I have not completed the build).
3. Follow the instuctions on http://www.colinux.org/wiki/index.php/GentooCoreImage
4. Follow the instructions for Gentoo given on this page

Note: You should have at least 768-1024MB of RAM on your computer in order to avoid excess paging - your coLinux memory should be at least 512MB and a swap file should be mounted before building unslung.

Note: As Gentoo package Bitkeeper depends on X11 (the installer is graphical), so unless you want to install this, it is better to install it manually. Go to www.bitkeeper.com, do a registered download and run the binary file with target directory set, e.g. /usr/libexec, rather than running the installer.

• A recent [GCC|http://gcc.gnu.org/] (a recent 3.x is prefered)

Note: Bitkeeper can not be emerged online. One has to go to www.bitkeeper.com, do a registered download manually and do offline emerge.

• bk -- a.k.a. BitKeeper
• http://subversion.tigris.org/ subversion

 apt-get install cvs   for cvs

For subversion, you could build & install it from the source or try one of the Debian unstable packages (both found http://subversion.tigris.org/project_packages.html here).

 emerge bzip2

• bzip2

You need also cvs, subversion, bzip2 and BitKeeper!

emerge bzip2

(Not recommended, but for the sake of completeness : If you don't plan to let OE build a toolchain using itself, you will also need a GCC arm-linux crosscompiler [http://www.openzaurus.org/official/toolchain/cross-3.3.2.tar.bz2] installed to /opt/. Also you need to prepend /opt/cross/bin to your PATH variable, as the OE tools won't find it automatically like OZ used to. You probably also need to unset LD_LIBRARY_PATH, if set.)

You need also cvs, subversion and BitKeeper!

 emerge psyco    for Psyco JIT Compiler

 emerge patch    for patch
 emerge m4       for m4
 emerge sed      for GNU sed
 emerge bison    for Bison

 emerge cvs
 emerge subversion
 emerge bitkeeper

Follow the Debian instructions, only using =urpmi= instead of =apt-get install=. Also, =ccache= is not an official Mandrake package. You can find it in the contrib section of any Mandrake mirror or seach for it using the http://rpms.mandrakeclub.com Mandrake Club rpm database.

Install http://linux01.gwdg.de/apt4rpm/ apt4rpm, then follow Debian instructions.

 emerge python   for Python
 emerge psyco     for Psyco JIT Compiler
 emerge ccache   for ccache
 emerge patch     for patch
 emerge m4         for m4
 emerge sed        for GNU sed
 emerge bison     for Bison
 emerge make     for Make

 emerge openjade for ~OpenJade?

To use the OE build system the following software is required on your system:

• [Python|http://www.python.org/] (Version 2.3.0 or later)
• [GNU patch|http://www.gnu.org/software/patch/patch.html] (Version 2.5.9 or later)
• [GNU m4|http://www.gnu.org/software/m4/m4.html]
• [GNU make|http://www.gnu.org/software/make/] (Version 3.80 or later for hh.org kernels)
• Tools to download source files:
  • wget or curl
  • cvs
  • bk
  • subversion
• [Psyco JIT Compiler|http://psyco.sf.net] is recommended to increase performance
• [ccache|http://ccache.samba.org/]
• Tools to build the various *-doc packages:
  • [Jade|http://www.jclark.com/jade/] or [OpenJade?|http://www.netfolder.com/DSSSL/]
    • I don't know which of these is preferred
  • [Docbook|http://sourceforge.net/projects/docbook/] DTDs? and DSSSL stylesheets
  • [sgmltools|http://sgmltools-lite.sourceforge.net/], called "sgmltools-lite", too
  • [docbook-utils|http://sources.redhat.com/docbook-tools/]
    • docbook-utils download is hard to find; look in ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES
  • [GNU sed| http://www.gnu.org/software/sed/sed.html] 4.x
  • [Bison|http://www.gnu.org/software/bison/bison.html]
  • A recent [GCC|http://gcc.gnu.org/] (3.3.2, 2.95.3 only required for some kernels - especially ZaurusKernels?)
    • glibc won't build with 2.95.3
  • bc (binary calculator), if you want to build a Zaurus kernel
  • [PyQt?|http://www.riverbankcomputing.co.uk], if you want to use oecommander
  • glibc headers (libc6-dev in Debian, glibc-devel in RPM based (in PLD also glibc-static is needed))

(Not recommended, but for the sake of completeness : If you don't plan to let OE build a toolchain using itself, you will also need a GCC arm-linux crosscompiler [http://www.openzaurus.org/official/toolchain/cross-3.3.2.tar.bz2] installed to <tt>/opt/</tt>. Also you need to prepend <tt>/opt/cross/bin</tt> to your PATH variable, as the OE tools won't find it automatically like OZ used to. You probably also need to unset LD_LIBRARY_PATH, if set.)

Debian instructions

 apt-get install python   for Python
 apt-get install ccache   for ccache
 apt-get install patch   for patch
 apt-get install m4   for m4
 apt-get install sed   for GNU sed
 apt-get install docbook   for docbook-utils and sgmltools
 apt-get install bison  for Bison
 apt-get install make for Make
 apt-get install libc6-dev' for glibc headers

You can also download (and install) http://hrw.one.pl/_pliki/oe/openembedded_0.1-2_all.deb this package which depends on all required programs (suggests docbook and bc).

(20040630) On my Debian stable 3.0r1 I have to install the 'stat' command too, or oemake breaks compiling base-files-3.0.14-r9 . Just:

 apt-get install coreutils  

Mandrake Linux instructions

Follow the Debian instructions, only using =urpmi= instead of =apt-get install=. Also, =ccache= is not an official Mandrake package. You can find it in the contrib section of any Mandrake mirror or seach for it using the Mandrake Club rpm database [http://rpms.mandrakeclub.com].

FreeBSD? instructions

Ports has most of these: python, fileutils, gsed, ccache, jade, docbook, dsssl-docbook-modular, sgmltools

SuSE? (9.1) instructions

Install [http://linux01.gwdg.de/apt4rpm/], then follow Debian instructions.

Gentoo instructions

 * <tt>emerge python</tt> for Python
 * <tt>emerge psyco</tt> for Psyco JIT Compiler
 * <tt>emerge ccache</tt> for ccache
 * <tt>emerge patch</tt> for patch
 * <tt>emerge m4</tt> for m4
 * <tt>emerge sed</tt> for GNU sed
 * <tt>emerge bison</tt> for Bison
 * <tt>emerge make</tt> for Make

 * <tt>emerge openjade</tt> for ~OpenJade?

Some of the development tools (e.g. make, m4) should already be installed by the gentoo base system