Update Java samples to match C samples.

Also add all of the samples as Java tests, referencing the output of the C samples.
2023-05-14 16:23:49 -07:00
parent 3739c7e3e0
commit 4f563490e2
25 changed files with 3884 additions and 906 deletions
--- a/bindings/java/samples/Sample_ppc.java
+++ b/bindings/java/samples/Sample_ppc.java
@@ -0,0 +1,91 @@
+/*
+
+Java bindings for the Unicorn Emulator Engine
+
+Copyright(c) 2023 Robert Xiao
+
+This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License
+version 2 as published by the Free Software Foundation.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+
+*/
+
+/* Sample code to demonstrate how to emulate S390X code */
+
+package samples;
+
+import unicorn.*;
+
+public class Sample_ppc implements UnicornConst, PpcConst {
+    /** code to be emulated:
+     * {@code add r26, r6, r3}
+     */
+    private static final byte[] CODE = Utils.hexToBytes("7F461A14");
+
+    // memory address where emulation starts
+    private static final long ADDRESS = 0x10000;
+
+    private static final BlockHook hook_block =
+        (uc, address, size, user_data) -> {
+            System.out.format(
+                ">>> Tracing basic block at 0x%x, block size = 0x%x\n",
+                address, size);
+        };
+
+    private static final CodeHook hook_code =
+        (uc, address, size, user_data) -> {
+            System.out.format(
+                ">>> Tracing instruction at 0x%x, instruction size = 0x%x\n",
+                address, size);
+        };
+
+    public static void test_ppc() {
+        long r3 = 0x1234;  // R3 register
+        long r6 = 0x6789;  // R6 register
+        long r26 = 0x8877; // R26 register   (result)
+
+        System.out.println("Emulate PPC code");
+
+        Unicorn uc =
+            new Unicorn(UC_ARCH_PPC, UC_MODE_PPC32 | UC_MODE_BIG_ENDIAN);
+
+        // map 2MB memory for this emulation
+        uc.mem_map(ADDRESS, 2 * 1024 * 1024, UC_PROT_ALL);
+
+        // write machine code to be emulated to memory
+        uc.mem_write(ADDRESS, CODE);
+
+        // initialize machine registers
+        uc.reg_write(UC_PPC_REG_3, r3);
+        uc.reg_write(UC_PPC_REG_6, r6);
+        uc.reg_write(UC_PPC_REG_26, r26);
+
+        // tracing all basic blocks with customized callback
+        uc.hook_add(hook_block, 1, 0, null);
+
+        // tracing one instruction at ADDRESS with customized callback
+        uc.hook_add(hook_code, ADDRESS, ADDRESS + CODE.length, null);
+
+        // emulate machine code in infinite time (last param = 0), or when
+        // finishing all the code.
+        uc.emu_start(ADDRESS, ADDRESS + CODE.length, 0, 0);
+
+        // now print out some registers
+        System.out.println(">>> Emulation done. Below is the CPU context");
+
+        System.out.format(">>> r26 = 0x%x\n", uc.reg_read(UC_PPC_REG_26));
+    }
+
+    public static final void main(String[] args) {
+        test_ppc();
+    }
+}