Bug 681: Add Basic ELF Header + ARM EABI Section Parsing, allowing to distinguish ARM soft-float/hard-float (part-1)

https://jogamp.org/bugzilla/show_bug.cgi?id=681

+ * References:
+ * <ul>
+ *   <li>http://linux.die.net/man/5/elf</li>
+ *   <li>http://www.sco.com/developers/gabi/latest/contents.html</li>
+ *   <li>http://infocenter.arm.com/
+ *   <ul>
+ *      <li>ARM IHI 0044E, current through ABI release 2.09</li>
+ *      <li>ARM IHI 0045D, current through ABI release 2.09</li>
+ *   </ul></li>

Added self contained jogamp.common.os.elf package w/ entry point class ElfHeader
to read a RandomAccessFile and parse it as an ELF file.

ELF Parsing completness:
  - Header: OK
  - SectionHeader: OK
  - Section Type SHT_ARM_ATTRIBUTES: OK
     - Will be read into SectionArmAttributes
     - Used to distinguisgh soft/hard VFP float

Tested manually on:
  - Linux intel 32bit / 64bit, arm soft-float and hard-float

1 files changed, 119 insertions, 0 deletions

diff --git a/src/junit/com/jogamp/common/os/TestElfReader01.java b/src/junit/com/jogamp/common/os/TestElfReader01.java
new file mode 100644
index 0000000..fe6adc2
--- /dev/null
+++ b/src/junit/com/jogamp/common/os/TestElfReader01.java
@@ -0,0 +1,119 @@
+package com.jogamp.common.os;
+
+import java.io.BufferedOutputStream;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.OutputStream;
+import java.io.RandomAccessFile;
+
+import jogamp.common.os.elf.ElfHeader;
+import jogamp.common.os.elf.Section;
+import jogamp.common.os.elf.SectionArmAttributes;
+import jogamp.common.os.elf.SectionHeader;
+
+import org.junit.Test;
+
+import com.jogamp.junit.util.JunitTracer;
+
+public class TestElfReader01 extends JunitTracer {
+    public static String GNU_LINUX_SELF_EXE = "/proc/self/exe";
+    public static String ARM_HF_EXE = "tst-exe-armhf";
+    public static String ARM_SF_EXE = "tst-exe-arm";
+    
+    @Test
+    public void testGNULinuxSelfExe () throws IOException {
+        testElfHeaderImpl(GNU_LINUX_SELF_EXE, false);
+    }
+    
+    // @Test
+    public void testArmHFExe () throws IOException {
+        testElfHeaderImpl(ARM_HF_EXE, false);
+    }
+    
+    // @Test
+    public void testArmSFExe () throws IOException {
+        testElfHeaderImpl(ARM_SF_EXE, false);
+    }
+    
+    void testElfHeaderImpl(String file, boolean fileOutSections) throws IOException {
+        RandomAccessFile in = new RandomAccessFile(file, "r");
+        try {
+            ElfHeader eh = ElfHeader.read(in);            
+            byte[] e_ident = eh.d.getE_ident();
+            int i=0;
+            System.err.print("[0..4]: 0x"+toHexString(e_ident[i++]));
+            System.err.print(", 0x"+toHexString(e_ident[i++]));
+            System.err.print(", 0x"+toHexString(e_ident[i++]));
+            System.err.println(", 0x"+toHexString(e_ident[i++]));
+            System.err.println("e_class      "+e_ident[ElfHeader.EI_CLASS]+", "+eh.getArchClassBits()+" bits");
+            System.err.println("e_data       "+e_ident[ElfHeader.EI_DATA]+", "+eh.getDataEncodingMode());
+            System.err.println("e_flags      "+toHexString(eh.getFlags()));
+            System.err.println("    ARM ABI     "+eh.getArmABI());
+            System.err.println("    ARM lGCC    "+eh.getArmLegacyGCCFlags());
+            System.err.println("    ARM FLOAT   "+eh.getArmFloatMode()+", is hard-float "+(2 == eh.getArmFloatMode()));
+            System.err.println("e_version    "+e_ident[ElfHeader.EI_VERSION]);
+            System.err.println("e_osabi      "+eh.getOSABI()+", Linux "+ElfHeader.ELFOSABI_LINUX);
+            System.err.println("e_abiversion "+e_ident[ElfHeader.EI_ABIVERSION]);
+            System.err.println("e_machine    "+eh.getMachine()+", isARM "+eh.isArm()+", isIntel "+eh.isIntel());
+            System.err.println("e_version    "+eh.d.getE_version());
+            System.err.println("e_type       "+eh.getType());
+            System.err.println("EH Size      "+eh.d.getE_ehsize());
+            System.err.println("SH num       "+eh.d.getE_shnum());
+            System.err.println("SH entsz     "+eh.d.getE_shentsize());
+            System.err.println("SH off       "+toHexString(eh.d.getE_shoff()));
+            System.err.println("SH strndx    "+eh.d.getE_shstrndx());
+            System.err.println("SH num "+eh.sht.length);
+            if( 0 < eh.sht.length ) {
+                System.err.println("SH size "+eh.sht[0].d.getBuffer().limit());
+            }
+            {
+                SectionHeader sh = eh.getSectionHeader(SectionHeader.SHT_ARM_ATTRIBUTES);
+                boolean abiVFPArgsAcceptsVFPVariant = false;
+                if( null != sh ) {
+                    final SectionArmAttributes sArmAttrs = (SectionArmAttributes) sh.readSection(in);
+                    final SectionArmAttributes.Attribute abiVFPArgsAttr = sArmAttrs.get(SectionArmAttributes.Tag.ABI_VFP_args);
+                    if( null != abiVFPArgsAttr ) {
+                        abiVFPArgsAcceptsVFPVariant = SectionArmAttributes.abiVFPArgsAcceptsVFPVariant(abiVFPArgsAttr.getULEB128());
+                    }
+                }
+                System.err.println("abiVFPArgsAcceptsVFPVariant "+abiVFPArgsAcceptsVFPVariant);
+            }
+            for(i=0; i<eh.sht.length; i++) {
+                final SectionHeader sh = eh.sht[i];
+                System.err.println(sh);
+                final int type = sh.getType();
+                if( SectionHeader.SHT_STRTAB == type ) {
+                    dumpSection(in, sh, "SHT_STRTAB", fileOutSections);
+                } else if( SectionHeader.SHT_ARM_ATTRIBUTES == type ) {
+                    dumpSection(in, sh, "SHT_ARM_ATTRIBUTES", fileOutSections);
+                }
+            }
+        } finally {
+            in.close();
+        }
+    }
+    
+    static void dumpSection(RandomAccessFile in, SectionHeader sh, String name, boolean fileOut) throws IllegalArgumentException, IOException {
+        final Section s = sh.readSection(in);
+        if(fileOut) {
+            File outFile = new File("ElfSection-"+sh.getIndex()+"-"+name);
+            OutputStream out = new BufferedOutputStream(new FileOutputStream(outFile));
+            try {
+                out.write(s.data, s.offset, s.length);
+            } finally {
+                out.close();
+            }
+        }
+        System.err.println(name+": read "+s.length+", "+s);
+    }
+    
+    public static void main(String args[]) throws IOException {
+        String tstname = TestElfReader01.class.getName();
+        org.junit.runner.JUnitCore.main(tstname);
+    }
+    
+    static String toHexString(int i) { return "0x"+Integer.toHexString(i); }
+    static String toHexString(long i) { return "0x"+Long.toHexString(i); }
+    
+}