From a2c78c09a33d474e0a823af7b1ba40b21ddf7446 Mon Sep 17 00:00:00 2001 From: jtbennett-fe Date: Wed, 16 Jan 2019 14:46:04 -0800 Subject: [PATCH] Create README.md addressing https://github.com/fireeye/flare-emu/issues/4 --- tests/README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 tests/README.md diff --git a/tests/README.md b/tests/README.md new file mode 100644 index 0000000..79ca803 --- /dev/null +++ b/tests/README.md @@ -0,0 +1,15 @@ +# Testing + +There are currently three IDAPython scripts used to test `flare-emu`. + +* flare_emu_test.py - Basic tests of the `emulateRange` and `iterate` features +* flare_emu_test_hooks.py - Tests the naive implementations of all the supported CRT and Windows API hooks +* objc2_analyzer_test.py - Tests the basic functionality of objc2_analyzer.py + +The `flare_emu_test_` binaries are Mach-O executables that should be loaded into IDA Pro and tested with the `flare_emu_test.py` IDAPython script. + +The `flare_emu_winhooks_test_x86.exe` binary is a PE executable that should be loaded into IDA Pro and tested with the `flare_emu_test_hooks.py` IDAPython script. You may need to apply the `printf` name to the `printf` function in the binary if IDA Pro fails to do so. + +The `objc2_analyzer_test_` binaries are Mach-O executables that should be loaded into IDA Pro and tested with the `objc2_analyzer_test.py` IDAPython script. + +Check the printed output of these test scripts to ensure there are no reported errors.