Init.h revision 375fb116bcb817b37509ab579dbd55cdbb765cbf 
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/*
18 * VM initialization and shutdown.
19 */
20#ifndef DALVIK_INIT_H_
21#define DALVIK_INIT_H_
22
23/*
24 * Standard VM initialization, usually invoked through JNI.
25 */
26int dvmStartup(int argc, const char* const argv[], bool ignoreUnrecognized,
27    JNIEnv* pEnv);
28void dvmShutdown(void);
29bool dvmInitAfterZygote(void);
30
31/*
32 * Enable Java programming language assert statements after the Zygote fork.
33 */
34void dvmLateEnableAssertions(void);
35
36/*
37 * Partial VM initialization; only used as part of "dexopt", which may be
38 * asked to optimize a DEX file holding fundamental classes.
39 */
40int dvmPrepForDexOpt(const char* bootClassPath, DexOptimizerMode dexOptMode,
41    DexClassVerifyMode verifyMode, int dexoptFlags);
42
43/*
44 * Look up the set of classes and members used directly by the VM,
45 * storing references to them into the globals instance. See
46 * Globals.h. This function is exposed so that dex optimization may
47 * call it (while avoiding doing other unnecessary VM initialization).
48 *
49 * The function returns a success flag (true == success).
50 */
51bool dvmFindRequiredClassesAndMembers(void);
52
53/*
54 * Look up required members of the class Reference, and set the global
55 * reference to Reference itself too. This needs to be done separately
56 * from dvmFindRequiredClassesAndMembers(), during the course of
57 * linking the class Reference (which is done specially).
58 */
59bool dvmFindReferenceMembers(ClassObject* classReference);
60
61/*
62 * Replacement for fprintf() when we want to send a message to the console.
63 * This defaults to fprintf(), but will use the JNI fprintf callback if
64 * one was provided.
65 */
66int dvmFprintf(FILE* fp, const char* format, ...)
67#if defined(__GNUC__)
68    __attribute__ ((format(printf, 2, 3)))
69#endif
70    ;
71
72#endif  // DALVIK_INIT_H_
73