Home | History | Annotate | Download | only in vm
      1 /*
      2  * Copyright (C) 2008 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 /*
     17  * Decode jar/apk/zip files.
     18  */
     19 #ifndef _DALVIK_JARFILE
     20 #define _DALVIK_JARFILE
     21 
     22 /*
     23  * This represents an open, scanned Jar file.  (It's actually for any Zip
     24  * archive that happens to hold a Dex file.)
     25  */
     26 typedef struct JarFile {
     27     ZipArchive  archive;
     28     //MemMapping  map;
     29     char*       cacheFileName;
     30     DvmDex*     pDvmDex;
     31 } JarFile;
     32 
     33 /*
     34  * Open the Zip archive and get a list of the classfile entries.
     35  *
     36  * On success, returns 0 and sets "*ppJarFile" to a newly-allocated JarFile.
     37  * On failure, returns a meaningful error code [currently just -1].
     38  */
     39 int dvmJarFileOpen(const char* fileName, const char* odexOutputName,
     40     JarFile** ppJarFile, bool isBootstrap);
     41 
     42 /*
     43  * Free a JarFile structure, along with any associated structures.
     44  */
     45 void dvmJarFileFree(JarFile* pJarFile);
     46 
     47 /* pry the DexFile out of a JarFile */
     48 INLINE DvmDex* dvmGetJarFileDex(JarFile* pJarFile) {
     49     return pJarFile->pDvmDex;
     50 }
     51 
     52 /* get full path of optimized DEX file */
     53 INLINE const char* dvmGetJarFileCacheFileName(JarFile* pJarFile) {
     54     return pJarFile->cacheFileName;
     55 }
     56 
     57 typedef enum DexCacheStatus {
     58     DEX_CACHE_ERROR = -2,
     59     DEX_CACHE_BAD_ARCHIVE = -1,
     60     DEX_CACHE_OK = 0,
     61     DEX_CACHE_STALE,
     62     DEX_CACHE_STALE_ODEX,
     63 } DexCacheStatus;
     64 
     65 /*
     66  * Checks the dependencies of the dex cache file corresponding
     67  * to the jar file at the absolute path "fileName".
     68  */
     69 DexCacheStatus dvmDexCacheStatus(const char *fileName);
     70 
     71 #endif /*_DALVIK_JARFILE*/
     72