DIY Linux Reference Build

This document is dedicated to those crazy "Do It Yourself" Linux enthusiasts who would rather build their own GNU/Linux system from source code than run a precompiled binary distro.

DIY Linux is not for the faint of heart. There are many drawbacks and not everyone will have the ability or desire to do it. You don't need to be an experienced programmer but you must have above average knowledge of software building principles. If all you want is a GNU/Linux system that simply "just works" then you would be far better off with a precompiled binary distro prepared by professionals. Nevertheless, if you have a legitimate reason to build your own GNU/Linux system completely from source, have sufficient technical skill, are a bit of a control freak, or you're the kind of person who simply must be in the driver's seat when it comes to your Linux system, you'll find a high quality build recipe here.

The intended audience is the more technically adept Linux user. Folks new to the world of DIY Linux should first head over to the Linux From Scratch (LFS) project to learn the basics.

This "reference" build is intended to be a solid foundation for building custom GNU/Linux systems. It's only a Reference Build so feel free to add or remove packages and customize it in any way you see fit. However, please keep in mind that the build recipe and package versions presented here have been tested and are known to work, so if you deviate you'll be on your own. Of course you're on your own anyway as this is, after all, a "DIY" project.

The goals can be summarized as follows:

The basic theory of operation involves building the target system natively inside a chroot environment. To this end, two separate build phases are utilized. The goal of the first phase is to build a self-hosted temporary toolchain which is installed into a non-standard prefix. The second phase is then conducted inside a chroot environment whereby the result of the first phase is used as a platform for building the final system.

There are currently two variations of the build method presented here. The first is the so-called "Next Generation" method which leverages cross compilation for the initial "Pass 1" toolchain. The second is the original method which is now deprecated and no longer recommended. The new method has 2 main advantages, 1) there is much less reliance on the host system and 2) it is much better equipped to handle modern "multi-arch" platforms like x86_64. For example, when targeting x86_64 it doesn't matter whether the host system is 32-bit or 64-bit or a combination of both (userland and/or kernel), or whether you want a pure 64-bit system or a bi-arch (multilib) system. The Next Generation build method caters for all these possibilities.

The following architectures are supported by the Reference Build: i386 (x86), ppc (PowerPC) and x86_64 (AMD64). We don't have access to hardware for other architectures therefore we are unable to test or support them (this includes 64-bit PowerPC). Please note the PowerPC and AMD64 builds appear to function perfectly but they are not as well tested as the x86 build.

Important

The Reference Build assumes a mostly native build environment. However, it should be noted that the Next Generation build method employs cross compilation for the initial pass 1 toolchain only. This has many advantages. For example, if you are running a 32-bit x86 system on AMD64 hardware and want to build a 64-bit environment (single or multi-arch), the cross toolchain can be used to cross compile a 64-bit kernel at the appropriate point in the procedure. The original build method does not support bi-arch and in the case of pure x86_64, it required the host machine to already be running a 64-bit kernel and have a 64-bit userland available.

It is assumed the reader will be scripting his/her own builds. In order to make the script writer's life easier we have structured this document in such a way as to allow direct extraction of (a) each package's build commands ("scriptlets") and (b) overall package information ("packagedata"). You can find a tarball containing these files right here. These scriptlets (and packagedata) are extremely handy for integration into your own build scripts.

A sample implementation of this "Document Centric Automation" is the author's own build scripts which you can find here. It's worth noting that the author runs a full test build using these scripts before any changes are made to the published version of this document. This goes a long way towards ensuring that the build commands as printed here are of high quality and free of typographical errors.

In addition to the goals listed above, the aim is to produce an NPTL-enabled system based on:

Important - Latest not necessarily the greatest!

Glibc development moves quite rapidly these days. While this is very much welcomed, there is a downside in that the release schedules of other toolchain components can sometimes get out of sync. This is a problem because history has shown that you cannot easily mix and match versions of toolchain components. In particular, Glibc compilation is very sensitive to the GCC version. For example, you cannot expect to compile a recent Glibc with a GCC from the 2.95.X era. It simply doesn't work. In our experience the most stable and trouble-free combinations of toolchain components are those of same or similar vintage. Another point to consider, every new major GCC release is stricter than the last. This means that once you get beyond the base Reference Build you will almost certainly come across packages that fail to compile with the latest GCC. For these reasons we have decided to support multiple major versions of toolchain components. The DIY build recipe has been carefully crafted to remain "out of the box" compatible with multiple GCC, Glibc and Binutils versions as per the table below. Simply set the corresponding environment variable for each toolchain component (detailed in Section 2.1, “Environment”) to build with your chosen versions. Another important factor in building toolchains is which set of kernel headers to use. The Linux-Libc-Headers package (LLH) worked well for a number of years. But it has now been superceded by a new method known as "make headers_install" (HDRS_INST) which was introduced in linux-2.6.18. HDRS_INST is now recommended because it provides a consistent and up-to-date set of headers that have the backing of kernel developers, system library developers and distributors alike. The table below shows some recommended toolchain combinations. Other combinations might work but do not receive any testing, and in some cases require patches (not provided here). If you decide to mix and match versions, you need to be aware of the risks associated with doing so. For example, occasionally you'll see warnings from upstream developers like this and this. Glibc GCC Binutils Headers Comments 2.3.6 3.4.6 2.16.1 FSF LLH A classic. Rock solid, but starting to show its age. 2.6.1 4.2.4 2.18 FSF HDRS_INST Very stable. Was the previous default. 2.7 4.2.4 2.18 FSF HDRS_INST An excellent match. Current Reference Build default. 2.7 4.3.3 2.18 FSF HDRS_INST Seems to be stable. No known major problems. 2.8 4.3.3 2.18 FSF HDRS_INST Appears OK. But still quite new so tread carefully. This table shows toolchain combinations that were once recommended but are no longer tested. But in all likelihood they should still work fine in the current Reference Build context. Glibc GCC Binutils Headers 2.3.6 4.0.4 2.16.1 FSF LLH 2.4 4.1.2 2.17 FSF LLH 2.5.1 4.1.2 2.17 FSF HDRS_INST

Udev is not yet included in the Reference Build. It'll go in once (a) there is unanimous Udev buy-in from all the major distros shipping 2.6 kernels which apparently hasn't happened yet and (b) Udev development settles down to a point where upgrading to the latest version doesn't break the system.

Bootscripts are not included in the Reference Build. Bootscripts tend to be a matter of personal taste so folks are encouraged to write their own or plug in an existing 3rd party package.

In the beginning we started out with something resembling the then current LFS. We then developed modifications with a view towards achieving the goals as listed above. Some other points worth noting:

FIXME mention stuff like gawk for recent glibc, bison for bash, texinfo for HJL binutils etc. Also point out how one can easily build "pass 0" versions of these tools if getting them installed on the host is impossible FIXME

FIXME shoot down the hysteria surrounding security patches. It's horses for courses. You want security? Then FFS run a distro which provides security updates. Mention how utterly idiotic it is to build a system yourself then place it in a security vulnerable situation (ie: on the internet) without having the faintest clue about security then expecting someone else to be responsible for patches. FIXME

FIXME explain the issues touched upon here. FIXME

There are many and varied techniques for implementing Package Management (PM) strategies. This LFS page has a reasonable writeup of the various PM styles that exist today. We've geared this Reference Build towards those Package Managers that operate on the basis of diverting `make install' to a temporary location for the purpose of creating an archive of the installed files. These Package Managers typically use the commonly available Makefile variable `DESTDIR' to achieve the diversion. Some examples of Package Managers in this category are RPM (Red Hat/Fedora etc), Dpkg (Debian etc), Portage (Gentoo), Pkgtool (Slackware), BPM (Bent Linux), Pacman (Arch Linux) and Pkgutils (Crux). Please note, we don't insist that you employ PM when using this Reference Build. All the build commands will still work correctly if you choose to perform a "build in place" style installation à la LFS. If you do decide to employ PM, feel free to choose any Package Manager from the supported category that meets your needs, because the Chroot phase installation commands are generic and should work with all of them. In our experience Package Managers with simple spec file formats are the easiest to integrate into a PM based Reference Build. You could even write your own simple Package Manager if you felt that way inclined.

In typical "build in place" style installations the entire Chroot phase is performed as root. However, in most source building scenarios it's generally considered best practice to build packages as a non-privileged user, and only when it's time for `make install' should you need to become root. Therefore in an ideal world involving PM, you would build and create archives as a non-privileged user, then install the archives with a Package Manager as root. We've set up this Reference Build in such a way as to try and achieve that ideal world. Be aware that creating package archives as a non-privileged user can sometimes result in wrong file ownerships and permissions on files inside the built archives. A potential solution to this problem is to make use of the "Fakeroot" package which we've included as an optional extra. Please note, we don't insist that you build packages in the Chroot phase as a non-privileged user when using this Reference Build. Building as root still works correctly.

The very first task is to set up a sane environment in which to perform the build. These environmental settings apply to the initial Temptools phase, though most will also be carried through into the Chroot phase. But first, a lesson that many folks have learned the hard way:

	Caution - Never build the Temptools phase as root!
	There is a government advertising campaign here in Australia that goes something like "If you drink and drive... you're a bloody idiot". Well, the same thing applies to building the Temptools phase as root. Never do it. The risk of trashing your host system is too great.

Create a specific user and group in which to perform the build of the Temptools phase. Let's call them something creative like `build'. As root:

groupadd build
useradd -s /bin/bash -g build -m -k /dev/null build
passwd build

Decide where you want to build and install the system to. This doesn't have to be a partition, it can be anywhere, under $HOME, /mnt, /tmp or wherever you like, as long as there is plenty of space there (FIXME how much?). The location you've chosen to build the system will be assigned to the $SYSROOT variable below. Once the build has finished, the entire root file system image may be transferred to its intended final destination.

The following steps are taken to ensure a sane shell environment in which to work in. Your build script should, in practice, inherit these settings but it would be wise to at least sanity check the variables yourself when writing your script. Now login as user `build' and create the needed bash startup files and config.site. Then source the files:

Important

Be sure to substitute the location you've chosen for the build in the $SYSROOT variable assignment below. You'll likely also want to amend the value of $TZ to match your local time zone. $DIY_TARGET is used to select the target architecture you are building for. It is vitally important to ensure that the vendor field of the target triplet is something other than "pc" or "unknown". This is because we want to force the pass 1 toolchain into cross compilation mode. For example, if your real target is i686-pc-linux-gnu, set $DIY_TARGET to i686-diy-linux-gnu or even i686-FAKE-linux-gnu. If your real target is x86_64-unknown-linux-gnu, set $DIY_TARGET to x86_64-diy-linux-gnu, and so forth. Feel free to tweak $TT_PFX if you don't care for the name "temptools". If you are building on SMP, uncomment the MAKEFLAGS line to take advantage of make's parallel execution feature. This is becoming more important as multi-core CPUs increase in popularity. Even on UP you can achieve quicker builds with export MAKEFLAGS="-j2" (at the expense of system responsiveness). If you are targeting x86_64 and also want the ability to compile and run 32-bit code (recommended) set $BIARCH to YES. This will provide a basic bi-arch (multilib) setup with 2 separate Glibc installations and the ability to compile the Grub bootloader which depends on 32-bit compilation. From this basic multilib setup, you then have the capability to build up a full-blown multilib development environment (not covered here), but be aware that going down this path can be a lot of trouble for your average DIY'er. Everything else should remain as is. If using the original (deprecated) build method, $DIY_ARCH is used to determine the target architecture ($DIY_TARGET and $BIARCH are ignored). Legal values for $DIY_ARCH are "i386", "ppc" and "x86_64" depending on which architecture you are building on.

su - build

cat > ~/.bash_profile << "EOF"
exec env -i HOME=$HOME TERM=$TERM PS1='\u:\w\$ ' /bin/bash
EOF

cat > ~/.bashrc << "EOF"
TT_PFX=/temptools
CONFIG_SHELL=${TT_PFX}/bin/bash
CONFIG_SITE=${HOME}/config.site
DIY_TARGET=i686-diy-linux-gnu
BIARCH=NO
if [ "$BIARCH" = YES ]; then
  if ! echo $DIY_TARGET | grep ^x86_64 >/dev/null; then
    echo Warning: no BIARCH support for target $DIY_TARGET !
  else
    export DIR_64=64
  fi
fi
LC_ALL=C
LDFLAGS="-s"
PATH=${TT_PFX}/bin:/bin:/usr/bin
SYSROOT=/mnt/sysroot
TZ='Australia/Sydney'
export TT_PFX CONFIG_SHELL CONFIG_SITE DIY_TARGET BIARCH LC_ALL LDFLAGS PATH SYSROOT TZ
#export MAKEFLAGS="-j3"
set +o hashall 2>/dev/null || set -o nohash
umask 022
BINUTILS_VER=2.18
GCC_VER=4.2.4
GLIBC_VER=2.7
export BINUTILS_VER GCC_VER GLIBC_VER
EOF

cat > ~/config.site << "EOF"
test "$prefix" = NONE && prefix=${TT_PFX}
test -z "$CFLAGS" && CFLAGS="-O2 -pipe"
test -z "$CXXFLAGS" && CXXFLAGS=${CFLAGS}
enable_nls=no
EOF

source ~/.bash_profile

# Add this section ONLY when using the original (deprecated) build method!
cat >> ~/.bashrc << "EOF"
export DIY_ARCH=i386
EOF

source ~/.bash_profile

FIXME explain rationale for each item above

Now become root and set up the sysroot area:

	Important
	Ensure you are currently logged in as user `build' then become root using plain `su'. DO NOT use `su -' (ie: with the hyphen) because you'll lose the environment variables that are critical for these commands to work as intended.

install -dv ${SYSROOT}${TT_PFX}/src/{tarballs,patches}
ln -sv ${SYSROOT}${TT_PFX} /
chown -Rv build ${SYSROOT}${TT_PFX}

Now exit the su (root) login and from this point onwards the environment should be sane enough to build the temptools phase whenever you login as user `build'. Dump all the needed tarballs and patches into their respective dirs. Now you're ready to rock.

Here is a list of source packages used in the build. This information is extracted into the aforementioned packagedata file for easy parsing and/or conversion into a wget script:

Patches used in the Reference Build can be downloaded from http://downloads.diy-linux.org/patches/. Be sure to look in the "PM" subdirectory for Package Management related patches, "ppc" subdirectory for PowerPC related patches, etc.

Important

This first pass of Bash is the only package we install "by hand". Everything else after this point is expected to be automated via a build script. However, you can still drive the build manually by typing in all the commands on the interactive shell command line if you prefer. Note: Do not skip Bash Pass 1. It used to be optional but is now a requirement of the build method due to our use of CONFIG_SHELL (see below).

patch -p1 -i ${TT_PFX}/src/patches/bash-3.2-official-039-combined-1.patch &&
sh -c "unset CONFIG_SHELL; ./configure" &&
make &&
install -dv ${TT_PFX}/bin &&
cp -v bash ${TT_PFX}/bin/bash-pass1 &&
ln -sv bash-pass1 ${TT_PFX}/bin/bash &&
ln -sv bash ${TT_PFX}/bin/sh

Rationale Notes

./configure
make
cp -v make ${TT_PFX}/bin
ln -sv make ${TT_PFX}/bin/gmake

Rationale Notes

./configure \
	ac_cv_header_stdbool_h=yes
make
cp -v sed/sed ${TT_PFX}/bin

Rationale Notes

# Red Hat 6.2 Hack
#[[ $DIY_TARGET == x86_64* ]] &&
#	sed -i.bak 's/bad_64bit_gcc=yes/bad_64bit_gcc=no/' bfd/configure

mkdir ../binutils-build
cd ../binutils-build

../binutils-$BINUTILS_VER/configure \
	--target=$DIY_TARGET \
	--with-lib-path=$TT_PFX/lib$DIR_64 \
	--disable-werror
echo "MAKEINFO = :" >> Makefile

make

[[ $DIY_TARGET == x86_64* && $BIARCH = NO ]] &&
	{ install -dv $TT_PFX/lib; ln -sv lib $TT_PFX/lib64; }

make install

Rationale Notes

[[ $GCC_VER == 3.4* && $DIY_TARGET == i?86* ]] &&
	patch -p1 -i $TT_PFX/src/patches/gcc-3.4-branch-x86-inhibit_libc-1.patch

if [[ $GCC_VER > 4.2.9 ]]; then
	bunzip2 -dc $TT_PFX/src/tarballs/mpfr-2.4.1.tar.bz2 | tar xf -
	bunzip2 -dc $TT_PFX/src/tarballs/gmp-4.2.4.tar.bz2 | tar xf -
	mv -v mpfr* mpfr
	mv -v gmp* gmp
fi

mkdir ../gcc-build
cd ../gcc-build

[[ $DIY_TARGET == x86_64* && $BIARCH = NO ]] &&
	GCC_EXTRA_CONFIG="--disable-multilib"

../gcc-$GCC_VER/configure \
	--target=$DIY_TARGET \
	--enable-languages=c \
	--disable-shared \
	--disable-threads \
	--disable-libmudflap \
	--disable-libssp \
	--disable-libgomp \
	--disable-decimal-float \
	$GCC_EXTRA_CONFIG

make
make install -j1

ln -sv libgcc.a `$DIY_TARGET-gcc -print-libgcc-file-name | sed 's/libgcc/&_eh/'`
if [ "$BIARCH" = YES ]; then
	ln -sv libgcc.a `$DIY_TARGET-gcc -m32 -print-libgcc-file-name | sed 's/libgcc/&_eh/'`
fi

Rationale Notes

Warning

The 2.6.18 kernel introduced the next generation method of obtaining sanitized kernel headers. For some background on the issue please see this mailing list post. When using the new technique you MUST SKIP the Linux-Libc-Headers step which follows next. In other words, choose one or the other, not both. Only use the old method when building a toolchain comprised of older components (see table of toolchain combinations listed earlier).

make mrproper
make headers_install INSTALL_HDR_PATH=temp
cp -rv temp/include $TT_PFX

Rationale Notes

patch -p1 -i ${TT_PFX}/src/patches/linux-libc-headers-2.6.12.0-syscalls-3.patch
cp -Rv include/asm-${DIY_ARCH} ${TT_PFX}/include/asm
cp -Rv include/linux ${TT_PFX}/include

[[ $GCC_VER > 4.2.9 && $GLIBC_VER == 2.7* ]] &&
	patch -p1 -i $TT_PFX/src/patches/glibc-2.7-gcc43-1.patch

mkdir ../glibc-build
cd ../glibc-build

CC="$DIY_TARGET-gcc -m32" \
CFLAGS="-O2 -march=i486 -pipe" \
../glibc-$GLIBC_VER/configure \
	--host=i686-diy-linux-gnu \
	--build=$(../glibc-$GLIBC_VER/scripts/config.guess) \
	--disable-profile \
	--enable-add-ons \
	--with-headers=$TT_PFX/include \
	libc_cv_initfini_array=yes \
	libc_cv_forced_unwind=yes \
	libc_cv_c_cleanup=yes

echo "AUTOCONF=no
MAKEINFO=:" > configparms

make
make install -j1

Proceed with Caution!

Glibc is possibly the most critical piece of software you will compile in a base Reference Build. There is a high probability of something going wrong. Be sure to heed the advice contained in Section B, “Glibc General Advice” before taking on this monster. Note: the Glibc compiled here in the Temptools phase is merely a "throw away bootstrap" Glibc, but please do read the aforementioned advice anyway.

[[ $GCC_VER > 4.2.9 && $GLIBC_VER == 2.7* ]] &&
	patch -p1 -i $TT_PFX/src/patches/glibc-2.7-gcc43-1.patch

mkdir ../glibc-build
cd ../glibc-build

[[ $DIY_TARGET == i?86* ]] && MARCH=-march=i486

CFLAGS="-O2 $MARCH -pipe" \
../glibc-$GLIBC_VER/configure \
	--host=$DIY_TARGET \
	--build=$(../glibc-$GLIBC_VER/scripts/config.guess) \
	--disable-profile \
	--enable-add-ons \
	--with-headers=$TT_PFX/include \
	libc_cv_initfini_array=yes \
	libc_cv_forced_unwind=yes \
	libc_cv_c_cleanup=yes

echo "AUTOCONF=no
MAKEINFO=:" > configparms

[ "$BIARCH" = YES ] &&
echo "slibdir=$TT_PFX/lib64
libdir=$TT_PFX/lib64" >> configparms

make
make install -j1

Rationale Notes

case $DIY_TARGET in
  i?86*)	DL=/lib/ld-linux.so.2 ;;
  powerpc-*)	DL=/lib/ld.so.1 ;;
  x86_64*)	DL=/lib64/ld-linux-x86-64.so.2 ;;
esac

$DIY_TARGET-gcc -dumpspecs | sed \
	-e "s,$DL,$TT_PFX&," \
	-e "/^\*cpp:$/{n;s,$, -isystem $TT_PFX/include,}" \
	> `dirname $($DIY_TARGET-gcc -print-libgcc-file-name)`/specs

echo 'main(){}' | $DIY_TARGET-gcc -B $TT_PFX/lib$DIR_64/ -x c - -lrt
readelf -l a.out | grep ": $TT_PFX"
rm -fv a.out

Rationale Notes

[[ $DIY_TARGET == x86_64* && $(uname -m) == i?86 ]] &&
	{ echo 'build a 64-bit kernel and reboot into it!'; exit 1; }

mkdir ../binutils-build
cd ../binutils-build

CC="$DIY_TARGET-gcc -B $TT_PFX/lib$DIR_64/" \
AR=$DIY_TARGET-ar RANLIB=$DIY_TARGET-ranlib \
../binutils-$BINUTILS_VER/configure \
	--with-lib-path=$TT_PFX/lib$DIR_64
echo "MAKEINFO = :" >> Makefile

make
make install

make -C ld clean
make -C ld LIB_PATH=/lib$DIR_64:/usr/lib$DIR_64
cp -v ld/ld-new $TT_PFX/bin

case $DIY_TARGET in
  i?86*)	DL=/lib/ld-linux.so.2;		DL_HEADER=i386/linux.h ;;
  powerpc-*)	DL=/lib/ld.so.1;		DL_HEADER=rs6000/sysv4.h ;;
  x86_64*)	DL=/lib64/ld-linux-x86-64.so.2; DL_HEADER=i386/linux64.h
		if [ "$BIARCH" = NO ]; then
			GCC_EXTRA_CONFIG=--disable-multilib
		else
			DL32=/lib/ld-linux.so.2
		fi ;;
esac

if [[ $GCC_VER > 4.2.9 ]]; then
	bunzip2 -dc $TT_PFX/src/tarballs/mpfr-2.4.1.tar.bz2 | tar xf -
	bunzip2 -dc $TT_PFX/src/tarballs/gmp-4.2.4.tar.bz2 | tar xf -
	mv -v mpfr* mpfr
	mv -v gmp* gmp
	patch -p1 -i $TT_PFX/src/patches/gcc-4.3-branch-startfiles-1.patch
fi

if [[ $BINUTILS_VER > 2.17.9 && $GCC_VER > 4.1.9 && $GLIBC_VER > 2.5.9 ]]; then
	patch -p1 -i $TT_PFX/src/patches/gcc-4.2-branch-hash-style-gnu-2.patch
	sed -i.bak '/^#define LINK_SPEC/s/i386} \\/i386} --hash-style=gnu \\/' \
		gcc/config/i386/linux64.h
fi

sed -i.bak "s@$DL@$TT_PFX&@" gcc/config/$DL_HEADER
[ "$BIARCH" = YES ] &&
	sed -i.bak2 "s@$DL32@$TT_PFX&@" gcc/config/$DL_HEADER

echo '
/* Remove /usr/include from include search path.  */
#undef STANDARD_INCLUDE_DIR
#define STANDARD_INCLUDE_DIR 0

/* Remove /lib and /usr/lib from startfiles search path.  */
#define STANDARD_STARTFILE_PREFIX_1 ""
#define STANDARD_STARTFILE_PREFIX_2 ""' >> gcc/config/$DL_HEADER

sed -i.bak \
	's,\./fixinc\.sh,-c true,' gcc/Makefile.in

[[ $GCC_VER == 4.* && $DIY_TARGET == i?86* ]] &&
	sed -i.bak2 's/^XCFLAGS =$/& -fomit-frame-pointer/' gcc/Makefile.in

mkdir ../gcc-build
cd ../gcc-build

CC="$DIY_TARGET-gcc -B $TT_PFX/lib$DIR_64/" \
AR=$DIY_TARGET-ar RANLIB=$DIY_TARGET-ranlib \
../gcc-$GCC_VER/configure \
	--with-local-prefix=$TT_PFX \
	--enable-shared \
	--disable-bootstrap \
	--enable-languages=c,c++ \
	--enable-clocale=gnu \
	--enable-threads=posix \
	--enable-__cxa_atexit \
	--disable-libstdcxx-pch \
	$GCC_EXTRA_CONFIG

make
make install -j1
ln -sv gcc $TT_PFX/bin/cc

# Sanity check - ensure host not being searched for libs
echo 'main(){}' | cc -x c -lbogus -v -Wl,--verbose - &> foo || :
if grep "^attempt to open /usr" foo; then
	echo Oops; exit 1
fi

Rationale Notes

./configure \
	ac_cv_func_working_mktime=yes
make
cp -v gawk ${TT_PFX}/bin
ln -sv gawk ${TT_PFX}/bin/awk

Rationale Notes

patch -p1 -i $TT_PFX/src/patches/coreutils-6.12-utimensat-1.patch
./configure \
	--enable-install-program=hostname,su
make
make install
cp -v src/su ${TT_PFX}/bin

Rationale Notes

	Important
	From this point onwards if you need to become root you must call the host's `su' explicitly by running /bin/su. Just running su will call the first `su' in the $PATH which is the one we just installed (it will fail because of the missing setuid bit). This is especially important when we go to enter the Chroot environment at the beginning of the next phase.

make PREFIX=${TT_PFX} LDFLAGS=${LDFLAGS} install

[[ $GLIBC_VER > 2.5.9 ]] &&
	sed -i.bak 's/futimens/gl_&/' gzip.c lib/utimens.{c,h}

./configure
make
cp -v gunzip gzip ${TT_PFX}/bin

./configure
make
cp -v src/{cmp,diff} ${TT_PFX}/bin

./configure
make
cp -v find/find xargs/xargs ${TT_PFX}/bin

./configure
make
cp -v make ${TT_PFX}/bin

./configure \
	--without-included-regex \
	--disable-perl-regexp
make
cp -v src/{,e,f}grep ${TT_PFX}/bin

Rationale Notes

./configure
make
cp -v sed/sed ${TT_PFX}/bin

cd gettext-tools
./configure \
	--disable-shared
make -C gnulib-lib
make -C src msgfmt
cp -v src/msgfmt ${TT_PFX}/bin

./configure \
	--without-debug \
	--without-ada \
	--enable-overwrite
make
make install

./configure
make
cp -v patch ${TT_PFX}/bin

./configure
make
cp -v src/tar ${TT_PFX}/bin

./configure
make
make install

patch -p1 -i ${TT_PFX}/src/patches/bash-3.2-official-039-combined-1.patch
./configure \
	--without-bash-malloc \
	ac_cv_func_working_mktime=yes
make
install -v bash ${TT_PFX}/bin

Rationale Notes

Tip

It's worth noting the next 3 packages (M4, Bison and Flex) are not strictly necessary in the Temptools phase when using an official FSF Binutils release. However, they are mandatory if using a release from HJL. The reason is that FSF releases are made with a "make dist" style procedure whereby the generated files (from Bison and Flex) are already included in the tarball thus removing the requirement for Bison and Flex at Binutils build time (in the Chroot phase). Our recommendation is to always build M4, Bison and Flex here to ensure the build recipe remains compatible with both FSF and HJL Binutils releases. There is another issue: if you skip M4, Bison and Flex here it's likely you'll run into ICA trouble which will require an additional hack when building Bison in the Chroot phase.

./configure
make V=1
cp -v src/m4 ${TT_PFX}/bin

./configure
make
make install

./configure
make
cp -v flex ${TT_PFX}/bin

mkdir build
cd build
../configure
make libs -j1
make install-libs

Rationale Notes

./configure
make -C mount
make -C getopt
cp -v mount/{,u}mount getopt/getopt ${TT_PFX}/bin

Rationale Notes

chmod -v u+w hints/linux.sh

cat >> hints/linux.sh << "EOF"
libc=${prefix}/lib/`ls -l ${prefix}/lib/libc.so.6 | awk '{print $NF}'`
locincpth=""
loclibpth=""
usrinc="${prefix}/include"
glibpth="${prefix}/lib"
EOF

./configure.gnu \
	--prefix=${TT_PFX} \
	-Dstatic_ext='IO Fcntl Data/Dumper POSIX'

make perl utilities ext/Errno/pm_to_blib
cp -v perl pod/pod2man ${TT_PFX}/bin
mkdir -pv ${TT_PFX}/lib/perl5/5.10.0
cp -Rv lib/* ${TT_PFX}/lib/perl5/5.10.0

Rationale Notes

cd unix
./configure
make
make install
make install-private-headers
ln -sv tclsh8.4 ${TT_PFX}/bin/tclsh

patch -p1 -i ${TT_PFX}/src/patches/expect-5.43-spawn-1.patch
sed -i.bak '/echo.*STTY_BIN/i STTY_BIN=stty' configure
./configure \
	--with-tcl=${TT_PFX}/lib \
	--with-tclinclude=${TT_PFX}/include \
	--with-x=no
make
make SCRIPTS="" install -j1

Rationale Notes

./configure
make install -j1

./configure
make
sed -i.bak \
	's,^PATHS=,&/lib$DIR_64:/usr/lib$DIR_64:,' \
	scripts/fakeroot
make install

Rationale Notes

Note -- Optional Package Management with Pacman

Only install the next 3 packages (Zlib, Libtar and Pacman) if you intend implementing Pacman based package management. Pacman is a simple tar.gz-based package manager for Linux originally written for the Arch Linux distro. Please refer to the gsbuild scripts for a sample Pacman implementation. It's worth noting the author personally uses Pacman which means it receives regular testing within the Reference Build context.

./configure --prefix=${TT_PFX}
make
make install

patch -p1 -i ${TT_PFX}/src/patches/libtar-1.2.11-2.patch
./configure
make
make install

patch -p1 -i ${TT_PFX}/src/patches/pacman-2.9.8-custom-mods-2.patch
patch -p1 -i ${TT_PFX}/src/patches/pacman-2.9.6-temptools-1.patch
patch -p1 -i ${TT_PFX}/src/patches/pacman-2.9.8-sep_install-1.patch
./configure
make
cp -v pacman scripts/makepkg ${TT_PFX}/bin
cp -v etc/{makepkg,pacman}.conf ${TT_PFX}/etc

Note -- Optional Package Management with BPM

Only install the next 3 packages (Ogdlutils, Cpio and BPM) if you intend implementing BPM based package management. BPM is an extremely compact package manager with the simplest spec file format imaginable. It comes from the Bent Linux distro. Please refer to the gsbuild scripts for a sample BPM implementation. BPM only receives occasional testing within the Reference Build context and is included here mainly as a proof of concept. (Note: the gsbuild BPM implementation currently gets some file permissions wrong - FIXME).

make -C c libogdl gpath -j1
cp -v c/gpath ${TT_PFX}/bin

./configure
make
cp -v src/cpio ${TT_PFX}/bin

cp -v bpm{build,install,pkgfix} ${TT_PFX}/bin

rm -rfv ${TT_PFX}/{,share/}{info,man}

As mentioned in the Introduction, Package Management (PM) is a goal of the Reference Build. Accordingly, all build commands in this Chroot phase strive to be "PM friendly". This is reflected in those individual commands associated with file installation. Commands associated with configuring and building remain exactly the same as when performing a "build in place" style installation.

You'll notice that a typical invocation of make install has now become make DESTDIR=$PM_DEST install. The expectation is this: if you're employing PM then you'll assign a value to the PM_DEST variable in your scripting environment that is equivalent to wherever your chosen Package Manager expects to find the installed files. Doing it this way ensures the installation commands remain generic. If you're not employing PM, that is you're performing a usual "build in place" style installation, you just have to ensure that the PM_DEST variable is nonexistent (or empty or unset), then the installation commands will work exactly as if `DESTDIR=$PM_DEST' weren't specified.

Important

Earlier in the Temptools phase we installed a somewhat crippled `su' program from Coreutils (with a missing setuid bit). Therefore, in order to become root and enter the Chroot environment, you must call the host's `su' explicitly by running /bin/su or else you'll fail to gain root privilege. Before entering the chroot environment, be sure to become root using plain `/bin/su'. DO NOT use `/bin/su -' (ie: with the hyphen) because you'll lose the environment variables that are critical for the following chroot command to work as intended. When including this chroot command in your script you'll need to make 2 adjustments: (a) you should omit the $PS1 variable because it is normally unset in non-interactive shells and (b) you'll want to execute a script instead of ${TT_PFX}/bin/bash --login +h (make sure your script does a set +h to switch off hashing).

$TT_PFX/bin/chroot $SYSROOT \
	$TT_PFX/bin/env -i \
	HOME=/root \
	PATH=/bin:/usr/bin:/sbin:/usr/sbin:$TT_PFX/bin \
	PS1='\u-in-chroot:\w\$ ' \
	TERM=$TERM \
	CONFIG_SITE=/etc/config.site \
	LC_ALL=C \
	LDFLAGS=$LDFLAGS \
	${MAKEFLAGS+"MAKEFLAGS=$MAKEFLAGS"} \
	TT_PFX=$TT_PFX \
	TZ=$TZ \
	BINUTILS_VER=$BINUTILS_VER \
	GCC_VER=$GCC_VER \
	GLIBC_VER=$GLIBC_VER \
	DIY_TARGET=$DIY_TARGET \
	BIARCH=$BIARCH \
	${DIR_64+DIR_64=$DIR_64} \
	$TT_PFX/bin/bash --login +h

mkdir -pv /{bin,etc,home,lib,proc,sys} \
	/dev/{pts,shm} \
	/usr/{bin,include,lib/locale,share/{man,doc,info}} \
	/var/{lock,log,mail,run}
#ln -sv share/{man,doc,info} /usr
install -dvm 0750 /root
install -dvm 1777 {,/var}/tmp

if [[ $DIY_TARGET == x86_64* ]]; then
	if [ "$BIARCH" = NO ]; then
		ln -sv lib /lib64
		ln -sv lib /usr/lib64
	else
		mkdir -pv /{,usr/}lib64
	fi
fi

Rationale Notes

test -r /etc/mtab || > /etc/mtab
mount proc /proc -t proc
mount devpts /dev/pts -t devpts
mount shm /dev/shm -t tmpfs
mount sysfs /sys -t sysfs

ln -sv $TT_PFX/bin/{bash,cat,echo,pwd} /bin
ln -sv $TT_PFX/bin/perl /usr/bin
ln -sv $TT_PFX/lib/lib{gcc_s.so.1,stdc++.so.6} /usr/lib
[ "$BIARCH" = YES ] &&
	ln -sv $TT_PFX/lib64/lib{gcc_s.so.1,stdc++.so.6} /usr/lib64
ln -sv $TT_PFX/lib/libfakeroot.so /usr/lib$DIR_64
ln -sv bash /bin/sh

Rationale Notes

cat > /etc/passwd << "EOF"
root:x:0:0:root:/root:/bin/bash
EOF

cat > /etc/group << "EOF"
root:x:0:
bin:x:1:
sys:x:2:
kmem:x:3:
tty:x:4:
tape:x:5:
daemon:x:6:
floppy:x:7:
disk:x:8:
lp:x:9:
dialout:x:10:
audio:x:11:
utmp:x:12:
EOF

echo "127.0.0.1 localhost $(hostname)" > /etc/hosts

touch /var/run/utmp /var/log/{btmp,lastlog,wtmp}
chmod -v 644 /var/run/utmp /var/log/{btmp,lastlog,wtmp}
chgrp -v utmp /var/run/utmp

cat > $CONFIG_SITE << "EOF"
test "$prefix" = NONE && prefix=/usr
test "$mandir" = '${prefix}/man' && mandir='${prefix}/share/man'
test "$infodir" = '${prefix}/info' && infodir='${prefix}/share/info'
test -z "$CFLAGS" && CFLAGS="-O2 -pipe"
test -z "$CXXFLAGS" && CXXFLAGS=${CFLAGS}
EOF

Rationale Notes

echo "pkgmgr:x:999:" >> /etc/group
echo "pkgmgr2:x:998:pkgmgr" >> /etc/group
echo "pkgmgr:x:999:999::/home/pkgmgr:/bin/bash" >> /etc/passwd
install -dv -o pkgmgr -g pkgmgr /home/pkgmgr

echo "dummy1:x:1000:" >> /etc/group
echo "dummy2:x:1001:dummy" >> /etc/group
echo "dummy:x:1000:1000::/home:/bin/bash" >> /etc/passwd

Rationale Notes

bzcat ${TT_PFX}/src/tarballs/MAKEDEV-1.7.bz2 > $PM_DEST/dev/MAKEDEV
chmod -v 754 $PM_DEST/dev/MAKEDEV
cd $PM_DEST/dev
./MAKEDEV -v generic-nopty

Rationale Notes

rm -fv man3/getspnam.3 man5/passwd.5
make DESTDIR=$PM_DEST install

Rationale Notes

make DESTDIR=$PM_DEST install

	Warning
	As mentioned earlier, the 2.6.18 kernel introduced the next generation method of obtaining sanitized kernel headers. When using the new technique you MUST SKIP the Linux-Libc-Headers step which follows next.

make mrproper
make headers_check || :
make headers_install INSTALL_HDR_PATH=temp
mkdir -pv $PM_DEST/usr
cp -rv temp/include $PM_DEST/usr

patch -p1 -i ${TT_PFX}/src/patches/linux-libc-headers-2.6.12.0-syscalls-3.patch
mkdir -pv $PM_DEST/usr/include
cp -Rv include/asm-${DIY_ARCH} $PM_DEST/usr/include/asm
cp -Rv include/linux $PM_DEST/usr/include

sed -i.bak \
	's|libs -o|libs -L/usr/lib -Wl,-dynamic-linker=/lib/ld-linux.so.2 -o|' \
	scripts/test-installation.pl

[[ $GCC_VER > 4.2.9 && $GLIBC_VER == 2.7* ]] &&
	patch -p1 -i $TT_PFX/src/patches/glibc-2.7-gcc43-1.patch

[[ $GCC_VER == 4.2* ]] &&
	patch -p1 -i $TT_PFX/src/patches/glibc-2.6-x86-math-tests-1.patch

[[ $GLIBC_VER == 2.8* ]] &&
	patch -p1 -i $TT_PFX/src/patches/glibc-2.8-iconv-tests-1.patch

mkdir ../glibc-build
cd ../glibc-build

MARCH=-march=i686
[[ $GCC_VER > 4.1.9 ]] && MARCH="$MARCH -mtune=generic"

CC="gcc -m32" CXX="g++ -m32" \
CFLAGS="-O3 $MARCH -pipe" \
../glibc-$GLIBC_VER/configure \
	--host=i686-pc-linux-gnu \
	--build=$(../glibc-$GLIBC_VER/scripts/config.guess) \
	--disable-profile \
	--enable-add-ons \
	--libexecdir=/usr/lib \
	--with-headers=/usr/include \
	--enable-kernel=2.6.18 \
	--enable-bind-now

echo "cross-compiling=no" > configparms

make

[[ $GLIBC_VER > 2.7.9 ]] &&
	cp -v ../glibc-$GLIBC_VER/iconvdata/gconv-modules iconvdata

make -k check || :
make install_root=$PM_DEST install -j1

if [ "$PM_DEST" ]; then
	cp -v $PM_DEST/usr/include/{gnu/stubs-32,sys/{elf,vm86}}.h /tmp
	rm -rfv $PM_DEST/{etc,sbin,usr/{bin,include,sbin,share}}
	mkdir -pv $PM_DEST/usr/include/{gnu,sys}
	mv -v /tmp/{elf,vm86}.h $PM_DEST/usr/include/sys
	mv -v /tmp/stubs-32.h $PM_DEST/usr/include/gnu
fi

	Proceed with Caution!
	Glibc is possibly the most critical piece of software you will compile in a base Reference Build. There is a high probability of something going wrong. Be sure to heed the advice contained in Section B, “Glibc General Advice” before taking on this monster.

case $DIY_TARGET in
  i?86*)	DL=/lib/ld-linux.so.2; MARCH=-march=i686
		[[ $GCC_VER > 4.1.9 ]] && MARCH="$MARCH -mtune=generic" ;;
  powerpc-*)	DL=/lib/ld.so.1 ;;
  x86_64*)	DL=/lib64/ld-linux-x86-64.so.2 ;;
esac

sed -i.bak \
	"s|libs -o|libs -L/usr/lib$DIR_64 -Wl,-dynamic-linker=${DL} -o|" \
	scripts/test-installation.pl

[[ $GCC_VER > 4.2.9 && $GLIBC_VER == 2.7* ]] &&
	patch -p1 -i $TT_PFX/src/patches/glibc-2.7-gcc43-1.patch

[[ $GCC_VER == 4.2* && $DIY_TARGET == i?86* ]] &&
	patch -p1 -i $TT_PFX/src/patches/glibc-2.6-x86-math-tests-1.patch

[[ $GLIBC_VER == 2.8* ]] &&
	patch -p1 -i $TT_PFX/src/patches/glibc-2.8-iconv-tests-1.patch

mkdir ../glibc-build
cd ../glibc-build

CFLAGS="-O3 $MARCH -pipe" \
../glibc-$GLIBC_VER/configure \
	--disable-profile \
	--enable-add-ons \
	--libexecdir=/usr/lib$DIR_64 \
	--with-headers=/usr/include \
	--enable-kernel=2.6.18 \
	--enable-bind-now

[ "$BIARCH" = YES ] &&
echo "slibdir=/lib64
libdir=/usr/lib64" > configparms

make

[[ $GLIBC_VER > 2.7.9 ]] &&
	cp -v ../glibc-$GLIBC_VER/iconvdata/gconv-modules iconvdata

make -k check || :
make install_root=$PM_DEST install -j1
#make install_root=$PM_DEST localedata/install-locales
cp -v --remove-destination $PM_DEST/usr/share/zoneinfo/$TZ $PM_DEST/etc/localtime

cat > $PM_DEST/etc/nsswitch.conf << "EOF"
# Begin /etc/nsswitch.conf

passwd: files
group: files
shadow: files

hosts: files dns
networks: files

protocols: files
services: files
ethers: files
rpc: files

# End /etc/nsswitch.conf
EOF

cat > $PM_DEST/etc/ld.so.conf << "EOF"
# Begin /etc/ld.so.conf

/usr/local/lib

# End /etc/ld.so.conf
EOF

Rationale Notes

Tip -- Set up Dual Threading Libraries

Ever since the advent of NPTL most mainstream distros are set up with both NPTL and Linuxthreads enabled Glibc's installed side by side. This is for backwards compatibility reasons. NPTL is still relatively new and a lot of commercial software simply won't run under it. Be sure to check out Section B, “Dual Threading Libraries” if you need this backwards compatibility and want to set up your system to match the distros.

ln -sv ${TT_PFX}/bin/ld-new /usr/bin/ld

case $DIY_TARGET in
  i?86*)	DL=/lib/ld-linux.so.2 ;;
  powerpc-*)	DL=/lib/ld.so.1 ;;
  x86_64*)	DL=/lib64/ld-linux-x86-64.so.2 ;;
esac

gcc -dumpspecs | sed \
	-e "/^\*link:$/{n;s,$, -L/usr/lib$DIR_64,}" \
	-e "s,${TT_PFX}${DL},${DL}," \
	-e '/^\*cpp:$/{n;s,$, -isystem /usr/include,}' \
	> /tmp/myspecs

# Sanity checks.
echo 'main(){}' | cc \
	-x c \
	-specs=/tmp/myspecs \
	-B/usr/lib$DIR_64/ \
	-B/usr/bin/ \
	-Wl,--verbose \
	- -lrt &> foo

# 1. dynamic linker
readelf -l a.out | grep ": /lib"

# 2. start files
grep " /usr/lib$DIR_64/crt1.o succ" foo

# 3. libc
grep " /lib.*libc.so.6 succ" foo

# 4. deps found from DT_NEEDED
grep "^found.*at /lib.*/libpth" foo

rm -fv a.out foo

sed -i.bak \
	'/SFL.*fPIC/s/${CFLAGS-"-fPIC -O3"}/"${CFLAGS-"-O3"} -fPIC"/' \
	configure

CC="gcc -specs=/tmp/myspecs -B/usr/lib$DIR_64/ -B/usr/bin/" \
./configure \
	--prefix=/usr
make
mv -v {,x}libz.a
make clean

CC="gcc -specs=/tmp/myspecs -B/usr/lib$DIR_64/ -B/usr/bin/" \
./configure \
	--prefix=/usr \
	--shared

[ "$BIARCH" = YES ] &&
	sed -i.bak '/^libdir/s/lib$/&64/' Makefile

make
make check
make prefix=$PM_DEST/usr install
cp -v xlibz.a $PM_DEST/usr/lib$DIR_64/libz.a
mkdir -pv $PM_DEST/lib$DIR_64
mv -v $PM_DEST/usr/lib$DIR_64/libz.so.* $PM_DEST/lib$DIR_64
ln -sfv ../../lib$DIR_64/libz.so.1 $PM_DEST/usr/lib$DIR_64/libz.so

Rationale Notes

rm -fv etc/standards.info
sed -i.bak '/^INFO/s/standards.info //' etc/Makefile.in

[[ $GCC_VER > 4.2.9 && $BINUTILS_VER == 2.18 ]] &&
	patch -p1 -i $TT_PFX/src/patches/binutils-2.18-gcc43-ld-shared-tests-1.patch

mkdir ../binutils-build
cd ../binutils-build

CC="gcc -specs=/tmp/myspecs -B/usr/lib$DIR_64/ -B/usr/bin/" \
../binutils-$BINUTILS_VER/configure \
	--enable-shared \
	${DIR_64+--libdir=/usr/lib64}
echo "MAKEINFO = makeinfo" >> Makefile
make tooldir=/usr
make -k check || :
make tooldir=/usr DESTDIR=$PM_DEST install
cp -v ../binutils-$BINUTILS_VER/include/libiberty.h $PM_DEST/usr/include

Rationale Notes

Caution -- Check your GCC Testsuite Results!

Upon completion of the GCC Testsuite run, sanity check your results by comparing against a set of known good results as per the links in the following table: i686-pc-linux-gnu powerpc-unknown-linux-gnu x86_64-unknown-linux-gnu 4.3.2 4.3.0 4.3.0 4.2.4 4.2.1 FIXME 4.1.2 4.1.2 4.1.1 4.0.4 4.0.4 4.0.3 3.4.6 3.4.6 3.4.6 Note: if you're using GCC-3.4.4 or earlier and running under a 2.6.12 kernel or above, a new kernel feature known as "address space randomization" will likely cause some PCH tests to fail as per these unsatisfactory results. The problem is now resolved in GCC-3.4.5 and above. However, if for some reason you need to use an old GCC version, the problem can be worked around by following the advice contained in this mailing list post.

if [[ $GCC_VER > 4.2.9 ]]; then
	tar -xf $TT_PFX/src/tarballs/mpfr-2.4.1.tar.bz2 --transform='s/-2.4.1//'
	tar -xf $TT_PFX/src/tarballs/gmp-4.2.4.tar.bz2 --transform='s/-4.2.4//'
fi

sed -i.bak \
	's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in

if [[ $BINUTILS_VER > 2.17.9 && $GCC_VER > 4.1.9 && $GLIBC_VER > 2.5.9 ]]; then
	patch -p1 -i $TT_PFX/src/patches/gcc-4.2-branch-hash-style-gnu-2.patch
	sed -i.bak '/^#define LINK_SPEC/s/i386} \\/i386} --hash-style=gnu \\/' \
		gcc/config/i386/linux64.h
fi

sed -i.bak \
	's,\./fixinc\.sh,-c true,' gcc/Makefile.in

[[ $GCC_VER == 4.* && $DIY_TARGET == i?86* ]] &&
	sed -i.bak2 's/^XCFLAGS =$/& -fomit-frame-pointer/' gcc/Makefile.in

[[ $GCC_VER == 4.* ]] &&
	sed -i.bak '/dg-timeout/s/3\|10/20/' libmudflap/testsuite/libmudflap.cth/*.c

mkdir ../gcc-build
cd ../gcc-build

[[ $DIY_TARGET == x86_64* && $BIARCH = NO ]] &&
	GCC_EXTRA_CONFIG=--disable-multilib

CC="gcc -specs=/tmp/myspecs -B/usr/lib$DIR_64/ -B/usr/bin/" \
../gcc-${GCC_VER}/configure \
	--libexecdir=/usr/lib$DIR_64 \
	--enable-shared \
	--disable-bootstrap \
	--enable-languages=c,c++ \
	--enable-clocale=gnu \
	--enable-threads=posix \
	--enable-__cxa_atexit \
	$GCC_EXTRA_CONFIG

make \
	LDFLAGS=$LDFLAGS \
	MAKEINFO=makeinfo \
	gcc_cv_prog_makeinfo_modern=yes

make -k check || :
../gcc-${GCC_VER}/contrib/test_summary
make DESTDIR=$PM_DEST install -j1

mkdir -pv $PM_DEST/lib
ln -sfv ../usr/bin/cpp $PM_DEST/lib
ln -sfv gcc $PM_DEST/usr/bin/cc

Rationale Notes

./configure \
	--bindir=/bin \
	--enable-html
make
make check
make DESTDIR=$PM_DEST install

sed -i.bak 's,/bin/rm,rm,' lib/blkid/test_probe.in

mkdir build
cd build

../configure \
	--with-root-prefix="" \
	--enable-elf-shlibs \
	${DIR_64+--libdir=/usr/lib64}
make
make check
make DESTDIR=$PM_DEST install install-libs ${DIR_64+root_libdir=/lib64}

Rationale Notes

patch -p1 -i $TT_PFX/src/patches/coreutils-6.12-utimensat-1.patch
sed -i.bak 's,HOME",HOME /dev/shm",' tests/other-fs-tmpdir
sed -i.bak 's/test-getaddrinfo\$(EXEEXT) //' gnulib-tests/Makefile.in

./configure \
	--enable-no-install-program=kill,uptime \
	--enable-install-program=hostname,su
make

if [ `id -u` -eq 0 ]; then
	make NON_ROOT_USERNAME=dummy check-root
	chown -v dummy gnulib-tests/.deps
	su dummy -c "make RUN_EXPENSIVE_TESTS=yes check"
else
	make RUN_EXPENSIVE_TESTS=yes check
fi
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/{bin,usr/sbin}
mv -v $PM_DEST/usr/bin/{cat,chgrp,chmod,chown,cp,date} $PM_DEST/bin
mv -v $PM_DEST/usr/bin/{dd,df,echo,false,hostname,ln,ls} $PM_DEST/bin
mv -v $PM_DEST/usr/bin/{mkdir,mknod,mv,pwd,rm,rmdir,sleep} $PM_DEST/bin
mv -v $PM_DEST/usr/bin/{stty,su,sync,touch,true,uname} $PM_DEST/bin
mv -v $PM_DEST/usr/bin/chroot $PM_DEST/usr/sbin

Rationale Notes

make STRIP=yes
make test
make DESTDIR=$PM_DEST install

Rationale Notes

./configure \
	--libexecdir=/usr/lib$DIR_64 \
	ac_cv_func_working_mktime=yes
make
make check
make DESTDIR=$PM_DEST install

Rationale Notes

./configure \
	--libexecdir=/usr/lib$DIR_64/locate \
	--localstatedir=/var/lib/locate
make
make check
make DESTDIR=$PM_DEST install

./configure \
	--with-shared \
	--without-debug \
	${DIR_64+--libdir=/usr/lib64}
make
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/lib$DIR_64
mv -v $PM_DEST/usr/lib$DIR_64/libncurses.so.5* $PM_DEST/lib$DIR_64
ln -sfv ../../lib$DIR_64/libncurses.so.5 $PM_DEST/usr/lib$DIR_64/libncurses.so
ln -sfv libncurses.so $PM_DEST/usr/lib$DIR_64/libcurses.so

patch -p1 -i ${TT_PFX}/src/patches/readline-5.2-official-012-combined-1.patch
./configure \
	${DIR_64+--libdir=/usr/lib64} \
	bash_cv_func_ctype_nonascii=yes
make SHLIB_LIBS=-lcurses
sed -i.bak '/MV.*old/d' Makefile
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/lib$DIR_64
mv -v $PM_DEST/usr/lib$DIR_64/lib{readline,history}.so.5* $PM_DEST/lib$DIR_64
ln -sfv ../../lib$DIR_64/libhistory.so.5 $PM_DEST/usr/lib$DIR_64/libhistory.so
ln -sfv ../../lib$DIR_64/libreadline.so.5 $PM_DEST/usr/lib$DIR_64/libreadline.so

Rationale Notes

echo '#define SYS_VIMRC_FILE "/etc/vimrc"' >> src/feature.h

./configure
make
make test -j1
mkdir -pv $PM_DEST/etc
make DESTDIR=$PM_DEST install -j1
ln -sfv vim $PM_DEST/usr/bin/vi

cat > $PM_DEST/etc/vimrc << "EOF"
" Begin /etc/vimrc

set nocompatible
set backspace=2
syntax on

" End /etc/vimrc
EOF

Rationale Notes

./configure
make V=1
make check V=1
make DESTDIR=$PM_DEST install

./configure \
	${DIR_64+--libdir=/usr/lib64}
make
make check
make DESTDIR=$PM_DEST install

./configure \
	--sysconfdir=/etc
make
make DESTDIR=$PM_DEST install

PAGE=A4 ./configure
make -j1
mkdir -pv $PM_DEST/usr
make prefix=$PM_DEST/usr install
ln -sfv soelim $PM_DEST/usr/bin/zsoelim
ln -sfv eqn $PM_DEST/usr/bin/geqn
ln -sfv tbl $PM_DEST/usr/bin/gtbl

./configure \
	${DIR_64+--libdir=/usr/lib64}
make
make check -j1
make DESTDIR=$PM_DEST install
ln -sfv flex $PM_DEST/usr/bin/lex
ln -sfv libfl.a $PM_DEST/usr/lib$DIR_64/libl.a

./configure \
	${DIR_64+--libdir=/usr/lib64}
make
make -k check || :
make DESTDIR=$PM_DEST install

Rationale Notes

sed -i.bak \
	-e '/PROGS/s/hostname //' \
	-e '/hostname.*bin/d' \
	Makefile
sed -i.bak 's/in 1 5/in 5/' man/Makefile
sed -i.bak '/default:/d' lib/inet_sr.c
sed -i.bak 's/of(x25/of(struct x25/' lib/x25_sr.c

yes "" | make config
make LOPTS=${LDFLAGS} -j1
make BASEDIR=$PM_DEST update

sed -i.bak '/man_MANS =/d' \
	{ftpd,inetd,logger,rexecd,rlogind,rshd,syslogd,talkd,telnetd,tftpd}/Makefile.in

./configure \
	--disable-servers \
	--disable-hostname \
	--disable-logger \
	--disable-whois \
	--disable-ifconfig \
	--libexecdir=/usr/sbin
make
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/bin
mv -v $PM_DEST/usr/bin/ping $PM_DEST/bin

make
make DESTDIR=$PM_DEST ldconfig=: install

sed -i.bak \
	"/if grep/a skip \"not testing setlogsock('stream'): _PATH_LOG unavailable\", 10 \
	unless -e Sys::Syslog::_PATH_LOG();" \
	ext/Sys/Syslog/t/syslog.t

./configure.gnu \
	-Dpager="/usr/bin/less -isR"

make BUILD_ZLIB=False
make test
make DESTDIR=$PM_DEST install

Rationale Notes

[[ $GLIBC_VER > 2.5.9 ]] &&
	sed -i.bak 's/futimens/gl_&/' gzip.c lib/utimens.{c,h}

./configure
make bindir=/bin
make check
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/bin
mv -v $PM_DEST/usr/bin/{gunzip,gzip,zcat} $PM_DEST/bin

Rationale Notes

./configure
make
make check
make DESTDIR=$PM_DEST install

./configure \
	--bindir=/bin \
	--without-included-regex
make
make check
make DESTDIR=$PM_DEST install

./configure \
	${DIR_64+--libdir=/usr/lib64}
make
make check
make DESTDIR=$PM_DEST install

./configure \
	${DIR_64+--libdir=/usr/lib64}
make
make check
make DESTDIR=$PM_DEST install

./configure
make
make check
make DESTDIR=$PM_DEST install

./configure
make
make -k check || :
make DESTDIR=$PM_DEST install

	Important
	The Bash testsuite is unlike most others in that it doesn't stop if errors are encountered. This means you have to physically examine the output and cannot rely on the exit status of the `make tests' command. It even tells you as much at the beginning of the run: "Any output from any test, unless otherwise noted, indicates a possible anomaly".

patch -p1 -i ${TT_PFX}/src/patches/bash-3.2-official-039-combined-1.patch
echo '#define NON_INTERACTIVE_LOGIN_SHELLS' >> config-top.h
./configure \
	--without-bash-malloc \
	--with-installed-readline \
	ac_cv_func_working_mktime=yes
make

sed -i '/THIS/s,1$,1 </dev/tty,' tests/run-test

if [ `id -u` -eq 0 ]; then
	chown -R dummy .
	su dummy -c "make tests"
else
	make tests
fi
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/bin
mv -v $PM_DEST/usr/bin/bash $PM_DEST/bin

Rationale Notes

sed -i.bak \
	-e 's,X)/man,X)/share/man,g' \
	-e '/ln .*PREFIX/s,$(PREFIX)/bin/,,' \
	Makefile

[ "$BIARCH" = YES ] &&
	sed -i.bak 's,/lib\( \|$\|/\),/lib64\1,g' Makefile

make -f Makefile-libbz2_so
make clean
make
make PREFIX=$PM_DEST/usr install
mkdir -pv $PM_DEST/{bin,lib$DIR_64}
cp -v bzip2-shared $PM_DEST/bin/bzip2
cp -av libbz2.so* $PM_DEST/lib$DIR_64
ln -sfv ../../lib$DIR_64/libbz2.so.1.0 $PM_DEST/usr/lib$DIR_64/libbz2.so
rm -fv $PM_DEST/usr/bin/{bunzip2,bzcat,bzip2}
ln -sfv bzip2 $PM_DEST/bin/bunzip2
ln -sfv bzip2 $PM_DEST/bin/bzcat

Rationale Notes

./configure
make
make DESTDIR=$PM_DEST install

./configure \
	--prefix=/usr \
	--bindir=/bin
make
make check
make DESTDIR=$PM_DEST install

sed -i.bak \
	's/ifdef OPTIONAL_PROGS/ifeq ($(OPTIONAL_PROGS),yes)/' \
	man/Makefile.in

sed -i.bak \
	's,@datadir@,&/kbd,' \
	{src,data}/Makefile.in

./configure \
	--enable-nls
make KEYCODES_PROGS=yes RESIZECONS_PROGS=yes
make KEYCODES_PROGS=yes RESIZECONS_PROGS=yes DESTDIR=$PM_DEST install

Rationale Notes

sed -i.bak 's/-is/&R/' configure
sed -i.bak 's%MANPATH./usr/man%#&%' src/man.conf.in
./configure \
	-default \
	-confdir=/etc
make
make DESTDIR=$PM_DEST install

./configure
make
make check
make DESTDIR=$PM_DEST install

./configure
make check DOCBOOKTOMAN=:
make maintainer-clean
patch -p1 -i $TT_PFX/src/patches/module-init-tools-3.4-manpages-1.patch

./configure --exec-prefix=/ --enable-zlib
make
make INSTALL=install DESTDIR=$PM_DEST install

Rationale Notes

./configure
make
make prefix=$PM_DEST/usr install

./configure
make
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/bin
mv -v $PM_DEST/usr/bin/{fuser,killall} $PM_DEST/bin

[[ $GLIBC_VER == 2.3* ]] &&
	sed -i.bak '1i #include <sys/types.h>' lib/{pw,group}io.h

./configure \
	--sysconfdir=/etc
make

find man -name Makefile | \
	xargs sed -i.bak \
		-e 's/groups\.1 //' \
		-e 's/su\.1\( \|$\)//' \
		-e 's/suauth\.5 //'
make DESTDIR=$PM_DEST bin_PROGRAMS=login suidbins= install
sed -i \
	-e 's%/var/spool/mail%/var/mail%' \
	-e 's%#MD5_CRYPT_ENAB.no%MD5_CRYPT_ENAB yes%' \
	$PM_DEST/etc/login.defs
sed -i \
	-e '/MAIL/s,yes,no,' \
	$PM_DEST/etc/default/useradd
mv -v $PM_DEST/usr/bin/passwd $PM_DEST/bin

Rationale Notes

make
mkdir -pv $PM_DEST/{etc,usr/{share/man/man{5,8},sbin}}
make prefix=$PM_DEST install

cat > $PM_DEST/etc/syslog.conf << "EOF"
# Begin /etc/syslog.conf

auth,authpriv.* -/var/log/auth.log
*.*;auth,authpriv.none -/var/log/sys.log
daemon.* -/var/log/daemon.log
kern.* -/var/log/kern.log
mail.* -/var/log/mail.log
user.* -/var/log/user.log
*.emerg *

# End /etc/syslog.conf
EOF

make -C src
mkdir -pv $PM_DEST/{{,s}bin,etc,usr/{{bin,include},share/man/man{1,5,8}}}
make -C src ROOT=$PM_DEST install

cat > $PM_DEST/etc/inittab << "EOF"
# Begin /etc/inittab
id:3:initdefault:

si::sysinit:/etc/rc.d/init.d/rc sysinit

l0:0:wait:/etc/rc.d/init.d/rc 0
l1:S1:wait:/etc/rc.d/init.d/rc 1
l2:2:wait:/etc/rc.d/init.d/rc 2
l3:3:wait:/etc/rc.d/init.d/rc 3
l4:4:wait:/etc/rc.d/init.d/rc 4
l5:5:wait:/etc/rc.d/init.d/rc 5
l6:6:wait:/etc/rc.d/init.d/rc 6

ca:12345:ctrlaltdel:/sbin/shutdown -t1 -a -r now

su:S016:once:/sbin/sulogin

1:2345:respawn:/sbin/agetty tty1 9600
2:2345:respawn:/sbin/agetty tty2 9600
3:2345:respawn:/sbin/agetty tty3 9600
4:2345:respawn:/sbin/agetty tty4 9600
5:2345:respawn:/sbin/agetty tty5 9600
6:2345:respawn:/sbin/agetty tty6 9600
# End /etc/inittab
EOF

./configure \
	--bindir=/bin \
	--libexecdir=/usr/sbin
make
make check
make DESTDIR=$PM_DEST install

sed -i.bak \
	's@etc/adjtime@var/lib/hwclock/adjtime@' \
	hwclock/hwclock.c

./configure \
	--enable-arch \
	--enable-write \
	--disable-wall
make
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/var/lib/hwclock

Rationale Notes

sed -i.bak '/ufs2/d' stage2/size_test
patch -p1 -i $TT_PFX/src/patches/grub-0.97-ext-256byte-inode-1.patch

./configure default_CFLAGS=yes
make
make check
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/boot/grub
cp -v $PM_DEST/usr/lib/grub/*/stage{1,2} $PM_DEST/boot/grub

Rationale Notes

sed -i 's@usr/local@usr@' Makefile etc/yaboot.conf man/*
make
make ROOT=$PM_DEST MANDIR=share/man install

patch -p1 -i ${TT_PFX}/src/patches/mac-fdisk-0.1.orig-debian-2.patch
make
mkdir -pv $PM_DEST/sbin
make DESTDIR=$PM_DEST install

./configure
make
mkdir -pv $PM_DEST/usr/{bin,share/man/man1}
make prefix=$PM_DEST/usr install

sed -i.bak 's,${srcdir}/tartest,true,' test/t.tar
./configure \
	${DIR_64+--libdir=/usr/lib64}
make
make check
make DESTDIR=$PM_DEST install

	Note -- Optional Package Management with Pacman
	As mentioned earlier in the Temptools phase, you only need the next 2 packages (Libtar and Pacman) if you've implemented Pacman based package management.

patch -p1 -i ${TT_PFX}/src/patches/libtar-1.2.11-2.patch
./configure \
	${DIR_64+--libdir=/usr/lib64}
make
make DESTDIR=$PM_DEST install

patch -p1 -i ${TT_PFX}/src/patches/pacman-2.9.8-custom-mods-2.patch
patch -p1 -i ${TT_PFX}/src/patches/pacman-2.9.8-sep_install-1.patch
./configure
make
make DESTDIR=$PM_DEST install

	Note -- Optional Package Management with BPM
	As mentioned earlier in the Temptools phase, you only need the next 3 packages (Ogdlutils, Cpio and BPM) if you've implemented BPM based package management.

make -C c libogdl gpath -j1
mkdir -pv $PM_DEST/usr/bin
cp -v c/gpath $PM_DEST/usr/bin

./configure \
	--enable-mt \
	--with-rmt=/usr/sbin/rmt
make
make check
make DESTDIR=$PM_DEST rmtdir= install

make DESTDIR=$PM_DEST install

FIXME

Mention some brief stuff here about kernel compilation and installation, bootscripts, network setup, system config files, fstab, bootloader, etc, etc, etc. In other words, anything needed to make the built system functional.

Remove the dummy user and groups that were created earlier.

sed -i '/dummy/d' /etc/{group,passwd}

For enhanced security, you probably want to enable shadow passwords and shadow group passwords:

/usr/sbin/pwconv
/usr/sbin/grpconv

If you found this document useful, I'd appreciate you dropping me a line at <gschafer@zip.com.au>. It will help me gauge levels of interest in the project and determine future development direction.

Many folks have helped out with fixes, suggestions, bug reports and testing (too numerous to list here). But some have made outstanding contributions for which I'd like to especially say thanks:

Important

This first pass of Bash is the only package we install "by hand". Everything else after this point is expected to be automated via a build script. However, you can still drive the build manually by typing in all the commands on the interactive shell command line if you prefer. Note: Do not skip Bash Pass 1. It used to be optional but is now a requirement of the build method due to our use of CONFIG_SHELL (see below).

patch -p1 -i ${TT_PFX}/src/patches/bash-3.2-official-039-combined-1.patch &&
sh -c "unset CONFIG_SHELL; ./configure" &&
make &&
install -dv ${TT_PFX}/bin &&
cp -v bash ${TT_PFX}/bin/bash-pass1 &&
ln -sv bash-pass1 ${TT_PFX}/bin/bash &&
ln -sv bash ${TT_PFX}/bin/sh

Rationale Notes

./configure
make
cp -v make ${TT_PFX}/bin
ln -sv make ${TT_PFX}/bin/gmake

Rationale Notes

./configure \
	ac_cv_header_stdbool_h=yes
make
cp -v sed/sed ${TT_PFX}/bin

Rationale Notes

mkdir ../binutils-build
cd ../binutils-build

../binutils-${BINUTILS_VER}/configure \
	--disable-werror
echo "MAKEINFO = :" >> Makefile
make LDFLAGS=${LDFLAGS}

[ "$DIY_ARCH" = x86_64 ] && {
	mkdir -pv $TT_PFX/lib; ln -sv lib $TT_PFX/lib64; }

make install

export CC="gcc -B/usr/bin/"
if echo | $CC -E -o /dev/null - 2>&1 | grep never > /dev/null; then
	CC=gcc
fi

make -C ld clean
make -C ld \
	CC="${CC}" \
	LDFLAGS=${LDFLAGS} \
	LIB_PATH=${TT_PFX}/lib
unset CC
cp -v ld/ld-new ${TT_PFX}/bin

Rationale Notes

sed -i.bak \
	-e '/^LIBGCC2_DEBUG/d' \
	-e '/^STAGE1_CHECK/d' \
	gcc/Makefile.in

BOOT_CFLAGS="-O2 -pipe"
[[ $GCC_VER == 4.* && $DIY_ARCH == i386 ]] &&
	BOOT_CFLAGS="$BOOT_CFLAGS -fomit-frame-pointer"

mkdir ../gcc-build
cd ../gcc-build

export CC="gcc -B/usr/bin/"
if echo | $CC -E -o /dev/null - 2>&1 | grep never > /dev/null; then
	CC=gcc
fi

../gcc-${GCC_VER}/configure \
	--with-local-prefix=${TT_PFX} \
	--disable-shared \
	--disable-libmudflap \
	--disable-libssp \
	--disable-libgomp \
	--disable-multilib \
	--disable-checking \
	--disable-stage1-checking \
	--enable-languages=c \
	--with-ld=${TT_PFX}/bin/ld \
	--with-as=${TT_PFX}/bin/as
unset CC

make \
	BOOT_LDFLAGS=${LDFLAGS} \
	BOOT_CFLAGS="${BOOT_CFLAGS}" \
	STAGE1_CFLAGS="-pipe" \
	LDFLAGS=${LDFLAGS} \
	bootstrap

make install -j1

ln -sv libgcc.a `gcc -print-libgcc-file-name | \
	sed 's/libgcc/&_eh/'`
ln -sv gcc ${TT_PFX}/bin/cc

Rationale Notes

Warning

The 2.6.18 kernel introduced the next generation method of obtaining sanitized kernel headers. For some background on the issue please see this mailing list post. When using the new technique you MUST SKIP the Linux-Libc-Headers step which follows next. In other words, choose one or the other, not both. Only use the old method when building a toolchain comprised of older components (see table of toolchain combinations listed earlier).

make mrproper
make headers_install INSTALL_HDR_PATH=temp
cp -rv temp/include $TT_PFX

patch -p1 -i ${TT_PFX}/src/patches/linux-libc-headers-2.6.12.0-syscalls-3.patch
cp -Rv include/asm-${DIY_ARCH} ${TT_PFX}/include/asm
cp -Rv include/linux ${TT_PFX}/include

Proceed with Caution!

Glibc is possibly the most critical piece of software you will compile in a base Reference Build. There is a high probability of something going wrong. Be sure to heed the advice contained in Section B, “Glibc General Advice” before taking on this monster. Note: the Glibc compiled here in the Temptools phase is merely a "throw away bootstrap" Glibc, but please do read the aforementioned advice anyway.

[[ $GLIBC_VER > 2.5.9 && $DIY_ARCH == i386 ]] &&
	MARCH="-march=i486"

mkdir ../glibc-build
cd ../glibc-build

CFLAGS="-O2 $MARCH -pipe" \
../glibc-${GLIBC_VER}/configure \
	--disable-profile \
	--enable-add-ons \
	--with-binutils=${TT_PFX}/bin \
	--with-headers=${TT_PFX}/include \
	--without-selinux

echo "AUTOCONF=no
MAKEINFO=:" > configparms

make
make install -j1

Rationale Notes

cp -pv ${TT_PFX}/bin/ld-new ${TT_PFX}/bin/ld
cp -pv ${TT_PFX}/bin/ld-new ${TT_PFX}/`gcc -dumpmachine`/bin/ld

case "$DIY_ARCH" in
  i386)   DL=/lib/ld-linux.so.2 ;;
  ppc)	  DL=/lib/ld.so.1 ;;
  x86_64) DL=/lib64/ld-linux-x86-64.so.2 ;;
esac

gcc -dumpspecs | sed \
	"s,${DL},${TT_PFX}&," > \
	`gcc -print-search-dirs | head -n 1 | awk '{ print $2 }'`specs

[ "$DIY_ARCH" = x86_64 ] &&
	sed -i.bak '/^\*multilib:$/{n;s/.*/. ;/}' `gcc -print-file-name=specs`

I=`gcc -print-file-name=include`
rm -rfv ${I}/*
J=`gcc -print-file-name=install-tools`
cp -pv ${J}/include/* ${I}
cp -pv ${J}/gsyslimits.h ${I}/syslimits.h

echo 'main(){}' | cc -x c -
readelf -l a.out | grep ": ${TT_PFX}"
rm -fv a.out

Rationale Notes

case "$DIY_ARCH" in
  i386)   DL=/lib/ld-linux.so.2;	  DL_HEADER=i386/linux.h ;;
  ppc)	  DL=/lib/ld.so.1;		  DL_HEADER=rs6000/sysv4.h ;;
  x86_64) DL=/lib64/ld-linux-x86-64.so.2; DL_HEADER=i386/linux64.h
	  sed -i.bak '/MULTILIB_OSDIRNAMES/d' gcc/config/i386/t-linux64 ;;
esac

[[ $BINUTILS_VER == 2.18* && $GCC_VER > 4.1.9 && $GLIBC_VER > 2.5.9 ]] &&
	patch -p1 -i ${TT_PFX}/src/patches/gcc-4.2-branch-hash-style-gnu-1.patch

sed -i.bak \
	"s@${DL}@${TT_PFX}&@" gcc/config/${DL_HEADER}

echo "
/* Remove /usr/include from end of include search path.  */
#undef STANDARD_INCLUDE_DIR
#define STANDARD_INCLUDE_DIR 0" >> gcc/config/${DL_HEADER}

sed -i.bak \
	-e 's,\./fixinc\.sh,-c true,' \
	-e '/^LIBGCC2_DEBUG/d' gcc/Makefile.in

[[ $GCC_VER == 4.* && $DIY_ARCH == i386 ]] &&
	sed -i.bak2 's/^XCFLAGS =$/& -fomit-frame-pointer/' gcc/Makefile.in

mkdir ../gcc-build
cd ../gcc-build

../gcc-${GCC_VER}/configure \
	--with-local-prefix=${TT_PFX} \
	--enable-shared \
	--disable-multilib \
	--disable-bootstrap \
	--enable-languages=c,c++ \
	--enable-clocale=gnu \
	--enable-threads=posix \
	--enable-__cxa_atexit \
	--disable-libstdcxx-pch

make LDFLAGS=${LDFLAGS}

make install -j1

Rationale Notes

mkdir ../binutils-build
cd ../binutils-build

../binutils-${BINUTILS_VER}/configure \
	--with-lib-path=${TT_PFX}/lib
echo "MAKEINFO = :" >> Makefile
make LDFLAGS=${LDFLAGS}
make install

make -C ld clean
make -C ld \
	LDFLAGS=${LDFLAGS} \
	LIB_PATH=/lib:/usr/lib
cp -v ld/ld-new ${TT_PFX}/bin

./configure
make
cp -v gawk ${TT_PFX}/bin
ln -sv gawk ${TT_PFX}/bin/awk

patch -p1 -i $TT_PFX/src/patches/coreutils-6.12-utimensat-1.patch
./configure \
	--enable-install-program=hostname,su
make
make install
cp -v src/su ${TT_PFX}/bin

Rationale Notes

	Important
	From this point onwards if you need to become root you must call the host's `su' explicitly by running /bin/su. Just running su will call the first `su' in the $PATH which is the one we just installed (it will fail because of the missing setuid bit). This is especially important when we go to enter the Chroot environment at the beginning of the next phase.

make PREFIX=${TT_PFX} LDFLAGS=${LDFLAGS} install

[[ $GLIBC_VER > 2.5.9 ]] &&
	sed -i.bak 's/futimens/gl_&/' gzip.c lib/utimens.{c,h}

./configure
make
cp -v gunzip gzip ${TT_PFX}/bin

./configure
make
cp -v src/{cmp,diff} ${TT_PFX}/bin

./configure
make
cp -v find/find xargs/xargs ${TT_PFX}/bin

./configure
make
cp -v make ${TT_PFX}/bin

./configure \
	--without-included-regex \
	--disable-perl-regexp
make
cp -v src/{,e,f}grep ${TT_PFX}/bin

Rationale Notes

./configure
make
cp -v sed/sed ${TT_PFX}/bin

cd gettext-tools
./configure \
	--disable-shared
make -C gnulib-lib
make -C src msgfmt
cp -v src/msgfmt ${TT_PFX}/bin

./configure \
	--without-debug \
	--without-ada \
	--enable-overwrite
make
make install

./configure
make
cp -v patch ${TT_PFX}/bin

./configure
make
cp -v src/tar ${TT_PFX}/bin

./configure
make
make install

patch -p1 -i ${TT_PFX}/src/patches/bash-3.2-official-039-combined-1.patch
./configure \
	--without-bash-malloc
make
install -v bash ${TT_PFX}/bin

Rationale Notes

Tip

It's worth noting the next 3 packages (M4, Bison and Flex) are not strictly necessary in the Temptools phase when using an official FSF Binutils release. However, they are mandatory if using a release from HJL. The reason is that FSF releases are made with a "make dist" style procedure whereby the generated files (from Bison and Flex) are already included in the tarball thus removing the requirement for Bison and Flex at Binutils build time (in the Chroot phase). Our recommendation is to always build M4, Bison and Flex here to ensure the build recipe remains compatible with both FSF and HJL Binutils releases. There is another issue: if you skip M4, Bison and Flex here it's likely you'll run into ICA trouble which will require an additional hack when building Bison in the Chroot phase.

./configure
make V=1
cp -v src/m4 ${TT_PFX}/bin

./configure
make
make install

./configure
make
cp -v flex ${TT_PFX}/bin

mkdir build
cd build
../configure
make libs -j1
make install-libs

Rationale Notes

./configure
make -C mount
make -C getopt
cp -v mount/{,u}mount getopt/getopt ${TT_PFX}/bin

Rationale Notes

chmod -v u+w hints/linux.sh

cat >> hints/linux.sh << "EOF"
libc=${prefix}/lib/`ls -l ${prefix}/lib/libc.so.6 | awk '{print $NF}'`
locincpth=""
loclibpth=""
usrinc="${prefix}/include"
glibpth="${prefix}/lib"
EOF

./configure.gnu \
	--prefix=${TT_PFX} \
	-Dstatic_ext='IO Fcntl Data/Dumper POSIX'

make perl utilities ext/Errno/pm_to_blib
cp -v perl pod/pod2man ${TT_PFX}/bin
mkdir -pv ${TT_PFX}/lib/perl5/5.10.0
cp -Rv lib/* ${TT_PFX}/lib/perl5/5.10.0

Rationale Notes

cd unix
./configure
make
make install
make install-private-headers
ln -sv tclsh8.4 ${TT_PFX}/bin/tclsh

patch -p1 -i ${TT_PFX}/src/patches/expect-5.43-spawn-1.patch
sed -i.bak '/echo.*STTY_BIN/i STTY_BIN=stty' configure
./configure \
	--with-tcl=${TT_PFX}/lib \
	--with-tclinclude=${TT_PFX}/include \
	--with-x=no
make
make SCRIPTS="" install -j1

Rationale Notes

./configure
make install -j1

./configure
make
sed -i.bak \
	's,^PATHS=,&/lib:/usr/lib:,' \
	scripts/fakeroot
make install

Rationale Notes

Note -- Optional Package Management with Pacman

Only install the next 3 packages (Zlib, Libtar and Pacman) if you intend implementing Pacman based package management. Pacman is a simple tar.gz-based package manager for Linux originally written for the Arch Linux distro. Please refer to the gsbuild scripts for a sample Pacman implementation. It's worth noting the author personally uses Pacman which means it receives regular testing within the Reference Build context.

./configure --prefix=${TT_PFX}
make
make install

patch -p1 -i ${TT_PFX}/src/patches/libtar-1.2.11-2.patch
./configure
make
make install

patch -p1 -i ${TT_PFX}/src/patches/pacman-2.9.8-custom-mods-2.patch
patch -p1 -i ${TT_PFX}/src/patches/pacman-2.9.6-temptools-1.patch
patch -p1 -i ${TT_PFX}/src/patches/pacman-2.9.8-sep_install-1.patch
./configure
make
cp -v pacman scripts/makepkg ${TT_PFX}/bin
cp -v etc/{makepkg,pacman}.conf ${TT_PFX}/etc

Note -- Optional Package Management with BPM

Only install the next 3 packages (Ogdlutils, Cpio and BPM) if you intend implementing BPM based package management. BPM is an extremely compact package manager with the simplest spec file format imaginable. It comes from the Bent Linux distro. Please refer to the gsbuild scripts for a sample BPM implementation. BPM only receives occasional testing within the Reference Build context and is included here mainly as a proof of concept. (Note: the gsbuild BPM implementation currently gets some file permissions wrong - FIXME).

make -C c libogdl gpath -j1
cp -v c/gpath ${TT_PFX}/bin

./configure
make
cp -v src/cpio ${TT_PFX}/bin

cp -v bpm{build,install,pkgfix} ${TT_PFX}/bin

rm -rfv ${TT_PFX}/{,share/}{info,man}

As mentioned in the Introduction, Package Management (PM) is a goal of the Reference Build. Accordingly, all build commands in this Chroot phase strive to be "PM friendly". This is reflected in those individual commands associated with file installation. Commands associated with configuring and building remain exactly the same as when performing a "build in place" style installation.

You'll notice that a typical invocation of make install has now become make DESTDIR=$PM_DEST install. The expectation is this: if you're employing PM then you'll assign a value to the PM_DEST variable in your scripting environment that is equivalent to wherever your chosen Package Manager expects to find the installed files. Doing it this way ensures the installation commands remain generic. If you're not employing PM, that is you're performing a usual "build in place" style installation, you just have to ensure that the PM_DEST variable is nonexistent (or empty or unset), then the installation commands will work exactly as if `DESTDIR=$PM_DEST' weren't specified.

Important

Earlier in the Temptools phase we installed a somewhat crippled `su' program from Coreutils (with a missing setuid bit). Therefore, in order to become root and enter the Chroot environment, you must call the host's `su' explicitly by running /bin/su or else you'll fail to gain root privilege. Before entering the chroot environment, be sure to become root using plain `/bin/su'. DO NOT use `/bin/su -' (ie: with the hyphen) because you'll lose the environment variables that are critical for the following chroot command to work as intended. When including this chroot command in your script you'll need to make 2 adjustments: (a) you should omit the $PS1 variable because it is normally unset in non-interactive shells and (b) you'll want to execute a script instead of ${TT_PFX}/bin/bash --login +h (make sure your script does a set +h to switch off hashing).

${TT_PFX}/bin/chroot $SYSROOT \
	${TT_PFX}/bin/env -i \
	HOME=/root \
	PATH=/bin:/usr/bin:/sbin:/usr/sbin:${TT_PFX}/bin \
	PS1='\u-in-chroot:\w\$ ' \
	TERM=${TERM} \
	CONFIG_SITE=/etc/config.site \
	DIY_ARCH=${DIY_ARCH} \
	LC_ALL=C \
	LDFLAGS=${LDFLAGS} \
	${MAKEFLAGS+"MAKEFLAGS=$MAKEFLAGS"} \
	TT_PFX=${TT_PFX} \
	TZ=${TZ} \
	BINUTILS_VER=${BINUTILS_VER} \
	GCC_VER=${GCC_VER} \
	GLIBC_VER=${GLIBC_VER} \
	${TT_PFX}/bin/bash --login +h

mkdir -pv /{bin,etc,home,lib,proc,sys} \
	/dev/{pts,shm} \
	/usr/{bin,include,lib/locale,share/{man,doc,info}} \
	/var/{lock,log,mail,run}
#ln -sv share/{man,doc,info} /usr
install -dvm 0750 /root
install -dvm 1777 {,/var}/tmp

if [ "$DIY_ARCH" = x86_64 ]; then
	ln -sv lib /lib64
	ln -sv lib /usr/lib64
fi

Rationale Notes

test -r /etc/mtab || > /etc/mtab
mount proc /proc -t proc
mount devpts /dev/pts -t devpts
mount shm /dev/shm -t tmpfs
mount sysfs /sys -t sysfs

ln -sv ${TT_PFX}/bin/{bash,cat,echo,pwd} /bin
ln -sv ${TT_PFX}/bin/perl /usr/bin
ln -sv ${TT_PFX}/lib/lib{gcc_s.so.1,stdc++.so.6,fakeroot.so} /usr/lib
ln -sv bash /bin/sh

Rationale Notes

cat > /etc/passwd << "EOF"
root:x:0:0:root:/root:/bin/bash
EOF

cat > /etc/group << "EOF"
root:x:0:
bin:x:1:
sys:x:2:
kmem:x:3:
tty:x:4:
tape:x:5:
daemon:x:6:
floppy:x:7:
disk:x:8:
lp:x:9:
dialout:x:10:
audio:x:11:
utmp:x:12:
EOF

echo "127.0.0.1 localhost $(hostname)" > /etc/hosts

touch /var/run/utmp /var/log/{btmp,lastlog,wtmp}
chmod -v 644 /var/run/utmp /var/log/{btmp,lastlog,wtmp}
chgrp -v utmp /var/run/utmp

cat > $CONFIG_SITE << "EOF"
test "$prefix" = NONE && prefix=/usr
test "$mandir" = '${prefix}/man' && mandir='${prefix}/share/man'
test "$infodir" = '${prefix}/info' && infodir='${prefix}/share/info'
test -z "$CFLAGS" && CFLAGS="-O2 -pipe"
test -z "$CXXFLAGS" && CXXFLAGS=${CFLAGS}
EOF

Rationale Notes

echo "pkgmgr:x:999:" >> /etc/group
echo "pkgmgr2:x:998:pkgmgr" >> /etc/group
echo "pkgmgr:x:999:999::/home/pkgmgr:/bin/bash" >> /etc/passwd
install -dv -o pkgmgr -g pkgmgr /home/pkgmgr

echo "dummy1:x:1000:" >> /etc/group
echo "dummy2:x:1001:dummy" >> /etc/group
echo "dummy:x:1000:1000::/home:/bin/bash" >> /etc/passwd

Rationale Notes

bzcat ${TT_PFX}/src/tarballs/MAKEDEV-1.7.bz2 > $PM_DEST/dev/MAKEDEV
chmod -v 754 $PM_DEST/dev/MAKEDEV
cd $PM_DEST/dev
./MAKEDEV -v generic-nopty

Rationale Notes

rm -fv man3/getspnam.3 man5/passwd.5
make DESTDIR=$PM_DEST install

Rationale Notes

make DESTDIR=$PM_DEST install

	Warning
	As mentioned earlier, the 2.6.18 kernel introduced the next generation method of obtaining sanitized kernel headers. When using the new technique you MUST SKIP the Linux-Libc-Headers step which follows next.

make mrproper
make headers_check || :
make headers_install INSTALL_HDR_PATH=temp
mkdir -pv $PM_DEST/usr
cp -rv temp/include $PM_DEST/usr

patch -p1 -i ${TT_PFX}/src/patches/linux-libc-headers-2.6.12.0-syscalls-3.patch
mkdir -pv $PM_DEST/usr/include
cp -Rv include/asm-${DIY_ARCH} $PM_DEST/usr/include/asm
cp -Rv include/linux $PM_DEST/usr/include

	Proceed with Caution!
	Glibc is possibly the most critical piece of software you will compile in a base Reference Build. There is a high probability of something going wrong. Be sure to heed the advice contained in Section B, “Glibc General Advice” before taking on this monster.

case "$DIY_ARCH" in
  i386)   DL=/lib/ld-linux.so.2; MARCH="-march=i686"
	  [[ $GCC_VER > 4.1.9 ]] && MARCH="$MARCH -mtune=generic" ;;
  ppc)	  DL=/lib/ld.so.1 ;;
  x86_64) DL=/lib64/ld-linux-x86-64.so.2 ;;
esac

sed -i.bak \
	"s|libs -o|libs -L/usr/lib -Wl,-dynamic-linker=${DL} -o|" \
	scripts/test-installation.pl

[[ $GLIBC_VER == 2.4* ]] &&
sed -i.bak \
	'/shlib_handle = NULL/{n;n;n;s/else$/& if (step->__shlib_handle == NULL)/}' \
	iconv/gconv_db.c

[[ $GLIBC_VER > 2.5.9 ]] &&
	patch -p1 -i ${TT_PFX}/src/patches/glibc-2.6-x86-math-tests-1.patch

mkdir ../glibc-build
cd ../glibc-build

CFLAGS="-O3 $MARCH -pipe" ../glibc-${GLIBC_VER}/configure \
	--disable-profile \
	--enable-add-ons \
	--libexecdir=/usr/lib \
	--with-headers=/usr/include \
	--enable-kernel=2.6.0 \
	--enable-bind-now

[[ $GLIBC_VER == 2.3* && $DIY_ARCH == x86_64 ]] &&
	sed -i.bak '/combreloc/s/no/yes/' config.make

make
make -k check || :
make install_root=$PM_DEST install -j1
#make install_root=$PM_DEST localedata/install-locales
cp -v --remove-destination $PM_DEST/usr/share/zoneinfo/${TZ} $PM_DEST/etc/localtime

mkdir -pv $PM_DEST/usr/include/hacks/glibc/bits
cp -v `find ../glibc-${GLIBC_VER} -name stdio-lock.h | grep -v nptl` \
	$PM_DEST/usr/include/hacks/glibc/bits

cat > $PM_DEST/etc/nsswitch.conf << "EOF"
# Begin /etc/nsswitch.conf

passwd: files
group: files
shadow: files

hosts: files dns
networks: files

protocols: files
services: files
ethers: files
rpc: files

# End /etc/nsswitch.conf
EOF

cat > $PM_DEST/etc/ld.so.conf << "EOF"
# Begin /etc/ld.so.conf

/usr/local/lib

# End /etc/ld.so.conf
EOF

Rationale Notes

Tip -- Set up Dual Threading Libraries

Ever since the advent of NPTL most mainstream distros are set up with both NPTL and Linuxthreads enabled Glibc's installed side by side. This is for backwards compatibility reasons. NPTL is still relatively new and a lot of commercial software simply won't run under it. Be sure to check out Section B, “Dual Threading Libraries” if you need this backwards compatibility and want to set up your system to match the distros.

ln -sv ${TT_PFX}/bin/ld-new /usr/bin/ld

case "$DIY_ARCH" in
  i386)   DL=/lib/ld-linux.so.2 ;;
  ppc)	  DL=/lib/ld.so.1 ;;
  x86_64) DL=/lib64/ld-linux-x86-64.so.2 ;;
esac

gcc -dumpspecs | sed \
	-e '/^\*link:$/{n;s,$, -L/usr/lib,}' \
	-e "s,${TT_PFX}${DL},${DL}," \
	-e '/^\*cpp:$/{n;s,$, -isystem /usr/include,}' \
	> /tmp/myspecs

# Sanity checks.
echo 'main(){}' | cc \
	-x c \
	-specs=/tmp/myspecs \
	-B/usr/lib/ \
	-B/usr/bin/ \
	-Wl,--verbose \
	- &> foo

# 1. dynamic linker
readelf -l a.out | grep ": /lib"

# 2. start files
grep " /usr/lib/crt1.o succ" foo

# 3. libc
grep " /lib.*libc.so.6 succ" foo

# 4. deps found from DT_NEEDED
grep "^found.*at /lib.*/ld" foo

rm -fv a.out foo

Caution -- Check your GCC Testsuite Results!

Upon completion of the GCC Testsuite run, sanity check your results by comparing against a set of known good results as per the links in the following table: i686-pc-linux-gnu powerpc-unknown-linux-gnu x86_64-unknown-linux-gnu 4.2.4 4.2.1 FIXME 4.1.2 4.1.2 4.1.1 4.0.4 4.0.4 4.0.3 3.4.6 3.4.6 3.4.6 Note: if you're using GCC-3.4.4 or earlier and running under a 2.6.12 kernel or above, a new kernel feature known as "address space randomization" will likely cause some PCH tests to fail as per these unsatisfactory results. The problem is now resolved in GCC-3.4.5 and above. However, if for some reason you need to use an old GCC version, the problem can be worked around by following the advice contained in this mailing list post.

sed -i.bak \
	's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in

[[ $BINUTILS_VER == 2.18* && $GCC_VER > 4.1.9 && $GLIBC_VER > 2.5.9 ]] &&
	patch -p1 -i ${TT_PFX}/src/patches/gcc-4.2-branch-hash-style-gnu-1.patch

sed -i.bak \
	-e 's,\./fixinc\.sh,-c true,' \
	-e '/^LIBGCC2_DEBUG/d' gcc/Makefile.in

[[ $GCC_VER == 4.* && $DIY_ARCH == i386 ]] &&
	sed -i.bak2 's/^XCFLAGS =$/& -fomit-frame-pointer/' gcc/Makefile.in

[[ $GCC_VER == 4.* ]] &&
	sed -i.bak '/dg-timeout/s/3\|10/20/' libmudflap/testsuite/libmudflap.cth/*.c

mkdir ../gcc-build
cd ../gcc-build

CC="gcc -specs=/tmp/myspecs -B/usr/lib/ -B/usr/bin/" \
	../gcc-${GCC_VER}/configure \
	--libexecdir=/usr/lib \
	--enable-shared \
	--disable-multilib \
	--disable-bootstrap \
	--enable-languages=c,c++ \
	--enable-clocale=gnu \
	--enable-threads=posix \
	--enable-__cxa_atexit

make \
	LDFLAGS=${LDFLAGS} \
	MAKEINFO=makeinfo \
	gcc_cv_prog_makeinfo_modern=yes

make -k check || :
../gcc-${GCC_VER}/contrib/test_summary
make DESTDIR=$PM_DEST install -j1

mkdir -pv $PM_DEST/lib
ln -sfv ../usr/bin/cpp $PM_DEST/lib
ln -sfv gcc $PM_DEST/usr/bin/cc

Rationale Notes

rm -fv etc/standards.info
sed -i.bak '/^INFO/s/standards.info //' etc/Makefile.in
mkdir ../binutils-build
cd ../binutils-build

../binutils-${BINUTILS_VER}/configure \
	--enable-shared
echo "MAKEINFO = makeinfo" >> Makefile
make LDFLAGS=${LDFLAGS} tooldir=/usr
make -k check || :
make tooldir=/usr DESTDIR=$PM_DEST install
cp -v ../binutils-${BINUTILS_VER}/include/libiberty.h $PM_DEST/usr/include

Rationale Notes

./configure \
	--bindir=/bin \
	--enable-html
make
make check
make DESTDIR=$PM_DEST install

sed -i.bak 's,/bin/rm,rm,' lib/blkid/test_probe.in

mkdir build
cd build

../configure \
	--with-root-prefix="" \
	--enable-elf-shlibs
make
make check
make DESTDIR=$PM_DEST install install-libs

Rationale Notes

patch -p1 -i $TT_PFX/src/patches/coreutils-6.12-utimensat-1.patch
sed -i.bak 's,HOME",HOME /dev/shm",' tests/other-fs-tmpdir
sed -i.bak 's/test-getaddrinfo\$(EXEEXT) //' gnulib-tests/Makefile.in

./configure \
	--enable-no-install-program=kill,uptime \
	--enable-install-program=hostname,su
make

if [ `id -u` -eq 0 ]; then
	make NON_ROOT_USERNAME=dummy check-root
	chown -v dummy gnulib-tests/.deps
	su dummy -c "make RUN_EXPENSIVE_TESTS=yes check"
else
	make RUN_EXPENSIVE_TESTS=yes check
fi
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/{bin,usr/sbin}
mv -v $PM_DEST/usr/bin/{cat,chgrp,chmod,chown,cp,date} $PM_DEST/bin
mv -v $PM_DEST/usr/bin/{dd,df,echo,false,hostname,ln,ls} $PM_DEST/bin
mv -v $PM_DEST/usr/bin/{mkdir,mknod,mv,pwd,rm,rmdir,sleep} $PM_DEST/bin
mv -v $PM_DEST/usr/bin/{stty,su,sync,touch,true,uname} $PM_DEST/bin
mv -v $PM_DEST/usr/bin/chroot $PM_DEST/usr/sbin

Rationale Notes

sed -i.bak \
	'/SFL.*fPIC/s/${CFLAGS-"-fPIC -O3"}/"${CFLAGS-"-O3"} -fPIC"/' \
	configure

./configure \
	--prefix=/usr
make
mv -v {,x}libz.a
make clean

./configure \
	--prefix=/usr \
	--shared
make
make check
make prefix=$PM_DEST/usr install
cp -v xlibz.a $PM_DEST/usr/lib/libz.a
mkdir -pv $PM_DEST/lib
mv -v $PM_DEST/usr/lib/libz.so.* $PM_DEST/lib
ln -sfv ../../lib/libz.so.1 $PM_DEST/usr/lib/libz.so

Rationale Notes

make STRIP=yes
make test
make DESTDIR=$PM_DEST install

Rationale Notes

./configure \
	--libexecdir=/usr/lib
make
make check
make DESTDIR=$PM_DEST install

./configure \
	--libexecdir=/usr/lib/locate \
	--localstatedir=/var/lib/locate
make
make check
make DESTDIR=$PM_DEST install

./configure \
	--with-shared \
	--without-debug
make
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/lib
mv -v $PM_DEST/usr/lib/libncurses.so.5* $PM_DEST/lib
ln -sfv ../../lib/libncurses.so.5 $PM_DEST/usr/lib/libncurses.so
ln -sfv libncurses.so $PM_DEST/usr/lib/libcurses.so

patch -p1 -i ${TT_PFX}/src/patches/readline-5.2-official-012-combined-1.patch
./configure \
	bash_cv_func_ctype_nonascii=yes
make SHLIB_LIBS=-lcurses
sed -i.bak '/MV.*old/d' Makefile
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/lib
mv -v $PM_DEST/usr/lib/lib{readline,history}.so.5* $PM_DEST/lib
ln -sfv ../../lib/libhistory.so.5 $PM_DEST/usr/lib/libhistory.so
ln -sfv ../../lib/libreadline.so.5 $PM_DEST/usr/lib/libreadline.so

Rationale Notes

echo '#define SYS_VIMRC_FILE "/etc/vimrc"' >> src/feature.h

./configure
make
make test -j1
mkdir -pv $PM_DEST/etc
make DESTDIR=$PM_DEST install -j1
ln -sfv vim $PM_DEST/usr/bin/vi

cat > $PM_DEST/etc/vimrc << "EOF"
" Begin /etc/vimrc

set nocompatible
set backspace=2
syntax on

" End /etc/vimrc
EOF

Rationale Notes

./configure
make V=1
make check V=1
make DESTDIR=$PM_DEST install

./configure
make
make check
make DESTDIR=$PM_DEST install

./configure \
	--sysconfdir=/etc
make
make DESTDIR=$PM_DEST install

PAGE=A4 ./configure
make -j1
mkdir -pv $PM_DEST/usr
make prefix=$PM_DEST/usr install
ln -sfv soelim $PM_DEST/usr/bin/zsoelim
ln -sfv eqn $PM_DEST/usr/bin/geqn
ln -sfv tbl $PM_DEST/usr/bin/gtbl

./configure
make
make check -j1
make DESTDIR=$PM_DEST install
ln -sfv flex $PM_DEST/usr/bin/lex
ln -sfv libfl.a $PM_DEST/usr/lib/libl.a

./configure
make
make -k check || :
make DESTDIR=$PM_DEST install

Rationale Notes

sed -i.bak \
	-e '/PROGS/s/hostname //' \
	-e '/hostname.*bin/d' \
	Makefile
sed -i.bak 's/in 1 5/in 5/' man/Makefile
sed -i.bak '/default:/d' lib/inet_sr.c
sed -i.bak 's/of(x25/of(struct x25/' lib/x25_sr.c

yes "" | make config
make LOPTS=${LDFLAGS} -j1
make BASEDIR=$PM_DEST update

sed -i.bak '/man_MANS =/d' \
	{ftpd,inetd,logger,rexecd,rlogind,rshd,syslogd,talkd,telnetd,tftpd}/Makefile.in

./configure \
	--disable-servers \
	--disable-hostname \
	--disable-logger \
	--disable-whois \
	--disable-ifconfig \
	--libexecdir=/usr/sbin
make
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/bin
mv -v $PM_DEST/usr/bin/ping $PM_DEST/bin

make
make DESTDIR=$PM_DEST ldconfig=: install

sed -i.bak \
	"/if grep/a skip \"not testing setlogsock('stream'): _PATH_LOG unavailable\", 10 \
	unless -e Sys::Syslog::_PATH_LOG();" \
	ext/Sys/Syslog/t/syslog.t

./configure.gnu \
	-Dpager="/usr/bin/less -isR"

make BUILD_ZLIB=False
make test
make DESTDIR=$PM_DEST install

Rationale Notes

[[ $GLIBC_VER > 2.5.9 ]] &&
	sed -i.bak 's/futimens/gl_&/' gzip.c lib/utimens.{c,h}

./configure
make bindir=/bin
make check
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/bin
mv -v $PM_DEST/usr/bin/{gunzip,gzip,zcat} $PM_DEST/bin

Rationale Notes

./configure
make
make check
make DESTDIR=$PM_DEST install

./configure \
	--bindir=/bin \
	--without-included-regex
make
make check
make DESTDIR=$PM_DEST install

./configure
make
make check
make DESTDIR=$PM_DEST install

./configure
make
make check
make DESTDIR=$PM_DEST install

./configure
make
make check
make DESTDIR=$PM_DEST install

./configure
make
make -k check || :
make DESTDIR=$PM_DEST install

	Important
	The Bash testsuite is unlike most others in that it doesn't stop if errors are encountered. This means you have to physically examine the output and cannot rely on the exit status of the `make tests' command. It even tells you as much at the beginning of the run: "Any output from any test, unless otherwise noted, indicates a possible anomaly".

patch -p1 -i ${TT_PFX}/src/patches/bash-3.2-official-039-combined-1.patch
echo '#define NON_INTERACTIVE_LOGIN_SHELLS' >> config-top.h
./configure \
	--without-bash-malloc \
	--with-installed-readline
make

sed -i '/THIS/s,1$,1 </dev/tty,' tests/run-test

if [ `id -u` -eq 0 ]; then
	chown -R dummy .
	su dummy -c "make tests"
else
	make tests
fi
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/bin
mv -v $PM_DEST/usr/bin/bash $PM_DEST/bin

Rationale Notes

sed -i.bak \
	-e 's,X)/man,X)/share/man,g' \
	-e '/ln .*PREFIX/s,$(PREFIX)/bin/,,' \
	Makefile

make -f Makefile-libbz2_so
make clean
make
make PREFIX=$PM_DEST/usr install
mkdir -pv $PM_DEST/{bin,lib}
cp -v bzip2-shared $PM_DEST/bin/bzip2
cp -av libbz2.so* $PM_DEST/lib
ln -sfv ../../lib/libbz2.so.1.0 $PM_DEST/usr/lib/libbz2.so
rm -fv $PM_DEST/usr/bin/{bunzip2,bzcat,bzip2}
ln -sfv bzip2 $PM_DEST/bin/bunzip2
ln -sfv bzip2 $PM_DEST/bin/bzcat

Rationale Notes

./configure
make
make DESTDIR=$PM_DEST install

./configure \
	--prefix=/usr \
	--bindir=/bin
make
make check
make DESTDIR=$PM_DEST install

sed -i.bak \
	's/ifdef OPTIONAL_PROGS/ifeq ($(OPTIONAL_PROGS),yes)/' \
	man/Makefile.in

sed -i.bak \
	's,@datadir@,&/kbd,' \
	{src,data}/Makefile.in

./configure \
	--enable-nls
make KEYCODES_PROGS=yes RESIZECONS_PROGS=yes
make KEYCODES_PROGS=yes RESIZECONS_PROGS=yes DESTDIR=$PM_DEST install

Rationale Notes

sed -i.bak 's/-is/&R/' configure
sed -i.bak 's%MANPATH./usr/man%#&%' src/man.conf.in
./configure \
	-default \
	-confdir=/etc
make
make DESTDIR=$PM_DEST install

./configure
make
make check
make DESTDIR=$PM_DEST install

./configure
make check DOCBOOKTOMAN=:
make maintainer-clean
patch -p1 -i $TT_PFX/src/patches/module-init-tools-3.4-manpages-1.patch

./configure --exec-prefix=/ --enable-zlib
make
make INSTALL=install DESTDIR=$PM_DEST install

Rationale Notes

./configure
make
make prefix=$PM_DEST/usr install

./configure
make
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/bin
mv -v $PM_DEST/usr/bin/{fuser,killall} $PM_DEST/bin

[[ $GLIBC_VER == 2.3* ]] &&
	sed -i.bak '1i #include <sys/types.h>' lib/{pw,group}io.h

./configure \
	--sysconfdir=/etc
make

find man -name Makefile | \
	xargs sed -i.bak \
		-e 's/groups\.1 //' \
		-e 's/su\.1\( \|$\)//' \
		-e 's/suauth\.5 //'
make DESTDIR=$PM_DEST bin_PROGRAMS=login suidbins= install
sed -i \
	-e 's%/var/spool/mail%/var/mail%' \
	-e 's%#MD5_CRYPT_ENAB.no%MD5_CRYPT_ENAB yes%' \
	$PM_DEST/etc/login.defs
sed -i \
	-e '/MAIL/s,yes,no,' \
	$PM_DEST/etc/default/useradd
mv -v $PM_DEST/usr/bin/passwd $PM_DEST/bin

Rationale Notes

make
mkdir -pv $PM_DEST/{etc,usr/{share/man/man{5,8},sbin}}
make prefix=$PM_DEST install

cat > $PM_DEST/etc/syslog.conf << "EOF"
# Begin /etc/syslog.conf

auth,authpriv.* -/var/log/auth.log
*.*;auth,authpriv.none -/var/log/sys.log
daemon.* -/var/log/daemon.log
kern.* -/var/log/kern.log
mail.* -/var/log/mail.log
user.* -/var/log/user.log
*.emerg *

# End /etc/syslog.conf
EOF

make -C src
mkdir -pv $PM_DEST/{{,s}bin,etc,usr/{{bin,include},share/man/man{1,5,8}}}
make -C src ROOT=$PM_DEST install

cat > $PM_DEST/etc/inittab << "EOF"
# Begin /etc/inittab
id:3:initdefault:

si::sysinit:/etc/rc.d/init.d/rc sysinit

l0:0:wait:/etc/rc.d/init.d/rc 0
l1:S1:wait:/etc/rc.d/init.d/rc 1
l2:2:wait:/etc/rc.d/init.d/rc 2
l3:3:wait:/etc/rc.d/init.d/rc 3
l4:4:wait:/etc/rc.d/init.d/rc 4
l5:5:wait:/etc/rc.d/init.d/rc 5
l6:6:wait:/etc/rc.d/init.d/rc 6

ca:12345:ctrlaltdel:/sbin/shutdown -t1 -a -r now

su:S016:once:/sbin/sulogin

1:2345:respawn:/sbin/agetty tty1 9600
2:2345:respawn:/sbin/agetty tty2 9600
3:2345:respawn:/sbin/agetty tty3 9600
4:2345:respawn:/sbin/agetty tty4 9600
5:2345:respawn:/sbin/agetty tty5 9600
6:2345:respawn:/sbin/agetty tty6 9600
# End /etc/inittab
EOF

./configure \
	--bindir=/bin \
	--libexecdir=/usr/sbin
make
make check
make DESTDIR=$PM_DEST install

sed -i.bak \
	's@etc/adjtime@var/lib/hwclock/adjtime@' \
	hwclock/hwclock.c

./configure \
	--enable-arch \
	--enable-write \
	--disable-wall
make
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/var/lib/hwclock

Rationale Notes

sed -i.bak '/ufs2/d' stage2/size_test
patch -p1 -i $TT_PFX/src/patches/grub-0.97-ext-256byte-inode-1.patch

./configure default_CFLAGS=yes
make
make check
make DESTDIR=$PM_DEST install
mkdir -pv $PM_DEST/boot/grub
cp -v $PM_DEST/usr/lib/grub/i386-pc/stage{1,2} $PM_DEST/boot/grub

Rationale Notes

sed -i 's@usr/local@usr@' Makefile etc/yaboot.conf man/*
make
make ROOT=$PM_DEST MANDIR=share/man install

patch -p1 -i ${TT_PFX}/src/patches/mac-fdisk-0.1.orig-debian-2.patch
make
mkdir -pv $PM_DEST/sbin
make DESTDIR=$PM_DEST install

./configure
make
mkdir -pv $PM_DEST/usr/{bin,share/man/man1}
make prefix=$PM_DEST/usr install

sed -i.bak 's,${srcdir}/tartest,true,' test/t.tar
./configure
make
make check
make DESTDIR=$PM_DEST install

	Note -- Optional Package Management with Pacman
	As mentioned earlier in the Temptools phase, you only need the next 2 packages (Libtar and Pacman) if you've implemented Pacman based package management.

patch -p1 -i ${TT_PFX}/src/patches/libtar-1.2.11-2.patch
./configure
make
make DESTDIR=$PM_DEST install

patch -p1 -i ${TT_PFX}/src/patches/pacman-2.9.8-custom-mods-2.patch
patch -p1 -i ${TT_PFX}/src/patches/pacman-2.9.8-sep_install-1.patch
./configure
make
make DESTDIR=$PM_DEST install

	Note -- Optional Package Management with BPM
	As mentioned earlier in the Temptools phase, you only need the next 3 packages (Ogdlutils, Cpio and BPM) if you've implemented BPM based package management.

make -C c libogdl gpath -j1
mkdir -pv $PM_DEST/usr/bin
cp -v c/gpath $PM_DEST/usr/bin

./configure \
	--enable-mt \
	--with-rmt=/usr/sbin/rmt
make
make check
make DESTDIR=$PM_DEST rmtdir= install

make DESTDIR=$PM_DEST install