aboutsummaryrefslogtreecommitdiff
path: root/baksmali/src/main/java/org/jf/baksmali/DexInputCommand.java
diff options
context:
space:
mode:
Diffstat (limited to 'baksmali/src/main/java/org/jf/baksmali/DexInputCommand.java')
-rw-r--r--baksmali/src/main/java/org/jf/baksmali/DexInputCommand.java150
1 files changed, 150 insertions, 0 deletions
diff --git a/baksmali/src/main/java/org/jf/baksmali/DexInputCommand.java b/baksmali/src/main/java/org/jf/baksmali/DexInputCommand.java
new file mode 100644
index 00000000..c7660cbe
--- /dev/null
+++ b/baksmali/src/main/java/org/jf/baksmali/DexInputCommand.java
@@ -0,0 +1,150 @@
+/*
+ * Copyright 2016, Google Inc.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+package org.jf.baksmali;
+
+import com.beust.jcommander.JCommander;
+import com.beust.jcommander.Parameter;
+import com.google.common.base.Strings;
+import com.google.common.collect.Lists;
+import org.jf.dexlib2.DexFileFactory;
+import org.jf.dexlib2.Opcodes;
+import org.jf.dexlib2.dexbacked.DexBackedDexFile;
+import org.jf.util.jcommander.Command;
+import org.jf.util.jcommander.ExtendedParameter;
+
+import javax.annotation.Nonnull;
+import java.io.File;
+import java.io.IOException;
+import java.util.List;
+
+/**
+ * This class implements common functionality for commands that need to load a dex file based on
+ * command line input
+ */
+public abstract class DexInputCommand extends Command {
+
+ @Parameter(names = {"-a", "--api"},
+ description = "The numeric api level of the file being disassembled.")
+ @ExtendedParameter(argumentNames = "api")
+ public int apiLevel = 15;
+
+ @Parameter(description = "A dex/apk/oat/odex file. For apk or oat files that contain multiple dex " +
+ "files, you can specify the specific entry to use as if the apk/oat file was a directory. " +
+ "e.g. \"app.apk/classes2.dex\". For more information, see \"baksmali help input\".")
+ @ExtendedParameter(argumentNames = "file")
+ protected List<String> inputList = Lists.newArrayList();
+
+ protected File inputFile;
+ protected String inputEntry;
+ protected DexBackedDexFile dexFile;
+
+ public DexInputCommand(@Nonnull List<JCommander> commandAncestors) {
+ super(commandAncestors);
+ }
+
+ /**
+ * Parses a dex file input from the user and loads the given dex file.
+ *
+ * In some cases, the input file can contain multiple dex files. If this is the case, you can refer to a specific
+ * dex file with a slash, followed by the entry name, optionally in quotes.
+ *
+ * If the entry name is enclosed in quotes, then it will strip the first and last quote and look for an entry with
+ * exactly that name. Otherwise, it will perform a partial filename match against the entry to find any candidates.
+ * If there is a single matching candidate, it will be used. Otherwise, an error will be generated.
+ *
+ * For example, to refer to the "/system/framework/framework.jar:classes2.dex" entry within the
+ * "framework/arm/framework.oat" oat file, you could use any of:
+ *
+ * framework/arm/framework.oat/"/system/framework/framework.jar:classes2.dex"
+ * framework/arm/framework.oat/system/framework/framework.jar:classes2.dex
+ * framework/arm/framework.oat/framework/framework.jar:classes2.dex
+ * framework/arm/framework.oat/framework.jar:classes2.dex
+ * framework/arm/framework.oat/classes2.dex
+ *
+ * The last option is the easiest, but only works if the oat file doesn't contain another entry with the
+ * "classes2.dex" name. e.g. "/system/framework/blah.jar:classes2.dex"
+ *
+ * It's technically possible (although unlikely) for an oat file to contain 2 entries like:
+ * /system/framework/framework.jar:classes2.dex
+ * system/framework/framework.jar:classes2.dex
+ *
+ * In this case, the "framework/arm/framework.oat/system/framework/framework.jar:classes2.dex" syntax will generate
+ * an error because both entries match the partial entry name. Instead, you could use the following for the
+ * first and second entry respectively:
+ *
+ * framework/arm/framework.oat/"/system/framework/framework.jar:classes2.dex"
+ * framework/arm/framework.oat/"system/framework/framework.jar:classes2.dex"
+ *
+ * @param input The name of a dex, apk, odex or oat file/entry.
+ */
+ protected void loadDexFile(@Nonnull String input) {
+ File file = new File(input);
+
+ while (file != null && !file.exists()) {
+ file = file.getParentFile();
+ }
+
+ if (file == null || !file.exists() || file.isDirectory()) {
+ System.err.println("Can't find file: " + input);
+ System.exit(1);
+ }
+
+ inputFile = file;
+
+ String dexEntry = null;
+ if (file.getPath().length() < input.length()) {
+ dexEntry = input.substring(file.getPath().length() + 1);
+ }
+
+ if (!Strings.isNullOrEmpty(dexEntry)) {
+ boolean exactMatch = false;
+ if (dexEntry.length() > 2 && dexEntry.charAt(0) == '"' && dexEntry.charAt(dexEntry.length() - 1) == '"') {
+ dexEntry = dexEntry.substring(1, dexEntry.length() - 1);
+ exactMatch = true;
+ }
+
+ inputEntry = dexEntry;
+
+ try {
+ dexFile = DexFileFactory.loadDexEntry(file, dexEntry, exactMatch, Opcodes.forApi(apiLevel));
+ } catch (IOException ex) {
+ throw new RuntimeException(ex);
+ }
+ } else {
+ try {
+ dexFile = DexFileFactory.loadDexFile(file, Opcodes.forApi(apiLevel));
+ } catch (IOException ex) {
+ throw new RuntimeException(ex);
+ }
+ }
+ }
+}