diff options
Diffstat (limited to 'android/avd/info.h')
| -rw-r--r-- | android/avd/info.h | 161 |
1 files changed, 0 insertions, 161 deletions
diff --git a/android/avd/info.h b/android/avd/info.h deleted file mode 100644 index ad8a138..0000000 --- a/android/avd/info.h +++ /dev/null @@ -1,161 +0,0 @@ -/* Copyright (C) 2008 The Android Open Source Project -** -** This software is licensed under the terms of the GNU General Public -** License version 2, as published by the Free Software Foundation, and -** may be copied, distributed, and modified under those terms. -** -** This program is distributed in the hope that it will be useful, -** but WITHOUT ANY WARRANTY; without even the implied warranty of -** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -** GNU General Public License for more details. -*/ -#ifndef ANDROID_AVD_INFO_H -#define ANDROID_AVD_INFO_H - -#include "android/utils/ini.h" -#include "android/avd/hw-config.h" - -/* An Android Virtual Device (AVD for short) corresponds to a - * directory containing all kernel/disk images for a given virtual - * device, as well as information about its hardware capabilities, - * SDK version number, skin, etc... - * - * Each AVD has a human-readable name and is backed by a root - * configuration file and a content directory. For example, an - * AVD named 'foo' will correspond to the following: - * - * - a root configuration file named ~/.android/avd/foo.ini - * describing where the AVD's content can be found - * - * - a content directory like ~/.android/avd/foo/ containing all - * disk image and configuration files for the virtual device. - * - * the 'foo.ini' file should contain at least one line of the form: - * - * rootPath=<content-path> - * - * it may also contain other lines that cache stuff found in the - * content directory, like hardware properties or SDK version number. - * - * it is possible to move the content directory by updating the foo.ini - * file to point to the new location. This can be interesting when your - * $HOME directory is located on a network share or in a roaming profile - * (Windows), given that the content directory of a single virtual device - * can easily use more than 100MB of data. - * - */ - -/* a macro used to define the list of disk images managed by the - * implementation. This macro will be expanded several times with - * varying definitions of _AVD_IMG - */ -#define AVD_IMAGE_LIST \ - _AVD_IMG(KERNEL,"kernel-qemu","kernel") \ - _AVD_IMG(RAMDISK,"ramdisk.img","ramdisk") \ - _AVD_IMG(SYSTEM,"system.img","system") \ - _AVD_IMG(USERDATA,"userdata.img","user data") \ - _AVD_IMG(CACHE,"cache.img","cache") \ - _AVD_IMG(SDCARD,"sdcard.img","SD Card") \ - -/* define the enumared values corresponding to each AVD image type - * examples are: AVD_IMAGE_KERNEL, AVD_IMAGE_SYSTEM, etc.. - */ -#define _AVD_IMG(x,y,z) AVD_IMAGE_##x , -typedef enum { - AVD_IMAGE_LIST - AVD_IMAGE_MAX /* do not remove */ -} AvdImageType; -#undef _AVD_IMG - -/* AvdInfo is an opaque structure used to model the information - * corresponding to a given AVD instance - */ -typedef struct AvdInfo AvdInfo; - -/* various flags used when creating an AvdInfo object */ -typedef enum { - /* use to force a data wipe */ - AVDINFO_WIPE_DATA = (1 << 0), - /* use to ignore the cache partition */ - AVDINFO_NO_CACHE = (1 << 1), - /* use to wipe cache partition, ignored if NO_CACHE is set */ - AVDINFO_WIPE_CACHE = (1 << 2), - /* use to ignore ignore SDCard image (default or provided) */ - AVDINFO_NO_SDCARD = (1 << 3), -} AvdFlags; - -typedef struct { - unsigned flags; - const char* skinName; - const char* skinRootPath; - const char* forcePaths[AVD_IMAGE_MAX]; -} AvdInfoParams; - -/* Creates a new AvdInfo object from a name. Returns NULL if name is NULL - * or contains characters that are not part of the following list: - * letters, digits, underscores, dashes and periods - */ -AvdInfo* avdInfo_new( const char* name, AvdInfoParams* params ); - -/* A special function used to setup an AvdInfo for use when starting - * the emulator from the Android build system. In this specific instance - * we're going to create temporary files to hold all writable image - * files, and activate all hardware features by default - * - * 'androidBuildRoot' must be the absolute path to the root of the - * Android build system (i.e. the 'android' directory) - * - * 'androidOut' must be the target-specific out directory where - * disk images will be looked for. - */ -AvdInfo* avdInfo_newForAndroidBuild( const char* androidBuildRoot, - const char* androidOut, - AvdInfoParams* params ); - -/* Frees an AvdInfo object and the corresponding strings that may be - * returned by its getXXX() methods - */ -void avdInfo_free( AvdInfo* i ); - -/* Return the name of the Android Virtual Device - */ -const char* avdInfo_getName( AvdInfo* i ); - -/* Try to find the path of a given image file, returns NULL - * if the corresponding file could not be found. the string - * belongs to the AvdInfo object. - */ -const char* avdInfo_getImageFile( AvdInfo* i, AvdImageType imageType ); - -/* Returns 1 if the corresponding image file is read-only - */ -int avdInfo_isImageReadOnly( AvdInfo* i, AvdImageType imageType ); - -/* lock an image file if it is writable. returns 0 on success, or -1 - * otherwise. note that if the file is read-only, it doesn't need to - * be locked and the function will return success. - */ -int avdInfo_lockImageFile( AvdInfo* i, AvdImageType imageType, int abortOnError); - -/* Manually set the path of a given image file. */ -void avdInfo_setImageFile( AvdInfo* i, AvdImageType imageType, const char* imagePath ); - -/* Returns the path of the skin directory */ -/* the string belongs to the AvdInfo object */ -const char* avdInfo_getSkinPath( AvdInfo* i ); - -/* Returns the name of the virtual device's skin */ -const char* avdInfo_getSkinName( AvdInfo* i ); - -/* Returns the root skin directory for this device */ -const char* avdInfo_getSkinDir ( AvdInfo* i ); - -/* Reads the AVD's hardware configuration into 'hw'. returns -1 on error, 0 otherwise */ -int avdInfo_getHwConfig( AvdInfo* i, AndroidHwConfig* hw ); - -/* Returns a *copy* of the path used to store trace 'foo'. result must be freed by caller */ -char* avdInfo_getTracePath( AvdInfo* i, const char* traceName ); - -/* */ - -#endif /* ANDROID_AVD_INFO_H */ |