changeset 706:4ff4cf117082

Add "description" files to each target, move settings comments (if any) into them, then fluff descriptions out a bit.
author Rob Landley <rob@landley.net>
date Tue, 07 Apr 2009 21:30:08 -0500
parents 04109e3f877e
children b95220513049
files sources/targets/armv4eb/description sources/targets/armv4l/description sources/targets/armv5l/description sources/targets/armv5l/settings sources/targets/armv6l/description sources/targets/hw-uml/description sources/targets/hw-wrt610n/description sources/targets/i586/description sources/targets/i586/settings sources/targets/i686/description sources/targets/i686/settings sources/targets/m68k/description sources/targets/m68k/settings sources/targets/mips/description sources/targets/mips/settings sources/targets/mipsel/description sources/targets/mipsel/settings sources/targets/powerpc-440fp/description sources/targets/powerpc-440fp/settings sources/targets/powerpc/description sources/targets/powerpc/settings sources/targets/sh4/description sources/targets/sparc/description sources/targets/sparc/settings sources/targets/x86_64/description
diffstat 25 files changed, 97 insertions(+), 24 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/armv4eb/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,6 @@
+ARM v4 big endian, soft float, OABI.
+
+Although arm processors can work with either endianness, most ARM boards are
+wired little endian, so building big endian arm is fairly uncommon.  The
+ixp4xx, ixp2000, and ixp23xx are the only current Linux targets to support
+big endian operation.
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/armv4l/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,16 @@
+ARM v4, little endian, soft float, OABI.
+
+This is the "i386 of ARM".  It's an extremely generic arm image that should run
+on any arm hardware still in use today (except ARMv7M, which is arm in name
+only).
+
+Note: and ARMv5 capable processor can run ARMv4 binaries, ARMv6 can run ARMv5,
+and so on.  Each new architecture is a superset of the old ones, and the main
+reason to compile for newer platforms is efficiency (faster speed, better
+battery life).
+
+The oldest architecture this compatability goes back to is ARMv3 (which
+introduced 32-bit addressing), but that hardware is obsolete (not just no
+longer being sold, but mostly cycled out of the installed base).
+
+For details, see http://www.arm.com/products/CPUs/architecture.html
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/armv5l/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,10 @@
+ARM v5, little endian, EABI with vector floating point (vfp).
+
+This is the "pentium" of arm.  Again, most modern arm hardware should be
+able to run this.
+
+Hardware that supports the v5 instruction set should run this about 25% faster
+than code compiled for v4, without consuming noticeably more electricity to do
+so.
+
+See http://www.arm.com/products/CPUs/architecture.html for details.
--- a/sources/targets/armv5l/settings	Tue Apr 07 19:48:56 2009 -0500
+++ b/sources/targets/armv5l/settings	Tue Apr 07 21:30:08 2009 -0500
@@ -1,7 +1,3 @@
-# ARMv5 with vector floating point (vfp).  Should run about 25% faster than
-# the armv4 image for integer stuff, and faster than that for floating point.
-# Assuming you have at least ARMv5 hardware (which most stuff sold today is).
-
 KARCH=arm
 KERNEL_PATH=arch/${KARCH}/boot/zImage
 GCC_FLAGS="--with-march=armv5 --with-mfloat-abi=soft --with-mfp=vfp --disable-sjlj-exceptions"
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/armv6l/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,8 @@
+ARM v6, little endian, EABI with vector floating point (vfp).
+
+This is a fairly recent ARM architecture (introduced 2001, actually shipped
+silicon around 2003).  This hardware can still run v4 and v5 instruction sets,
+but v6 is targeted to the newer stuff and should run more efficiently (faster
+prformance/better battery life).
+
+See http://www.arm.com/products/CPUs/architecture.html for details.
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/hw-uml/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,3 @@
+User Mode Linux (based on i686)
+
+This is a Linux kernel built to run as a normal userspace process.
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/hw-wrt610n/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,11 @@
+Linksys WRT610n.
+
+A small blue mips-based router.
+
+This doesn't actually work yet, because the kernel doesn't fully support this
+hardware without more patches, and trx image packaging needs an additional
+32 byte header before the router's installer and bootloader will accept it.
+
+TODO
+
+See http://www.linksysbycisco.com/US/en/products/WRT610N
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/i586/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,5 @@
+An i586 board, such as the original Pentium/Pentium Pro/Pentium II/Via Samuel
+
+This demonstrates how creating code which runs on the host can still be cross
+compiling, because the target may only support a subset of the host's
+instruction set.
--- a/sources/targets/i586/settings	Tue Apr 07 19:48:56 2009 -0500
+++ b/sources/targets/i586/settings	Tue Apr 07 21:30:08 2009 -0500
@@ -1,8 +1,3 @@
-# An i586 board, to demonstrate that code that runs on the host can still be
-# cross compiling.
-
-# This should run on an original Pentium or Pentium Pro, which i686 code won't.
-
 KARCH=i386
 KERNEL_PATH=arch/${KARCH}/boot/bzImage
 BINUTILS_FLAGS=
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/i686/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,1 @@
+Standard x86 target, Pentium 3 or later.
--- a/sources/targets/i686/settings	Tue Apr 07 19:48:56 2009 -0500
+++ b/sources/targets/i686/settings	Tue Apr 07 21:30:08 2009 -0500
@@ -1,5 +1,3 @@
-# Standard x86 target.
-
 KARCH=i386
 KERNEL_PATH=arch/${KARCH}/boot/bzImage
 BINUTILS_FLAGS=
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/m68k/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,9 @@
+Motorola 68000.
+
+This builds, but qemu can't run it yet.  (The qemu m68k support is actually
+only coldfire, an mmu-less subset of the m68k instruction set.)
+
+The aranym emulator might be able to run this (with a different kernel
+configuration) but that emulator doesn't support serial consoles.
+
+TODO
--- a/sources/targets/m68k/settings	Tue Apr 07 19:48:56 2009 -0500
+++ b/sources/targets/m68k/settings	Tue Apr 07 21:30:08 2009 -0500
@@ -1,6 +1,3 @@
-# XXX Status: builds but can't test it, need a kernel .config and matching emulator.
-# The current kernel miniconfig is based on defconfig (aimed at the Amiga).
-
 KARCH=m68k
 KERNEL_PATH=vmlinux
 GCC_FLAGS="--enable-sjlj-exceptions" # "--with-float=soft"
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/mips/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,1 @@
+Mips r4k big endian.
--- a/sources/targets/mips/settings	Tue Apr 07 19:48:56 2009 -0500
+++ b/sources/targets/mips/settings	Tue Apr 07 21:30:08 2009 -0500
@@ -1,5 +1,3 @@
-# Mips r4k big endian
-
 KARCH=mips
 KERNEL_PATH=vmlinux
 BINUTILS_FLAGS=
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/mipsel/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,1 @@
+Mips r4k little endian
--- a/sources/targets/mipsel/settings	Tue Apr 07 19:48:56 2009 -0500
+++ b/sources/targets/mipsel/settings	Tue Apr 07 21:30:08 2009 -0500
@@ -1,5 +1,3 @@
-# Mips r4k little endian
-
 KARCH=mips
 KERNEL_PATH=vmlinux
 BINUTILS_FLAGS=
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/powerpc-440fp/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,1 @@
+Power PC 440, with hardware floating point.
--- a/sources/targets/powerpc-440fp/settings	Tue Apr 07 19:48:56 2009 -0500
+++ b/sources/targets/powerpc-440fp/settings	Tue Apr 07 21:30:08 2009 -0500
@@ -1,5 +1,3 @@
-# Power PC system
-
 source "$CONFIG_DIR/powerpc/settings"
 
 CROSS_TARGET=powerpc-unknown-linux
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/powerpc/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,11 @@
+Power PC, 32 bit
+
+Generic Power PC system, a basic unoptimized instruction set which
+just about any powerpc should be able to run.
+
+The main exceptions are the 440 and 880 lines, which were stripped down
+versions of the powerpc (created by IBM and Motorola, respectively) targetted
+at battery powered devices such as cell phones.  They do not support the entire
+powerpc instruction set.  (Alas, the two chose _different_ subsets, so they
+don't run each other's code either.  The 880 is mostly dead today, but the
+440 is alive and well.)
--- a/sources/targets/powerpc/settings	Tue Apr 07 19:48:56 2009 -0500
+++ b/sources/targets/powerpc/settings	Tue Apr 07 21:30:08 2009 -0500
@@ -1,5 +1,3 @@
-# Power PC system
-
 KARCH=powerpc
 KERNEL_PATH=vmlinux
 GCC_FLAGS="--enable-sjlj-exceptions"
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/sh4/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,4 @@
+The Super Hitachi processor is fairly popular in Japan, and winds up in things
+like the Sega Dreamcast and automobile onboard computers.
+
+There's a wiki about it at http://linux-sh.org
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/sparc/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,7 @@
+32-bit sparc
+
+Sparc was a risc processor design Sun Microsystems came up with to replace
+m68k in their Unix workstations.  With the advent of OpenSolaris and
+x86-64, Fujitsu mainframes may now use more of it than they do.
+
+This has been broken for a couple years, and nobody's bothered to fix it.
--- a/sources/targets/sparc/settings	Tue Apr 07 19:48:56 2009 -0500
+++ b/sources/targets/sparc/settings	Tue Apr 07 21:30:08 2009 -0500
@@ -1,5 +1,3 @@
-# Status: Builds but doesn't run, due to bugs in uClibc 0.9.29 for sparc.
-
 # Originally contributed by Bertl.
 
 KARCH=sparc
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sources/targets/x86_64/description	Tue Apr 07 21:30:08 2009 -0500
@@ -0,0 +1,3 @@
+64 bit x86.
+
+Modern standard PC architecture.  Runs i686 code as well.