Mercurial > hg > aboriginal
changeset 928:0291e9591d18
Update downloads/binaries/README
author | Rob Landley <rob@landley.net> |
---|---|
date | Tue, 08 Dec 2009 20:22:53 -0600 |
parents | e546c8767a0e |
children | 0f180c5006e0 |
files | www/downloads/binaries/README |
diffstat | 1 files changed, 34 insertions(+), 30 deletions(-) [+] |
line wrap: on
line diff
--- a/www/downloads/binaries/README Tue Dec 08 18:12:16 2009 -0600 +++ b/www/downloads/binaries/README Tue Dec 08 20:22:53 2009 -0600 @@ -5,54 +5,58 @@ The following tarballs are found here: -cross-compiler-ARCH.tar.bz2 - - Statically linked cross compilers which creates target binaries for - a given architecture (linked against uClibc). +cross-compiler-$ARCH.tar.bz2 - To use, extract this tarball and add its "bin" subdirectory to your $PATH, - then use the appropriate ARCH-gcc as your compiler name. - -cross-static-ARCH.tar.bz2 + C and C++ Cross compilers, which create target binaries for each + architecture, linked against uClibc (and uClibc++ for C++ source). - Same as the above cross-compiler tarballs, only built to run on an i686 - host and statically linked (against uClibc, this time on the host) for - maximum portability between PC Linux distributions. + To use, extract this tarball anywhere and add its "bin" subdirectory to + your $PATH, then use the appropriate $ARCH-gcc as your target compiler. - These versions include uClibc++, to support C++. Note that the i686 and - x86_64 targeted cross compilers allow you to build binaries linked against - uClibc/uClibc++ with minimal preparation. + These are built for an i686 host and statically linked against uClibc, + for maximum portability between PC Linux distributions. Includes uClibc++ + (to support C++), and thread support. -root-filesystem-ARCH.tar.bz2 +root-filesystem-$ARCH.tar.bz2 Native Linux root filesystem for a given target, suitable for chrooting into (on appropriate hardware) or packaging up into a bootable system image. It contains busybox, uClibc, a simple boot script (usr/sbin/init.sh), and a native toolchain with which to build additional target binaries from source. -native-compiler-ARCH.tar.bz2 +native-compiler-$ARCH.tar.bz2 Statically linked version of the native compiler from root-filesystem, which you can extract and run on an appropriate target the same way you can extract and run the cross-compiler on the host. - You don't need this when using FWL's root filesystem images, it provides - a native compiler for use with existing target filesystems. Again, - linking binaries against uClibc/uClibc++. + You don't need this when using FWL's root filesystem images, which provide + their own native compiler. This is provided for use with existing target + filesystems. system-image-ARCH.tar.bz2 Prepackaged bootable system images image for each target. - This includes the above root-filesystem files (packaged as either ext2 or - squashfs filesystem images), an appropriately configured Linux kernel, - and a wrapper script to invoke the emulator QEMU on them. Running the - wrapper script should produce a shell prompt on the emulator's stdin/stdout - connected to the emulated system's /dev/console. + The above root-filesystem files packaged into a squashfs image, plus + an appropriately configured Linux kernel, and a wrapper script to + invoke the emulator QEMU on the two of them. + + This allows you to compile additional packages natively under QEMU. + Just wget the source tarball and build it normally. + + The run-emulator.sh wrapper script should produce a shell prompt, with + the emulator's stdin/stdout connected to the emulated system's + /dev/console. See the screenshots page for examples. - This allows you to compile additional packages natively, generally under - QEMU. (Just wget the source tarball and build it normally.) See the file - "run-from-build.sh" in the FWL source tarball for an example of how to set - up a working native development environment with a writeable 2 gigabyte - disk image (mounted on /home) and optionally use distcc to call out to the - cross compiler to accelerate the native builds. + The dev-environment.sh script calls run-emulator.sh with a few extra + arguments to provide a better development environment (namely a 2 gigabyte + writeable ext2 image mounted on /home and 256 megs of memory for the + emulated system). + + If distccd and the appropriate $ARCH-cc cross compiler are the $PATH, + run-emulator.sh will automatically set up distcc to call out through the + virtual network to the host's $ARCH-cc, to move the heavy lifting of + compilation outside the emulator, and also take advantage of SMP. (Doing + so does not require the package being built to be cross compile aware. + The emulated build is still a simple single-context native build.)