Updated READMEs with the MIPS platform.

diff --git a/README b/README
index b959ba4..c273853 100644 (file)
--- a/README
+++ b/README
@@ -33,6 +33,7 @@ pc86          produces bootable floppy disk images for 8086 PCs
 linux386      produces ELF executables for PC Linux systems
 linux68k      produces ELF executables for m68020 Linux systems
 linuxppc      produces ELF executables for PowerPC Linux systems
+linuxmips     produces ELF executables for little-endian MIPS32r2 Linux systems
 cpm           produces i80 CP/M .COM files
 rpi           produces Raspberry Pi GPU binaries
 pdpv7         produces PDP/11 V7 Unix binaries
@@ -194,4 +195,4 @@ Please enjoy.
 
 David Given (davidgiven on Github)
 dg@cowlark.com
-2016-11-26
+2018-09-18

diff --git a/plat/linuxmips/README b/plat/linuxmips/README
new file mode 100644 (file)
index 0000000..ab294db
--- /dev/null
+++ b/plat/linuxmips/README
@@ -0,0 +1,37 @@
+The linuxmips platform
+======================
+
+linuxmips is a little-endian MIPS32r2 BSP that produces Linux MIPS executables.
+
+This port only implements a very limited number of system calls; basically,
+just enough to make the demo apps run. Adding more is easy, but there are some
+subtleties that require more thought. The port should be considered only in
+proof-of-concept stage right now.
+
+Important note: you *can't* link access ELF shared libraries from these
+executables. In other words, you have to all your work from inside ACK.
+
+IEEE floating point is available, but requires an FPU.
+
+The executables are generated with aelfslod and are extremely simple; there's
+one rwx ELF section which contains all the application's code and data. This
+is not optimal, but it does work. Symbols are provided.
+
+
+Bugs
+====
+
+isatty() is a stub and always returns 0.
+
+
+Example command line
+====================
+
+ack -mlinuxmips -O -o linuxmips.exe examples/paranoia.c
+
+The file linuxmips.exe can then be run on a MIPS32r2 Linux machine (or on an
+emulation thereof).
+
+
+David Given
+dg@cowlark.com