summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>1997-01-29 15:35:13 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>1997-01-29 15:35:13 +0000
commitcd912a09aef583a1c4a631a0471515fdac944d65 (patch)
tree8861ef9966ec54751285c59a240101b18d26bb62
parentFixed this where it works. It includes the libpc.a and libc.a from (diff)
downloadrtems-cd912a09aef583a1c4a631a0471515fdac944d65.tar.bz2
new file explaining issues related to this bsp.
-rw-r--r--c/src/lib/libbsp/i386/go32/README38
1 files changed, 38 insertions, 0 deletions
diff --git a/c/src/lib/libbsp/i386/go32/README b/c/src/lib/libbsp/i386/go32/README
new file mode 100644
index 0000000000..fa0d3efd29
--- /dev/null
+++ b/c/src/lib/libbsp/i386/go32/README
@@ -0,0 +1,38 @@
+#
+# $Id$
+#
+
+1. This is based on djgpp v1.x which has been superceded. That version
+ is still available but is no longer supported. It would be greatly
+ appreciated if someone would update this bsp to the current version.
+
+2. In general the regular instructions for building a cross GNU toolset
+ apply to the i386-go32-rtems toolset. However, you will need some items
+ from the djgpp distribution. Here is the list of djgpp files we use:
+
+ djeoe112.zip - files required on target PC
+ djdev112.zip - libraries and include files required on host
+
+3. We attempt to minimize what we copy into our built and installed GNU
+ toolset from the binary distribution of the GNU tools. Here is what
+ we do by hand. You will need to localize this to meet your directory
+ structure. All paths are starting at the toolset install point.
+
+ a. Copy go32.h, dpmi.h, dos.h. and pc.h in the i386-go32-rtems/include
+ directory. These files only include sys/types.h and newlib has that.
+
+ b. copy crt0.o to i386-go32-rtems/gcc-lib/i386-go32-rtems/2.7.2
+ c. copy libc.a to i386-go32-rtems/gcc-lib/i386-go32-rtems/2.7.2/libcgo32.a
+ d. copy libpc.a to i386-go32-rtems/gcc-lib/i386-go32-rtems/2.7.2/libpc.a
+
+ It is almost a certainty that libcgo32.a and libpc.a have symbols and
+ routines which duplicate those in newlib. In post 3.6.0 RTEMS versions,
+ the --start-group and --end-group GNU ld options are used to group
+ the non-GO32 supplied libraries. This attempts to resolve every symbolic
+ reference from RTEMS specific libraries before getting them from
+ GO32 libraries.
+
+4. This configuration is built on a UNIX host by the RTEMS Team using
+ cross configurations of the tools. Building it under DOS requires
+ special effort.
+