Merge "Remove inconsistent \'cmd package compile\' documentation." into nyc-dev am: 12f2984dbf (cef26863) · Commits · e / os / android_frameworks_base

services/core/java/com/android/server/pm/PackageManagerShellCommand.java

+24 −52

Original line number	Original line	Diff line number	Diff line
	@@ -260,35 +260,6 @@ class PackageManagerShellCommand extends ShellCommand {
	String compilationReason = null;		String compilationReason = null;
	String checkProfilesRaw = null;		String checkProfilesRaw = null;

	if (peekNextArg() == null) {
	// No arguments, show help.
	pw.println("Usage: cmd package compile [-c] [-f] [--reset] [-m mode] " +
	"[-r reason] [-a\|pkg]");
	pw.println();
	pw.println(" -c Clear profile data");
	pw.println(" -f Force compilation");
	pw.println(" --check-prof val Look at profiles when doing dexopt.");
	pw.println(" Overrides dalvik.vm.usejitprofiles to true of false");
	pw.println(" --reset Reset package");
	pw.println(" -m mode Compilation mode, one of the dex2oat compiler filters");
	pw.println(" verify-none");
	pw.println(" verify-at-runtime");
	pw.println(" verify-profile");
	pw.println(" interpret-only");
	pw.println(" space-profile");
	pw.println(" space");
	pw.println(" speed-profile");
	pw.println(" speed");
	pw.println(" everything");
	pw.println(" -r reason Compiler reason, one of the package manager reasons");
	for (int i = 0; i < PackageManagerServiceCompilerMapping.REASON_STRINGS.length; i++) {
	pw.println(" " +
	PackageManagerServiceCompilerMapping.REASON_STRINGS[i]);
	}
	pw.println(" -a Apply to all packages");
	return 1;
	}

	String opt;		String opt;
	while ((opt = getNextOption()) != null) {		while ((opt = getNextOption()) != null) {
	switch (opt) {		switch (opt) {
	@@ -307,7 +278,7 @@ class PackageManagerShellCommand extends ShellCommand {
	case "-r":		case "-r":
	compilationReason = getNextArgRequired();		compilationReason = getNextArgRequired();
	break;		break;
	case "-check-prof":		case "--check-prof":
	checkProfilesRaw = getNextArgRequired();		checkProfilesRaw = getNextArgRequired();
	break;		break;
	case "--reset":		case "--reset":
	@@ -345,25 +316,12 @@ class PackageManagerShellCommand extends ShellCommand {

	String targetCompilerFilter;		String targetCompilerFilter;
	if (compilerFilter != null) {		if (compilerFilter != null) {
	// Specially recognize default and reset. Otherwise, only accept valid modes.
	if ("default".equals(compilerFilter)) {
	// Use the default mode for background dexopt.
	targetCompilerFilter =
	PackageManagerServiceCompilerMapping.getCompilerFilterForReason(
	PackageManagerService.REASON_BACKGROUND_DEXOPT);
	} else if ("reset".equals(compilerFilter)) {
	// Use the default mode for install.
	targetCompilerFilter =
	PackageManagerServiceCompilerMapping.getCompilerFilterForReason(
	PackageManagerService.REASON_INSTALL);
	} else {
	if (!DexFile.isValidCompilerFilter(compilerFilter)) {		if (!DexFile.isValidCompilerFilter(compilerFilter)) {
	pw.println("Error: \"" + compilerFilter +		pw.println("Error: \"" + compilerFilter +
	"\" is not a valid compilation filter.");		"\" is not a valid compilation filter.");
	return 1;		return 1;
	}		}
	targetCompilerFilter = compilerFilter;		targetCompilerFilter = compilerFilter;
	}
	} else {		} else {
	int reason = -1;		int reason = -1;
	for (int i = 0; i < PackageManagerServiceCompilerMapping.REASON_STRINGS.length; i++) {		for (int i = 0; i < PackageManagerServiceCompilerMapping.REASON_STRINGS.length; i++) {
	@@ -1428,17 +1386,31 @@ class PackageManagerShellCommand extends ShellCommand {
	pw.println(" help");		pw.println(" help");
	pw.println(" Print this help text.");		pw.println(" Print this help text.");
	pw.println("");		pw.println("");
	pw.println(" compile [-m MODE] [-f] [-c] [--reset] (-a \| TARGET-PACKAGE)");		pw.println(" compile [-m MODE \| -r REASON] [-f] [-c]");
			pw.println(" [--reset] [--check-prof (true \| false)] (-a \| TARGET-PACKAGE)");
	pw.println(" Trigger compilation of TARGET-PACKAGE or all packages if \"-a\".");		pw.println(" Trigger compilation of TARGET-PACKAGE or all packages if \"-a\".");
	pw.println(" Options:");		pw.println(" Options:");
	pw.println(" -a: compile all packages");		pw.println(" -a: compile all packages");
	pw.println(" -c: clear profile data before compiling");		pw.println(" -c: clear profile data before compiling");
	pw.println(" -f: force compilation even if not needed");		pw.println(" -f: force compilation even if not needed");
	pw.println(" -m: select compilation mode");		pw.println(" -m: select compilation mode");
	pw.println(" MODE can be one of \"default\", \"full\", \"profile\"," +		pw.println(" MODE is one of the dex2oat compiler filters:");
	" and \"extract\"");		pw.println(" verify-none");
			pw.println(" verify-at-runtime");
			pw.println(" verify-profile");
			pw.println(" interpret-only");
			pw.println(" space-profile");
			pw.println(" space");
			pw.println(" speed-profile");
			pw.println(" speed");
			pw.println(" everything");
			pw.println(" -r: select compilation reason");
			pw.println(" REASON is one of:");
			for (int i = 0; i < PackageManagerServiceCompilerMapping.REASON_STRINGS.length; i++) {
			pw.println(" " + PackageManagerServiceCompilerMapping.REASON_STRINGS[i]);
			}
	pw.println(" --reset: restore package to its post-install state");		pw.println(" --reset: restore package to its post-install state");
	pw.println(" shorthand for \"-c -f -m extract\"");		pw.println(" --check-prof (true \| false): look at profiles when doing dexopt?");
	pw.println(" list features");		pw.println(" list features");
	pw.println(" Prints all features of the system.");		pw.println(" Prints all features of the system.");
	pw.println(" list instrumentation [-f] [TARGET-PACKAGE]");		pw.println(" list instrumentation [-f] [TARGET-PACKAGE]");