Lines Matching refs:UsageError
209 static void UsageError(const char* fmt, ...) { in UsageError() function
222 UsageError("Command: %s", CommandLine().c_str()); in Usage()
224 UsageError("Usage: dex2oat [options]..."); in Usage()
225 UsageError(""); in Usage()
226 UsageError(" -j<number>: specifies the number of threads used for compilation."); in Usage()
227 UsageError(" Default is the number of detected hardware threads available on the"); in Usage()
228 UsageError(" host system."); in Usage()
229 UsageError(" Example: -j12"); in Usage()
230 UsageError(""); in Usage()
231 UsageError(" --cpu-set=<set>: sets the cpu affinity to <set>. The <set> argument is a comma"); in Usage()
232 UsageError(" separated list of CPUs."); in Usage()
233 UsageError(" Example: --cpu-set=0,1,2,3"); in Usage()
234 UsageError(""); in Usage()
235 UsageError(" --dex-file=<dex-file>: specifies a .dex, .jar, or .apk file to compile."); in Usage()
236 UsageError(" Example: --dex-file=/system/framework/core.jar"); in Usage()
237 UsageError(""); in Usage()
238 UsageError(" --dex-location=<dex-location>: specifies an alternative dex location to"); in Usage()
239 UsageError(" encode in the oat file for the corresponding --dex-file argument."); in Usage()
240 UsageError(" Example: --dex-file=/home/build/out/system/framework/core.jar"); in Usage()
241 UsageError(" --dex-location=/system/framework/core.jar"); in Usage()
242 UsageError(""); in Usage()
243 UsageError(" --zip-fd=<file-descriptor>: specifies a file descriptor of a zip file"); in Usage()
244 UsageError(" containing a classes.dex file to compile."); in Usage()
245 UsageError(" Example: --zip-fd=5"); in Usage()
246 UsageError(""); in Usage()
247 UsageError(" --zip-location=<zip-location>: specifies a symbolic name for the file"); in Usage()
248 UsageError(" corresponding to the file descriptor specified by --zip-fd."); in Usage()
249 UsageError(" Example: --zip-location=/system/app/Calculator.apk"); in Usage()
250 UsageError(""); in Usage()
251 UsageError(" --oat-file=<file.oat>: specifies an oat output destination via a filename."); in Usage()
252 UsageError(" Example: --oat-file=/system/framework/boot.oat"); in Usage()
253 UsageError(""); in Usage()
254 UsageError(" --oat-symbols=<file.oat>: specifies a symbolized oat output destination."); in Usage()
255 UsageError(" Example: --oat-file=symbols/system/framework/boot.oat"); in Usage()
256 UsageError(""); in Usage()
257 UsageError(" --oat-fd=<number>: specifies the oat output destination via a file descriptor."); in Usage()
258 UsageError(" Example: --oat-fd=6"); in Usage()
259 UsageError(""); in Usage()
260 UsageError(" --input-vdex-fd=<number>: specifies the vdex input source via a file descriptor."); in Usage()
261 UsageError(" Example: --input-vdex-fd=6"); in Usage()
262 UsageError(""); in Usage()
263 UsageError(" --output-vdex-fd=<number>: specifies the vdex output destination via a file"); in Usage()
264 UsageError(" descriptor."); in Usage()
265 UsageError(" Example: --output-vdex-fd=6"); in Usage()
266 UsageError(""); in Usage()
267 UsageError(" --oat-location=<oat-name>: specifies a symbolic name for the file corresponding"); in Usage()
268 UsageError(" to the file descriptor specified by --oat-fd."); in Usage()
269 UsageError(" Example: --oat-location=/data/dalvik-cache/system@app@Calculator.apk.oat"); in Usage()
270 UsageError(""); in Usage()
271 UsageError(" --oat-symbols=<file.oat>: specifies a destination where the oat file is copied."); in Usage()
272 UsageError(" This is equivalent to file copy as build post-processing step."); in Usage()
273 UsageError(" It is intended to be used with --strip and it happens before it."); in Usage()
274 UsageError(" Example: --oat-symbols=/symbols/system/framework/boot.oat"); in Usage()
275 UsageError(""); in Usage()
276 UsageError(" --strip: remove all debugging sections at the end (but keep mini-debug-info)."); in Usage()
277 UsageError(" This is equivalent to the \"strip\" command as build post-processing step."); in Usage()
278 UsageError(" It is intended to be used with --oat-symbols and it happens after it."); in Usage()
279 UsageError(" Example: --oat-symbols=/symbols/system/framework/boot.oat"); in Usage()
280 UsageError(""); in Usage()
281 UsageError(" --image=<file.art>: specifies an output image filename."); in Usage()
282 UsageError(" Example: --image=/system/framework/boot.art"); in Usage()
283 UsageError(""); in Usage()
284 UsageError(" --image-fd=<number>: same as --image but accepts a file descriptor instead."); in Usage()
285 UsageError(" Cannot be used together with --image."); in Usage()
286 UsageError(""); in Usage()
287 UsageError(" --image-format=(uncompressed|lz4|lz4hc):"); in Usage()
288 UsageError(" Which format to store the image."); in Usage()
289 UsageError(" Example: --image-format=lz4"); in Usage()
290 UsageError(" Default: uncompressed"); in Usage()
291 UsageError(""); in Usage()
292 UsageError(" --base=<hex-address>: specifies the base address when creating a boot image."); in Usage()
293 UsageError(" Example: --base=0x50000000"); in Usage()
294 UsageError(""); in Usage()
295 UsageError(" --boot-image=<file.art>: provide the image file for the boot class path."); in Usage()
296 UsageError(" Do not include the arch as part of the name, it is added automatically."); in Usage()
297 UsageError(" Example: --boot-image=/system/framework/boot.art"); in Usage()
298 UsageError(" (specifies /system/framework/<arch>/boot.art as the image file)"); in Usage()
299 UsageError(" Example: --boot-image=boot.art:boot-framework.art"); in Usage()
300 UsageError(" (specifies <bcp-path1>/<arch>/boot.art as the image file and"); in Usage()
301 UsageError(" <bcp-path2>/<arch>/boot-framework.art as the image extension file"); in Usage()
302 UsageError(" with paths taken from corresponding boot class path components)"); in Usage()
303 UsageError(" Example: --boot-image=/apex/com.android.art/boot.art:/system/framework/*:*"); in Usage()
304 UsageError(" (specifies /apex/com.android.art/<arch>/boot.art as the image"); in Usage()
305 UsageError(" file and search for extensions in /framework/system and boot"); in Usage()
306 UsageError(" class path components' paths)"); in Usage()
307 UsageError(" Default: $ANDROID_ROOT/system/framework/boot.art"); in Usage()
308 UsageError(""); in Usage()
309 UsageError(" --android-root=<path>: used to locate libraries for portable linking."); in Usage()
310 UsageError(" Example: --android-root=out/host/linux-x86"); in Usage()
311 UsageError(" Default: $ANDROID_ROOT"); in Usage()
312 UsageError(""); in Usage()
313 UsageError(" --instruction-set=(arm|arm64|x86|x86_64): compile for a particular"); in Usage()
314 UsageError(" instruction set."); in Usage()
315 UsageError(" Example: --instruction-set=x86"); in Usage()
316 UsageError(" Default: arm"); in Usage()
317 UsageError(""); in Usage()
318 UsageError(" --instruction-set-features=...,: Specify instruction set features"); in Usage()
319 UsageError(" On target the value 'runtime' can be used to detect features at run time."); in Usage()
320 UsageError(" If target does not support run-time detection the value 'runtime'"); in Usage()
321 UsageError(" has the same effect as the value 'default'."); in Usage()
322 UsageError(" Note: the value 'runtime' has no effect if it is used on host."); in Usage()
323 UsageError(" Example: --instruction-set-features=div"); in Usage()
324 UsageError(" Default: default"); in Usage()
325 UsageError(""); in Usage()
326 UsageError(" --compiler-backend=(Quick|Optimizing): select compiler backend"); in Usage()
327 UsageError(" set."); in Usage()
328 UsageError(" Example: --compiler-backend=Optimizing"); in Usage()
329 UsageError(" Default: Optimizing"); in Usage()
330 UsageError(""); in Usage()
331 UsageError(" --compiler-filter=" in Usage()
342 UsageError(" select compiler filter."); in Usage()
343 UsageError(" Example: --compiler-filter=everything"); in Usage()
344 UsageError(" Default: speed-profile if --profile-file or --profile-file-fd is used,"); in Usage()
345 UsageError(" speed otherwise"); in Usage()
346 UsageError(""); in Usage()
347 UsageError(" --huge-method-max=<method-instruction-count>: threshold size for a huge"); in Usage()
348 UsageError(" method for compiler filter tuning."); in Usage()
349 UsageError(" Example: --huge-method-max=%d", CompilerOptions::kDefaultHugeMethodThreshold); in Usage()
350 UsageError(" Default: %d", CompilerOptions::kDefaultHugeMethodThreshold); in Usage()
351 UsageError(""); in Usage()
352 UsageError(" --large-method-max=<method-instruction-count>: threshold size for a large"); in Usage()
353 UsageError(" method for compiler filter tuning."); in Usage()
354 UsageError(" Example: --large-method-max=%d", CompilerOptions::kDefaultLargeMethodThreshold); in Usage()
355 UsageError(" Default: %d", CompilerOptions::kDefaultLargeMethodThreshold); in Usage()
356 UsageError(""); in Usage()
357 UsageError(" --num-dex-methods=<method-count>: threshold size for a small dex file for"); in Usage()
358 UsageError(" compiler filter tuning. If the input has fewer than this many methods"); in Usage()
359 UsageError(" and the filter is not interpret-only or verify-none or verify-at-runtime, "); in Usage()
360 UsageError(" overrides the filter to use speed"); in Usage()
361 UsageError(" Example: --num-dex-method=%d", CompilerOptions::kDefaultNumDexMethodsThreshold); in Usage()
362 UsageError(" Default: %d", CompilerOptions::kDefaultNumDexMethodsThreshold); in Usage()
363 UsageError(""); in Usage()
364 UsageError(" --inline-max-code-units=<code-units-count>: the maximum code units that a method"); in Usage()
365 UsageError(" can have to be considered for inlining. A zero value will disable inlining."); in Usage()
366 UsageError(" Honored only by Optimizing. Has priority over the --compiler-filter option."); in Usage()
367 UsageError(" Intended for development/experimental use."); in Usage()
368 UsageError(" Example: --inline-max-code-units=%d", in Usage()
370 UsageError(" Default: %d", CompilerOptions::kDefaultInlineMaxCodeUnits); in Usage()
371 UsageError(""); in Usage()
372 UsageError(" --dump-timings: display a breakdown of where time was spent"); in Usage()
373 UsageError(""); in Usage()
374 UsageError(" --dump-pass-timings: display a breakdown of time spent in optimization"); in Usage()
375 UsageError(" passes for each compiled method."); in Usage()
376 UsageError(""); in Usage()
377 UsageError(" -g"); in Usage()
378 UsageError(" --generate-debug-info: Generate debug information for native debugging,"); in Usage()
379 UsageError(" such as stack unwinding information, ELF symbols and DWARF sections."); in Usage()
380 UsageError(" If used without --debuggable, it will be best-effort only."); in Usage()
381 UsageError(" This option does not affect the generated code. (disabled by default)"); in Usage()
382 UsageError(""); in Usage()
383 UsageError(" --no-generate-debug-info: Do not generate debug information for native debugging."); in Usage()
384 UsageError(""); in Usage()
385 UsageError(" --generate-mini-debug-info: Generate minimal amount of LZMA-compressed"); in Usage()
386 UsageError(" debug information necessary to print backtraces. (disabled by default)"); in Usage()
387 UsageError(""); in Usage()
388 UsageError(" --no-generate-mini-debug-info: Do not generate backtrace info."); in Usage()
389 UsageError(""); in Usage()
390 UsageError(" --generate-build-id: Generate GNU-compatible linker build ID ELF section with"); in Usage()
391 UsageError(" SHA-1 of the file content (and thus stable across identical builds)"); in Usage()
392 UsageError(""); in Usage()
393 UsageError(" --no-generate-build-id: Do not generate the build ID ELF section."); in Usage()
394 UsageError(""); in Usage()
395 UsageError(" --debuggable: Produce code debuggable with Java debugger."); in Usage()
396 UsageError(""); in Usage()
397 UsageError(" --avoid-storing-invocation: Avoid storing the invocation args in the key value"); in Usage()
398 UsageError(" store. Used to test determinism with different args."); in Usage()
399 UsageError(""); in Usage()
400 UsageError(" --write-invocation-to=<file>: Write the invocation commandline to the given file"); in Usage()
401 UsageError(" for later use. Used to test determinism with different host architectures."); in Usage()
402 UsageError(""); in Usage()
403 UsageError(" --runtime-arg <argument>: used to specify various arguments for the runtime,"); in Usage()
404 UsageError(" such as initial heap size, maximum heap size, and verbose output."); in Usage()
405 UsageError(" Use a separate --runtime-arg switch for each argument."); in Usage()
406 UsageError(" Example: --runtime-arg -Xms256m"); in Usage()
407 UsageError(""); in Usage()
408 UsageError(" --profile-file=<filename>: specify profiler output file to use for compilation."); in Usage()
409 UsageError(""); in Usage()
410 UsageError(" --profile-file-fd=<number>: same as --profile-file but accepts a file descriptor."); in Usage()
411 UsageError(" Cannot be used together with --profile-file."); in Usage()
412 UsageError(""); in Usage()
413 UsageError(" --swap-file=<file-name>: specifies a file to use for swap."); in Usage()
414 UsageError(" Example: --swap-file=/data/tmp/swap.001"); in Usage()
415 UsageError(""); in Usage()
416 UsageError(" --swap-fd=<file-descriptor>: specifies a file to use for swap (by descriptor)."); in Usage()
417 UsageError(" Example: --swap-fd=10"); in Usage()
418 UsageError(""); in Usage()
419 UsageError(" --swap-dex-size-threshold=<size>: specifies the minimum total dex file size in"); in Usage()
420 UsageError(" bytes to allow the use of swap."); in Usage()
421 UsageError(" Example: --swap-dex-size-threshold=1000000"); in Usage()
422 UsageError(" Default: %zu", kDefaultMinDexFileCumulativeSizeForSwap); in Usage()
423 UsageError(""); in Usage()
424 UsageError(" --swap-dex-count-threshold=<count>: specifies the minimum number of dex files to"); in Usage()
425 UsageError(" allow the use of swap."); in Usage()
426 UsageError(" Example: --swap-dex-count-threshold=10"); in Usage()
427 UsageError(" Default: %zu", kDefaultMinDexFilesForSwap); in Usage()
428 UsageError(""); in Usage()
429 UsageError(" --very-large-app-threshold=<size>: specifies the minimum total dex file size in"); in Usage()
430 UsageError(" bytes to consider the input \"very large\" and reduce compilation done."); in Usage()
431 UsageError(" Example: --very-large-app-threshold=100000000"); in Usage()
432 UsageError(""); in Usage()
433 UsageError(" --app-image-fd=<file-descriptor>: specify output file descriptor for app image."); in Usage()
434 UsageError(" The image is non-empty only if a profile is passed in."); in Usage()
435 UsageError(" Example: --app-image-fd=10"); in Usage()
436 UsageError(""); in Usage()
437 UsageError(" --app-image-file=<file-name>: specify a file name for app image."); in Usage()
438 UsageError(" Example: --app-image-file=/data/dalvik-cache/system@app@Calculator.apk.art"); in Usage()
439 UsageError(""); in Usage()
440 UsageError(" --multi-image: specify that separate oat and image files be generated for "); in Usage()
441 UsageError(" each input dex file; the default for boot image and boot image extension."); in Usage()
442 UsageError(""); in Usage()
443 UsageError(" --single-image: specify that a single oat and image file be generated for "); in Usage()
444 UsageError(" all input dex files; the default for app image."); in Usage()
445 UsageError(""); in Usage()
446 UsageError(" --force-determinism: force the compiler to emit a deterministic output."); in Usage()
447 UsageError(""); in Usage()
448 UsageError(" --dump-cfg=<cfg-file>: dump control-flow graphs (CFGs) to specified file."); in Usage()
449 UsageError(" Example: --dump-cfg=output.cfg"); in Usage()
450 UsageError(""); in Usage()
451 UsageError(" --dump-cfg-append: when dumping CFGs to an existing file, append new CFG data to"); in Usage()
452 UsageError(" existing data (instead of overwriting existing data with new data, which is"); in Usage()
453 UsageError(" the default behavior). This option is only meaningful when used with"); in Usage()
454 UsageError(" --dump-cfg."); in Usage()
455 UsageError(""); in Usage()
456 UsageError(" --verbose-methods=<method-names>: Restrict dumped CFG data to methods whose name"); in Usage()
457 UsageError(" contain one of the method names passed as argument"); in Usage()
458 UsageError(" Example: --verbose-methods=toString,hashCode"); in Usage()
459 UsageError(""); in Usage()
460 UsageError(" --classpath-dir=<directory-path>: directory used to resolve relative class paths."); in Usage()
461 UsageError(""); in Usage()
462 UsageError(" --class-loader-context=<string spec>: a string specifying the intended"); in Usage()
463 UsageError(" runtime loading context for the compiled dex files."); in Usage()
464 UsageError(""); in Usage()
465 UsageError(" --stored-class-loader-context=<string spec>: a string specifying the intended"); in Usage()
466 UsageError(" runtime loading context that is stored in the oat file. Overrides"); in Usage()
467 UsageError(" --class-loader-context. Note that this ignores the classpath_dir arg."); in Usage()
468 UsageError(""); in Usage()
469 UsageError(" It describes how the class loader chain should be built in order to ensure"); in Usage()
470 UsageError(" classes are resolved during dex2aot as they would be resolved at runtime."); in Usage()
471 UsageError(" This spec will be encoded in the oat file. If at runtime the dex file is"); in Usage()
472 UsageError(" loaded in a different context, the oat file will be rejected."); in Usage()
473 UsageError(""); in Usage()
474 UsageError(" The chain is interpreted in the natural 'parent order', meaning that class"); in Usage()
475 UsageError(" loader 'i+1' will be the parent of class loader 'i'."); in Usage()
476 UsageError(" The compilation sources will be appended to the classpath of the first class"); in Usage()
477 UsageError(" loader."); in Usage()
478 UsageError(""); in Usage()
479 UsageError(" E.g. if the context is 'PCL[lib1.dex];DLC[lib2.dex]' and "); in Usage()
480 UsageError(" --dex-file=src.dex then dex2oat will setup a PathClassLoader with classpath "); in Usage()
481 UsageError(" 'lib1.dex:src.dex' and set its parent to a DelegateLastClassLoader with "); in Usage()
482 UsageError(" classpath 'lib2.dex'."); in Usage()
483 UsageError(""); in Usage()
484 UsageError(" Note that the compiler will be tolerant if the source dex files specified"); in Usage()
485 UsageError(" with --dex-file are found in the classpath. The source dex files will be"); in Usage()
486 UsageError(" removed from any class loader's classpath possibly resulting in empty"); in Usage()
487 UsageError(" class loaders."); in Usage()
488 UsageError(""); in Usage()
489 UsageError(" Example: --class-loader-context=PCL[lib1.dex:lib2.dex];DLC[lib3.dex]"); in Usage()
490 UsageError(""); in Usage()
491 UsageError(" --class-loader-context-fds=<fds>: a colon-separated list of file descriptors"); in Usage()
492 UsageError(" for dex files in --class-loader-context. Their order must be the same as"); in Usage()
493 UsageError(" dex files in flattened class loader context."); in Usage()
494 UsageError(""); in Usage()
495 UsageError(" --dirty-image-objects=<file-path>: list of known dirty objects in the image."); in Usage()
496 UsageError(" The image writer will group them together."); in Usage()
497 UsageError(""); in Usage()
498 UsageError(" --updatable-bcp-packages-file=<file-path>: file with a list of updatable"); in Usage()
499 UsageError(" boot class path packages. Classes in these packages and sub-packages"); in Usage()
500 UsageError(" shall not be resolved during app compilation to avoid AOT assumptions"); in Usage()
501 UsageError(" being invalidated after applying updates to these components."); in Usage()
502 UsageError(""); in Usage()
503 UsageError(" --compact-dex-level=none|fast: None avoids generating compact dex, fast"); in Usage()
504 UsageError(" generates compact dex with low compile time. If speed-profile is specified as"); in Usage()
505 UsageError(" the compiler filter and the profile is not empty, the default compact dex"); in Usage()
506 UsageError(" level is always used."); in Usage()
507 UsageError(""); in Usage()
508 UsageError(" --deduplicate-code=true|false: enable|disable code deduplication. Deduplicated"); in Usage()
509 UsageError(" code will have an arbitrary symbol tagged with [DEDUPED]."); in Usage()
510 UsageError(""); in Usage()
511 UsageError(" --copy-dex-files=true|false: enable|disable copying the dex files into the"); in Usage()
512 UsageError(" output vdex."); in Usage()
513 UsageError(""); in Usage()
514 UsageError(" --compilation-reason=<string>: optional metadata specifying the reason for"); in Usage()
515 UsageError(" compiling the apk. If specified, the string will be embedded verbatim in"); in Usage()
516 UsageError(" the key value store of the oat file."); in Usage()
517 UsageError(" Example: --compilation-reason=install"); in Usage()
518 UsageError(""); in Usage()
519 UsageError(" --resolve-startup-const-strings=true|false: If true, the compiler eagerly"); in Usage()
520 UsageError(" resolves strings referenced from const-string of startup methods."); in Usage()
521 UsageError(""); in Usage()
522 UsageError(" --max-image-block-size=<size>: Maximum solid block size for compressed images."); in Usage()
523 UsageError(""); in Usage()
524 UsageError(" --compile-individually: Compiles dex files individually, unloading classes in"); in Usage()
525 UsageError(" between compiling each file."); in Usage()
526 UsageError(""); in Usage()