Skip to content

Ghidra is a software reverse engineering (SRE) framework

7.7 KB
Raw Blame
/* ###
 * 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.
 */
package generic.application;

import java.io.File;
import java.io.IOException;
import java.util.*;
import java.util.Map.Entry;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

import org.apache.commons.lang3.StringUtils;

import generic.jar.ResourceFile;
import ghidra.framework.ApplicationProperties;
import ghidra.framework.GModule;
import ghidra.util.SystemUtilities;
import utility.application.ApplicationLayout;
import utility.application.ApplicationUtilities;
import utility.module.ClasspathFilter;
import utility.module.ModuleUtilities;

/**
 * A low-level implementation of {@link ApplicationLayout} that is suitable for basic applications.
 * This class makes use of the {@link GModule Module} system to find application components at
 * runtime.
 */
public class GenericApplicationLayout extends ApplicationLayout {

	/**
	 * System property that allows specification of additional application root dirs.  This is used
	 * for clients that build plugins external to an installation.  The property will be parsed
	 * using {@link File#pathSeparator}, allowing for multiple values.
	 */
	private static final String ADDITIONAL_APPLICATION_ROOT_DIRS =
		"ADDITIONAL_APPLICATION_ROOT_DIRS";

	private static final String NO_RELEASE_NAME = "NO_RELEASE";

	/** Dev mode main source bin dir pattern */
	private static final Pattern CLASS_PATH_MODULE_NAME_PATTERN =
		Pattern.compile(".*/(\\w+)/bin/main");

	/**
	 * Constructs a new application layout object with the given name and version.
	 *
	 * @param name The name of the application.
	 * @param version The version of the application.
	 * @throws IOException if there was a problem getting a user directory.
	 */
	public GenericApplicationLayout(String name, String version) throws IOException {
		this(new ApplicationProperties(name, version, NO_RELEASE_NAME));
	}

	/**
	 * Constructs a new application layout object with the given set of application
	 * properties.  The default Ghidra application root directory(s) will be used.
	 *
	 * @param applicationProperties The properties object that will be read system properties.
	 * @throws IOException if there was a problem getting a user directory.
	 */
	public GenericApplicationLayout(ApplicationProperties applicationProperties)
			throws IOException {
		this(getDefaultApplicationRootDirs(), applicationProperties);
	}

	/**
	 * Constructs a new application layout object with the given set of application
	 * properties.
	 *
	 * @param applicationRootDirs list of application root directories which should be
	 * used to identify modules and resources.  The first entry will be treated as the
	 * installation root.
	 * @param applicationProperties The properties object that will be read system properties.
	 * @throws IOException if there was a problem getting a user directory.
	 */
	public GenericApplicationLayout(SequencedCollection<ResourceFile> applicationRootDirs,
			ApplicationProperties applicationProperties) throws IOException {

		this.applicationProperties = Objects.requireNonNull(applicationProperties);
		this.applicationRootDirs = applicationRootDirs;
		applicationRootDirs.addAll(getAdditionalApplicationRootDirs(applicationRootDirs));

		// Application installation directory
		applicationInstallationDir = applicationRootDirs.iterator().next().getParentFile();
		if (SystemUtilities.isInDevelopmentMode() && applicationRootDirs.size() > 1) {
			applicationInstallationDir = applicationInstallationDir.getParentFile();
		}

		// Modules
		Collection<ResourceFile> moduleRoots =
			ModuleUtilities.findModuleRootDirectories(applicationRootDirs);

		Map<String, GModule> allModules = new HashMap<>();
		Map<String, GModule> discoveredModules =
			ModuleUtilities.findModules(applicationRootDirs, moduleRoots, new ClasspathFilter());
		allModules.putAll(discoveredModules);

		for (ResourceFile root : applicationRootDirs) {
			GModule rootModule = new GModule(applicationRootDirs, root);
			allModules.put(rootModule.getName(), rootModule);
		}

		modules = Collections.unmodifiableMap(allModules);

		// User directories
		userTempDir =
			ApplicationUtilities.getDefaultUserTempDir(applicationProperties.getApplicationName());
		userSettingsDir = ApplicationUtilities.getDefaultUserSettingsDir(applicationProperties,
			applicationInstallationDir);

		extensionInstallationDirs = Collections.emptyList();
	}

	protected Collection<ResourceFile> getAdditionalApplicationRootDirs(
			Collection<ResourceFile> roots) {
		return Collections.emptyList();
	}

	protected Map<String, GModule> findModules() {
		if (!SystemUtilities.isInDevelopmentMode()) {
			// in release mode we only have one application root, so no need to find all others
			return ModuleUtilities.findModules(applicationRootDirs, applicationRootDirs);
		}

		// In development mode we may have multiple module root directories under which modules may
		// be found.  Search all roots for modules.
		Collection<ResourceFile> roots =
			ModuleUtilities.findModuleRootDirectories(applicationRootDirs, new ArrayList<>());
		Map<String, GModule> allModules = ModuleUtilities.findModules(applicationRootDirs, roots);

		// Filter any modules found to ensure that we only include those that are listed on the
		// classpath.  (Due to the nature of how the development classpath is created, not all
		// found modules may match the classpath entries.)
		Set<String> cpNames = getClassPathModuleNames();
		Map<String, GModule> filteredModules = new HashMap<>();
		Set<Entry<String, GModule>> entrySet = allModules.entrySet();
		for (Entry<String, GModule> entry : entrySet) {
			GModule module = entry.getValue();
			if (cpNames.contains(module.getName())) {
				filteredModules.put(entry.getKey(), module);
			}
		}

		return filteredModules;
	}

	private Set<String> getClassPathModuleNames() {
		String cp = System.getProperty("java.class.path");
		String[] pathParts = cp.split(File.pathSeparator);
		Set<String> paths = new HashSet<>(Arrays.asList(pathParts));
		Set<String> cpNames = new HashSet<>();
		for (String cpEntry : paths) {
			Matcher matcher = CLASS_PATH_MODULE_NAME_PATTERN.matcher(cpEntry);
			if (matcher.matches()) {
				cpNames.add(matcher.group(1));
			}
		}
		return cpNames;
	}

	/**
	 * Get the default list of Application directories.  In repo-based development mode this
	 * includes the root Ghidra directory within each repo.  When not in development mode, the
	 * requirement is that the current working directory correspond to the installation root.  The
	 * first entry will be the primary root in both cases.
	 * @return root directories
	 */
	public static SequencedCollection<ResourceFile> getDefaultApplicationRootDirs() {

		List<ResourceFile> results = new ArrayList<>();
		String additionalRootsProperty = System.getProperty(ADDITIONAL_APPLICATION_ROOT_DIRS);
		if (!StringUtils.isBlank(additionalRootsProperty)) {
			String[] paths = additionalRootsProperty.split(File.pathSeparator);
			for (String path : paths) {
				ResourceFile file = new ResourceFile(path);
				results.add(file);
			}
		}

		if (SystemUtilities.isInDevelopmentMode()) {
			Collection<ResourceFile> defaultRoots =
				ApplicationUtilities.findDefaultApplicationRootDirs();
			results.addAll(defaultRoots);
		}
		else {
			results.add(new ResourceFile(System.getProperty("user.dir")));
		}

		return results;
	}
}