/* this header file can be included several times by the same source code. * it contains the list of support command-line options for the Android * emulator program */ #ifndef OPT_PARAM #error OPT_PARAM is not defined #endif #ifndef OPT_LIST #error OPT_LIST is not defined #endif #ifndef OPT_FLAG #error OPT_FLAG is not defined #endif #ifndef CFG_PARAM #define CFG_PARAM OPT_PARAM #endif #ifndef CFG_FLAG #define CFG_FLAG OPT_FLAG #endif /* required to ensure that the CONFIG_XXX macros are properly defined */ #include "android/config/config.h" /* Some options acts like flags, while others must be followed by a parameter * string. Nothing really new here. * * Some options correspond to AVD (Android Virtual Device) configuration * and will be ignored if you start the emulator with the -avd flag. * * However, if you use them with -avd-create , these options will be * recorded into the new AVD directory. Once an AVD is created, there is no * way to change these options. * * Several macros are used to define options: * * OPT_FLAG( name, "description" ) * used to define a non-config flag option. * * 'name' is the option suffix that must follow the dash (-) * as well as the name of an integer variable whose value will * be 1 if the flag is used, or 0 otherwise. * * "description" is a short description string that will be * displayed by 'emulator -help'. * * OPT_PARAM( name, "", "description" ) * used to define a non-config parameter option * * 'name' will point to a char* variable (NULL if option is unused) * * "" is a template for the parameter displayed by the help * * 'varname' is the name of a char* variable that will point * to the parameter string, if any, or will be NULL otherwise. * * CFG_FLAG( name, "description" ) * used to define a configuration-specific flag option. * * CFG_PARAM( name, "", "description" ) * used to define a configuration-specific parameter option. * * NOTE: Keep in mind that optio names are converted by translating * dashes into underscore. * * This means that '-some-option' is equivalent to '-some_option' * and will be backed by a variable name 'some_option' * */ CFG_PARAM( sysdir, "", "search for system disk images in " ) CFG_PARAM( system, "", "read initial system image from " ) CFG_PARAM( datadir, "", "write user data into " ) CFG_PARAM( kernel, "", "use specific emulated kernel" ) CFG_PARAM( ramdisk, "", "ramdisk image (default /ramdisk.img" ) CFG_PARAM( image, "", "obsolete, use -system instead" ) CFG_PARAM( init_data, "", "initial data image (default /userdata.img" ) CFG_PARAM( initdata, "", "same as '-init-data '" ) CFG_PARAM( data, "", "data image (default /userdata-qemu.img" ) CFG_PARAM( partition_size, "", "system/data partition size in MBs" ) CFG_PARAM( cache, "", "cache partition image (default is temporary file)" ) CFG_FLAG ( no_cache, "disable the cache partition" ) CFG_FLAG ( nocache, "same as -no-cache" ) OPT_PARAM( sdcard, "", "SD card image (default /sdcard.img") OPT_PARAM( sdcard2, "", "SD card 2 image (default /sdcard2.img") OPT_FLAG ( wipe_data, "reset the use data image (copy it from initdata)" ) CFG_PARAM( avd, "", "use a specific android virtual device" ) CFG_PARAM( skindir, "", "search skins in (default /skins)" ) CFG_PARAM( skin, "", "select a given skin" ) CFG_FLAG ( no_skin, "don't use any emulator skin" ) CFG_FLAG ( noskin, "same as -no-skin" ) CFG_PARAM( memory, "", "physical RAM size in MBs" ) OPT_PARAM( netspeed, "", "maximum network download/upload speeds" ) OPT_PARAM( netdelay, "", "network latency emulation" ) OPT_FLAG ( netfast, "disable network shaping" ) OPT_PARAM( trace, "", "enable code profiling (F9 to start)" ) OPT_FLAG ( show_kernel, "display kernel messages" ) OPT_FLAG ( shell, "enable root shell on current terminal" ) OPT_FLAG ( no_jni, "disable JNI checks in the Dalvik runtime" ) OPT_FLAG ( nojni, "same as -no-jni" ) OPT_PARAM( logcat, "", "enable logcat output with given tags" ) OPT_FLAG ( no_audio, "disable audio support" ) OPT_FLAG ( noaudio, "same as -no-audio" ) OPT_PARAM( audio, "", "use specific audio backend" ) OPT_PARAM( audio_in, "", "use specific audio input backend" ) OPT_PARAM( audio_out,"", "use specific audio output backend" ) OPT_FLAG ( raw_keys, "disable Unicode keyboard reverse-mapping" ) OPT_PARAM( radio, "", "redirect radio modem interface to character device" ) OPT_PARAM( port, "", "TCP port that will be used for the console" ) OPT_PARAM( ports, ",", "TCP ports used for the console and adb bridge" ) OPT_PARAM( onion, "", "use overlay PNG image over screen" ) OPT_PARAM( onion_alpha, "<%age>", "specify onion-skin translucency" ) OPT_PARAM( onion_rotation, "0|1|2|3", "specify onion-skin rotation" ) OPT_PARAM( scale, "", "scale emulator window" ) OPT_PARAM( dpi_device, "", "specify device's resolution in dpi (default " STRINGIFY(DEFAULT_DEVICE_DPI) ")" ) OPT_PARAM( http_proxy, "", "make TCP connections through a HTTP/HTTPS proxy" ) OPT_PARAM( timezone, "", "use this timezone instead of the host's default" ) OPT_PARAM( dns_server, "", "use this DNS server(s) in the emulated system" ) OPT_PARAM( cpu_delay, "", "throttle CPU emulation" ) OPT_FLAG ( no_boot_anim, "disable animation for faster boot" ) OPT_FLAG( no_window, "disable graphical window display" ) OPT_FLAG( version, "display emulator version number" ) OPT_PARAM( report_console, "", "report console port to remote socket" ) OPT_PARAM( gps, "", "redirect NMEA GPS to character device" ) OPT_PARAM( keyset, "", "specify keyset file name" ) OPT_PARAM( shell_serial, "", "specific character device for root shell" ) OPT_FLAG ( old_system, "support old (pre 1.4) system images" ) OPT_PARAM( tcpdump, "", "capture network packets to file" ) OPT_PARAM( bootchart, "", "enable bootcharting") OPT_PARAM( charmap, "", "use specific key character map") OPT_LIST( prop, "=", "set system property on boot") #ifdef CONFIG_NAND_LIMITS OPT_PARAM( nand_limits, "", "enforce NAND/Flash read/write thresholds" ) #endif #ifdef CONFIG_MEMCHECK OPT_PARAM( memcheck, "", "enable memory access checking" ) #endif // CONFIG_MEMCHECK #undef CFG_FLAG #undef CFG_PARAM #undef OPT_FLAG #undef OPT_PARAM #undef OPT_LIST