Ghidra 11.4

Author: xx-shitai-xx

DevGuide.md

@@ -354,6 +354,53 @@ We also provide out-of-the-box QEMU integration via GDB.
 
 When submitting help tickets and pull requests, please tag those related to the debugger with "Debugger" so that we can triage them more quickly.
 
+## Troubleshooting and Help
+
+### Eclipse Issues
+After pulling or syncing with the latest Ghidra source repository, you might run into the following
+issues in Eclipse:
+
+* __Problem:__ _There are Eclipse compilation errors that I don't know how to deal with...I give up!_
+  * __Solution:__
+    * From Eclipse, collapse all projects in the _Package Explorer_ or _Project Explorer_ by
+      clicking the `⊟` icon in that frame
+    * Locate any projects in the _Package Explorer_ or _Project Explorer_ that have little `?` icons
+      on them (these projects should no longer be in source control)
+    * Right-click on __only them__, and then click _Delete_.
+    * __CHECK__ the _"Delete project contents on disk"_ checkbox.
+    * Click _OK_ (confirm git does not contain any new unstaged files for delete)
+    * Select all projects in the _Package Explorer_ or _Project Explorer_
+    * Right-click on them, and then click _Delete_ (this may not work if projects are not collapsed)
+    * Leave _"Delete project contents on disk"_ checkbox __UNCHECKED__
+    * Click _OK_.  You should now have an empty _Package Explorer_ or _Project Explorer_.
+    * `gradle -I gradle/support/fetchDependencies.gradle`
+    * `gradle prepdev cleanEclipse eclipse buildNatives`
+    * From Eclipse, _File -> Import..._
+    * _General | Existing Projects into Workspace_
+    * Select root directory to be your downloaded or cloned ghidra source repository
+    * Check _"Search for nested projects"_
+    * Click _Finish_
+    
+    This should get Eclipse back to a fresh state. There should never be a need to re-clone the
+    repository.
+
+* __Problem:__ _The Ghidra run configurations (launchers) are missing_.
+  * __Solution:__
+    The Ghidra run configurations are kept under source control in various modules' `.launch/` 
+    directories (i.e., `Ghidra/Features/Base/.launch/`). As long as the corresponding module 
+    project is imported into Eclipse (i.e., `Features Base`), the run configurations should be
+    available in Eclipse under _Run -> Run Configurations_.  If they aren't there and the 
+    projects are imported, try closing and reopening Eclipse. 
+    
+    __NOTE:__ Sometimes you have to launch Ghidra via the _Run -> Run Configurations..._ window one
+    time for the run configuration to show up under the favorites menu in the main Eclipse button 
+    bar.
+    
+    __NOTE:__ Never address missing run configurations by manually importing them via _File -> 
+    Import... -> Run/Debug -> Launch Configurations._ This avoids the real issue and will 
+    inevitably result in duplicate run configurations showing up one day, which can cause
+    additional confusion.
+
 ## Known Issues
 * There is a known issue in Gradle that can prevent it from discovering native toolchains on Linux 
   if a non-English system locale is being used. As a workaround, set the following environment 
@@ -363,7 +410,7 @@ When submitting help tickets and pull requests, please tag those related to the
 
 [java]: https://dev.java
 [cpp]: https://isocpp.org
-[sleigh]: https://htmlpreview.github.io/?https://github.com/NationalSecurityAgency/ghidra/blob/master/GhidraDocs/languages/index.html
+[sleigh]: https://htmlpreview.github.io/?https://github.com/NationalSecurityAgency/ghidra/blob/stable/GhidraDocs/languages/index.html
 [python]: https://www.python.org
 [venv]: https://docs.python.org/3/tutorial/venv.html
 [jython]: https://www.jython.org

GPL/DMG/src/dmg/java/mobiledevices/dmg/ghidra/GDataConverterBE.java

@@ -13,9 +13,6 @@
 public class GDataConverterBE implements GDataConverter {
 	public static final GDataConverterBE INSTANCE = new GDataConverterBE();
 
-	/**
-	 * 
-	 */
 	private static final long serialVersionUID = 1L;
 
 	/**

GPL/DMG/src/dmg/java/mobiledevices/dmg/ghidra/GDataConverterLE.java

@@ -11,9 +11,7 @@
 
 public class GDataConverterLE implements GDataConverter {
 	public static GDataConverterLE INSTANCE = new GDataConverterLE();
-	/**
-	 * 
-	 */
+
 	private static final long serialVersionUID = 1L;
 
 	/**

GPL/DemanglerGnu/build.gradle

@@ -35,8 +35,8 @@ def srcVersion24 = "src/demangler_gnu_v2_24"
  */
 task zipBuildableSource(type:Zip) {
 
-	group 'private'
-	description "Collects the source files needed to build this module."
+	group = 'private'
+	description = "Collects the source files needed to build this module."
 	archiveBaseName = project.name + "-src-for-build"
 	archiveExtension = 'zip'
 

GPL/GnuDisassembler/buildGdis.gradle

@@ -76,8 +76,8 @@ gradle.taskGraph.whenReady {
  * Task to unpack the standard binutils zip file
  *******************************************************************************************/
 task binutilsUnpack {
-	description "Unpack binutils (for building gdis)"
-	group "Native Build Dependencies"
+	description = "Unpack binutils (for building gdis)"
+	group = "Native Build Dependencies"
 	outputs.file { binutilsUnpackDir }
 	onlyIf { !binutilsUnpackDir.exists() }
 
@@ -104,8 +104,8 @@ supportedPlatforms.each { platform ->
 	def artifactsDir = file("build/binutils/${platform}")
 
 	task(buildName) {
-		description "Configure and make binutils for $platform (for building gdis)"
-		group "Native Prebuild Dependencies"
+		description ="Configure and make binutils for $platform (for building gdis)"
+		group = "Native Prebuild Dependencies"
 
 		onlyIf { !configDir.exists() }
 
@@ -122,21 +122,21 @@ supportedPlatforms.each { platform ->
 			println "Configuring binutils - config directory: $configDir"
 			println "${binutilsDir}/configure --prefix=\"${configDir}\" --enable-targets=all --with-zlib=no --disable-nls --disable-werror"
 			configDir.mkdirs();
-			exec {
+			providers.exec {
 				workingDir configDir
 				commandLine "${binutilsDir}/configure", "--prefix=${configDir}", "--enable-targets=all", "--with-zlib=no", "--disable-nls",  "--disable-werror"
-			}
+			}.result.get()
 
 			println "Building binutils - config directory: $configDir"
-			exec {
+			providers.exec {
 				commandLine "make", "-C", "${configDir}", "all"
-			}
+			}.result.get()
 		}	
 	}
 
 	task(postBuildName, type: Copy) {
-		description "Copy binutil artifcacts for $platform (for building gdis)"
-		group "Native Prebuild Dependencies"
+		description = "Copy binutil artifcacts for $platform (for building gdis)"
+		group = "Native Prebuild Dependencies"
 
 		dependsOn buildName
 

GPL/nativeBuildProperties.gradle

@@ -34,39 +34,25 @@ model {
 		}
 	}	
 
-	// The toolChains block is needed because Gradle doesn't find gcc/clang on ARM-based Linux
-	// and macOS platforms without explicitly declaring their targets.  Might be a bug in the 
-	// native Gradle plugin. 
+	// The toolChains block is needed because Gradle doesn't find the native toolchain in various
+	// scenarios. These checks, can be removed when Gradle fixes them, and we advertise a
+	// minimum Gradle version that includes the fix.
 	toolChains {
-		if (isCurrentLinux()) {
-			gcc(Gcc) {
-				if (isCurrentArm_64()) {
-					target("linux_arm_64")
-				}
-			}
+		def current = getCurrentPlatformName()
+		if (isLinux(current)) {
+			// https://github.com/gradle/gradle/issues/17660 (fixed in Gradle 8.11)
+			gcc(Gcc).target(current)
+			clang(Clang).target(current)
 		}
-		if (isCurrentMac()) {
-			clang(Clang) {
-				if (isCurrentArm_64()) {
-					target("mac_arm_64")
-				}
-			}
-		}
-		if (isCurrentFreeBSD()) {
-			gcc(Gcc) {
-				if (isCurrentArm_64()) {
-					target("freebsd_arm_64")
-				} 
-				else {
-					target("freebsd_x86_64")
-				}
-			}
+		if (isFreeBSD(current)) {
+			// https://github.com/gradle/gradle/issues/32895
+			gcc(Gcc).target(current)
+			clang(Clang).target(current)
 		}
-		if (isCurrentWindows() && VISUAL_STUDIO_INSTALL_DIR) {
-			// specify installDir because Gradle doesn't find VS Build Tools.
-			// See https://github.com/gradle/gradle-native/issues/617#issuecomment-575735288
+		if (isWindows(current) && VISUAL_STUDIO_INSTALL_DIR) {
+			// https://github.com/gradle/gradle-native/issues/617#issuecomment-575735288
 			visualCpp(VisualCpp) {
-				installDir VISUAL_STUDIO_INSTALL_DIR
+				installDir = VISUAL_STUDIO_INSTALL_DIR
 			}
 		}
 	}

GPL/vsconfig.gradle

@@ -45,7 +45,7 @@ def configureVisualStudio() {
 				println "  -> Visual Studio vswhere.exe returned an error code (${vswhereExit})!"
 			}
 			println "  -> Please confirm ${vswherePath} is version 2.5 or later."
-			println "  -> Please check README.md or InstallationGuide.html to verify you are using a supported version of Visual Studio." 
+			println "  -> Please check README.md or GettingStarted.md to verify you are using a supported version of Visual Studio." 
 			return
 		}
 		def vswhereJson = new groovy.json.JsonSlurper().parseText(vswhereOutput);