Index: third_party/libxml/src/VxWorks/README |
diff --git a/third_party/libxml/src/VxWorks/README b/third_party/libxml/src/VxWorks/README |
new file mode 100644 |
index 0000000000000000000000000000000000000000..b7566770897ed23e74ada82a2108886207084ba4 |
--- /dev/null |
+++ b/third_party/libxml/src/VxWorks/README |
@@ -0,0 +1,86 @@ |
+ libxml2 on VxWorks 6.4+ |
+ |
+Here are my instructions for building on VxWorks.... I am very ashamed of |
+how I did this because it is a complete hack, but it works great, so I |
+can't complain too much. |
+ |
+General Information |
+ |
+1. The only way to build for VxWorks is to cross compile from a windows or |
+linux system. We use a RedHat 5.1 workstation system as our build |
+environment. |
+ |
+2. VxWorks 6.X has two main types of executable, DKMs (dynamic kernel |
+modules), and RTPs (real-time processes). Kernel modules are the bread |
+and butter of VxWorks, but they look nothing like processes/threads in |
+normal UNIX/Windows systems. RTPs are more like processes that have |
+memory protection, threads, etc. VxWorks 6.X also introduces some level |
+of POSIX conformance to their environment. The POSIX conformance was the |
+key for us to be able to port libxml2. We support accessing libxml2 from |
+both DKMs and RTPs. |
+ |
+3. There are 2 compilers for VxWorks, the WindRiver compiler, and a port |
+of the GNU toolchain, we have only tested and built with the GNU |
+toolchain. |
+ |
+How To Build |
+ |
+1. Run the configure on your native linux system (this is the cheesy |
+hack). Since the VxWorks GNU toolchain is very close in version to the |
+one in red hat, it generates a good config.h file. We configured libxml2 |
+with the following to keep the size down, (but we have done basic testing |
+with everything compiled in). |
+ |
+./configure --with-minimum --with-reader --with-writer --with-regexps |
+--with-threads --with-thread-alloc |
+ |
+2. Rename the libxml2 folder to "src". This step is required for our |
+replacement makefile to work. |
+ |
+3. Run the replacement makefile. I wrote a new makefile that sets all the |
+proper vxworks defines and uses the correct compilers. The two defines on |
+the make command line are to tell it which VxWorks Target (SH3.2 little |
+endian), and the executable type. We have tested this code on PENTIUM2gnu |
+and SH32gnule. |
+ |
+This makefile creates a shared library that runs on VxWorks: (libxml2.so) |
+make -f Makefile.vxworks clean all VXCPU=SH32gnule VXTYPE=RTP |
+ |
+This makefile creates a kernel module that runs on VxWorks: (xml2.out) |
+make -f Makefile.vxworks clean all VXCPU=SH32gnule VXTYPE=DKM |
+ |
+Important Notes |
+ |
+1. There are several ways that this process could be improved, but at the |
+end of the day, we make products, not port libraries, so we did a meets |
+minimum for our needs. |
+ |
+2. VxWorks is the devil, give me embedded linux every day. |
+ |
+3. No matter what I tried, I couldn't get the configure to pick up the |
+VxWorks toolchain, and in my investigation, it has something to do with |
+automake/autoconf, not any individual package. VxWorks doesn't play by |
+the normal rules for building toolchains. |
+ |
+4. The PIC flag in VxWorks (especially for SH processors) is very |
+important, and very troublesome. On linux, you can liberally use the PIC |
+flag when compiling and the compiler/linker will ignore it as needed, on |
+VxWorks if must always be on for shared libraries, and always be off for |
+static libraries and executables. |
+ |
+5. If anyone wants to work on a better way to do the build of libxml2 for |
+VxWorks, I'm happy to help as much as I can, but I'm not looking to |
+support it myself. |
+ |
+Attached Files |
+ |
+1. To use my Makefile for vxworks, you should enter the vxworks |
+environment (/opt/windriver/wrenv.linux -p vxworks-6.4 for me). |
+2. Run: build.sh libxml2-2.6.32 SH32gnule RTP (where you have |
+libxml2-2.6.32.tar.gz and the Makefile in the same directory as the script |
+file). |
+ |
+Thanks, |
+ |
+Jim Wert Jr. |
+JWert@ILSTechnology.com |