Skip to content

FunctionID: Add AddSingleFunction.java Ghidra script #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
115 changes: 115 additions & 0 deletions Ghidra/Features/FunctionID/ghidra_scripts/AddSingleFunction.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@

/* ###
* 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.
*/
//Adds the function at the current address to the chosen FID library.
//@category FunctionID

import java.util.List;

import ghidra.app.script.GhidraScript;
import ghidra.feature.fid.db.*;
import ghidra.feature.fid.hash.FidHashQuad;
import ghidra.feature.fid.service.FidService;
import ghidra.feature.fid.service.FidServiceLibraryIngest;
import ghidra.framework.model.DomainFile;
import ghidra.program.model.lang.CompilerSpec;
import ghidra.program.model.lang.Language;
import ghidra.program.model.lang.LanguageID;
import ghidra.program.model.listing.Function;
import ghidra.program.model.listing.FunctionManager;

public class AddSingleFunction extends GhidraScript {

private FidDB fidDb = null;

@Override
protected void run() throws Exception {

if (currentProgram == null) {
printerr("No current program");
return;
}
if (currentAddress == null) {
printerr("No current address (?)");
return;
}
FunctionManager functionManager = currentProgram.getFunctionManager();
Function function = functionManager.getFunctionContaining(currentAddress);
if (function == null) {
printerr("No current function");
return;
}

FidService service = new FidService();
FidHashQuad hashFunction = service.hashFunction(function);
if (hashFunction == null) {
printerr("Function too small");
return;
}

FidFileManager fidFileManager = FidFileManager.getInstance();
List<FidFile> userFid = fidFileManager.getUserAddedFiles();
if (userFid.isEmpty()) {
printerr("No available FID DB");
return;
}
FidFile fidFile =
askChoice("FID database", "Choose FID database", userFid, userFid.get(0));
try {
fidDb = fidFile.getFidDB(true);

Comment on lines +71 to +73
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

Missing exception handling.

The code opens the FID database but doesn't handle specific exceptions that might occur during this operation, such as file not found, permission issues, or database corruption.

Consider adding specific exception handling:

 		try {
 			fidDb = fidFile.getFidDB(true);
+		} catch (IOException e) {
+			printerr("Failed to open FID database: " + e.getMessage());
+			return;
 

Committable suggestion skipped: line range outside the PR's diff.

List<LibraryRecord> libraries = fidDb.getAllLibraries();
LibraryRecord library;
if (libraries == null || libraries.isEmpty()) {
println("No libraries found. Creating one...");

String libraryFamilyName =
askString("Library Family Name", "Choose Library Family Name");
String libraryVersion = askString("Library Version", "Choose Library Version");
String libraryVariant = askString("Library Variant", "Choose Library Variant");
LanguageID languageId = currentProgram.getLanguageID();
Language language = currentProgram.getLanguage();
CompilerSpec compilerSpec = currentProgram.getCompilerSpec();
library = fidDb.createNewLibrary(libraryFamilyName, libraryVersion, libraryVariant,
getGhidraVersion(), languageId, language.getVersion(),
language.getMinorVersion(), compilerSpec.getCompilerSpecID());
}
else {
library =
askChoice("FID libraries", "Choose FID library", libraries, libraries.get(0));
}

boolean disableNamespaceStripping =
askYesNo("Namespace stripping",
"Do you want to disable namespace stripping?");

long offset = function.getEntryPoint().getOffset();

boolean hasTerminator = FidServiceLibraryIngest.findTerminator(function, monitor);

DomainFile domainFile = getCurrentProgram().getDomainFile();

fidDb.createNewFunction(library, hashFunction,
function.getName(disableNamespaceStripping), offset, domainFile.getName(),
hasTerminator);
Comment on lines +105 to +107
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

Missing duplicate check before adding function.

The script adds the function to the database without checking if it already exists, which could lead to duplicate entries.

Consider adding a check to determine if the function already exists in the database:

+			// Check if function already exists in the database
+			List<FunctionRecord> existingFunctions = 
+				fidDb.findFunctionsByLibraryAndName(library, function.getName(disableNamespaceStripping));
+			boolean functionExists = false;
+			for (FunctionRecord existingFunction : existingFunctions) {
+				if (existingFunction.getFullHash() == hashFunction.getFullHash() &&
+					existingFunction.getSpecificHash() == hashFunction.getSpecificHash()) {
+					functionExists = true;
+					break;
+				}
+			}
+			
+			if (functionExists) {
+				println("Function already exists in the database. Skipping.");
+				return;
+			}
+			
 			fidDb.createNewFunction(library, hashFunction,
 				function.getName(disableNamespaceStripping), offset, domainFile.getName(),
 				hasTerminator);
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
fidDb.createNewFunction(library, hashFunction,
function.getName(disableNamespaceStripping), offset, domainFile.getName(),
hasTerminator);
// Check if function already exists in the database
List<FunctionRecord> existingFunctions =
fidDb.findFunctionsByLibraryAndName(library, function.getName(disableNamespaceStripping));
boolean functionExists = false;
for (FunctionRecord existingFunction : existingFunctions) {
if (existingFunction.getFullHash() == hashFunction.getFullHash() &&
existingFunction.getSpecificHash() == hashFunction.getSpecificHash()) {
functionExists = true;
break;
}
}
if (functionExists) {
println("Function already exists in the database. Skipping.");
return;
}
fidDb.createNewFunction(library, hashFunction,
function.getName(disableNamespaceStripping), offset, domainFile.getName(),
hasTerminator);


fidDb.saveDatabase("Saving", monitor);
}
finally {
fidDb.close();
}
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@
import ghidra.util.exception.VersionException;
import ghidra.util.task.TaskMonitor;

class FidServiceLibraryIngest {
public class FidServiceLibraryIngest {
private static final int MAXIMUM_NUMBER_OF_NAME_RESOLUTION_RELATIONS = 12;

private FidDB fidDb; // The database being populated
Expand Down Expand Up @@ -523,7 +523,7 @@ private void resolveNamedRelations() throws CancelledException {
* @return if a terminating flow was found in the function body
* @throws CancelledException if the user cancels
*/
private static boolean findTerminator(Function function, TaskMonitor monitor)
public static boolean findTerminator(Function function, TaskMonitor monitor)
throws CancelledException {
boolean retFound = false;
AddressSetView body = function.getBody();
Expand Down