/*
* 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.dexlib2.iface.MultiDexContainer;
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
/**
* 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 = -1;
@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 MultiDexContainer.DexEntry<? extends DexBackedDexFile> dexEntry;
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"
Params: - input – The name of a dex, apk, odex or oat file/entry.
/**
* 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 dexEntryName = null;
if (file.getPath().length() < input.length()) {
dexEntryName = input.substring(file.getPath().length() + 1);
}
Opcodes opcodes = null;
if (apiLevel != -1) {
opcodes = Opcodes.forApi(apiLevel);
}
if (!Strings.isNullOrEmpty(dexEntryName)) {
boolean exactMatch = false;
if (dexEntryName.length() > 2 && dexEntryName.charAt(0) == '"' && dexEntryName.charAt(dexEntryName.length() - 1) == '"') {
dexEntryName = dexEntryName.substring(1, dexEntryName.length() - 1);
exactMatch = true;
}
inputEntry = dexEntryName;
try {
dexEntry = DexFileFactory.loadDexEntry(file, dexEntryName, exactMatch, opcodes);
dexFile = dexEntry.getDexFile();
} catch (IOException ex) {
throw new RuntimeException(ex);
}
} else {
try {
MultiDexContainer<? extends DexBackedDexFile> container =
DexFileFactory.loadDexContainer(file, opcodes);
if (container.getDexEntryNames().size() == 1) {
dexEntry = container.getEntry(container.getDexEntryNames().get(0));
assert dexEntry != null;
dexFile = dexEntry.getDexFile();
} else if (container.getDexEntryNames().size() > 1) {
dexEntry = container.getEntry("classes.dex");
if (dexEntry == null) {
dexEntry = container.getEntry(container.getDexEntryNames().get(0));
}
assert dexEntry != null;
dexFile = dexEntry.getDexFile();
} else {
throw new RuntimeException(String.format("\"%s\" has no dex files", input));
}
} catch (IOException ex) {
throw new RuntimeException(ex);
}
}
}
}