From faf55a8de68c03934eec9318350ff5dce37c970d Mon Sep 17 00:00:00 2001 From: Ryan Kurtz Date: Wed, 30 Oct 2024 11:46:25 -0400 Subject: [PATCH] GP-5078: Improvements to Ghidra Module directory layout --- GPL/DMG/README.md | 1 + GPL/DMG/certification.manifest | 1 + GPL/DemanglerGnu/README.md | 1 + GPL/DemanglerGnu/certification.manifest | 2 +- GPL/GnuDisassembler/README.md | 27 +++++ GPL/GnuDisassembler/README.txt | 26 ----- GPL/GnuDisassembler/certification.manifest | 2 +- .../Configurations/Public_Release/README.md | 1 + .../Public_Release/certification.manifest | 1 + Ghidra/Debug/AnnotationValidator/README.md | 1 + .../certification.manifest | 1 + Ghidra/Debug/Debugger-agent-dbgeng/README.md | 1 + .../certification.manifest | 1 + .../README.md | 1 + .../certification.manifest | 1 + .../Debug/Debugger-agent-dbgmodel/README.md | 1 + .../certification.manifest | 1 + .../Debug/Debugger-agent-frida/FridaNotes.txt | 28 ------ Ghidra/Debug/Debugger-agent-frida/README.md | 58 +++++++++++ .../certification.manifest | 2 +- Ghidra/Debug/Debugger-agent-gdb/README.md | 1 + .../Debugger-agent-gdb/certification.manifest | 1 + Ghidra/Debug/Debugger-agent-lldb/README.md | 1 + .../certification.manifest | 1 + Ghidra/Debug/Debugger-api/README.md | 1 + .../Debug/Debugger-api/certification.manifest | 1 + Ghidra/Debug/Debugger-gadp/README.md | 1 + .../Debugger-gadp/certification.manifest | 1 + Ghidra/Debug/Debugger-isf/README.md | 1 + Ghidra/Debug/Debugger-isf/build.gradle | 12 +-- .../Debug/Debugger-isf/certification.manifest | 3 +- .../Debugger-isf/{ => support}/runISFServer | 4 +- Ghidra/Debug/Debugger-jpda/README.md | 1 + .../Debugger-jpda/certification.manifest | 1 + Ghidra/Debug/Debugger-rmi-trace/README.md | 1 + .../Debugger-rmi-trace/certification.manifest | 1 + Ghidra/Debug/Debugger-swig-lldb/README.md | 1 + .../Debugger-swig-lldb/certification.manifest | 1 + Ghidra/Debug/Debugger/README.md | 1 + Ghidra/Debug/Debugger/certification.manifest | 1 + Ghidra/Debug/Framework-AsyncComm/README.md | 1 + .../certification.manifest | 1 + Ghidra/Debug/Framework-Debugging/README.md | 1 + .../certification.manifest | 1 + .../Debug/Framework-TraceModeling/README.md | 1 + .../certification.manifest | 1 + Ghidra/Debug/ProposedUtils/README.md | 1 + .../ProposedUtils/certification.manifest | 1 + .../Extensions/BSimElasticPlugin/INSTALL.txt | 99 ------------------- Ghidra/Extensions/BSimElasticPlugin/README.md | 99 +++++++++++++++++++ .../BSimElasticPlugin/certification.manifest | 2 +- Ghidra/Extensions/MachineLearning/README.md | 1 + .../MachineLearning/certification.manifest | 2 +- Ghidra/Extensions/SampleTablePlugin/README.md | 1 + .../SampleTablePlugin/certification.manifest | 1 + Ghidra/Extensions/SleighDevTools/README.md | 1 + .../SleighDevTools/certification.manifest | 1 + Ghidra/Extensions/bundle_examples/README.md | 1 + .../bundle_examples/certification.manifest | 1 + Ghidra/Extensions/sample/README.md | 1 + .../Extensions/sample/certification.manifest | 1 + Ghidra/Features/BSim/README.md | 1 + Ghidra/Features/BSim/build.gradle | 9 +- Ghidra/Features/BSim/certification.manifest | 1 + .../topics/BSim/DatabaseConfiguration.html | 6 +- .../bsim/query/BSimControlLaunchable.java | 7 +- .../BSim/{ => support}/make-postgres.sh | 33 ++++--- .../Features/BSimFeatureVisualizer/README.md | 1 + .../certification.manifest | 1 + Ghidra/Features/Base/README.md | 1 + Ghidra/Features/Base/certification.manifest | 1 + Ghidra/Features/BytePatterns/README.md | 1 + .../BytePatterns/certification.manifest | 1 + Ghidra/Features/ByteViewer/README.md | 1 + .../ByteViewer/certification.manifest | 1 + Ghidra/Features/CodeCompare/README.md | 1 + .../CodeCompare/certification.manifest | 1 + Ghidra/Features/DebugUtils/README.md | 1 + .../DebugUtils/certification.manifest | 1 + Ghidra/Features/Decompiler/README.md | 1 + .../Decompiler/certification.manifest | 1 + Ghidra/Features/DecompilerDependent/README.md | 1 + .../certification.manifest | 1 + Ghidra/Features/FileFormats/README.md | 1 + .../FileFormats/certification.manifest | 1 + Ghidra/Features/FunctionGraph/README.md | 1 + .../FunctionGraph/certification.manifest | 1 + .../README.md | 1 + .../certification.manifest | 1 + Ghidra/Features/FunctionID/README.md | 1 + .../FunctionID/certification.manifest | 1 + Ghidra/Features/GhidraGo/README.md | 1 + .../Features/GhidraGo/certification.manifest | 1 + Ghidra/Features/GhidraServer/README.md | 1 + .../GhidraServer/certification.manifest | 1 + Ghidra/Features/GnuDemangler/README.md | 1 + .../GnuDemangler/certification.manifest | 1 + Ghidra/Features/GraphFunctionCalls/README.md | 1 + .../GraphFunctionCalls/certification.manifest | 1 + Ghidra/Features/GraphServices/README.md | 1 + .../GraphServices/certification.manifest | 1 + Ghidra/Features/Jython/README.md | 1 + Ghidra/Features/Jython/certification.manifest | 1 + .../Features/MicrosoftCodeAnalyzer/README.md | 1 + .../certification.manifest | 1 + Ghidra/Features/MicrosoftDemangler/README.md | 1 + .../MicrosoftDemangler/certification.manifest | 1 + Ghidra/Features/MicrosoftDmang/README.md | 1 + .../MicrosoftDmang/certification.manifest | 1 + Ghidra/Features/PDB/README.md | 1 + Ghidra/Features/PDB/certification.manifest | 1 + Ghidra/Features/ProgramDiff/README.md | 1 + .../ProgramDiff/certification.manifest | 1 + Ghidra/Features/ProgramGraph/README.md | 1 + .../ProgramGraph/certification.manifest | 1 + Ghidra/Features/PyGhidra/README.md | 1 + Ghidra/Features/PyGhidra/build.gradle | 12 --- .../Features/PyGhidra/certification.manifest | 1 + .../{ => support}/pyghidra_launcher.py | 0 Ghidra/Features/Recognizers/README.md | 1 + .../Recognizers/certification.manifest | 1 + Ghidra/Features/Sarif/README.md | 1 + Ghidra/Features/Sarif/certification.manifest | 1 + Ghidra/Features/SourceCodeLookup/README.md | 1 + .../SourceCodeLookup/certification.manifest | 1 + Ghidra/Features/SwiftDemangler/README.md | 1 + .../SwiftDemangler/certification.manifest | 1 + Ghidra/Features/SystemEmulation/README.md | 1 + .../SystemEmulation/certification.manifest | 1 + Ghidra/Features/VersionTracking/README.md | 1 + .../VersionTracking/certification.manifest | 1 + Ghidra/Features/VersionTrackingBSim/README.md | 1 + .../certification.manifest | 1 + Ghidra/Features/WildcardAssembler/README.md | 1 + .../WildcardAssembler/certification.manifest | 1 + Ghidra/Framework/DB/README.md | 1 + Ghidra/Framework/DB/certification.manifest | 1 + Ghidra/Framework/Docking/README.md | 1 + .../Framework/Docking/certification.manifest | 1 + Ghidra/Framework/Emulation/README.md | 1 + .../Emulation/certification.manifest | 1 + Ghidra/Framework/FileSystem/README.md | 1 + .../FileSystem/certification.manifest | 1 + Ghidra/Framework/Generic/README.md | 1 + .../Framework/Generic/certification.manifest | 1 + Ghidra/Framework/Gui/README.md | 1 + Ghidra/Framework/Gui/certification.manifest | 1 + Ghidra/Framework/Help/README.md | 1 + Ghidra/Framework/Help/certification.manifest | 1 + Ghidra/Framework/Project/README.md | 1 + .../Framework/Project/certification.manifest | 1 + Ghidra/Framework/Pty/README.md | 1 + Ghidra/Framework/Pty/certification.manifest | 1 + Ghidra/Framework/SoftwareModeling/README.md | 1 + .../SoftwareModeling/certification.manifest | 1 + Ghidra/Framework/Utility/README.md | 1 + .../Framework/Utility/certification.manifest | 1 + Ghidra/Processors/6502/README.md | 1 + Ghidra/Processors/6502/certification.manifest | 1 + Ghidra/Processors/68000/README.md | 1 + .../Processors/68000/certification.manifest | 1 + Ghidra/Processors/8048/README.md | 1 + Ghidra/Processors/8048/certification.manifest | 1 + Ghidra/Processors/8051/README.md | 1 + Ghidra/Processors/8051/certification.manifest | 1 + Ghidra/Processors/8085/README.md | 1 + Ghidra/Processors/8085/certification.manifest | 1 + Ghidra/Processors/AARCH64/README.md | 1 + .../Processors/AARCH64/certification.manifest | 1 + Ghidra/Processors/ARM/README.md | 1 + Ghidra/Processors/ARM/certification.manifest | 1 + Ghidra/Processors/Atmel/README.md | 1 + .../Processors/Atmel/certification.manifest | 1 + Ghidra/Processors/BPF/README.md | 1 + Ghidra/Processors/BPF/certification.manifest | 1 + Ghidra/Processors/CP1600/README.md | 1 + .../Processors/CP1600/certification.manifest | 1 + Ghidra/Processors/CR16/README.md | 1 + Ghidra/Processors/CR16/certification.manifest | 1 + Ghidra/Processors/DATA/README.md | 1 + Ghidra/Processors/DATA/certification.manifest | 1 + Ghidra/Processors/Dalvik/README.md | 1 + .../Processors/Dalvik/certification.manifest | 1 + Ghidra/Processors/HCS08/README.md | 1 + .../Processors/HCS08/certification.manifest | 1 + Ghidra/Processors/HCS12/README.md | 1 + .../Processors/HCS12/certification.manifest | 1 + Ghidra/Processors/JVM/README.md | 1 + Ghidra/Processors/JVM/certification.manifest | 1 + Ghidra/Processors/Loongarch/README.md | 1 + .../Loongarch/certification.manifest | 1 + Ghidra/Processors/M16C/README.md | 1 + Ghidra/Processors/M16C/certification.manifest | 1 + Ghidra/Processors/M8C/README.md | 1 + Ghidra/Processors/M8C/certification.manifest | 1 + Ghidra/Processors/MC6800/README.md | 1 + .../Processors/MC6800/certification.manifest | 1 + Ghidra/Processors/MCS96/README.md | 1 + .../Processors/MCS96/certification.manifest | 1 + Ghidra/Processors/MIPS/README.md | 1 + Ghidra/Processors/MIPS/certification.manifest | 1 + Ghidra/Processors/PA-RISC/README.md | 1 + .../Processors/PA-RISC/certification.manifest | 1 + Ghidra/Processors/PIC/README.md | 1 + Ghidra/Processors/PIC/certification.manifest | 1 + Ghidra/Processors/PowerPC/README.md | 1 + .../Processors/PowerPC/certification.manifest | 1 + Ghidra/Processors/RISCV/README.md | 1 + .../Processors/RISCV/certification.manifest | 1 + Ghidra/Processors/Sparc/README.md | 1 + .../Processors/Sparc/certification.manifest | 1 + Ghidra/Processors/SuperH/README.md | 1 + .../Processors/SuperH/certification.manifest | 1 + Ghidra/Processors/SuperH4/README.md | 1 + .../Processors/SuperH4/certification.manifest | 1 + Ghidra/Processors/TI_MSP430/README.md | 1 + .../TI_MSP430/certification.manifest | 1 + Ghidra/Processors/Toy/README.md | 1 + Ghidra/Processors/Toy/certification.manifest | 1 + Ghidra/Processors/V850/README.md | 1 + Ghidra/Processors/V850/certification.manifest | 1 + Ghidra/Processors/Xtensa/README.md | 1 + .../Processors/Xtensa/certification.manifest | 1 + Ghidra/Processors/Z80/README.md | 1 + Ghidra/Processors/Z80/certification.manifest | 1 + Ghidra/Processors/eBPF/README.md | 1 + Ghidra/Processors/eBPF/certification.manifest | 1 + Ghidra/Processors/tricore/README.md | 1 + .../Processors/tricore/certification.manifest | 1 + Ghidra/Processors/x86/README.md | 1 + Ghidra/Processors/x86/certification.manifest | 1 + .../RuntimeScripts/Linux/support/pyghidraRun | 2 +- .../Windows/support/pyghidraRun.bat | 2 +- .../GhidraDev/GhidraDevFeature/feature.xml | 2 +- .../GhidraDevPlugin/.launch/GhidraDev.launch | 12 ++- .../GhidraDevPlugin/META-INF/MANIFEST.MF | 2 +- .../GhidraDev/GhidraDevPlugin/README.md | 3 + .../utils/GhidraModuleUtils.java | 5 + GhidraBuild/Skeleton/README.md | 1 + GhidraBuild/Skeleton/certification.manifest | 1 + .../BSim/BSimTutorial_Ghidra_Command_Line.md | 2 +- GhidraDocs/certification.manifest | 12 --- gradle/distributableGhidraModule.gradle | 32 ++++-- 243 files changed, 482 insertions(+), 238 deletions(-) create mode 100644 GPL/DMG/README.md create mode 100644 GPL/DemanglerGnu/README.md create mode 100644 GPL/GnuDisassembler/README.md delete mode 100644 GPL/GnuDisassembler/README.txt create mode 100644 Ghidra/Configurations/Public_Release/README.md create mode 100644 Ghidra/Debug/AnnotationValidator/README.md create mode 100644 Ghidra/Debug/Debugger-agent-dbgeng/README.md create mode 100644 Ghidra/Debug/Debugger-agent-dbgmodel-traceloader/README.md create mode 100644 Ghidra/Debug/Debugger-agent-dbgmodel/README.md delete mode 100644 Ghidra/Debug/Debugger-agent-frida/FridaNotes.txt create mode 100644 Ghidra/Debug/Debugger-agent-frida/README.md create mode 100644 Ghidra/Debug/Debugger-agent-gdb/README.md create mode 100644 Ghidra/Debug/Debugger-agent-lldb/README.md create mode 100644 Ghidra/Debug/Debugger-api/README.md create mode 100644 Ghidra/Debug/Debugger-gadp/README.md create mode 100644 Ghidra/Debug/Debugger-isf/README.md rename Ghidra/Debug/Debugger-isf/{ => support}/runISFServer (93%) create mode 100644 Ghidra/Debug/Debugger-jpda/README.md create mode 100644 Ghidra/Debug/Debugger-rmi-trace/README.md create mode 100644 Ghidra/Debug/Debugger-swig-lldb/README.md create mode 100644 Ghidra/Debug/Debugger/README.md create mode 100644 Ghidra/Debug/Framework-AsyncComm/README.md create mode 100644 Ghidra/Debug/Framework-Debugging/README.md create mode 100644 Ghidra/Debug/Framework-TraceModeling/README.md create mode 100644 Ghidra/Debug/ProposedUtils/README.md delete mode 100755 Ghidra/Extensions/BSimElasticPlugin/INSTALL.txt create mode 100644 Ghidra/Extensions/BSimElasticPlugin/README.md create mode 100644 Ghidra/Extensions/MachineLearning/README.md create mode 100644 Ghidra/Extensions/SampleTablePlugin/README.md create mode 100644 Ghidra/Extensions/SleighDevTools/README.md create mode 100644 Ghidra/Extensions/bundle_examples/README.md create mode 100644 Ghidra/Extensions/sample/README.md create mode 100644 Ghidra/Features/BSim/README.md rename Ghidra/Features/BSim/{ => support}/make-postgres.sh (80%) create mode 100644 Ghidra/Features/BSimFeatureVisualizer/README.md create mode 100644 Ghidra/Features/Base/README.md create mode 100644 Ghidra/Features/BytePatterns/README.md create mode 100644 Ghidra/Features/ByteViewer/README.md create mode 100644 Ghidra/Features/CodeCompare/README.md create mode 100644 Ghidra/Features/DebugUtils/README.md create mode 100644 Ghidra/Features/Decompiler/README.md create mode 100644 Ghidra/Features/DecompilerDependent/README.md create mode 100644 Ghidra/Features/FileFormats/README.md create mode 100644 Ghidra/Features/FunctionGraph/README.md create mode 100644 Ghidra/Features/FunctionGraphDecompilerExtension/README.md create mode 100644 Ghidra/Features/FunctionID/README.md create mode 100644 Ghidra/Features/GhidraGo/README.md create mode 100644 Ghidra/Features/GhidraServer/README.md create mode 100644 Ghidra/Features/GnuDemangler/README.md create mode 100644 Ghidra/Features/GraphFunctionCalls/README.md create mode 100644 Ghidra/Features/GraphServices/README.md create mode 100644 Ghidra/Features/Jython/README.md create mode 100644 Ghidra/Features/MicrosoftCodeAnalyzer/README.md create mode 100644 Ghidra/Features/MicrosoftDemangler/README.md create mode 100644 Ghidra/Features/MicrosoftDmang/README.md create mode 100644 Ghidra/Features/PDB/README.md create mode 100644 Ghidra/Features/ProgramDiff/README.md create mode 100644 Ghidra/Features/ProgramGraph/README.md create mode 100644 Ghidra/Features/PyGhidra/README.md rename Ghidra/Features/PyGhidra/{ => support}/pyghidra_launcher.py (100%) create mode 100644 Ghidra/Features/Recognizers/README.md create mode 100644 Ghidra/Features/Sarif/README.md create mode 100644 Ghidra/Features/SourceCodeLookup/README.md create mode 100644 Ghidra/Features/SwiftDemangler/README.md create mode 100644 Ghidra/Features/SystemEmulation/README.md create mode 100644 Ghidra/Features/VersionTracking/README.md create mode 100644 Ghidra/Features/VersionTrackingBSim/README.md create mode 100644 Ghidra/Features/WildcardAssembler/README.md create mode 100644 Ghidra/Framework/DB/README.md create mode 100644 Ghidra/Framework/Docking/README.md create mode 100644 Ghidra/Framework/Emulation/README.md create mode 100644 Ghidra/Framework/FileSystem/README.md create mode 100644 Ghidra/Framework/Generic/README.md create mode 100644 Ghidra/Framework/Gui/README.md create mode 100644 Ghidra/Framework/Help/README.md create mode 100644 Ghidra/Framework/Project/README.md create mode 100644 Ghidra/Framework/Pty/README.md create mode 100644 Ghidra/Framework/SoftwareModeling/README.md create mode 100644 Ghidra/Framework/Utility/README.md create mode 100644 Ghidra/Processors/6502/README.md create mode 100644 Ghidra/Processors/68000/README.md create mode 100644 Ghidra/Processors/8048/README.md create mode 100644 Ghidra/Processors/8051/README.md create mode 100644 Ghidra/Processors/8085/README.md create mode 100644 Ghidra/Processors/AARCH64/README.md create mode 100644 Ghidra/Processors/ARM/README.md create mode 100644 Ghidra/Processors/Atmel/README.md create mode 100644 Ghidra/Processors/BPF/README.md create mode 100644 Ghidra/Processors/CP1600/README.md create mode 100644 Ghidra/Processors/CR16/README.md create mode 100644 Ghidra/Processors/DATA/README.md create mode 100644 Ghidra/Processors/Dalvik/README.md create mode 100644 Ghidra/Processors/HCS08/README.md create mode 100644 Ghidra/Processors/HCS12/README.md create mode 100644 Ghidra/Processors/JVM/README.md create mode 100644 Ghidra/Processors/Loongarch/README.md create mode 100644 Ghidra/Processors/M16C/README.md create mode 100644 Ghidra/Processors/M8C/README.md create mode 100644 Ghidra/Processors/MC6800/README.md create mode 100644 Ghidra/Processors/MCS96/README.md create mode 100644 Ghidra/Processors/MIPS/README.md create mode 100644 Ghidra/Processors/PA-RISC/README.md create mode 100644 Ghidra/Processors/PIC/README.md create mode 100644 Ghidra/Processors/PowerPC/README.md create mode 100644 Ghidra/Processors/RISCV/README.md create mode 100644 Ghidra/Processors/Sparc/README.md create mode 100644 Ghidra/Processors/SuperH/README.md create mode 100644 Ghidra/Processors/SuperH4/README.md create mode 100644 Ghidra/Processors/TI_MSP430/README.md create mode 100644 Ghidra/Processors/Toy/README.md create mode 100644 Ghidra/Processors/V850/README.md create mode 100644 Ghidra/Processors/Xtensa/README.md create mode 100644 Ghidra/Processors/Z80/README.md create mode 100644 Ghidra/Processors/eBPF/README.md create mode 100644 Ghidra/Processors/tricore/README.md create mode 100644 Ghidra/Processors/x86/README.md create mode 100644 GhidraBuild/Skeleton/README.md diff --git a/GPL/DMG/README.md b/GPL/DMG/README.md new file mode 100644 index 0000000000..0c432feb7e --- /dev/null +++ b/GPL/DMG/README.md @@ -0,0 +1 @@ +# DMG diff --git a/GPL/DMG/certification.manifest b/GPL/DMG/certification.manifest index ebc6cd3f2f..7bd311991b 100644 --- a/GPL/DMG/certification.manifest +++ b/GPL/DMG/certification.manifest @@ -3,6 +3,7 @@ ##MODULE IP: LGPL 2.1 ##MODULE IP: Public Domain Module.manifest||Public Domain||||END| +README.md||GHIDRA||||END| data/lib/csframework.jar||LGPL 2.1||||END| data/lib/hfsexplorer-0_21-src.zip||GPL 3||||END| data/lib/hfsx.jar||GPL 3||||END| diff --git a/GPL/DemanglerGnu/README.md b/GPL/DemanglerGnu/README.md new file mode 100644 index 0000000000..fe77397bc2 --- /dev/null +++ b/GPL/DemanglerGnu/README.md @@ -0,0 +1 @@ +# DemanglerGnu diff --git a/GPL/DemanglerGnu/certification.manifest b/GPL/DemanglerGnu/certification.manifest index 6f2767e5f8..84ad4bbb4c 100644 --- a/GPL/DemanglerGnu/certification.manifest +++ b/GPL/DemanglerGnu/certification.manifest @@ -5,5 +5,5 @@ ##MODULE IP: LGPL 3.0 ##MODULE IP: Public Domain Module.manifest||Public Domain||||END| +README.md||GHIDRA||||END| src/demangler_gnu_v2_24/README.txt||Public Domain||||END| -src/demangler_gnu_v2_33_1/README.txt||Public Domain||||END| diff --git a/GPL/GnuDisassembler/README.md b/GPL/GnuDisassembler/README.md new file mode 100644 index 0000000000..cf13ca0dd7 --- /dev/null +++ b/GPL/GnuDisassembler/README.md @@ -0,0 +1,27 @@ +# GnuDisassembler + +The GnuDisassembler extension module must be built using gradle prior to its use within Ghidra. + +This module provides the ability to leverage the binutils disassembler capabilities +for various processors as a means of verifying Sleigh disassembler output syntax. + +To build this extension for Linux or macOS: + +1. If building for an installation of Ghidra, copy the appropriate source distribution of binutils + into this module's root directory. If building within a git clone of the full Ghidra source, copy + binutils source distribution file into the `ghidra.bin/GPL/GnuDisassembler` directory. + + The supported version and archive format is identified within the build.gradle file. If a + different binutils distribution is used the build.gradle and/or buildGdis.gradle may require + modification. + + The build requires the following packages to be installed: + * flex + * bison + * texinfo + * zlib1g-dev + +2. Run gradle from the module's root directory (see top of `build.gradle` file for specific +instructions). + +This resulting gdis executable will be located in `build/os/`. diff --git a/GPL/GnuDisassembler/README.txt b/GPL/GnuDisassembler/README.txt deleted file mode 100644 index 3af72f4239..0000000000 --- a/GPL/GnuDisassembler/README.txt +++ /dev/null @@ -1,26 +0,0 @@ -The GnuDisassembler extension module must be built using gradle prior to its' use within Ghidra. - -This module provides the ability to leverage the binutils disassembler capabilities -for various processors as a means of verifying Sleigh disassembler output syntax. - -To build this extension for Linux or Mac OS X: - - 1. If building for an installation of Ghidra, copy the appropriate source distribution of - binutils into this module's root directory. If building within a git clone of the full - Ghidra source, copy binutils source distribution file into the ghidra.bin/GPL/GnuDisassembler - directory. - - The supported version and archive format is identified within the build.gradle file. - If a different binutils distribution is used the build.gradle and/or buildGdis.gradle - may require modification. - - The build requires the following packages to be installed: - * flex - * bison - * texinfo - * zlib1g-dev - - 2. Run gradle from the module's root directory (see top of build.gradle file for - specific instructions). - -This resulting gdis executable will be located in build/os/. diff --git a/GPL/GnuDisassembler/certification.manifest b/GPL/GnuDisassembler/certification.manifest index ffbc546607..c0bfaeb02b 100644 --- a/GPL/GnuDisassembler/certification.manifest +++ b/GPL/GnuDisassembler/certification.manifest @@ -3,7 +3,7 @@ ##MODULE IP: Public Domain .gitignore||Public Domain||||END| Module.manifest||Public Domain||||END| -README.txt||Public Domain||||END| +README.md||GHIDRA||||END| data/arm_test1.s||Public Domain||||END| data/big.elf||Public Domain||||END| data/little.elf||Public Domain||||END| diff --git a/Ghidra/Configurations/Public_Release/README.md b/Ghidra/Configurations/Public_Release/README.md new file mode 100644 index 0000000000..6043ccb8af --- /dev/null +++ b/Ghidra/Configurations/Public_Release/README.md @@ -0,0 +1 @@ +# Public_Release diff --git a/Ghidra/Configurations/Public_Release/certification.manifest b/Ghidra/Configurations/Public_Release/certification.manifest index 3a50c1b4a9..bf35c85f28 100644 --- a/Ghidra/Configurations/Public_Release/certification.manifest +++ b/Ghidra/Configurations/Public_Release/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/PDB_SYMBOL_SERVER_URLS.pdburl||GHIDRA||||END| src/global/docs/ChangeHistory.html||GHIDRA||||END| src/global/docs/UserAgreement.html||GHIDRA||||END| diff --git a/Ghidra/Debug/AnnotationValidator/README.md b/Ghidra/Debug/AnnotationValidator/README.md new file mode 100644 index 0000000000..f091081429 --- /dev/null +++ b/Ghidra/Debug/AnnotationValidator/README.md @@ -0,0 +1 @@ +# AnnotationValidator diff --git a/Ghidra/Debug/AnnotationValidator/certification.manifest b/Ghidra/Debug/AnnotationValidator/certification.manifest index 25b31ce77d..ec930ac55b 100644 --- a/Ghidra/Debug/AnnotationValidator/certification.manifest +++ b/Ghidra/Debug/AnnotationValidator/certification.manifest @@ -1,3 +1,4 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| src/main/resources/META-INF/services/javax.annotation.processing.Processor||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-agent-dbgeng/README.md b/Ghidra/Debug/Debugger-agent-dbgeng/README.md new file mode 100644 index 0000000000..76f4987688 --- /dev/null +++ b/Ghidra/Debug/Debugger-agent-dbgeng/README.md @@ -0,0 +1 @@ +# Debugger-agent-dbgeng diff --git a/Ghidra/Debug/Debugger-agent-dbgeng/certification.manifest b/Ghidra/Debug/Debugger-agent-dbgeng/certification.manifest index 827d3f672d..e01aa867bf 100644 --- a/Ghidra/Debug/Debugger-agent-dbgeng/certification.manifest +++ b/Ghidra/Debug/Debugger-agent-dbgeng/certification.manifest @@ -2,6 +2,7 @@ ##MODULE IP: Apache License 2.0 ##MODULE IP: MIT Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/debugger-launchers/kernel-dbgeng.bat||GHIDRA||||END| data/debugger-launchers/local-dbgeng-attach.bat||GHIDRA||||END| data/debugger-launchers/local-dbgeng-ext.bat||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-agent-dbgmodel-traceloader/README.md b/Ghidra/Debug/Debugger-agent-dbgmodel-traceloader/README.md new file mode 100644 index 0000000000..fcf665b185 --- /dev/null +++ b/Ghidra/Debug/Debugger-agent-dbgmodel-traceloader/README.md @@ -0,0 +1 @@ +# Debugger-agent-dbgmodel-traceloader diff --git a/Ghidra/Debug/Debugger-agent-dbgmodel-traceloader/certification.manifest b/Ghidra/Debug/Debugger-agent-dbgmodel-traceloader/certification.manifest index d1f21abd88..5e05c17012 100644 --- a/Ghidra/Debug/Debugger-agent-dbgmodel-traceloader/certification.manifest +++ b/Ghidra/Debug/Debugger-agent-dbgmodel-traceloader/certification.manifest @@ -1,3 +1,4 @@ ##VERSION: 2.0 ##MODULE IP: Apache License 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-agent-dbgmodel/README.md b/Ghidra/Debug/Debugger-agent-dbgmodel/README.md new file mode 100644 index 0000000000..43a7f3ea9a --- /dev/null +++ b/Ghidra/Debug/Debugger-agent-dbgmodel/README.md @@ -0,0 +1 @@ +# Debugger-agent-dbgmodel diff --git a/Ghidra/Debug/Debugger-agent-dbgmodel/certification.manifest b/Ghidra/Debug/Debugger-agent-dbgmodel/certification.manifest index c4d5c18430..e04c1bb1e9 100644 --- a/Ghidra/Debug/Debugger-agent-dbgmodel/certification.manifest +++ b/Ghidra/Debug/Debugger-agent-dbgmodel/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| src/javaprovider/def/javaprovider.def||GHIDRA||||END| src/javaprovider/rc/javaprovider.rc||GHIDRA||||END| src/main/resources/agent/dbgmodel/model/impl/dbgmodel_schema.xml||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-agent-frida/FridaNotes.txt b/Ghidra/Debug/Debugger-agent-frida/FridaNotes.txt deleted file mode 100644 index 50ad5712d6..0000000000 --- a/Ghidra/Debug/Debugger-agent-frida/FridaNotes.txt +++ /dev/null @@ -1,28 +0,0 @@ -Random Notes on the Implementation of Debugger-agent-frida - -- Building libfrida-core.so: - You can download libfrida-core.a for Frida by grabbing the latest frida-core-devkit for your OS from - https://github.com/frida/frida/releases - or by downloading the Frida source and running: - python3 devkit.py frida-core linux-x86_64 DEVKIT - from the "releng" directory. - -Ghidra needs a dynamically-loadable version of libfrida-core.a which you can generate by something like: - - cp ghidra_wrapper.c into the directory with libfrida-core.a and frida-core.h (distro or DEVKIT) - g++ -shared ghidra_wrapper.c ./libfrida-core.a -o libfrida-core.so - -Libfrida-core.so should then be added to the jna.library.path or put someplace like /usr/lib/x86_64-linux-gnu, where it will get picked up by Native.load(). - -- Frida Functionality - The most interesting bits of Frida are available as "methods" from the Objects Tree. For instance, if you select a function and hit "M", you will get a dialog with available methods. Selecting, for example, "intercept" will bring up a second dialog with the relevant parameters. For many of these, you will want to provide your own Javascript "on" functions, e.g. onEnter for the Interceptor. Stalking is available on Threads and the individual thread entries. Scan, protect, and watch functions are available on Memory. You can also redirect the output to GhidraScript, although this relies on a bit of a hack. If your Javascript "Name" parameter is something like "interpreter", prepend "interpreter<=" to the output from your Javascript, and the results will be passed to both the console and the script. - -- State in Frida: - Commands in Frida are, generally speaking, not state-dependent, i.e. they do not depend on whether the target is running or not, only on whether the frida-agent thread is running. Many of the gum-based commands do, however, depend on ptrace. If you have a ptrace-based debugger attached to the target, they will time out. You can attach a debugger after Frida, but you will have to detach it to regain the gum-based functionality. "Detach" in most debuggers includes "resume", so it is difficult to get state other than the "initial" state from the frida-agent injection point. It would be nice if "disconnect" worked, but "disconnect" (i.e. detach without resuming) also leaves Frida in a partially disabled state. - -- Errors in Frida - The cloaking logic in Frida, e.g. in gum_cloak_add_thread and gum_cloak_index_of_thread, is broken as of the writing of this note. Gum_cloak_add_thread is called for every thread, and gum_cloak_index_of_thread returns a non-negative result for every call but the first. As a result, every thread but one is cloaked, and enumerateThreads returns only a single thread. This is documented in Issue #625 for the frida-gum project. A quick fix is to comment out the cloaking call in frida-gum/gum/gumprocess.c::gum_emit_thread_if_not_cloaked. Obviously, this may have other undesirable effects, but... - - The logic in the ordering of exception handlers also appears to be broken (Issue #627). New handlers are appended to the queue, in most cases after gum_exceptor_handle_scope_exception and gum_quick_core_handle_crashed_js. Gum_exceptor_handle_scope_exception almost always returns TRUE, breaking out of the queue and causing any remaining handlers to be ignored. This means any handler added with Process.setExceptionHandler is likely to be ignored. A quick fix is to modify gum_exceptor_add to use g_slist_prepend instead of g_slist_append. - - Not really an error, but worth noting: building libfrida-core.so from the source may result in a library with glib2.0 dependencies that are incompatible with the current version of Eclipse. The not-so-simple solution is to build Eclipse on the machine that you used to build libfrida-core. diff --git a/Ghidra/Debug/Debugger-agent-frida/README.md b/Ghidra/Debug/Debugger-agent-frida/README.md new file mode 100644 index 0000000000..633598a024 --- /dev/null +++ b/Ghidra/Debug/Debugger-agent-frida/README.md @@ -0,0 +1,58 @@ +# Debugger-agent-frida + +## Random Notes on the Implementation of Debugger-agent-frida + +Building libfrida-core.so: +* You can download libfrida-core.a for Frida by grabbing the latest frida-core-devkit for your OS + from https://github.com/frida/frida/releases or by downloading the Frida source and running: + `python3 devkit.py frida-core linux-x86_64 DEVKIT` from the `releng` directory. + +Ghidra needs a dynamically-loadable version of libfrida-core.a which you can generate by something like: +```bash +cp ghidra_wrapper.c into the directory with libfrida-core.a and frida-core.h (distro or DEVKIT) +g++ -shared ghidra_wrapper.c ./libfrida-core.a -o libfrida-core.so +``` + +Libfrida-core.so should then be added to the `j`na.library.path`or put someplace like +`/usr/lib/x86_64-linux-gnu`, where it will get picked up by `Native.load()`. + +### Frida Functionality +The most interesting bits of Frida are available as "methods" from the Objects Tree. For instance, +if you select a function and hit `M`, you will get a dialog with available methods. Selecting, +for example, `intercept` will bring up a second dialog with the relevant parameters. For many of +these, you will want to provide your own Javascript `on` functions, e.g. `onEnter` for the +Interceptor. Stalking is available on Threads and the individual thread entries. Scan, protect, and +watch functions are available on Memory. You can also redirect the output to GhidraScript, although +this relies on a bit of a hack. If your Javascript `Name` parameter is something like +`interpreter`, prepend `interpreter<=` to the output from your Javascript, and the results will be +passed to both the console and the script. + +### State in Frida +Commands in Frida are, generally speaking, not state-dependent, i.e. they do not depend on whether +the target is running or not, only on whether the frida-agent thread is running. Many of the +gum-based commands do, however, depend on ptrace. If you have a ptrace-based debugger attached to +the target, they will time out. You can attach a debugger after Frida, but you will have to detach +it to regain the gum-based functionality. "Detach" in most debuggers includes "resume", so it is +difficult to get state other than the "initial" state from the frida-agent injection point. It +would be nice if "disconnect" worked, but "disconnect" (i.e. detach without resuming) also leaves +Frida in a partially disabled state. + +### Errors in Frida +The cloaking logic in Frida, e.g. in `gum_cloak_add_thread` and `gum_cloak_index_of_thread`, is +broken as of the writing of this note. `gum_cloak_add_thread` is called for every thread, and +`gum_cloak_index_of_thread` returns a non-negative result for every call but the first. As a +result, every thread but one is cloaked, and `enumerateThreads`returns only a single thread. This is +documented in `Issue #625` for the frida-gum project. A quick fix is to comment out the cloaking +call in `frida-gum/gum/gumprocess.c::gum_emit_thread_if_not_cloaked`. Obviously, this may have +other undesirable effects, but... + +The logic in the ordering of exception handlers also appears to be broken (`Issue #627`). New +handlers are appended to the queue, in most cases after `gum_exceptor_handle_scope_exception` and +`gum_quick_core_handle_crashed_js`. `gum_exceptor_handle_scope_exception` almost always returns +`TRUE`, breaking out of the queue and causing any remaining handlers to be ignored. This means any +handler added with `Process.setExceptionHandler` is likely to be ignored. A quick fix is to modify +`gum_exceptor_add` to use `g_slist_prepend instead` of `g_slist_append`. + +Not really an error, but worth noting: building `libfrida-core.so` from the source may result in a +library with glib2.0 dependencies that are incompatible with the current version of Eclipse. The +not-so-simple solution is to build Eclipse on the machine that you used to build `libfrida-core`. diff --git a/Ghidra/Debug/Debugger-agent-frida/certification.manifest b/Ghidra/Debug/Debugger-agent-frida/certification.manifest index 5f713628fb..39d62132cd 100644 --- a/Ghidra/Debug/Debugger-agent-frida/certification.manifest +++ b/Ghidra/Debug/Debugger-agent-frida/certification.manifest @@ -1,8 +1,8 @@ ##VERSION: 2.0 ##MODULE IP: Apache License 2.0 ##MODULE IP: Apache License 2.0 with LLVM Exceptions -FridaNotes.txt||GHIDRA||||END| Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| build.gradle||GHIDRA||||END| data/scripts/onAccess.js||GHIDRA||||END| data/scripts/onAccessExt.js||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-agent-gdb/README.md b/Ghidra/Debug/Debugger-agent-gdb/README.md new file mode 100644 index 0000000000..a1f011eec6 --- /dev/null +++ b/Ghidra/Debug/Debugger-agent-gdb/README.md @@ -0,0 +1 @@ +# Debugger-agent-gdb diff --git a/Ghidra/Debug/Debugger-agent-gdb/certification.manifest b/Ghidra/Debug/Debugger-agent-gdb/certification.manifest index a5d9bacee4..142537a9c2 100644 --- a/Ghidra/Debug/Debugger-agent-gdb/certification.manifest +++ b/Ghidra/Debug/Debugger-agent-gdb/certification.manifest @@ -1,6 +1,7 @@ ##VERSION: 2.0 ##MODULE IP: JSch License Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/debugger-launchers/local-gdb.bat||GHIDRA||||END| data/debugger-launchers/qemu-gdb.bat||GHIDRA||||END| data/debugger-launchers/raw-gdb.bat||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-agent-lldb/README.md b/Ghidra/Debug/Debugger-agent-lldb/README.md new file mode 100644 index 0000000000..cb84e64cb5 --- /dev/null +++ b/Ghidra/Debug/Debugger-agent-lldb/README.md @@ -0,0 +1 @@ +# Debugger-agent-lldb diff --git a/Ghidra/Debug/Debugger-agent-lldb/certification.manifest b/Ghidra/Debug/Debugger-agent-lldb/certification.manifest index 9e5ae383ba..e1976e0e7e 100644 --- a/Ghidra/Debug/Debugger-agent-lldb/certification.manifest +++ b/Ghidra/Debug/Debugger-agent-lldb/certification.manifest @@ -2,6 +2,7 @@ ##MODULE IP: Apache License 2.0 ##MODULE IP: Apache License 2.0 with LLVM Exceptions Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| build.gradle||GHIDRA||||END| data/debugger-launchers/local-lldb.bat||GHIDRA||||END| src/llvm-project/lldb/bindings/java/java-typemaps.swig||Apache License 2.0 with LLVM Exceptions||||END| diff --git a/Ghidra/Debug/Debugger-api/README.md b/Ghidra/Debug/Debugger-api/README.md new file mode 100644 index 0000000000..9956e15fee --- /dev/null +++ b/Ghidra/Debug/Debugger-api/README.md @@ -0,0 +1 @@ +# Debugger-api diff --git a/Ghidra/Debug/Debugger-api/certification.manifest b/Ghidra/Debug/Debugger-api/certification.manifest index 895ac4b698..6841c5219a 100644 --- a/Ghidra/Debug/Debugger-api/certification.manifest +++ b/Ghidra/Debug/Debugger-api/certification.manifest @@ -1,2 +1,3 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-gadp/README.md b/Ghidra/Debug/Debugger-gadp/README.md new file mode 100644 index 0000000000..d7a631e089 --- /dev/null +++ b/Ghidra/Debug/Debugger-gadp/README.md @@ -0,0 +1 @@ +# Debugger-gadp diff --git a/Ghidra/Debug/Debugger-gadp/certification.manifest b/Ghidra/Debug/Debugger-gadp/certification.manifest index 895ac4b698..6841c5219a 100644 --- a/Ghidra/Debug/Debugger-gadp/certification.manifest +++ b/Ghidra/Debug/Debugger-gadp/certification.manifest @@ -1,2 +1,3 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-isf/README.md b/Ghidra/Debug/Debugger-isf/README.md new file mode 100644 index 0000000000..518e30a685 --- /dev/null +++ b/Ghidra/Debug/Debugger-isf/README.md @@ -0,0 +1 @@ +# Debugger-isf diff --git a/Ghidra/Debug/Debugger-isf/build.gradle b/Ghidra/Debug/Debugger-isf/build.gradle index bbf74efa55..126f93ad7d 100644 --- a/Ghidra/Debug/Debugger-isf/build.gradle +++ b/Ghidra/Debug/Debugger-isf/build.gradle @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -31,11 +31,3 @@ dependencies { testImplementation project(path: ':Framework-AsyncComm', configuration: 'testArtifacts') testImplementation project(path: ':Framework-Debugging', configuration: 'testArtifacts') } - -// Include buildable native source in distribution -rootProject.assembleDistribution { - from (this.project.projectDir.toString()) { - include "runISFServer" - into { getZipPath(this.project) } - } -} diff --git a/Ghidra/Debug/Debugger-isf/certification.manifest b/Ghidra/Debug/Debugger-isf/certification.manifest index c471bc1a4c..75aba617bb 100644 --- a/Ghidra/Debug/Debugger-isf/certification.manifest +++ b/Ghidra/Debug/Debugger-isf/certification.manifest @@ -1,3 +1,4 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| -runISFServer||GHIDRA||||END| +README.md||GHIDRA||||END| +support/runISFServer||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-isf/runISFServer b/Ghidra/Debug/Debugger-isf/support/runISFServer similarity index 93% rename from Ghidra/Debug/Debugger-isf/runISFServer rename to Ghidra/Debug/Debugger-isf/support/runISFServer index 6efa890ff0..090d45d90b 100755 --- a/Ghidra/Debug/Debugger-isf/runISFServer +++ b/Ghidra/Debug/Debugger-isf/support/runISFServer @@ -26,9 +26,9 @@ VMARG_LIST="-XX:ParallelGCThreads=2 -XX:CICompilerCount=2 " # fallback, which doesn't attempt to do anything with links. SCRIPT_FILE="$(readlink -f "$0" 2>/dev/null || readlink "$0" 2>/dev/null || echo "$0")" SCRIPT_DIR="${SCRIPT_FILE%/*}" -SUPPORT_DIR="${SCRIPT_DIR}/../../../support" +SUPPORT_DIR="${SCRIPT_DIR}/../../../../support" if ! [ -f "${SUPPORT_DIR}/launch.properties" ]; then - SUPPORT_DIR="${SCRIPT_DIR}/../../RuntimeScripts/Linux/support" + SUPPORT_DIR="${SCRIPT_DIR}/../../../RuntimeScripts/Linux/support" fi # Launch ISF Server. diff --git a/Ghidra/Debug/Debugger-jpda/README.md b/Ghidra/Debug/Debugger-jpda/README.md new file mode 100644 index 0000000000..d63d7414f3 --- /dev/null +++ b/Ghidra/Debug/Debugger-jpda/README.md @@ -0,0 +1 @@ +# Debugger-jpda diff --git a/Ghidra/Debug/Debugger-jpda/certification.manifest b/Ghidra/Debug/Debugger-jpda/certification.manifest index adcba046d9..354784e591 100644 --- a/Ghidra/Debug/Debugger-jpda/certification.manifest +++ b/Ghidra/Debug/Debugger-jpda/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/debugger-launchers/attach-java.jsh||GHIDRA||||END| data/debugger-launchers/bypid-java.jsh||GHIDRA||||END| data/debugger-launchers/local-java.jsh||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-rmi-trace/README.md b/Ghidra/Debug/Debugger-rmi-trace/README.md new file mode 100644 index 0000000000..e7a8e0596c --- /dev/null +++ b/Ghidra/Debug/Debugger-rmi-trace/README.md @@ -0,0 +1 @@ +# Debugger-rmi-trace diff --git a/Ghidra/Debug/Debugger-rmi-trace/certification.manifest b/Ghidra/Debug/Debugger-rmi-trace/certification.manifest index e339fc31b5..3beeb10bb8 100644 --- a/Ghidra/Debug/Debugger-rmi-trace/certification.manifest +++ b/Ghidra/Debug/Debugger-rmi-trace/certification.manifest @@ -3,6 +3,7 @@ ##MODULE IP: BSD-3-PSUTIL DEVNOTES.txt||GHIDRA||||END| Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/TraceRmiConnectionManagerPlugin/TraceRmiConnectionManagerPlugin.html||GHIDRA||||END| diff --git a/Ghidra/Debug/Debugger-swig-lldb/README.md b/Ghidra/Debug/Debugger-swig-lldb/README.md new file mode 100644 index 0000000000..0618277385 --- /dev/null +++ b/Ghidra/Debug/Debugger-swig-lldb/README.md @@ -0,0 +1 @@ +# Debugger-swig-lldb diff --git a/Ghidra/Debug/Debugger-swig-lldb/certification.manifest b/Ghidra/Debug/Debugger-swig-lldb/certification.manifest index fc0dff555c..20f2bf68e7 100644 --- a/Ghidra/Debug/Debugger-swig-lldb/certification.manifest +++ b/Ghidra/Debug/Debugger-swig-lldb/certification.manifest @@ -3,6 +3,7 @@ ##MODULE IP: Apache License 2.0 with LLVM Exceptions InstructionsForBuildingLLDBInterface.txt||GHIDRA||||END| Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| build.gradle||GHIDRA||||END| src/llvm-project/lldb/bindings/java/java-typemaps.swig||Apache License 2.0 with LLVM Exceptions||||END| src/llvm-project/lldb/bindings/java/java.swig||Apache License 2.0 with LLVM Exceptions||||END| diff --git a/Ghidra/Debug/Debugger/README.md b/Ghidra/Debug/Debugger/README.md new file mode 100644 index 0000000000..b0f56432b8 --- /dev/null +++ b/Ghidra/Debug/Debugger/README.md @@ -0,0 +1 @@ +# Debugger diff --git a/Ghidra/Debug/Debugger/certification.manifest b/Ghidra/Debug/Debugger/certification.manifest index 9d341db90b..3c55cc5b0d 100644 --- a/Ghidra/Debug/Debugger/certification.manifest +++ b/Ghidra/Debug/Debugger/certification.manifest @@ -5,6 +5,7 @@ ##MODULE IP: Oxygen Icons - LGPL 3.0 ##MODULE IP: Tango Icons - Public Domain Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/debugger.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| diff --git a/Ghidra/Debug/Framework-AsyncComm/README.md b/Ghidra/Debug/Framework-AsyncComm/README.md new file mode 100644 index 0000000000..9249390a40 --- /dev/null +++ b/Ghidra/Debug/Framework-AsyncComm/README.md @@ -0,0 +1 @@ +# Framework-AsyncComm diff --git a/Ghidra/Debug/Framework-AsyncComm/certification.manifest b/Ghidra/Debug/Framework-AsyncComm/certification.manifest index c163a88c69..dc139ab07c 100644 --- a/Ghidra/Debug/Framework-AsyncComm/certification.manifest +++ b/Ghidra/Debug/Framework-AsyncComm/certification.manifest @@ -1,3 +1,4 @@ ##VERSION: 2.0 ##MODULE IP: BSD-3-GOOGLE Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Debug/Framework-Debugging/README.md b/Ghidra/Debug/Framework-Debugging/README.md new file mode 100644 index 0000000000..7798ce1442 --- /dev/null +++ b/Ghidra/Debug/Framework-Debugging/README.md @@ -0,0 +1 @@ +# Framework-Debugging diff --git a/Ghidra/Debug/Framework-Debugging/certification.manifest b/Ghidra/Debug/Framework-Debugging/certification.manifest index 3cf64be0b6..9e9e246da1 100644 --- a/Ghidra/Debug/Framework-Debugging/certification.manifest +++ b/Ghidra/Debug/Framework-Debugging/certification.manifest @@ -1,6 +1,7 @@ ##VERSION: 2.0 ##MODULE IP: Apache License 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| src/main/resources/agent.log4j.xml||GHIDRA||||END| src/main/resources/log4j-appender-console.xml||GHIDRA||||END| diff --git a/Ghidra/Debug/Framework-TraceModeling/README.md b/Ghidra/Debug/Framework-TraceModeling/README.md new file mode 100644 index 0000000000..b1f9b8e98f --- /dev/null +++ b/Ghidra/Debug/Framework-TraceModeling/README.md @@ -0,0 +1 @@ +# Framework-TraceModeling diff --git a/Ghidra/Debug/Framework-TraceModeling/certification.manifest b/Ghidra/Debug/Framework-TraceModeling/certification.manifest index f59b605fe9..7ea17c8468 100644 --- a/Ghidra/Debug/Framework-TraceModeling/certification.manifest +++ b/Ghidra/Debug/Framework-TraceModeling/certification.manifest @@ -1,3 +1,4 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/tracemodeling.theme.properties||GHIDRA||||END| diff --git a/Ghidra/Debug/ProposedUtils/README.md b/Ghidra/Debug/ProposedUtils/README.md new file mode 100644 index 0000000000..1a4689f5a6 --- /dev/null +++ b/Ghidra/Debug/ProposedUtils/README.md @@ -0,0 +1 @@ +# ProposedUtils diff --git a/Ghidra/Debug/ProposedUtils/certification.manifest b/Ghidra/Debug/ProposedUtils/certification.manifest index ab3e50857c..6c405ffaf5 100644 --- a/Ghidra/Debug/ProposedUtils/certification.manifest +++ b/Ghidra/Debug/ProposedUtils/certification.manifest @@ -1,4 +1,5 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| build.gradle||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| diff --git a/Ghidra/Extensions/BSimElasticPlugin/INSTALL.txt b/Ghidra/Extensions/BSimElasticPlugin/INSTALL.txt deleted file mode 100755 index b84395214f..0000000000 --- a/Ghidra/Extensions/BSimElasticPlugin/INSTALL.txt +++ /dev/null @@ -1,99 +0,0 @@ -Installation of the Elasticsearch BSim Plug-in: - -In order to use Elasticsearch as the back-end database for a BSim instance, -the lsh plug-in, included with this Ghidra extension, must be installed on -the Elasticsearch cluster. - -The lsh plug-in is bundled in the standard plug-in format as the file -'lsh.zip'. It must be installed separately on EVERY node of the cluster, -and each node must be restarted after the install in order for the plug-in to -become active. - -For a single node, installation is accomplished with the command-line -'elasticsearch-plugin' script that comes with the standard Elasticsearch -distribution. It expects a URL pointing to the plug-in to be installed. -The basic command, executed in the Elasticsearch installation directory -for the node, is - - bin/elasticsearch-plugin install file:///path/to/ghidra/Ghidra/Extensions/BSimElasticPlugin/data/lsh.zip - -Replace the initial portion of the absolute path in the URL to point to your -particular Ghidra installation. - -Deployment: - -Follow the Elasticsearch documentation to do any additional configuration, -starting, stopping, and management of your Elasticsearch cluster. - -To try BSim with a toy deployment, you can start a single node (as per the -documentation) from the command-line by just running - - bin/elasticsearch - -This will dump logging messages to the console, and you should see '[lsh]' -listed among the loaded plug-ins as the node starts up. - -This will typically start the database with password authentication enabled. An -'elastic' user will be automatically created with a randomly generated password that -gets printed to the console the first time the node is started. To add additional -users, use a curl command like - -curl -k -u elastic:XXXXXX -X POST "https://localhost:9200/_security/user/ghidrauser?pretty" -H 'Content-Type: application/json' -d' -{ - "password" : "changeme", - "roles" : [ "superuser" ], - "full_name" : "Ghidra User", - "email" : "ghidrauser@example.com" -} -' - -Replace XXXXXX with the generated password for the 'elastic' user. This example -creates a user 'ghidrauser', with administrator privileges. The built-in role -'viewer' can be used to create users with read-only access to the database. - -Once the Elasticsearch node(s) are running, whether they are a toy or a full -deployment, you can immediately proceed to the BSim 'bsim' command. -The Ghidra/BSim client and 'bsim' command automatically assume an -Elasticsearch server when they see the 'https' protocol in the provided URLs, -although the 'elastic" protocol may also be specified and is equivalent. -The use of the 'http' protocol for Elasticsearch is not supported. -Adjust the hostname, port number, and repository name as appropriate. -Use a command-line similar to the following to create a BSim instance: - - bsim createdatabase elastic://1.2.3.4:9200/repo medium_32 - -This is equivalent to: - - bsim createdatabase https://1.2.3.4:9200/repo medium_32 - -Use a command-line like this to generate and commit signatures from a Ghidra Server -repository to the Elasticsearch database created above: - - bsim generatesigs ghidra://1.2.3.4/repo --bsim elastic://1.2.3.4:9200/repo - -Within Ghidra's BSim client, enter the same URL into the database connection -panel in order to place queries to your Elasticsearch deployment. See the BSim -documentation included with Ghidra for full details. - - -Version: - -The current BSim plug-in was tested with Elasticsearch version 8.8.1. -A change to the Elasticsearch scripting interface, starting with version 7.15, makes the BSim -plug-in incompatible with previous versions, but the lsh plug-in jars may work without change -across later Elasticsearch versions. - -Elasticsearch plug-ins explicitly encode the version of Elasticsearch they work with, and the -plug-in script will refuse to install the lsh plug-in if its version does not match your -particular installation. If your Elasticsearch version is slightly different, you can try -unpacking the zip file, changing the version number to match your software, and then repacking -the zip file. Within the zip archive, the version number is stored in a configuration file - - elasticsearch/plugin-descriptor.properties - -The file format is fairly simple: edit the line - - elasticsearch.version=8.8.1 - -The plugin may work with other nearby versions, but proceed at your own risk. - diff --git a/Ghidra/Extensions/BSimElasticPlugin/README.md b/Ghidra/Extensions/BSimElasticPlugin/README.md new file mode 100644 index 0000000000..b7c224b41e --- /dev/null +++ b/Ghidra/Extensions/BSimElasticPlugin/README.md @@ -0,0 +1,99 @@ +# BSimElasticPlugin + +## Installation of the Elasticsearch BSim Plug-in +In order to use Elasticsearch as the back-end database for a BSim instance, the lsh plug-in, +included with this Ghidra extension, must be installed on the Elasticsearch cluster. + +The lsh plug-in is bundled in the standard plug-in format as the file `lsh.zip`. It must be +installed separately on EVERY node of the cluster, and each node must be restarted after the install +in order for the plug-in to become active. + +For a single node, installation is accomplished with the command-line `elasticsearch-plugin` script +that comes with the standard Elasticsearch distribution. It expects a URL pointing to the plug-in to +be installed. The basic command, executed in the Elasticsearch installation directory for the node, +is: +``` +bin/elasticsearch-plugin install file:///path/to/ghidra/Ghidra/Extensions/BSimElasticPlugin/data/lsh.zip +``` + +Replace the initial portion of the absolute path in the URL to point to your particular Ghidra +installation. + +## Deployment +Follow the Elasticsearch documentation to do any additional configuration, starting, stopping, and +management of your Elasticsearch cluster. + +To try BSim with a toy deployment, you can start a single node (as per the documentation) from the +command-line by just running +``` +bin/elasticsearch +``` + +This will dump logging messages to the console, and you should see `[lsh]` listed among the loaded +plug-ins as the node starts up. + +This will typically start the database with password authentication enabled. An `elastic` user will +be automatically created with a randomly generated password that gets printed to the console the +first time the node is started. To add additional users, use a curl command like +``` +curl -k -u elastic:XXXXXX -X POST "https://localhost:9200/_security/user/ghidrauser?pretty" -H 'Content-Type: application/json' -d' +{ + "password" : "changeme", + "roles" : [ "superuser" ], + "full_name" : "Ghidra User", + "email" : "ghidrauser@example.com" +} +``` + +Replace `XXXXXX` with the generated password for the `elastic` user. This example creates a user +`ghidrauser`, with administrator privileges. The built-in role `viewer` can be used to create users +with read-only access to the database. + +Once the Elasticsearch node(s) are running, whether they are a toy or a full deployment, you can +immediately proceed to the BSim `bsim` command. The Ghidra/BSim client and `bsim` command +automatically assume an Elasticsearch server when they see the __https__ protocol in the provided +URLs, although the __elastic__ protocol may also be specified and is equivalent. The use of the +__http__ protocol for Elasticsearch is not supported. Adjust the hostname, port number, and +repository name as appropriate. Use a command-line similar to the following to create a BSim +instance: +``` +bsim createdatabase elastic://1.2.3.4:9200/repo medium_32 +``` + +This is equivalent to: +``` +bsim createdatabase https://1.2.3.4:9200/repo medium_32 +``` + +Use a command-line like this to generate and commit signatures from a Ghidra Server repository to +the Elasticsearch database created above: +``` +bsim generatesigs ghidra://1.2.3.4/repo --bsim elastic://1.2.3.4:9200/repo +``` + +Within Ghidra's BSim client, enter the same URL into the database connection panel in order to place +queries to your Elasticsearch deployment. See the BSim documentation included with Ghidra for full +details. + +## Version + +The current BSim plug-in was tested with Elasticsearch version `8.8.1`. A change to the +Elasticsearch scripting interface, starting with version `7.15`, makes the BSim plug-in incompatible +with previous versions, but the lsh plug-in jars may work without change across later Elasticsearch +versions. + +Elasticsearch plug-ins explicitly encode the version of Elasticsearch they work with, and the +plug-in script will refuse to install the lsh plug-in if its version does not match your +particular installation. If your Elasticsearch version is slightly different, you can try +unpacking the zip file, changing the version number to match your software, and then repacking +the zip file. Within the zip archive, the version number is stored in a configuration file +``` +elasticsearch/plugin-descriptor.properties +``` + +The file format is fairly simple: edit the line +``` +elasticsearch.version=8.8.1 +``` + +The plugin may work with other nearby versions, but proceed at your own risk. diff --git a/Ghidra/Extensions/BSimElasticPlugin/certification.manifest b/Ghidra/Extensions/BSimElasticPlugin/certification.manifest index 3724510928..8a93507d47 100755 --- a/Ghidra/Extensions/BSimElasticPlugin/certification.manifest +++ b/Ghidra/Extensions/BSimElasticPlugin/certification.manifest @@ -1,6 +1,6 @@ ##VERSION: 2.0 ##MODULE IP: Apache License 2.0 -INSTALL.txt||GHIDRA||||END| Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| contribZipExclude/plugin-descriptor.properties||GHIDRA||||END| extension.properties||GHIDRA||||END| diff --git a/Ghidra/Extensions/MachineLearning/README.md b/Ghidra/Extensions/MachineLearning/README.md new file mode 100644 index 0000000000..c59783712a --- /dev/null +++ b/Ghidra/Extensions/MachineLearning/README.md @@ -0,0 +1 @@ +# MachineLearning diff --git a/Ghidra/Extensions/MachineLearning/certification.manifest b/Ghidra/Extensions/MachineLearning/certification.manifest index a5eedd190b..a4bfe16b00 100644 --- a/Ghidra/Extensions/MachineLearning/certification.manifest +++ b/Ghidra/Extensions/MachineLearning/certification.manifest @@ -3,8 +3,8 @@ ##MODULE IP: BSD-2-ORACLE ##MODULE IP: BSD-3-GOOGLE Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| extension.properties||GHIDRA||||END| -lib/README.txt||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/RandomForestFunctionFinderPlugin/RandomForestFunctionFinderPlugin.htm||GHIDRA||||END| src/main/resources/images/README.txt||GHIDRA||||END| diff --git a/Ghidra/Extensions/SampleTablePlugin/README.md b/Ghidra/Extensions/SampleTablePlugin/README.md new file mode 100644 index 0000000000..500e6b61e5 --- /dev/null +++ b/Ghidra/Extensions/SampleTablePlugin/README.md @@ -0,0 +1 @@ +# SampleTablePlugin diff --git a/Ghidra/Extensions/SampleTablePlugin/certification.manifest b/Ghidra/Extensions/SampleTablePlugin/certification.manifest index 2e5c198cc0..18d0e22d43 100644 --- a/Ghidra/Extensions/SampleTablePlugin/certification.manifest +++ b/Ghidra/Extensions/SampleTablePlugin/certification.manifest @@ -2,6 +2,7 @@ ##MODULE IP: FAMFAMFAM Icons - CC 2.5 ##MODULE IP: Oxygen Icons - LGPL 3.0 Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/sampletableplugin.theme.properties||GHIDRA||||END| extension.properties||GHIDRA||||END| diff --git a/Ghidra/Extensions/SleighDevTools/README.md b/Ghidra/Extensions/SleighDevTools/README.md new file mode 100644 index 0000000000..a49b24aa47 --- /dev/null +++ b/Ghidra/Extensions/SleighDevTools/README.md @@ -0,0 +1 @@ +# SleighDevTools diff --git a/Ghidra/Extensions/SleighDevTools/certification.manifest b/Ghidra/Extensions/SleighDevTools/certification.manifest index d82fb5b166..f36cf561c1 100644 --- a/Ghidra/Extensions/SleighDevTools/certification.manifest +++ b/Ghidra/Extensions/SleighDevTools/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/LanguageMap.txt||GHIDRA||||END| extension.properties||GHIDRA||||END| diff --git a/Ghidra/Extensions/bundle_examples/README.md b/Ghidra/Extensions/bundle_examples/README.md new file mode 100644 index 0000000000..a9c170483b --- /dev/null +++ b/Ghidra/Extensions/bundle_examples/README.md @@ -0,0 +1 @@ +# bundle_examples diff --git a/Ghidra/Extensions/bundle_examples/certification.manifest b/Ghidra/Extensions/bundle_examples/certification.manifest index 7cbc96e96a..159c001f38 100644 --- a/Ghidra/Extensions/bundle_examples/certification.manifest +++ b/Ghidra/Extensions/bundle_examples/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| extension.properties||GHIDRA||||END| scripts_jar1/META-INF/MANIFEST.MF||GHIDRA||||END| scripts_jar2/META-INF/MANIFEST.MF||GHIDRA||||END| diff --git a/Ghidra/Extensions/sample/README.md b/Ghidra/Extensions/sample/README.md new file mode 100644 index 0000000000..4e31d2f35c --- /dev/null +++ b/Ghidra/Extensions/sample/README.md @@ -0,0 +1 @@ +# sample diff --git a/Ghidra/Extensions/sample/certification.manifest b/Ghidra/Extensions/sample/certification.manifest index 7790314feb..924963e7d0 100644 --- a/Ghidra/Extensions/sample/certification.manifest +++ b/Ghidra/Extensions/sample/certification.manifest @@ -2,6 +2,7 @@ ##MODULE IP: FAMFAMFAM Icons - CC 2.5 ##MODULE IP: Oxygen Icons - LGPL 3.0 Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| data/README.txt||GHIDRA||||END| data/sample.theme.properties||GHIDRA||||END| extension.properties||GHIDRA||||END| diff --git a/Ghidra/Features/BSim/README.md b/Ghidra/Features/BSim/README.md new file mode 100644 index 0000000000..ebdf290d08 --- /dev/null +++ b/Ghidra/Features/BSim/README.md @@ -0,0 +1 @@ +# BSim diff --git a/Ghidra/Features/BSim/build.gradle b/Ghidra/Features/BSim/build.gradle index a7b3909fe9..de0bd157e9 100755 --- a/Ghidra/Features/BSim/build.gradle +++ b/Ghidra/Features/BSim/build.gradle @@ -44,19 +44,18 @@ dependencies { // into common zip to allow for a rebuild of the postgres server if needed rootProject.assembleDistribution { + def p = this.project + def zipPath = getZipPath(p) String postgresqlDepsFile = "${DEPS_DIR}/BSim/${postgresql_distro}" String postgresqlBinRepoFile = "${BIN_REPO}/Ghidra/Features/BSim/${postgresql_distro}" def postgresqlFile = file(postgresqlDepsFile).exists() ? postgresqlDepsFile : postgresqlBinRepoFile - into (getZipPath(this.project)) { - from file("make-postgres.sh") - } - into (getZipPath(this.project)) { + into ("${zipPath}/support") { from file(postgresqlFile) } - into (getZipPath(this.project) + "/src/lshvector") { + into ("${zipPath}/src/lshvector") { from files("src/lshvector") } } diff --git a/Ghidra/Features/BSim/certification.manifest b/Ghidra/Features/BSim/certification.manifest index ed03fd0803..951b1874fb 100755 --- a/Ghidra/Features/BSim/certification.manifest +++ b/Ghidra/Features/BSim/certification.manifest @@ -11,6 +11,7 @@ ##MODULE IP: PostgresqlJDBC License ##MODULE IP: Public Domain Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/bsim.theme.properties||GHIDRA||||END| data/large_32.xml||GHIDRA||||END| data/lshweights_32.xml||GHIDRA|||Signature data|END| diff --git a/Ghidra/Features/BSim/src/main/help/help/topics/BSim/DatabaseConfiguration.html b/Ghidra/Features/BSim/src/main/help/help/topics/BSim/DatabaseConfiguration.html index b9244a645c..ad09bf241a 100644 --- a/Ghidra/Features/BSim/src/main/help/help/topics/BSim/DatabaseConfiguration.html +++ b/Ghidra/Features/BSim/src/main/help/help/topics/BSim/DatabaseConfiguration.html @@ -104,7 +104,7 @@ extension, provided as part of the Ghidra installation. Prebuilt servers, like those provided as OS distribution packages, will not work as is with BSim. For users on Linux and macOS, the Ghidra installation provides a script, make-postgres.sh, - in the module directory Ghidra/Features/BSim that builds both the PostgreSQL + in the module directory Ghidra/Features/BSim/support that builds both the PostgreSQL server and the BSim extension from source and prepares the installation for use with Ghidra. If not already included in the Ghidra installation, the source distribution file, currently postgresql-15.3.tar.gz, can be obtained from the PostgreSQL @@ -127,7 +127,7 @@
-
$(ROOT)/Ghidra/Features/BSim/postgresql-15.3.tar.gz + $(ROOT)/Ghidra/Features/BSim/support/postgresql-15.3.tar.gz
@@ -138,7 +138,7 @@
- diff --git a/Ghidra/Features/BSim/src/main/java/ghidra/features/bsim/query/BSimControlLaunchable.java b/Ghidra/Features/BSim/src/main/java/ghidra/features/bsim/query/BSimControlLaunchable.java index 9b8e7137aa..a922e02a8a 100644 --- a/Ghidra/Features/BSim/src/main/java/ghidra/features/bsim/query/BSimControlLaunchable.java +++ b/Ghidra/Features/BSim/src/main/java/ghidra/features/bsim/query/BSimControlLaunchable.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -112,7 +112,8 @@ public class BSimControlLaunchable implements GhidraLaunchable { } private final static String POSTGRES = "postgresql"; - private final static String POSTGRES_BUILD_SCRIPT = "Ghidra/Features/BSim/make-postgres.sh"; + private final static String POSTGRES_BUILD_SCRIPT = + "Ghidra/Features/BSim/support/make-postgres.sh"; private final static String POSTGRES_CONFIGFILE = "postgresql.conf"; private final static String POSTGRES_CONNECTFILE = "pg_hba.conf"; private final static String POSTGRES_IDENTFILE = "pg_ident.conf"; diff --git a/Ghidra/Features/BSim/make-postgres.sh b/Ghidra/Features/BSim/support/make-postgres.sh similarity index 80% rename from Ghidra/Features/BSim/make-postgres.sh rename to Ghidra/Features/BSim/support/make-postgres.sh index 9bdf7898b4..b36a7609cd 100755 --- a/Ghidra/Features/BSim/make-postgres.sh +++ b/Ghidra/Features/BSim/support/make-postgres.sh @@ -1,18 +1,18 @@ #!/bin/bash ## ### -# IP: GHIDRA -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. +# IP: GHIDRA +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. ## # # This script builds the postgresql server and BSim extension within a @@ -50,11 +50,12 @@ POSTGRES=postgresql-15.3 POSTGRES_GZ=${POSTGRES}.tar.gz POSTGRES_CONFIG_OPTIONS="--disable-rpath --with-openssl" -DIR=$(cd `dirname $0`; pwd) +DIR=$(cd `dirname $0`; pwd)/.. +echo $DIR POSTGRES_GZ_PATH=${DIR}/../../../../ghidra.bin/Ghidra/Features/BSim/${POSTGRES_GZ} if [ ! -f "${POSTGRES_GZ_PATH}" ]; then - POSTGRES_GZ_PATH=${DIR}/${POSTGRES_GZ} + POSTGRES_GZ_PATH=${DIR}/support/${POSTGRES_GZ} if [ ! -f "${POSTGRES_GZ_PATH}" ]; then echo "Postgres source bundle not found: ${POSTGRES_GZ_PATH}" exit -1 @@ -76,7 +77,7 @@ fi # Build postgresql -pushd build/${POSTGRES} +pushd build/${POSTGRES} if [ "$OS" = "Darwin" ]; then export MACOSX_DEPLOYMENT_TARGET=10.5 diff --git a/Ghidra/Features/BSimFeatureVisualizer/README.md b/Ghidra/Features/BSimFeatureVisualizer/README.md new file mode 100644 index 0000000000..6a98def69d --- /dev/null +++ b/Ghidra/Features/BSimFeatureVisualizer/README.md @@ -0,0 +1 @@ +# BSimFeatureVisualizer diff --git a/Ghidra/Features/BSimFeatureVisualizer/certification.manifest b/Ghidra/Features/BSimFeatureVisualizer/certification.manifest index 6665759d74..5946f5cae9 100755 --- a/Ghidra/Features/BSimFeatureVisualizer/certification.manifest +++ b/Ghidra/Features/BSimFeatureVisualizer/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/bsim.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/BSimFeatureVisualizerPlugin/BSimFeatureVisualizerPlugin.htm||GHIDRA||||END| diff --git a/Ghidra/Features/Base/README.md b/Ghidra/Features/Base/README.md new file mode 100644 index 0000000000..b095337e9e --- /dev/null +++ b/Ghidra/Features/Base/README.md @@ -0,0 +1 @@ +# Base diff --git a/Ghidra/Features/Base/certification.manifest b/Ghidra/Features/Base/certification.manifest index e96e82e7a6..197fae7184 100644 --- a/Ghidra/Features/Base/certification.manifest +++ b/Ghidra/Features/Base/certification.manifest @@ -15,6 +15,7 @@ .launch/Headless.launch||GHIDRA||||END| .launch/JShell.launch||GHIDRA||||END| Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ElfFunctionsThatDoNotReturn||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/GolangFunctionsThatDoNotReturn||GHIDRA||||END| diff --git a/Ghidra/Features/BytePatterns/README.md b/Ghidra/Features/BytePatterns/README.md new file mode 100644 index 0000000000..1461b475bf --- /dev/null +++ b/Ghidra/Features/BytePatterns/README.md @@ -0,0 +1 @@ +# BytePatterns diff --git a/Ghidra/Features/BytePatterns/certification.manifest b/Ghidra/Features/BytePatterns/certification.manifest index 99ac789f9e..2f3a6d76a5 100644 --- a/Ghidra/Features/BytePatterns/certification.manifest +++ b/Ghidra/Features/BytePatterns/certification.manifest @@ -1,6 +1,7 @@ ##VERSION: 2.0 ##MODULE IP: Oxygen Icons - LGPL 3.0 Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| data/bytepatterns.theme.properties||GHIDRA||||END| data/test/FileBitPatternInfoReaderTestFile1.xml||GHIDRA||||END| data/test/FileBitPatternInfoReaderTestFile2.xml||GHIDRA||||END| diff --git a/Ghidra/Features/ByteViewer/README.md b/Ghidra/Features/ByteViewer/README.md new file mode 100644 index 0000000000..d7138aa653 --- /dev/null +++ b/Ghidra/Features/ByteViewer/README.md @@ -0,0 +1 @@ +# ByteViewer diff --git a/Ghidra/Features/ByteViewer/certification.manifest b/Ghidra/Features/ByteViewer/certification.manifest index 108fc10ebf..25ae57f4a1 100644 --- a/Ghidra/Features/ByteViewer/certification.manifest +++ b/Ghidra/Features/ByteViewer/certification.manifest @@ -2,6 +2,7 @@ ##MODULE IP: FAMFAMFAM Icons - CC 2.5 ##MODULE IP: Oxygen Icons - LGPL 3.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||reviewed||END| data/byteviewer.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||reviewed||END| diff --git a/Ghidra/Features/CodeCompare/README.md b/Ghidra/Features/CodeCompare/README.md new file mode 100644 index 0000000000..e27809963e --- /dev/null +++ b/Ghidra/Features/CodeCompare/README.md @@ -0,0 +1 @@ +# CodeCompare diff --git a/Ghidra/Features/CodeCompare/certification.manifest b/Ghidra/Features/CodeCompare/certification.manifest index 8fae79a3bf..2c3da6e882 100755 --- a/Ghidra/Features/CodeCompare/certification.manifest +++ b/Ghidra/Features/CodeCompare/certification.manifest @@ -1,4 +1,5 @@ ##VERSION: 2.0 ##MODULE IP: LGPL 3.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/codecompare.theme.properties||GHIDRA||||END| diff --git a/Ghidra/Features/DebugUtils/README.md b/Ghidra/Features/DebugUtils/README.md new file mode 100644 index 0000000000..2a6f15744e --- /dev/null +++ b/Ghidra/Features/DebugUtils/README.md @@ -0,0 +1 @@ +# DebugUtils diff --git a/Ghidra/Features/DebugUtils/certification.manifest b/Ghidra/Features/DebugUtils/certification.manifest index 59819fa1e4..bf64a959e6 100644 --- a/Ghidra/Features/DebugUtils/certification.manifest +++ b/Ghidra/Features/DebugUtils/certification.manifest @@ -1,2 +1,3 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Features/Decompiler/README.md b/Ghidra/Features/Decompiler/README.md new file mode 100644 index 0000000000..e83280abe4 --- /dev/null +++ b/Ghidra/Features/Decompiler/README.md @@ -0,0 +1 @@ +# Decompiler diff --git a/Ghidra/Features/Decompiler/certification.manifest b/Ghidra/Features/Decompiler/certification.manifest index 2e4307fb1b..8e7f2fab8c 100644 --- a/Ghidra/Features/Decompiler/certification.manifest +++ b/Ghidra/Features/Decompiler/certification.manifest @@ -6,6 +6,7 @@ ##MODULE IP: Tango Icons - Public Domain ##MODULE IP: zlib License Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/decompiler.theme.properties||GHIDRA||||END| src/decompile/.cproject||GHIDRA||||END| src/decompile/cpp/.gitignore||GHIDRA||||END| diff --git a/Ghidra/Features/DecompilerDependent/README.md b/Ghidra/Features/DecompilerDependent/README.md new file mode 100644 index 0000000000..3b00c58a0f --- /dev/null +++ b/Ghidra/Features/DecompilerDependent/README.md @@ -0,0 +1 @@ +# DecompilerDependent diff --git a/Ghidra/Features/DecompilerDependent/certification.manifest b/Ghidra/Features/DecompilerDependent/certification.manifest index b428bddc97..12dbefcacd 100644 --- a/Ghidra/Features/DecompilerDependent/certification.manifest +++ b/Ghidra/Features/DecompilerDependent/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/decompiler.dependent.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| diff --git a/Ghidra/Features/FileFormats/README.md b/Ghidra/Features/FileFormats/README.md new file mode 100644 index 0000000000..dd68e23e6c --- /dev/null +++ b/Ghidra/Features/FileFormats/README.md @@ -0,0 +1 @@ +# FileFormats diff --git a/Ghidra/Features/FileFormats/certification.manifest b/Ghidra/Features/FileFormats/certification.manifest index c1fcf570e1..0944b3210d 100644 --- a/Ghidra/Features/FileFormats/certification.manifest +++ b/Ghidra/Features/FileFormats/certification.manifest @@ -10,6 +10,7 @@ ##MODULE IP: LGPL 2.1 ##MODULE IP: Public Domain Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/android/eclipse-classpath||GHIDRA||reviewed||END| data/android/eclipse-project||GHIDRA||reviewed||END| diff --git a/Ghidra/Features/FunctionGraph/README.md b/Ghidra/Features/FunctionGraph/README.md new file mode 100644 index 0000000000..f5edbf5e60 --- /dev/null +++ b/Ghidra/Features/FunctionGraph/README.md @@ -0,0 +1 @@ +# FunctionGraph diff --git a/Ghidra/Features/FunctionGraph/certification.manifest b/Ghidra/Features/FunctionGraph/certification.manifest index ebddfd6db5..9759b3d2ae 100644 --- a/Ghidra/Features/FunctionGraph/certification.manifest +++ b/Ghidra/Features/FunctionGraph/certification.manifest @@ -4,6 +4,7 @@ ##MODULE IP: Oxygen Icons - LGPL 3.0 ##MODULE IP: Tango Icons - Public Domain Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/functiongraph.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| diff --git a/Ghidra/Features/FunctionGraphDecompilerExtension/README.md b/Ghidra/Features/FunctionGraphDecompilerExtension/README.md new file mode 100644 index 0000000000..451f221400 --- /dev/null +++ b/Ghidra/Features/FunctionGraphDecompilerExtension/README.md @@ -0,0 +1 @@ +# FunctionGraphDecompilerExtension diff --git a/Ghidra/Features/FunctionGraphDecompilerExtension/certification.manifest b/Ghidra/Features/FunctionGraphDecompilerExtension/certification.manifest index 3550183332..3ded7206db 100644 --- a/Ghidra/Features/FunctionGraphDecompilerExtension/certification.manifest +++ b/Ghidra/Features/FunctionGraphDecompilerExtension/certification.manifest @@ -1,4 +1,5 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/functiongraph.extension.decompiler.theme.properties||GHIDRA||||END| src/main/resources/images/function_graph_code_flow.png||GHIDRA||reviewed||END| diff --git a/Ghidra/Features/FunctionID/README.md b/Ghidra/Features/FunctionID/README.md new file mode 100644 index 0000000000..28b1723214 --- /dev/null +++ b/Ghidra/Features/FunctionID/README.md @@ -0,0 +1 @@ +# FunctionID diff --git a/Ghidra/Features/FunctionID/certification.manifest b/Ghidra/Features/FunctionID/certification.manifest index 5a7bbe3386..7c5dc459f5 100644 --- a/Ghidra/Features/FunctionID/certification.manifest +++ b/Ghidra/Features/FunctionID/certification.manifest @@ -1,6 +1,7 @@ ##VERSION: 2.0 ##MODULE IP: Nuvola Icons - LGPL 2.1 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/building_fid.txt||GHIDRA||||END| data/common_symbols_win32.txt||GHIDRA|||Symbols used to generate fiddb files distributed with Ghidra|END| data/common_symbols_win64.txt||GHIDRA|||Symbols used to generate fiddb files distributed with Ghidra|END| diff --git a/Ghidra/Features/GhidraGo/README.md b/Ghidra/Features/GhidraGo/README.md new file mode 100644 index 0000000000..c2f5054c32 --- /dev/null +++ b/Ghidra/Features/GhidraGo/README.md @@ -0,0 +1 @@ +# GhidraGo diff --git a/Ghidra/Features/GhidraGo/certification.manifest b/Ghidra/Features/GhidraGo/certification.manifest index 69125eb9f8..06fd52b5b7 100644 --- a/Ghidra/Features/GhidraGo/certification.manifest +++ b/Ghidra/Features/GhidraGo/certification.manifest @@ -1,4 +1,5 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/GhidraGo/GhidraGo.html||GHIDRA||||END| diff --git a/Ghidra/Features/GhidraServer/README.md b/Ghidra/Features/GhidraServer/README.md new file mode 100644 index 0000000000..e03570d6e6 --- /dev/null +++ b/Ghidra/Features/GhidraServer/README.md @@ -0,0 +1 @@ +# GhidraServer diff --git a/Ghidra/Features/GhidraServer/certification.manifest b/Ghidra/Features/GhidraServer/certification.manifest index 62e2ccc857..d0f0fa2d8d 100644 --- a/Ghidra/Features/GhidraServer/certification.manifest +++ b/Ghidra/Features/GhidraServer/certification.manifest @@ -3,6 +3,7 @@ ##MODULE IP: LGPL 2.1 ##MODULE IP: Tango Icons - Public Domain Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/serial.filter||GHIDRA||||END| os/readme.txt||GHIDRA||||END| src/main/java/ghidra/server/remote/ServerHelp.txt||GHIDRA||||END| diff --git a/Ghidra/Features/GnuDemangler/README.md b/Ghidra/Features/GnuDemangler/README.md new file mode 100644 index 0000000000..e338c9018b --- /dev/null +++ b/Ghidra/Features/GnuDemangler/README.md @@ -0,0 +1 @@ +# GnuDemangler diff --git a/Ghidra/Features/GnuDemangler/certification.manifest b/Ghidra/Features/GnuDemangler/certification.manifest index d91e2ae41b..327735d36c 100644 --- a/Ghidra/Features/GnuDemangler/certification.manifest +++ b/Ghidra/Features/GnuDemangler/certification.manifest @@ -1,4 +1,5 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/default.gnu.demangler.replacements.txt||GHIDRA||||END| src/test/resources/ghidra/app/util/demangler/gnu_mangled_names.txt||GHIDRA||reviewed||END| diff --git a/Ghidra/Features/GraphFunctionCalls/README.md b/Ghidra/Features/GraphFunctionCalls/README.md new file mode 100644 index 0000000000..c50c016148 --- /dev/null +++ b/Ghidra/Features/GraphFunctionCalls/README.md @@ -0,0 +1 @@ +# GraphFunctionCalls diff --git a/Ghidra/Features/GraphFunctionCalls/certification.manifest b/Ghidra/Features/GraphFunctionCalls/certification.manifest index cd6895cd38..a29474992a 100644 --- a/Ghidra/Features/GraphFunctionCalls/certification.manifest +++ b/Ghidra/Features/GraphFunctionCalls/certification.manifest @@ -1,6 +1,7 @@ ##VERSION: 2.0 ##MODULE IP: Oxygen Icons - LGPL 3.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/functioncallgraph.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/FunctionCallGraphPlugin/Function_Call_Graph.html||GHIDRA||||END| diff --git a/Ghidra/Features/GraphServices/README.md b/Ghidra/Features/GraphServices/README.md new file mode 100644 index 0000000000..4431620e4e --- /dev/null +++ b/Ghidra/Features/GraphServices/README.md @@ -0,0 +1 @@ +# GraphServices diff --git a/Ghidra/Features/GraphServices/certification.manifest b/Ghidra/Features/GraphServices/certification.manifest index 8640954b5a..cfbdbe9566 100644 --- a/Ghidra/Features/GraphServices/certification.manifest +++ b/Ghidra/Features/GraphServices/certification.manifest @@ -7,6 +7,7 @@ ##MODULE IP: Oxygen Icons - LGPL 3.0 ##MODULE IP: Tango Icons - Public Domain Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/graphservices.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| diff --git a/Ghidra/Features/Jython/README.md b/Ghidra/Features/Jython/README.md new file mode 100644 index 0000000000..3950134c5b --- /dev/null +++ b/Ghidra/Features/Jython/README.md @@ -0,0 +1 @@ +# Jython diff --git a/Ghidra/Features/Jython/certification.manifest b/Ghidra/Features/Jython/certification.manifest index d3b4b1eb36..7c7d60d6ba 100644 --- a/Ghidra/Features/Jython/certification.manifest +++ b/Ghidra/Features/Jython/certification.manifest @@ -2,6 +2,7 @@ ##MODULE IP: Jython License ##MODULE IP: LGPL 2.1 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/jython.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/Jython/interpreter.html||GHIDRA||||END| diff --git a/Ghidra/Features/MicrosoftCodeAnalyzer/README.md b/Ghidra/Features/MicrosoftCodeAnalyzer/README.md new file mode 100644 index 0000000000..0016785733 --- /dev/null +++ b/Ghidra/Features/MicrosoftCodeAnalyzer/README.md @@ -0,0 +1 @@ +# MicrosoftCodeAnalyzer diff --git a/Ghidra/Features/MicrosoftCodeAnalyzer/certification.manifest b/Ghidra/Features/MicrosoftCodeAnalyzer/certification.manifest index 59819fa1e4..bf64a959e6 100644 --- a/Ghidra/Features/MicrosoftCodeAnalyzer/certification.manifest +++ b/Ghidra/Features/MicrosoftCodeAnalyzer/certification.manifest @@ -1,2 +1,3 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Features/MicrosoftDemangler/README.md b/Ghidra/Features/MicrosoftDemangler/README.md new file mode 100644 index 0000000000..c807bd368c --- /dev/null +++ b/Ghidra/Features/MicrosoftDemangler/README.md @@ -0,0 +1 @@ +# MicrosoftDemangler diff --git a/Ghidra/Features/MicrosoftDemangler/certification.manifest b/Ghidra/Features/MicrosoftDemangler/certification.manifest index 59819fa1e4..bf64a959e6 100644 --- a/Ghidra/Features/MicrosoftDemangler/certification.manifest +++ b/Ghidra/Features/MicrosoftDemangler/certification.manifest @@ -1,2 +1,3 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Features/MicrosoftDmang/README.md b/Ghidra/Features/MicrosoftDmang/README.md new file mode 100644 index 0000000000..7e261f6182 --- /dev/null +++ b/Ghidra/Features/MicrosoftDmang/README.md @@ -0,0 +1 @@ +# MicrosoftDmang diff --git a/Ghidra/Features/MicrosoftDmang/certification.manifest b/Ghidra/Features/MicrosoftDmang/certification.manifest index 99d26fe55e..8618ff9887 100644 --- a/Ghidra/Features/MicrosoftDmang/certification.manifest +++ b/Ghidra/Features/MicrosoftDmang/certification.manifest @@ -1,3 +1,4 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| src/main/java/mdemangler/MDMang_README.txt||GHIDRA||||END| diff --git a/Ghidra/Features/PDB/README.md b/Ghidra/Features/PDB/README.md new file mode 100644 index 0000000000..f9e4f223b5 --- /dev/null +++ b/Ghidra/Features/PDB/README.md @@ -0,0 +1 @@ +# PDB diff --git a/Ghidra/Features/PDB/certification.manifest b/Ghidra/Features/PDB/certification.manifest index c52a7cc7ae..89070e6ce6 100644 --- a/Ghidra/Features/PDB/certification.manifest +++ b/Ghidra/Features/PDB/certification.manifest @@ -4,6 +4,7 @@ ##MODULE IP: Nuvola Icons - LGPL 2.1 ##MODULE IP: Oxygen Icons - LGPL 3.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| src/global/docs/README_PDB.html||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/Pdb/LoadPDB.html||GHIDRA||||END| diff --git a/Ghidra/Features/ProgramDiff/README.md b/Ghidra/Features/ProgramDiff/README.md new file mode 100644 index 0000000000..65550b0621 --- /dev/null +++ b/Ghidra/Features/ProgramDiff/README.md @@ -0,0 +1 @@ +# ProgramDiff diff --git a/Ghidra/Features/ProgramDiff/certification.manifest b/Ghidra/Features/ProgramDiff/certification.manifest index b8f3d7eecd..25c3c98461 100644 --- a/Ghidra/Features/ProgramDiff/certification.manifest +++ b/Ghidra/Features/ProgramDiff/certification.manifest @@ -6,6 +6,7 @@ ##MODULE IP: Oxygen Icons - LGPL 3.0 ##MODULE IP: Tango Icons - Public Domain Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/programdiff.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/Diff/Diff.htm||GHIDRA||||END| diff --git a/Ghidra/Features/ProgramGraph/README.md b/Ghidra/Features/ProgramGraph/README.md new file mode 100644 index 0000000000..d638e002c2 --- /dev/null +++ b/Ghidra/Features/ProgramGraph/README.md @@ -0,0 +1 @@ +# ProgramGraph diff --git a/Ghidra/Features/ProgramGraph/certification.manifest b/Ghidra/Features/ProgramGraph/certification.manifest index af2e2594b3..6a6b1f9875 100644 --- a/Ghidra/Features/ProgramGraph/certification.manifest +++ b/Ghidra/Features/ProgramGraph/certification.manifest @@ -1,6 +1,7 @@ ##VERSION: 2.0 ##MODULE IP: Oxygen Icons - LGPL 3.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/ProgramGraphPlugin/ProgramGraph.htm||GHIDRA||||END| src/main/help/help/topics/ProgramGraphPlugin/images/BasicBlockExampleCode.png||GHIDRA||||END| diff --git a/Ghidra/Features/PyGhidra/README.md b/Ghidra/Features/PyGhidra/README.md new file mode 100644 index 0000000000..c485eb46a5 --- /dev/null +++ b/Ghidra/Features/PyGhidra/README.md @@ -0,0 +1 @@ +# PyGhidra diff --git a/Ghidra/Features/PyGhidra/build.gradle b/Ghidra/Features/PyGhidra/build.gradle index 29af546104..655bbeb147 100644 --- a/Ghidra/Features/PyGhidra/build.gradle +++ b/Ghidra/Features/PyGhidra/build.gradle @@ -78,15 +78,3 @@ task installEditablePyGhidra(type: Exec) { if (findPython3(false)) { rootProject.prepDev.dependsOn installEditablePyGhidra } - -// Add pyghidra_launcher.py to the release -rootProject.assembleDistribution { - dependsOn(buildPyPackage) - def p = this.project - def zipPath = getZipPath(p) - from (this.project.projectDir.toString()) { - include "pyghidra_launcher.py" - into { zipPath } - } -} - diff --git a/Ghidra/Features/PyGhidra/certification.manifest b/Ghidra/Features/PyGhidra/certification.manifest index d39c2306f0..ebf8c62a6c 100644 --- a/Ghidra/Features/PyGhidra/certification.manifest +++ b/Ghidra/Features/PyGhidra/certification.manifest @@ -9,6 +9,7 @@ .launch/_PyGhidra GUI Debug.launch||GHIDRA||||END| .launch/_PyGhidra Interpreter Debug.launch||GHIDRA||||END| Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/python.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/PyGhidra/interpreter.html||GHIDRA||||END| diff --git a/Ghidra/Features/PyGhidra/pyghidra_launcher.py b/Ghidra/Features/PyGhidra/support/pyghidra_launcher.py similarity index 100% rename from Ghidra/Features/PyGhidra/pyghidra_launcher.py rename to Ghidra/Features/PyGhidra/support/pyghidra_launcher.py diff --git a/Ghidra/Features/Recognizers/README.md b/Ghidra/Features/Recognizers/README.md new file mode 100644 index 0000000000..b784d88f8a --- /dev/null +++ b/Ghidra/Features/Recognizers/README.md @@ -0,0 +1 @@ +# Recognizers diff --git a/Ghidra/Features/Recognizers/certification.manifest b/Ghidra/Features/Recognizers/certification.manifest index 895ac4b698..6841c5219a 100644 --- a/Ghidra/Features/Recognizers/certification.manifest +++ b/Ghidra/Features/Recognizers/certification.manifest @@ -1,2 +1,3 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Features/Sarif/README.md b/Ghidra/Features/Sarif/README.md new file mode 100644 index 0000000000..c132f43fde --- /dev/null +++ b/Ghidra/Features/Sarif/README.md @@ -0,0 +1 @@ +# Sarif diff --git a/Ghidra/Features/Sarif/certification.manifest b/Ghidra/Features/Sarif/certification.manifest index 8f1376792a..1b8f24a59b 100644 --- a/Ghidra/Features/Sarif/certification.manifest +++ b/Ghidra/Features/Sarif/certification.manifest @@ -1,6 +1,7 @@ ##VERSION: 2.0 ##MODULE IP: MIT Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/Sarif/SARIF.htm||GHIDRA||||END| diff --git a/Ghidra/Features/SourceCodeLookup/README.md b/Ghidra/Features/SourceCodeLookup/README.md new file mode 100644 index 0000000000..56fd92b088 --- /dev/null +++ b/Ghidra/Features/SourceCodeLookup/README.md @@ -0,0 +1 @@ +# SourceCodeLookup diff --git a/Ghidra/Features/SourceCodeLookup/certification.manifest b/Ghidra/Features/SourceCodeLookup/certification.manifest index 913b81f759..b98adb8b05 100644 --- a/Ghidra/Features/SourceCodeLookup/certification.manifest +++ b/Ghidra/Features/SourceCodeLookup/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 ##MODULE IP: Oxygen Icons - LGPL 3.0 Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/SourceCodeLookupPlugin/Source_Code_Lookup.html||GHIDRA||||END| diff --git a/Ghidra/Features/SwiftDemangler/README.md b/Ghidra/Features/SwiftDemangler/README.md new file mode 100644 index 0000000000..bff6ba5a24 --- /dev/null +++ b/Ghidra/Features/SwiftDemangler/README.md @@ -0,0 +1 @@ +# SwiftDemangler diff --git a/Ghidra/Features/SwiftDemangler/certification.manifest b/Ghidra/Features/SwiftDemangler/certification.manifest index 895ac4b698..6841c5219a 100644 --- a/Ghidra/Features/SwiftDemangler/certification.manifest +++ b/Ghidra/Features/SwiftDemangler/certification.manifest @@ -1,2 +1,3 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Features/SystemEmulation/README.md b/Ghidra/Features/SystemEmulation/README.md new file mode 100644 index 0000000000..0f16029e29 --- /dev/null +++ b/Ghidra/Features/SystemEmulation/README.md @@ -0,0 +1 @@ +# SystemEmulation diff --git a/Ghidra/Features/SystemEmulation/certification.manifest b/Ghidra/Features/SystemEmulation/certification.manifest index 895ac4b698..6841c5219a 100644 --- a/Ghidra/Features/SystemEmulation/certification.manifest +++ b/Ghidra/Features/SystemEmulation/certification.manifest @@ -1,2 +1,3 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Features/VersionTracking/README.md b/Ghidra/Features/VersionTracking/README.md new file mode 100644 index 0000000000..8447fda7e1 --- /dev/null +++ b/Ghidra/Features/VersionTracking/README.md @@ -0,0 +1 @@ +# VersionTracking diff --git a/Ghidra/Features/VersionTracking/certification.manifest b/Ghidra/Features/VersionTracking/certification.manifest index 3e8f42116b..a4666dbcb4 100644 --- a/Ghidra/Features/VersionTracking/certification.manifest +++ b/Ghidra/Features/VersionTracking/certification.manifest @@ -4,6 +4,7 @@ ##MODULE IP: Oxygen Icons - LGPL 3.0 ##MODULE IP: Tango Icons - Public Domain Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||reviewed||END| data/version.tracking.theme.properties||GHIDRA||||END| src/main/docs/VTClasses.png||GHIDRA||reviewed||END| diff --git a/Ghidra/Features/VersionTrackingBSim/README.md b/Ghidra/Features/VersionTrackingBSim/README.md new file mode 100644 index 0000000000..b9f50421ef --- /dev/null +++ b/Ghidra/Features/VersionTrackingBSim/README.md @@ -0,0 +1 @@ +# VersionTrackingBSim diff --git a/Ghidra/Features/VersionTrackingBSim/certification.manifest b/Ghidra/Features/VersionTrackingBSim/certification.manifest index 5b5390cfde..cd8e93e39c 100755 --- a/Ghidra/Features/VersionTrackingBSim/certification.manifest +++ b/Ghidra/Features/VersionTrackingBSim/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 ##MODULE IP: LGPL 3.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/BSimCorrelator/BSim_Correlator.html||GHIDRA||||END| diff --git a/Ghidra/Features/WildcardAssembler/README.md b/Ghidra/Features/WildcardAssembler/README.md new file mode 100644 index 0000000000..82a7a48232 --- /dev/null +++ b/Ghidra/Features/WildcardAssembler/README.md @@ -0,0 +1 @@ +# WildcardAssembler diff --git a/Ghidra/Features/WildcardAssembler/certification.manifest b/Ghidra/Features/WildcardAssembler/certification.manifest index 8f1aa79186..edbbb9dafa 100644 --- a/Ghidra/Features/WildcardAssembler/certification.manifest +++ b/Ghidra/Features/WildcardAssembler/certification.manifest @@ -2,5 +2,6 @@ ##MODULE IP: FAMFAMFAM Icons - CC 2.5 ##MODULE IP: Oxygen Icons - LGPL 3.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| src/main/help/help/topics/WildcardAssemblerModule/Wildcard_Assembler.html||GHIDRA||||END| diff --git a/Ghidra/Framework/DB/README.md b/Ghidra/Framework/DB/README.md new file mode 100644 index 0000000000..a4aca600d5 --- /dev/null +++ b/Ghidra/Framework/DB/README.md @@ -0,0 +1 @@ +# DB diff --git a/Ghidra/Framework/DB/certification.manifest b/Ghidra/Framework/DB/certification.manifest index 59819fa1e4..bf64a959e6 100644 --- a/Ghidra/Framework/DB/certification.manifest +++ b/Ghidra/Framework/DB/certification.manifest @@ -1,2 +1,3 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Framework/Docking/README.md b/Ghidra/Framework/Docking/README.md new file mode 100644 index 0000000000..bb5b94fca4 --- /dev/null +++ b/Ghidra/Framework/Docking/README.md @@ -0,0 +1 @@ +# Docking diff --git a/Ghidra/Framework/Docking/certification.manifest b/Ghidra/Framework/Docking/certification.manifest index eac279b3de..72503187a9 100644 --- a/Ghidra/Framework/Docking/certification.manifest +++ b/Ghidra/Framework/Docking/certification.manifest @@ -8,6 +8,7 @@ ##MODULE IP: Oxygen Icons - LGPL 3.0 ##MODULE IP: Tango Icons - Public Domain Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/docking.theme.properties||GHIDRA||||END| src/main/help/help/TOC_Source.xml||GHIDRA||||END| diff --git a/Ghidra/Framework/Emulation/README.md b/Ghidra/Framework/Emulation/README.md new file mode 100644 index 0000000000..649d5df0f1 --- /dev/null +++ b/Ghidra/Framework/Emulation/README.md @@ -0,0 +1 @@ +# Emulation diff --git a/Ghidra/Framework/Emulation/certification.manifest b/Ghidra/Framework/Emulation/certification.manifest index 90dcde061a..622afd9044 100644 --- a/Ghidra/Framework/Emulation/certification.manifest +++ b/Ghidra/Framework/Emulation/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| src/test/resources/mock.cspec||GHIDRA||||END| src/test/resources/mock.ldefs||GHIDRA||||END| src/test/resources/mock.pspec||GHIDRA||||END| diff --git a/Ghidra/Framework/FileSystem/README.md b/Ghidra/Framework/FileSystem/README.md new file mode 100644 index 0000000000..72cab82c40 --- /dev/null +++ b/Ghidra/Framework/FileSystem/README.md @@ -0,0 +1 @@ +# FileSystem diff --git a/Ghidra/Framework/FileSystem/certification.manifest b/Ghidra/Framework/FileSystem/certification.manifest index 268c4261f3..049e27ab98 100644 --- a/Ghidra/Framework/FileSystem/certification.manifest +++ b/Ghidra/Framework/FileSystem/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| src/main/java/ghidra/framework/client/package.html||GHIDRA||reviewed||END| src/main/java/ghidra/framework/store/db/package.html||GHIDRA||reviewed||END| src/main/java/ghidra/framework/store/local/package.html||GHIDRA||reviewed||END| diff --git a/Ghidra/Framework/Generic/README.md b/Ghidra/Framework/Generic/README.md new file mode 100644 index 0000000000..8b8c28148f --- /dev/null +++ b/Ghidra/Framework/Generic/README.md @@ -0,0 +1 @@ +# Generic diff --git a/Ghidra/Framework/Generic/certification.manifest b/Ghidra/Framework/Generic/certification.manifest index 6f5194ad66..94dc2ae741 100644 --- a/Ghidra/Framework/Generic/certification.manifest +++ b/Ghidra/Framework/Generic/certification.manifest @@ -12,6 +12,7 @@ .classpath||GHIDRA||||END| .gitignore||GHIDRA||||END| Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| src/main/java/ghidra/util/datastruct/package.html||GHIDRA||||END| src/main/java/ghidra/util/graph/attributes/package.html||GHIDRA||||END| diff --git a/Ghidra/Framework/Gui/README.md b/Ghidra/Framework/Gui/README.md new file mode 100644 index 0000000000..15c29441e9 --- /dev/null +++ b/Ghidra/Framework/Gui/README.md @@ -0,0 +1 @@ +# Gui diff --git a/Ghidra/Framework/Gui/certification.manifest b/Ghidra/Framework/Gui/certification.manifest index 866ff3ec78..db69886e7e 100644 --- a/Ghidra/Framework/Gui/certification.manifest +++ b/Ghidra/Framework/Gui/certification.manifest @@ -8,6 +8,7 @@ ##MODULE IP: Tango Icons - Public Domain .classpath||GHIDRA||||END| Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/gui.palette.theme.properties||GHIDRA||||END| data/gui.theme.properties||GHIDRA||||END| src/main/java/ghidra/framework/options/package.html||GHIDRA||||END| diff --git a/Ghidra/Framework/Help/README.md b/Ghidra/Framework/Help/README.md new file mode 100644 index 0000000000..61d37c07a1 --- /dev/null +++ b/Ghidra/Framework/Help/README.md @@ -0,0 +1 @@ +# Help diff --git a/Ghidra/Framework/Help/certification.manifest b/Ghidra/Framework/Help/certification.manifest index eff66886aa..159ca660e1 100644 --- a/Ghidra/Framework/Help/certification.manifest +++ b/Ghidra/Framework/Help/certification.manifest @@ -3,6 +3,7 @@ ##MODULE IP: GPL 2 With Classpath Exception ##MODULE IP: Oxygen Icons - LGPL 3.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| build.files/buildLocalHelp.xml||GHIDRA||||END| data/help.theme.properties||GHIDRA||||END| src/main/resources/help/shared/close16.gif||GHIDRA||||END| diff --git a/Ghidra/Framework/Project/README.md b/Ghidra/Framework/Project/README.md new file mode 100644 index 0000000000..dab306f45e --- /dev/null +++ b/Ghidra/Framework/Project/README.md @@ -0,0 +1 @@ +# Project diff --git a/Ghidra/Framework/Project/certification.manifest b/Ghidra/Framework/Project/certification.manifest index d708106508..cbe20f1f1e 100644 --- a/Ghidra/Framework/Project/certification.manifest +++ b/Ghidra/Framework/Project/certification.manifest @@ -7,6 +7,7 @@ ##MODULE IP: Public Domain ##MODULE IP: Tango Icons - Public Domain Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/project.icons.theme.properties||GHIDRA||||END| data/project.theme.properties||GHIDRA||||END| diff --git a/Ghidra/Framework/Pty/README.md b/Ghidra/Framework/Pty/README.md new file mode 100644 index 0000000000..47283290f0 --- /dev/null +++ b/Ghidra/Framework/Pty/README.md @@ -0,0 +1 @@ +# Pty diff --git a/Ghidra/Framework/Pty/certification.manifest b/Ghidra/Framework/Pty/certification.manifest index cb190baaae..c927d7143c 100644 --- a/Ghidra/Framework/Pty/certification.manifest +++ b/Ghidra/Framework/Pty/certification.manifest @@ -2,3 +2,4 @@ ##MODULE IP: Apache License 2.0 ##MODULE IP: JSch License Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Framework/SoftwareModeling/README.md b/Ghidra/Framework/SoftwareModeling/README.md new file mode 100644 index 0000000000..bc897b5244 --- /dev/null +++ b/Ghidra/Framework/SoftwareModeling/README.md @@ -0,0 +1 @@ +# SoftwareModeling diff --git a/Ghidra/Framework/SoftwareModeling/certification.manifest b/Ghidra/Framework/SoftwareModeling/certification.manifest index 565d156f60..a0ae6dbbce 100644 --- a/Ghidra/Framework/SoftwareModeling/certification.manifest +++ b/Ghidra/Framework/SoftwareModeling/certification.manifest @@ -5,6 +5,7 @@ ##MODULE IP: Tango Icons - Public Domain .launch/Sleigh.launch||GHIDRA||||END| Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/charset_info.xml||GHIDRA||||END| data/languages/compiler_spec.rxg||GHIDRA||||END| diff --git a/Ghidra/Framework/Utility/README.md b/Ghidra/Framework/Utility/README.md new file mode 100644 index 0000000000..0b58bca881 --- /dev/null +++ b/Ghidra/Framework/Utility/README.md @@ -0,0 +1 @@ +# Utility diff --git a/Ghidra/Framework/Utility/certification.manifest b/Ghidra/Framework/Utility/certification.manifest index 59819fa1e4..bf64a959e6 100644 --- a/Ghidra/Framework/Utility/certification.manifest +++ b/Ghidra/Framework/Utility/certification.manifest @@ -1,2 +1,3 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| diff --git a/Ghidra/Processors/6502/README.md b/Ghidra/Processors/6502/README.md new file mode 100644 index 0000000000..d88d4a68b7 --- /dev/null +++ b/Ghidra/Processors/6502/README.md @@ -0,0 +1 @@ +# 6502 diff --git a/Ghidra/Processors/6502/certification.manifest b/Ghidra/Processors/6502/certification.manifest index 3070490891..4664a60509 100644 --- a/Ghidra/Processors/6502/certification.manifest +++ b/Ghidra/Processors/6502/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/6502.cspec||GHIDRA||||END| data/languages/6502.ldefs||GHIDRA||||END| data/languages/6502.pspec||GHIDRA||||END| diff --git a/Ghidra/Processors/68000/README.md b/Ghidra/Processors/68000/README.md new file mode 100644 index 0000000000..db0dd1d870 --- /dev/null +++ b/Ghidra/Processors/68000/README.md @@ -0,0 +1 @@ +# 68000 diff --git a/Ghidra/Processors/68000/certification.manifest b/Ghidra/Processors/68000/certification.manifest index c8eb60ade0..55d58490e3 100644 --- a/Ghidra/Processors/68000/certification.manifest +++ b/Ghidra/Processors/68000/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/68000.cspec||GHIDRA||||END| data/languages/68000.dwarf||GHIDRA||||END| data/languages/68000.ldefs||GHIDRA||||END| diff --git a/Ghidra/Processors/8048/README.md b/Ghidra/Processors/8048/README.md new file mode 100644 index 0000000000..0ff4f01889 --- /dev/null +++ b/Ghidra/Processors/8048/README.md @@ -0,0 +1 @@ +# 8048 diff --git a/Ghidra/Processors/8048/certification.manifest b/Ghidra/Processors/8048/certification.manifest index 04a77a7ea4..45f75c6e6e 100644 --- a/Ghidra/Processors/8048/certification.manifest +++ b/Ghidra/Processors/8048/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/8048.cspec||GHIDRA||||END| data/languages/8048.ldefs||GHIDRA||||END| data/languages/8048.pspec||GHIDRA||||END| diff --git a/Ghidra/Processors/8051/README.md b/Ghidra/Processors/8051/README.md new file mode 100644 index 0000000000..e18a9ea3f1 --- /dev/null +++ b/Ghidra/Processors/8051/README.md @@ -0,0 +1 @@ +# 8051 diff --git a/Ghidra/Processors/8051/certification.manifest b/Ghidra/Processors/8051/certification.manifest index 63fc5faabc..ab3f5280a2 100644 --- a/Ghidra/Processors/8051/certification.manifest +++ b/Ghidra/Processors/8051/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/80251.cspec||GHIDRA||||END| data/languages/80251.pspec||GHIDRA||||END| data/languages/80251.sinc||GHIDRA||||END| diff --git a/Ghidra/Processors/8085/README.md b/Ghidra/Processors/8085/README.md new file mode 100644 index 0000000000..0889b3e4d5 --- /dev/null +++ b/Ghidra/Processors/8085/README.md @@ -0,0 +1 @@ +# 8085 diff --git a/Ghidra/Processors/8085/certification.manifest b/Ghidra/Processors/8085/certification.manifest index e3af5827ad..890f59d21d 100644 --- a/Ghidra/Processors/8085/certification.manifest +++ b/Ghidra/Processors/8085/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/8085.cspec||GHIDRA||||END| data/languages/8085.ldefs||GHIDRA||reviewed||END| data/languages/8085.pspec||GHIDRA||reviewed||END| diff --git a/Ghidra/Processors/AARCH64/README.md b/Ghidra/Processors/AARCH64/README.md new file mode 100644 index 0000000000..6a19d96a96 --- /dev/null +++ b/Ghidra/Processors/AARCH64/README.md @@ -0,0 +1 @@ +# AARCH64 diff --git a/Ghidra/Processors/AARCH64/certification.manifest b/Ghidra/Processors/AARCH64/certification.manifest index e4316a202f..0ccc0b2789 100644 --- a/Ghidra/Processors/AARCH64/certification.manifest +++ b/Ghidra/Processors/AARCH64/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/aarch64-pltThunks.xml||GHIDRA||||END| data/languages/AARCH64.cspec||GHIDRA||||END| data/languages/AARCH64.dwarf||GHIDRA||||END| diff --git a/Ghidra/Processors/ARM/README.md b/Ghidra/Processors/ARM/README.md new file mode 100644 index 0000000000..a5c808a637 --- /dev/null +++ b/Ghidra/Processors/ARM/README.md @@ -0,0 +1 @@ +# ARM diff --git a/Ghidra/Processors/ARM/certification.manifest b/Ghidra/Processors/ARM/certification.manifest index 07837a53b0..777e1f93dd 100644 --- a/Ghidra/Processors/ARM/certification.manifest +++ b/Ghidra/Processors/ARM/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/ARM.cspec||GHIDRA||||END| data/languages/ARM.dwarf||GHIDRA||||END| data/languages/ARM.gdis||GHIDRA||||END| diff --git a/Ghidra/Processors/Atmel/README.md b/Ghidra/Processors/Atmel/README.md new file mode 100644 index 0000000000..70ac8d3282 --- /dev/null +++ b/Ghidra/Processors/Atmel/README.md @@ -0,0 +1 @@ +# Atmel diff --git a/Ghidra/Processors/Atmel/certification.manifest b/Ghidra/Processors/Atmel/certification.manifest index 00ddbbf807..f3b63522ba 100644 --- a/Ghidra/Processors/Atmel/certification.manifest +++ b/Ghidra/Processors/Atmel/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/atmega256.pspec||GHIDRA||||END| data/languages/avr32.opinion||GHIDRA||||END| data/languages/avr32a.cspec||GHIDRA||||END| diff --git a/Ghidra/Processors/BPF/README.md b/Ghidra/Processors/BPF/README.md new file mode 100644 index 0000000000..4970dad87a --- /dev/null +++ b/Ghidra/Processors/BPF/README.md @@ -0,0 +1 @@ +# BPF diff --git a/Ghidra/Processors/BPF/certification.manifest b/Ghidra/Processors/BPF/certification.manifest index a43deae25a..8c1d024dfb 100644 --- a/Ghidra/Processors/BPF/certification.manifest +++ b/Ghidra/Processors/BPF/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/BPF.cspec||GHIDRA||||END| data/languages/BPF.ldefs||GHIDRA||||END| data/languages/BPF.pspec||GHIDRA||||END| diff --git a/Ghidra/Processors/CP1600/README.md b/Ghidra/Processors/CP1600/README.md new file mode 100644 index 0000000000..ce5d7dd3ae --- /dev/null +++ b/Ghidra/Processors/CP1600/README.md @@ -0,0 +1 @@ +# CP1600 diff --git a/Ghidra/Processors/CP1600/certification.manifest b/Ghidra/Processors/CP1600/certification.manifest index ec1036e386..c3c761f7f9 100644 --- a/Ghidra/Processors/CP1600/certification.manifest +++ b/Ghidra/Processors/CP1600/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/CP1600.cspec||GHIDRA||||END| data/languages/CP1600.ldefs||GHIDRA||||END| data/languages/CP1600.opinion||GHIDRA||||END| diff --git a/Ghidra/Processors/CR16/README.md b/Ghidra/Processors/CR16/README.md new file mode 100644 index 0000000000..895093882d --- /dev/null +++ b/Ghidra/Processors/CR16/README.md @@ -0,0 +1 @@ +# CR16 diff --git a/Ghidra/Processors/CR16/certification.manifest b/Ghidra/Processors/CR16/certification.manifest index 722e9fa2d1..b2d83104c0 100644 --- a/Ghidra/Processors/CR16/certification.manifest +++ b/Ghidra/Processors/CR16/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/build.xml||GHIDRA||||END| data/languages/CR16.cspec||GHIDRA||||END| data/languages/CR16.ldefs||GHIDRA||||END| diff --git a/Ghidra/Processors/DATA/README.md b/Ghidra/Processors/DATA/README.md new file mode 100644 index 0000000000..ff1843eee4 --- /dev/null +++ b/Ghidra/Processors/DATA/README.md @@ -0,0 +1 @@ +# DATA diff --git a/Ghidra/Processors/DATA/certification.manifest b/Ghidra/Processors/DATA/certification.manifest index 9dd5cce35c..e8ac56de70 100644 --- a/Ghidra/Processors/DATA/certification.manifest +++ b/Ghidra/Processors/DATA/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/data-be-64.slaspec||GHIDRA||||END| data/languages/data-le-64.slaspec||GHIDRA||||END| data/languages/data-ptr16.cspec||GHIDRA||||END| diff --git a/Ghidra/Processors/Dalvik/README.md b/Ghidra/Processors/Dalvik/README.md new file mode 100644 index 0000000000..3518929ec2 --- /dev/null +++ b/Ghidra/Processors/Dalvik/README.md @@ -0,0 +1 @@ +# Dalvik diff --git a/Ghidra/Processors/Dalvik/certification.manifest b/Ghidra/Processors/Dalvik/certification.manifest index 5a2df59c27..e171607a72 100644 --- a/Ghidra/Processors/Dalvik/certification.manifest +++ b/Ghidra/Processors/Dalvik/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/Dalvik.ldefs||GHIDRA||||END| data/languages/Dalvik.opinion||GHIDRA||||END| data/languages/Dalvik_Base.cspec||GHIDRA||||END| diff --git a/Ghidra/Processors/HCS08/README.md b/Ghidra/Processors/HCS08/README.md new file mode 100644 index 0000000000..f7c9ec9f73 --- /dev/null +++ b/Ghidra/Processors/HCS08/README.md @@ -0,0 +1 @@ +# HCS08 diff --git a/Ghidra/Processors/HCS08/certification.manifest b/Ghidra/Processors/HCS08/certification.manifest index 7da80ef97b..0eefdf5a16 100644 --- a/Ghidra/Processors/HCS08/certification.manifest +++ b/Ghidra/Processors/HCS08/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/HC05-M68HC05TB.pspec||GHIDRA||||END| data/languages/HC05.cspec||GHIDRA||||END| data/languages/HC05.ldefs||GHIDRA||||END| diff --git a/Ghidra/Processors/HCS12/README.md b/Ghidra/Processors/HCS12/README.md new file mode 100644 index 0000000000..e5b7e31f71 --- /dev/null +++ b/Ghidra/Processors/HCS12/README.md @@ -0,0 +1 @@ +# HCS12 diff --git a/Ghidra/Processors/HCS12/certification.manifest b/Ghidra/Processors/HCS12/certification.manifest index 272fd59042..18fe63ef9b 100644 --- a/Ghidra/Processors/HCS12/certification.manifest +++ b/Ghidra/Processors/HCS12/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/build.xml||GHIDRA||||END| data/languages/HC12.cspec||GHIDRA||||END| data/languages/HC12.pspec||GHIDRA||||END| diff --git a/Ghidra/Processors/JVM/README.md b/Ghidra/Processors/JVM/README.md new file mode 100644 index 0000000000..867fbfb5be --- /dev/null +++ b/Ghidra/Processors/JVM/README.md @@ -0,0 +1 @@ +# JVM diff --git a/Ghidra/Processors/JVM/certification.manifest b/Ghidra/Processors/JVM/certification.manifest index 797321d013..416c6768da 100644 --- a/Ghidra/Processors/JVM/certification.manifest +++ b/Ghidra/Processors/JVM/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/ExtensionPoint.manifest||GHIDRA||||END| data/build.xml||GHIDRA||||END| data/languages/JVM.cspec||GHIDRA||||END| diff --git a/Ghidra/Processors/Loongarch/README.md b/Ghidra/Processors/Loongarch/README.md new file mode 100644 index 0000000000..643fc21759 --- /dev/null +++ b/Ghidra/Processors/Loongarch/README.md @@ -0,0 +1 @@ +# Loongarch diff --git a/Ghidra/Processors/Loongarch/certification.manifest b/Ghidra/Processors/Loongarch/certification.manifest index 04ad2afbc6..4d37fb78cd 100644 --- a/Ghidra/Processors/Loongarch/certification.manifest +++ b/Ghidra/Processors/Loongarch/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/ilp32d.cspec||GHIDRA||||END| data/languages/ilp32f.cspec||GHIDRA||||END| data/languages/lasx.sinc||GHIDRA||||END| diff --git a/Ghidra/Processors/M16C/README.md b/Ghidra/Processors/M16C/README.md new file mode 100644 index 0000000000..c9d0def561 --- /dev/null +++ b/Ghidra/Processors/M16C/README.md @@ -0,0 +1 @@ +# M16C diff --git a/Ghidra/Processors/M16C/certification.manifest b/Ghidra/Processors/M16C/certification.manifest index 06f5f2e280..11cc2a453f 100644 --- a/Ghidra/Processors/M16C/certification.manifest +++ b/Ghidra/Processors/M16C/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/M16C_60.cspec||GHIDRA||||END| data/languages/M16C_60.ldefs||GHIDRA||||END| data/languages/M16C_60.pspec||GHIDRA||||END| diff --git a/Ghidra/Processors/M8C/README.md b/Ghidra/Processors/M8C/README.md new file mode 100644 index 0000000000..e8f11de65f --- /dev/null +++ b/Ghidra/Processors/M8C/README.md @@ -0,0 +1 @@ +# M8C diff --git a/Ghidra/Processors/M8C/certification.manifest b/Ghidra/Processors/M8C/certification.manifest index dbc7a5cec7..9bcdb9d9d1 100644 --- a/Ghidra/Processors/M8C/certification.manifest +++ b/Ghidra/Processors/M8C/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/build.xml||GHIDRA||||END| data/languages/m8c.cspec||GHIDRA||||END| data/languages/m8c.ldefs||GHIDRA||||END| diff --git a/Ghidra/Processors/MC6800/README.md b/Ghidra/Processors/MC6800/README.md new file mode 100644 index 0000000000..7972f5d40c --- /dev/null +++ b/Ghidra/Processors/MC6800/README.md @@ -0,0 +1 @@ +# MC6800 diff --git a/Ghidra/Processors/MC6800/certification.manifest b/Ghidra/Processors/MC6800/certification.manifest index 390dc50b2e..5d68f17636 100644 --- a/Ghidra/Processors/MC6800/certification.manifest +++ b/Ghidra/Processors/MC6800/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/6800.ldefs||GHIDRA||||END| data/languages/6805.cspec||GHIDRA||||END| data/languages/6805.ldefs||GHIDRA||||END| diff --git a/Ghidra/Processors/MCS96/README.md b/Ghidra/Processors/MCS96/README.md new file mode 100644 index 0000000000..b365df7bb2 --- /dev/null +++ b/Ghidra/Processors/MCS96/README.md @@ -0,0 +1 @@ +# MCS96 diff --git a/Ghidra/Processors/MCS96/certification.manifest b/Ghidra/Processors/MCS96/certification.manifest index 5f9fa8c828..45bfd41927 100644 --- a/Ghidra/Processors/MCS96/certification.manifest +++ b/Ghidra/Processors/MCS96/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/build.xml||GHIDRA||||END| data/languages/MCS96.cspec||GHIDRA||||END| data/languages/MCS96.ldefs||GHIDRA||||END| diff --git a/Ghidra/Processors/MIPS/README.md b/Ghidra/Processors/MIPS/README.md new file mode 100644 index 0000000000..5faceb3389 --- /dev/null +++ b/Ghidra/Processors/MIPS/README.md @@ -0,0 +1 @@ +# MIPS diff --git a/Ghidra/Processors/MIPS/certification.manifest b/Ghidra/Processors/MIPS/certification.manifest index d2e35cd296..d7054bc7d0 100644 --- a/Ghidra/Processors/MIPS/certification.manifest +++ b/Ghidra/Processors/MIPS/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/MIPS.opinion||GHIDRA||||END| data/languages/mips.dwarf||GHIDRA||||END| data/languages/mips.ldefs||GHIDRA||||END| diff --git a/Ghidra/Processors/PA-RISC/README.md b/Ghidra/Processors/PA-RISC/README.md new file mode 100644 index 0000000000..1706affa3a --- /dev/null +++ b/Ghidra/Processors/PA-RISC/README.md @@ -0,0 +1 @@ +# PA-RISC diff --git a/Ghidra/Processors/PA-RISC/certification.manifest b/Ghidra/Processors/PA-RISC/certification.manifest index 46653811f0..454b96a0cc 100644 --- a/Ghidra/Processors/PA-RISC/certification.manifest +++ b/Ghidra/Processors/PA-RISC/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/pa-risc.ldefs||GHIDRA||||END| data/languages/pa-risc.opinion||GHIDRA||||END| data/languages/pa-risc.sinc||GHIDRA||||END| diff --git a/Ghidra/Processors/PIC/README.md b/Ghidra/Processors/PIC/README.md new file mode 100644 index 0000000000..f6003a9251 --- /dev/null +++ b/Ghidra/Processors/PIC/README.md @@ -0,0 +1 @@ +# PIC diff --git a/Ghidra/Processors/PIC/certification.manifest b/Ghidra/Processors/PIC/certification.manifest index e60fb77053..960425f0f7 100644 --- a/Ghidra/Processors/PIC/certification.manifest +++ b/Ghidra/Processors/PIC/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/PIC24.cspec||GHIDRA||||END| data/languages/PIC24.ldefs||GHIDRA||||END| data/languages/PIC24.opinion||GHIDRA||||END| diff --git a/Ghidra/Processors/PowerPC/README.md b/Ghidra/Processors/PowerPC/README.md new file mode 100644 index 0000000000..15a1883732 --- /dev/null +++ b/Ghidra/Processors/PowerPC/README.md @@ -0,0 +1 @@ +# PowerPC diff --git a/Ghidra/Processors/PowerPC/certification.manifest b/Ghidra/Processors/PowerPC/certification.manifest index 992387aed2..8894e81535 100644 --- a/Ghidra/Processors/PowerPC/certification.manifest +++ b/Ghidra/Processors/PowerPC/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/4xx.sinc||GHIDRA||||END| data/languages/FPRC.sinc||GHIDRA||||END| data/languages/PowerPC.opinion||GHIDRA||||END| diff --git a/Ghidra/Processors/RISCV/README.md b/Ghidra/Processors/RISCV/README.md new file mode 100644 index 0000000000..31dd73c9cc --- /dev/null +++ b/Ghidra/Processors/RISCV/README.md @@ -0,0 +1 @@ +# RISCV diff --git a/Ghidra/Processors/RISCV/certification.manifest b/Ghidra/Processors/RISCV/certification.manifest index 569138783b..53b21f900f 100644 --- a/Ghidra/Processors/RISCV/certification.manifest +++ b/Ghidra/Processors/RISCV/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/RV32G.pspec||GHIDRA||||END| data/languages/RV32GC.pspec||GHIDRA||||END| data/languages/RV32I.pspec||GHIDRA||||END| diff --git a/Ghidra/Processors/Sparc/README.md b/Ghidra/Processors/Sparc/README.md new file mode 100644 index 0000000000..28ccaf2b80 --- /dev/null +++ b/Ghidra/Processors/Sparc/README.md @@ -0,0 +1 @@ +# Sparc diff --git a/Ghidra/Processors/Sparc/certification.manifest b/Ghidra/Processors/Sparc/certification.manifest index b27bbfd6cd..e1cdb0ae98 100644 --- a/Ghidra/Processors/Sparc/certification.manifest +++ b/Ghidra/Processors/Sparc/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/Sparc.dwarf||GHIDRA||||END| data/languages/Sparc.opinion||GHIDRA||||END| data/languages/SparcV9.ldefs||GHIDRA||||END| diff --git a/Ghidra/Processors/SuperH/README.md b/Ghidra/Processors/SuperH/README.md new file mode 100644 index 0000000000..e4d0503d30 --- /dev/null +++ b/Ghidra/Processors/SuperH/README.md @@ -0,0 +1 @@ +# SuperH diff --git a/Ghidra/Processors/SuperH/certification.manifest b/Ghidra/Processors/SuperH/certification.manifest index 4b01ebe8d5..96eadcbbbf 100644 --- a/Ghidra/Processors/SuperH/certification.manifest +++ b/Ghidra/Processors/SuperH/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/sh-1.slaspec||GHIDRA||||END| data/languages/sh-2.slaspec||GHIDRA||||END| data/languages/sh-2a.slaspec||GHIDRA||||END| diff --git a/Ghidra/Processors/SuperH4/README.md b/Ghidra/Processors/SuperH4/README.md new file mode 100644 index 0000000000..1feb1c9117 --- /dev/null +++ b/Ghidra/Processors/SuperH4/README.md @@ -0,0 +1 @@ +# SuperH4 diff --git a/Ghidra/Processors/SuperH4/certification.manifest b/Ghidra/Processors/SuperH4/certification.manifest index db65fa8445..94ba3bb05a 100644 --- a/Ghidra/Processors/SuperH4/certification.manifest +++ b/Ghidra/Processors/SuperH4/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/build.xml||GHIDRA||||END| data/languages/SuperH4.ldefs||GHIDRA||||END| data/languages/SuperH4.opinion||GHIDRA||||END| diff --git a/Ghidra/Processors/TI_MSP430/README.md b/Ghidra/Processors/TI_MSP430/README.md new file mode 100644 index 0000000000..9c2ca86d07 --- /dev/null +++ b/Ghidra/Processors/TI_MSP430/README.md @@ -0,0 +1 @@ +# TI_MSP430 diff --git a/Ghidra/Processors/TI_MSP430/certification.manifest b/Ghidra/Processors/TI_MSP430/certification.manifest index 8fc757c16a..0a7be8d26c 100644 --- a/Ghidra/Processors/TI_MSP430/certification.manifest +++ b/Ghidra/Processors/TI_MSP430/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/TI430Common.sinc||GHIDRA||||END| data/languages/TI430X.sinc||GHIDRA||||END| data/languages/TI_MSP430.cspec||GHIDRA||||END| diff --git a/Ghidra/Processors/Toy/README.md b/Ghidra/Processors/Toy/README.md new file mode 100644 index 0000000000..09e4ea058e --- /dev/null +++ b/Ghidra/Processors/Toy/README.md @@ -0,0 +1 @@ +# Toy diff --git a/Ghidra/Processors/Toy/certification.manifest b/Ghidra/Processors/Toy/certification.manifest index c7b7516794..4491cd011a 100644 --- a/Ghidra/Processors/Toy/certification.manifest +++ b/Ghidra/Processors/Toy/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/old/ToyV00BE64.lang||GHIDRA||||END| data/languages/old/ToyV0BE64.trans||GHIDRA||||END| data/languages/old/ToyV0LE64.lang||GHIDRA||||END| diff --git a/Ghidra/Processors/V850/README.md b/Ghidra/Processors/V850/README.md new file mode 100644 index 0000000000..a21914200a --- /dev/null +++ b/Ghidra/Processors/V850/README.md @@ -0,0 +1 @@ +# V850 diff --git a/Ghidra/Processors/V850/certification.manifest b/Ghidra/Processors/V850/certification.manifest index f824c150ff..bddaec2f3c 100644 --- a/Ghidra/Processors/V850/certification.manifest +++ b/Ghidra/Processors/V850/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/Helpers/Conditions.sinc||GHIDRA||||END| data/languages/Helpers/Extras.sinc||GHIDRA||||END| data/languages/Helpers/Macros.sinc||GHIDRA||||END| diff --git a/Ghidra/Processors/Xtensa/README.md b/Ghidra/Processors/Xtensa/README.md new file mode 100644 index 0000000000..fc9a7d3449 --- /dev/null +++ b/Ghidra/Processors/Xtensa/README.md @@ -0,0 +1 @@ +# Xtensa diff --git a/Ghidra/Processors/Xtensa/certification.manifest b/Ghidra/Processors/Xtensa/certification.manifest index 11a527af56..736c1ff007 100644 --- a/Ghidra/Processors/Xtensa/certification.manifest +++ b/Ghidra/Processors/Xtensa/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/cust.sinc||GHIDRA||||END| data/languages/flix.sinc||GHIDRA||||END| data/languages/xtensa.cspec||GHIDRA||||END| diff --git a/Ghidra/Processors/Z80/README.md b/Ghidra/Processors/Z80/README.md new file mode 100644 index 0000000000..8acb059c05 --- /dev/null +++ b/Ghidra/Processors/Z80/README.md @@ -0,0 +1 @@ +# Z80 diff --git a/Ghidra/Processors/Z80/certification.manifest b/Ghidra/Processors/Z80/certification.manifest index 9a5ecf115a..64a5b0f68b 100644 --- a/Ghidra/Processors/Z80/certification.manifest +++ b/Ghidra/Processors/Z80/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/z180.pspec||GHIDRA||||END| data/languages/z180.slaspec||GHIDRA||||END| data/languages/z182.pspec||GHIDRA||||END| diff --git a/Ghidra/Processors/eBPF/README.md b/Ghidra/Processors/eBPF/README.md new file mode 100644 index 0000000000..edb36d801a --- /dev/null +++ b/Ghidra/Processors/eBPF/README.md @@ -0,0 +1 @@ +# eBPF diff --git a/Ghidra/Processors/eBPF/certification.manifest b/Ghidra/Processors/eBPF/certification.manifest index c709be0282..b27d4f3656 100644 --- a/Ghidra/Processors/eBPF/certification.manifest +++ b/Ghidra/Processors/eBPF/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/languages/eBPF.cspec||GHIDRA||||END| data/languages/eBPF.dwarf||GHIDRA||||END| data/languages/eBPF.ldefs||GHIDRA||||END| diff --git a/Ghidra/Processors/tricore/README.md b/Ghidra/Processors/tricore/README.md new file mode 100644 index 0000000000..16d84c5cd4 --- /dev/null +++ b/Ghidra/Processors/tricore/README.md @@ -0,0 +1 @@ +# tricore diff --git a/Ghidra/Processors/tricore/certification.manifest b/Ghidra/Processors/tricore/certification.manifest index 369942d44e..888df603db 100644 --- a/Ghidra/Processors/tricore/certification.manifest +++ b/Ghidra/Processors/tricore/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/build.xml||GHIDRA||||END| data/languages/tc172x.pspec||GHIDRA||||END| data/languages/tc176x.pspec||GHIDRA||||END| diff --git a/Ghidra/Processors/x86/README.md b/Ghidra/Processors/x86/README.md new file mode 100644 index 0000000000..d98c9cdc40 --- /dev/null +++ b/Ghidra/Processors/x86/README.md @@ -0,0 +1 @@ +# x86 diff --git a/Ghidra/Processors/x86/certification.manifest b/Ghidra/Processors/x86/certification.manifest index 6fbc15df88..8d64f3e60b 100644 --- a/Ghidra/Processors/x86/certification.manifest +++ b/Ghidra/Processors/x86/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||||END| +README.md||GHIDRA||||END| data/extensions/rust/unix/cc.xml||GHIDRA||||END| data/extensions/rust/unix/probe_fixup.xml||GHIDRA||||END| data/extensions/rust/unix/try_fixup.xml||GHIDRA||||END| diff --git a/Ghidra/RuntimeScripts/Linux/support/pyghidraRun b/Ghidra/RuntimeScripts/Linux/support/pyghidraRun index 9c3a0fe2f4..5ed3758386 100755 --- a/Ghidra/RuntimeScripts/Linux/support/pyghidraRun +++ b/Ghidra/RuntimeScripts/Linux/support/pyghidraRun @@ -28,6 +28,6 @@ if [ ! -d "${INSTALL_DIR}/Ghidra" ]; then INSTALL_DIR="${SCRIPT_DIR}/../../../.." fi -PYGHIDRA_LAUNCHER="${INSTALL_DIR}/Ghidra/Features/PyGhidra/pyghidra_launcher.py" +PYGHIDRA_LAUNCHER="${INSTALL_DIR}/Ghidra/Features/PyGhidra/support/pyghidra_launcher.py" python3 "${PYGHIDRA_LAUNCHER}" "${INSTALL_DIR}" ${DEV_ARG} ${VMARG_LIST} "$@" diff --git a/Ghidra/RuntimeScripts/Windows/support/pyghidraRun.bat b/Ghidra/RuntimeScripts/Windows/support/pyghidraRun.bat index 61d48139d6..2af21aac33 100644 --- a/Ghidra/RuntimeScripts/Windows/support/pyghidraRun.bat +++ b/Ghidra/RuntimeScripts/Windows/support/pyghidraRun.bat @@ -32,7 +32,7 @@ if not exist "%INSTALL_DIR%\Ghidra" ( set "INSTALL_DIR=%SCRIPT_DIR%\..\..\..\.." ) -set "PYGHIDRA_LAUNCHER=%INSTALL_DIR%\Ghidra\Features\PyGhidra\pyghidra_launcher.py +set "PYGHIDRA_LAUNCHER=%INSTALL_DIR%\Ghidra\Features\PyGhidra\support\pyghidra_launcher.py %PYTHON% "%PYGHIDRA_LAUNCHER%" "%INSTALL_DIR%" %DEV_ARG% %VMARG_LIST% %* diff --git a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevFeature/feature.xml b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevFeature/feature.xml index 54d9fd86a3..f4a0c661f6 100644 --- a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevFeature/feature.xml +++ b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevFeature/feature.xml @@ -2,7 +2,7 @@ diff --git a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/.launch/GhidraDev.launch b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/.launch/GhidraDev.launch index 219d1935e4..b78e35f9df 100644 --- a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/.launch/GhidraDev.launch +++ b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/.launch/GhidraDev.launch @@ -168,13 +168,14 @@ + - + + - @@ -183,6 +184,8 @@ + + @@ -381,10 +384,13 @@ - + + + + diff --git a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/META-INF/MANIFEST.MF b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/META-INF/MANIFEST.MF index a07e73115d..e6c54306be 100644 --- a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/META-INF/MANIFEST.MF +++ b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/META-INF/MANIFEST.MF @@ -3,7 +3,7 @@ Manifest-Version: 1.0 Bundle-ManifestVersion: 2 Bundle-Name: GhidraDev Bundle-SymbolicName: ghidra.ghidradev;singleton:=true -Bundle-Version: 4.0.0.qualifier +Bundle-Version: 4.0.1.qualifier Bundle-Activator: ghidradev.Activator Require-Bundle: org.eclipse.ant.core;bundle-version="3.7.200", org.eclipse.buildship.core;bundle-version="3.1.8", diff --git a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/README.md b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/README.md index f114b7983b..2862c17572 100644 --- a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/README.md +++ b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/README.md @@ -30,6 +30,9 @@ change with future releases. 12. [Building](#building) ## Change History +__4.0.1:__ +* New Ghidra module projects now contain a default `README.md` file. + __4.0.0:__ * GhidraDev has been upgraded to be compatible with Ghidra 11.2 and later. It is not backwards compatible with versions of Ghidra prior to 11.2. Older versions of GhidraDev will report an diff --git a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/src/main/java/ghidradev/ghidraprojectcreator/utils/GhidraModuleUtils.java b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/src/main/java/ghidradev/ghidraprojectcreator/utils/GhidraModuleUtils.java index fefabd83db..fbf377ff1c 100644 --- a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/src/main/java/ghidradev/ghidraprojectcreator/utils/GhidraModuleUtils.java +++ b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/src/main/java/ghidradev/ghidraprojectcreator/utils/GhidraModuleUtils.java @@ -193,6 +193,11 @@ public class GhidraModuleUtils { // Update language ant properties file GhidraModuleUtils.writeAntProperties(project, ghidraLayout); + // Create a README + try (PrintWriter out = new PrintWriter(new File(projectDir, "README.md"))) { + out.println("# " + project.getName()); + } + // Refactor/rename the source files, package, and help files String packageName = project.getName().toLowerCase(); for (ModuleTemplateType moduleTemplateType : moduleTemplateTypes) { diff --git a/GhidraBuild/Skeleton/README.md b/GhidraBuild/Skeleton/README.md new file mode 100644 index 0000000000..41b86bfc19 --- /dev/null +++ b/GhidraBuild/Skeleton/README.md @@ -0,0 +1 @@ +# Skeleton diff --git a/GhidraBuild/Skeleton/certification.manifest b/GhidraBuild/Skeleton/certification.manifest index d6cc5eeda9..e9c49e009b 100644 --- a/GhidraBuild/Skeleton/certification.manifest +++ b/GhidraBuild/Skeleton/certification.manifest @@ -1,5 +1,6 @@ ##VERSION: 2.0 Module.manifest||GHIDRA||reviewed||END| +README.md||GHIDRA||||END| data/README.txt||GHIDRA||||END| data/buildLanguage.xml||GHIDRA||||END| data/languages/skel.cspec||GHIDRA||||END| diff --git a/GhidraDocs/GhidraClass/BSim/BSimTutorial_Ghidra_Command_Line.md b/GhidraDocs/GhidraClass/BSim/BSimTutorial_Ghidra_Command_Line.md index ae0b1698af..9d26802148 100644 --- a/GhidraDocs/GhidraClass/BSim/BSimTutorial_Ghidra_Command_Line.md +++ b/GhidraDocs/GhidraClass/BSim/BSimTutorial_Ghidra_Command_Line.md @@ -18,7 +18,7 @@ To build the files, execute the following commands in a shell: [^1] ```bash cd /Features/BSim export CFLAGS="-O2 -g" -./make-postgres.sh +./support/make-postgres.sh mkdir ~/postgres_object_files cd build find . -name p*o -size +100000c -size -700000c -exec cp {} ~/postgres_object_files/ \; diff --git a/GhidraDocs/certification.manifest b/GhidraDocs/certification.manifest index e720cc3653..07cb838275 100644 --- a/GhidraDocs/certification.manifest +++ b/GhidraDocs/certification.manifest @@ -21,29 +21,17 @@ GhidraClass/AdvancedDevelopment/GhidraAdvancedDevelopment.html||GHIDRA|||This fi GhidraClass/AdvancedDevelopment/GhidraAdvancedDevelopment_withNotes.html||Public Domain|||Slight modification of code that is available for distribution, without restrictions, (original extremely permissive wtf license allows us to change IP to Public Domain),from https://github.com/paulrouget/dzslides.|END| GhidraClass/AdvancedDevelopment/Images/GhidraLogo64.png||GHIDRA||||END| GhidraClass/AdvancedDevelopment/Images/highLevelClasses.png||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_BSim_Command_Line.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_BSim_Command_Line.md||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_Basic_Queries.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_Basic_Queries.md||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_Creating_Database_From_GUI.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_Creating_Database_From_GUI.md||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_Enabling.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_Enabling.md||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_Evaluating_Matches.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_Evaluating_Matches.md||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_Exe_Results.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_Exe_Results.md||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_Filters.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_Filters.md||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_Ghidra_Command_Line.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_Ghidra_Command_Line.md||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_Intro.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_Intro.md||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_Overview_Queries.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_Overview_Queries.md||GHIDRA||||END| -GhidraClass/BSim/BSimTutorial_Scripting.html||GHIDRA||||END| GhidraClass/BSim/BSimTutorial_Scripting.md||GHIDRA||||END| -GhidraClass/BSim/README.html||GHIDRA||||END| GhidraClass/BSim/README.md||GHIDRA||||END| GhidraClass/BSim/images/Plus2.png||GHIDRA||||END| GhidraClass/BSim/images/actions.png||GHIDRA||||END| diff --git a/gradle/distributableGhidraModule.gradle b/gradle/distributableGhidraModule.gradle index d68a761e7f..62f2866a0a 100644 --- a/gradle/distributableGhidraModule.gradle +++ b/gradle/distributableGhidraModule.gradle @@ -28,28 +28,35 @@ apply from: "$rootProject.projectDir/gradle/support/distributionCommon.gradle" rootProject.assembleDistribution { def p = this.project - def zipPath = getZipPath(p) - from (p.projectDir.toString() + "/Module.manifest") { + from ("${p.projectDir}/Module.manifest") { into { zipPath } } + + from ("${p.projectDir}/README.md") { + into { zipPath } + } + + from ("${p.projectDir}/support") { + into { "${zipPath}/support" } + } - from (p.projectDir.toString() + "/data") { - into { zipPath + "/data" } + from ("${p.projectDir}/data") { + into { "${zipPath}/data" } exclude 'build.xml' // associated with language modules (dev use only) } - from (BIN_REPO + '/' + getGhidraRelativePath(p) + "/data") { - into { zipPath + "/data" } + from ("${BIN_REPO}/${getGhidraRelativePath(p)}/data") { + into { "${zipPath}/data" } } - from (p.projectDir.toString() + "/build/LICENSE.txt") { + from ("${p.projectDir}/build/LICENSE.txt") { into { zipPath } } // handle special case where modules build data artifacts into the build dir - from (p.projectDir.toString() + "/build/data") { + from ("${p.projectDir}/build/data") { into {zipPath + "/data" } } @@ -200,6 +207,15 @@ plugins.withType(JavaPlugin) { } } + +rootProject.assembleMarkdownToHtml { + def p = this.project + def zipPath = getZipPath(p) + + from ("${p.projectDir}/README.md") { + into { zipPath } + } +} ///////////////////////////////////////////////////////////////////////////// // Native
cd $(ROOT)/Ghidra/Features/BSim + cd $(ROOT)/Ghidra/Features/BSim/support