AndroidRuntime.cpp revision 4280c4a93ea17f2e9d3f651e49d8c13dc3fb92aa 
1/*
2 * Copyright (C) 2006 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#define LOG_TAG "AndroidRuntime"
18//#define LOG_NDEBUG 0
19
20#include <android_runtime/AndroidRuntime.h>
21#include <binder/IBinder.h>
22#include <binder/IPCThreadState.h>
23#include <binder/IServiceManager.h>
24#include <utils/Log.h>
25#include <utils/misc.h>
26#include <binder/Parcel.h>
27#include <utils/StringArray.h>
28#include <utils/threads.h>
29#include <cutils/properties.h>
30
31#include <SkGraphics.h>
32#include <SkImageDecoder.h>
33#include <SkImageRef_GlobalPool.h>
34
35#include "jni.h"
36#include "JNIHelp.h"
37#include "android_util_Binder.h"
38
39#include <stdio.h>
40#include <signal.h>
41#include <sys/stat.h>
42#include <sys/types.h>
43#include <signal.h>
44#include <dirent.h>
45#include <assert.h>
46
47
48using namespace android;
49
50extern void register_BindTest();
51
52extern int register_android_os_Binder(JNIEnv* env);
53extern int register_android_os_Process(JNIEnv* env);
54extern int register_android_graphics_Bitmap(JNIEnv*);
55extern int register_android_graphics_BitmapFactory(JNIEnv*);
56extern int register_android_graphics_BitmapRegionDecoder(JNIEnv*);
57extern int register_android_graphics_Camera(JNIEnv* env);
58extern int register_android_graphics_Graphics(JNIEnv* env);
59extern int register_android_graphics_Interpolator(JNIEnv* env);
60extern int register_android_graphics_LayerRasterizer(JNIEnv*);
61extern int register_android_graphics_MaskFilter(JNIEnv* env);
62extern int register_android_graphics_Movie(JNIEnv* env);
63extern int register_android_graphics_NinePatch(JNIEnv*);
64extern int register_android_graphics_PathEffect(JNIEnv* env);
65extern int register_android_graphics_Shader(JNIEnv* env);
66extern int register_android_graphics_Typeface(JNIEnv* env);
67extern int register_android_graphics_YuvImage(JNIEnv* env);
68
69extern int register_com_google_android_gles_jni_EGLImpl(JNIEnv* env);
70extern int register_com_google_android_gles_jni_GLImpl(JNIEnv* env);
71extern int register_android_opengl_jni_GLES10(JNIEnv* env);
72extern int register_android_opengl_jni_GLES10Ext(JNIEnv* env);
73extern int register_android_opengl_jni_GLES11(JNIEnv* env);
74extern int register_android_opengl_jni_GLES11Ext(JNIEnv* env);
75extern int register_android_opengl_jni_GLES20(JNIEnv* env);
76
77extern int register_android_hardware_Camera(JNIEnv *env);
78extern int register_android_hardware_SensorManager(JNIEnv *env);
79extern int register_android_hardware_SerialPort(JNIEnv *env);
80extern int register_android_hardware_UsbDevice(JNIEnv *env);
81extern int register_android_hardware_UsbDeviceConnection(JNIEnv *env);
82extern int register_android_hardware_UsbRequest(JNIEnv *env);
83
84extern int register_android_media_AudioRecord(JNIEnv *env);
85extern int register_android_media_AudioSystem(JNIEnv *env);
86extern int register_android_media_AudioTrack(JNIEnv *env);
87extern int register_android_media_JetPlayer(JNIEnv *env);
88extern int register_android_media_ToneGenerator(JNIEnv *env);
89
90extern int register_android_util_FloatMath(JNIEnv* env);
91
92namespace android {
93
94/*
95 * JNI-based registration functions.  Note these are properly contained in
96 * namespace android.
97 */
98extern int register_android_content_AssetManager(JNIEnv* env);
99extern int register_android_util_EventLog(JNIEnv* env);
100extern int register_android_util_Log(JNIEnv* env);
101extern int register_android_content_StringBlock(JNIEnv* env);
102extern int register_android_content_XmlBlock(JNIEnv* env);
103extern int register_android_emoji_EmojiFactory(JNIEnv* env);
104extern int register_android_graphics_Canvas(JNIEnv* env);
105extern int register_android_graphics_ColorFilter(JNIEnv* env);
106extern int register_android_graphics_DrawFilter(JNIEnv* env);
107extern int register_android_graphics_Matrix(JNIEnv* env);
108extern int register_android_graphics_Paint(JNIEnv* env);
109extern int register_android_graphics_Path(JNIEnv* env);
110extern int register_android_graphics_PathMeasure(JNIEnv* env);
111extern int register_android_graphics_Picture(JNIEnv*);
112extern int register_android_graphics_PorterDuff(JNIEnv* env);
113extern int register_android_graphics_Rasterizer(JNIEnv* env);
114extern int register_android_graphics_Region(JNIEnv* env);
115extern int register_android_graphics_SurfaceTexture(JNIEnv* env);
116extern int register_android_graphics_Xfermode(JNIEnv* env);
117extern int register_android_graphics_PixelFormat(JNIEnv* env);
118extern int register_android_view_Display(JNIEnv* env);
119extern int register_android_view_DisplayEventReceiver(JNIEnv* env);
120extern int register_android_view_GLES20DisplayList(JNIEnv* env);
121extern int register_android_view_GLES20Canvas(JNIEnv* env);
122extern int register_android_view_HardwareRenderer(JNIEnv* env);
123extern int register_android_view_Surface(JNIEnv* env);
124extern int register_android_view_TextureView(JNIEnv* env);
125extern int register_android_database_CursorWindow(JNIEnv* env);
126extern int register_android_database_SQLiteConnection(JNIEnv* env);
127extern int register_android_database_SQLiteGlobal(JNIEnv* env);
128extern int register_android_database_SQLiteDebug(JNIEnv* env);
129extern int register_android_debug_JNITest(JNIEnv* env);
130extern int register_android_nio_utils(JNIEnv* env);
131extern int register_android_text_format_Time(JNIEnv* env);
132extern int register_android_os_Debug(JNIEnv* env);
133extern int register_android_os_MessageQueue(JNIEnv* env);
134extern int register_android_os_Parcel(JNIEnv* env);
135extern int register_android_os_ParcelFileDescriptor(JNIEnv *env);
136extern int register_android_os_Power(JNIEnv *env);
137extern int register_android_os_StatFs(JNIEnv *env);
138extern int register_android_os_SystemProperties(JNIEnv *env);
139extern int register_android_os_SystemClock(JNIEnv* env);
140extern int register_android_os_Trace(JNIEnv* env);
141extern int register_android_os_FileObserver(JNIEnv *env);
142extern int register_android_os_FileUtils(JNIEnv *env);
143extern int register_android_os_UEventObserver(JNIEnv* env);
144extern int register_android_os_MemoryFile(JNIEnv* env);
145extern int register_android_net_LocalSocketImpl(JNIEnv* env);
146extern int register_android_net_NetworkUtils(JNIEnv* env);
147extern int register_android_net_TrafficStats(JNIEnv* env);
148extern int register_android_net_wifi_WifiManager(JNIEnv* env);
149extern int register_android_text_AndroidCharacter(JNIEnv *env);
150extern int register_android_text_AndroidBidi(JNIEnv *env);
151extern int register_android_text_KeyCharacterMap(JNIEnv *env);
152extern int register_android_opengl_classes(JNIEnv *env);
153extern int register_android_bluetooth_HeadsetBase(JNIEnv* env);
154extern int register_android_bluetooth_BluetoothAudioGateway(JNIEnv* env);
155extern int register_android_bluetooth_BluetoothSocket(JNIEnv *env);
156extern int register_android_server_BluetoothService(JNIEnv* env);
157extern int register_android_server_BluetoothEventLoop(JNIEnv *env);
158extern int register_android_server_BluetoothA2dpService(JNIEnv* env);
159extern int register_android_server_NetworkManagementSocketTagger(JNIEnv* env);
160extern int register_android_server_Watchdog(JNIEnv* env);
161extern int register_android_ddm_DdmHandleNativeHeap(JNIEnv *env);
162extern int register_com_android_internal_os_ZygoteInit(JNIEnv* env);
163extern int register_android_backup_BackupDataInput(JNIEnv *env);
164extern int register_android_backup_BackupDataOutput(JNIEnv *env);
165extern int register_android_backup_FileBackupHelperBase(JNIEnv *env);
166extern int register_android_backup_BackupHelperDispatcher(JNIEnv *env);
167extern int register_android_app_backup_FullBackup(JNIEnv *env);
168extern int register_android_app_ActivityThread(JNIEnv *env);
169extern int register_android_app_NativeActivity(JNIEnv *env);
170extern int register_android_view_InputChannel(JNIEnv* env);
171extern int register_android_view_InputEventReceiver(JNIEnv* env);
172extern int register_android_view_KeyEvent(JNIEnv* env);
173extern int register_android_view_MotionEvent(JNIEnv* env);
174extern int register_android_view_PointerIcon(JNIEnv* env);
175extern int register_android_view_VelocityTracker(JNIEnv* env);
176extern int register_android_content_res_ObbScanner(JNIEnv* env);
177extern int register_android_content_res_Configuration(JNIEnv* env);
178extern int register_android_animation_PropertyValuesHolder(JNIEnv *env);
179extern int register_com_android_internal_content_NativeLibraryHelper(JNIEnv *env);
180
181static AndroidRuntime* gCurRuntime = NULL;
182
183static void doThrow(JNIEnv* env, const char* exc, const char* msg = NULL)
184{
185    if (jniThrowException(env, exc, msg) != 0)
186        assert(false);
187}
188
189/*
190 * Code written in the Java Programming Language calls here from main().
191 */
192static void com_android_internal_os_RuntimeInit_nativeFinishInit(JNIEnv* env, jobject clazz)
193{
194    gCurRuntime->onStarted();
195}
196
197static void com_android_internal_os_RuntimeInit_nativeZygoteInit(JNIEnv* env, jobject clazz)
198{
199    gCurRuntime->onZygoteInit();
200}
201
202static void com_android_internal_os_RuntimeInit_nativeSetExitWithoutCleanup(JNIEnv* env,
203        jobject clazz, jboolean exitWithoutCleanup)
204{
205    gCurRuntime->setExitWithoutCleanup(exitWithoutCleanup);
206}
207
208/*
209 * JNI registration.
210 */
211static JNINativeMethod gMethods[] = {
212    { "nativeFinishInit", "()V",
213        (void*) com_android_internal_os_RuntimeInit_nativeFinishInit },
214    { "nativeZygoteInit", "()V",
215        (void*) com_android_internal_os_RuntimeInit_nativeZygoteInit },
216    { "nativeSetExitWithoutCleanup", "(Z)V",
217        (void*) com_android_internal_os_RuntimeInit_nativeSetExitWithoutCleanup },
218};
219
220int register_com_android_internal_os_RuntimeInit(JNIEnv* env)
221{
222    return jniRegisterNativeMethods(env, "com/android/internal/os/RuntimeInit",
223        gMethods, NELEM(gMethods));
224}
225
226// ----------------------------------------------------------------------
227
228/*static*/ JavaVM* AndroidRuntime::mJavaVM = NULL;
229
230
231AndroidRuntime::AndroidRuntime() :
232        mExitWithoutCleanup(false)
233{
234    SkGraphics::Init();
235    // this sets our preference for 16bit images during decode
236    // in case the src is opaque and 24bit
237    SkImageDecoder::SetDeviceConfig(SkBitmap::kRGB_565_Config);
238    // This cache is shared between browser native images, and java "purgeable"
239    // bitmaps. This globalpool is for images that do not either use the java
240    // heap, or are not backed by ashmem. See BitmapFactory.cpp for the key
241    // java call site.
242    SkImageRef_GlobalPool::SetRAMBudget(512 * 1024);
243    // There is also a global font cache, but its budget is specified in code
244    // see SkFontHost_android.cpp
245
246    // Pre-allocate enough space to hold a fair number of options.
247    mOptions.setCapacity(20);
248
249    assert(gCurRuntime == NULL);        // one per process
250    gCurRuntime = this;
251}
252
253AndroidRuntime::~AndroidRuntime()
254{
255    SkGraphics::Term();
256}
257
258/*
259 * Register native methods using JNI.
260 */
261/*static*/ int AndroidRuntime::registerNativeMethods(JNIEnv* env,
262    const char* className, const JNINativeMethod* gMethods, int numMethods)
263{
264    return jniRegisterNativeMethods(env, className, gMethods, numMethods);
265}
266
267status_t AndroidRuntime::callMain(const char* className,
268    jclass clazz, int argc, const char* const argv[])
269{
270    JNIEnv* env;
271    jmethodID methodId;
272
273    ALOGD("Calling main entry %s", className);
274
275    env = getJNIEnv();
276    if (clazz == NULL || env == NULL) {
277        return UNKNOWN_ERROR;
278    }
279
280    methodId = env->GetStaticMethodID(clazz, "main", "([Ljava/lang/String;)V");
281    if (methodId == NULL) {
282        ALOGE("ERROR: could not find method %s.main(String[])\n", className);
283        return UNKNOWN_ERROR;
284    }
285
286    /*
287     * We want to call main() with a String array with our arguments in it.
288     * Create an array and populate it.
289     */
290    jclass stringClass;
291    jobjectArray strArray;
292
293    stringClass = env->FindClass("java/lang/String");
294    strArray = env->NewObjectArray(argc, stringClass, NULL);
295
296    for (int i = 0; i < argc; i++) {
297        jstring argStr = env->NewStringUTF(argv[i]);
298        env->SetObjectArrayElement(strArray, i, argStr);
299    }
300
301    env->CallStaticVoidMethod(clazz, methodId, strArray);
302    return NO_ERROR;
303}
304
305/*
306 * The VM calls this through the "exit" hook.
307 */
308static void runtime_exit(int code)
309{
310    gCurRuntime->exit(code);
311}
312
313/*
314 * The VM calls this through the "vfprintf" hook.
315 *
316 * We ignore "fp" and just write the results to the log file.
317 */
318static void runtime_vfprintf(FILE* fp, const char* format, va_list ap)
319{
320    LOG_PRI_VA(ANDROID_LOG_INFO, "vm-printf", format, ap);
321}
322
323/**
324 * The VM calls this when mutex contention debugging is enabled to
325 * determine whether or not the blocked thread was a "sensitive thread"
326 * for user responsiveness/smoothess.
327 *
328 * Our policy for this is whether or not we're tracing any StrictMode
329 * events on this thread (which we might've inherited via Binder calls
330 * into us)
331 */
332static bool runtime_isSensitiveThread() {
333    IPCThreadState* state = IPCThreadState::selfOrNull();
334    return state && state->getStrictModePolicy() != 0;
335}
336
337
338/**
339 * Add VM arguments to the to-be-executed VM
340 * Stops at first non '-' argument (also stops at an argument of '--')
341 * Returns the number of args consumed
342 */
343int AndroidRuntime::addVmArguments(int argc, const char* const argv[])
344{
345    int i;
346
347    for (i = 0; i<argc; i++) {
348        if (argv[i][0] != '-') {
349            return i;
350        }
351        if (argv[i][1] == '-' && argv[i][2] == 0) {
352            return i+1;
353        }
354
355        JavaVMOption opt;
356        memset(&opt, 0, sizeof(opt));
357        opt.optionString = (char*)argv[i];
358        mOptions.add(opt);
359    }
360    return i;
361}
362
363static int hasDir(const char* dir)
364{
365    struct stat s;
366    int res = stat(dir, &s);
367    if (res == 0) {
368        return S_ISDIR(s.st_mode);
369    }
370    return 0;
371}
372
373/*
374 * We just want failed write() calls to just return with an error.
375 */
376static void blockSigpipe()
377{
378    sigset_t mask;
379
380    sigemptyset(&mask);
381    sigaddset(&mask, SIGPIPE);
382    if (sigprocmask(SIG_BLOCK, &mask, NULL) != 0)
383        ALOGW("WARNING: SIGPIPE not blocked\n");
384}
385
386/*
387 * Read the persistent locale.
388 */
389static void readLocale(char* language, char* region)
390{
391    char propLang[PROPERTY_VALUE_MAX], propRegn[PROPERTY_VALUE_MAX];
392
393    property_get("persist.sys.language", propLang, "");
394    property_get("persist.sys.country", propRegn, "");
395    if (*propLang == 0 && *propRegn == 0) {
396        /* Set to ro properties, default is en_US */
397        property_get("ro.product.locale.language", propLang, "en");
398        property_get("ro.product.locale.region", propRegn, "US");
399    }
400    strncat(language, propLang, 2);
401    strncat(region, propRegn, 2);
402    //ALOGD("language=%s region=%s\n", language, region);
403}
404
405/*
406 * Parse a property containing space-separated options that should be
407 * passed directly to the VM, e.g. "-Xmx32m -verbose:gc -Xregenmap".
408 *
409 * This will cut up "extraOptsBuf" as we chop it into individual options.
410 *
411 * Adds the strings, if any, to mOptions.
412 */
413void AndroidRuntime::parseExtraOpts(char* extraOptsBuf)
414{
415    JavaVMOption opt;
416    char* start;
417    char* end;
418
419    memset(&opt, 0, sizeof(opt));
420    start = extraOptsBuf;
421    while (*start != '\0') {
422        while (*start == ' ')                   /* skip leading whitespace */
423            start++;
424        if (*start == '\0')                     /* was trailing ws, bail */
425            break;
426
427        end = start+1;
428        while (*end != ' ' && *end != '\0')     /* find end of token */
429            end++;
430        if (*end == ' ')
431            *end++ = '\0';          /* mark end, advance to indicate more */
432
433        opt.optionString = start;
434        mOptions.add(opt);
435        start = end;
436    }
437}
438
439/*
440 * Start the Dalvik Virtual Machine.
441 *
442 * Various arguments, most determined by system properties, are passed in.
443 * The "mOptions" vector is updated.
444 *
445 * Returns 0 on success.
446 */
447int AndroidRuntime::startVm(JavaVM** pJavaVM, JNIEnv** pEnv)
448{
449    int result = -1;
450    JavaVMInitArgs initArgs;
451    JavaVMOption opt;
452    char propBuf[PROPERTY_VALUE_MAX];
453    char stackTraceFileBuf[PROPERTY_VALUE_MAX];
454    char dexoptFlagsBuf[PROPERTY_VALUE_MAX];
455    char enableAssertBuf[sizeof("-ea:")-1 + PROPERTY_VALUE_MAX];
456    char jniOptsBuf[sizeof("-Xjniopts:")-1 + PROPERTY_VALUE_MAX];
457    char heapstartsizeOptsBuf[sizeof("-Xms")-1 + PROPERTY_VALUE_MAX];
458    char heapsizeOptsBuf[sizeof("-Xmx")-1 + PROPERTY_VALUE_MAX];
459    char heapgrowthlimitOptsBuf[sizeof("-XX:HeapGrowthLimit=")-1 + PROPERTY_VALUE_MAX];
460    char extraOptsBuf[PROPERTY_VALUE_MAX];
461    char* stackTraceFile = NULL;
462    bool checkJni = false;
463    bool checkDexSum = false;
464    bool logStdio = false;
465    enum {
466      kEMDefault,
467      kEMIntPortable,
468      kEMIntFast,
469#if defined(WITH_JIT)
470      kEMJitCompiler,
471#endif
472    } executionMode = kEMDefault;
473
474
475    property_get("dalvik.vm.checkjni", propBuf, "");
476    if (strcmp(propBuf, "true") == 0) {
477        checkJni = true;
478    } else if (strcmp(propBuf, "false") != 0) {
479        /* property is neither true nor false; fall back on kernel parameter */
480        property_get("ro.kernel.android.checkjni", propBuf, "");
481        if (propBuf[0] == '1') {
482            checkJni = true;
483        }
484    }
485
486    property_get("dalvik.vm.execution-mode", propBuf, "");
487    if (strcmp(propBuf, "int:portable") == 0) {
488        executionMode = kEMIntPortable;
489    } else if (strcmp(propBuf, "int:fast") == 0) {
490        executionMode = kEMIntFast;
491#if defined(WITH_JIT)
492    } else if (strcmp(propBuf, "int:jit") == 0) {
493        executionMode = kEMJitCompiler;
494#endif
495    }
496
497    property_get("dalvik.vm.stack-trace-file", stackTraceFileBuf, "");
498
499    property_get("dalvik.vm.check-dex-sum", propBuf, "");
500    if (strcmp(propBuf, "true") == 0) {
501        checkDexSum = true;
502    }
503
504    property_get("log.redirect-stdio", propBuf, "");
505    if (strcmp(propBuf, "true") == 0) {
506        logStdio = true;
507    }
508
509    strcpy(enableAssertBuf, "-ea:");
510    property_get("dalvik.vm.enableassertions", enableAssertBuf+4, "");
511
512    strcpy(jniOptsBuf, "-Xjniopts:");
513    property_get("dalvik.vm.jniopts", jniOptsBuf+10, "");
514
515    /* route exit() to our handler */
516    opt.extraInfo = (void*) runtime_exit;
517    opt.optionString = "exit";
518    mOptions.add(opt);
519
520    /* route fprintf() to our handler */
521    opt.extraInfo = (void*) runtime_vfprintf;
522    opt.optionString = "vfprintf";
523    mOptions.add(opt);
524
525    /* register the framework-specific "is sensitive thread" hook */
526    opt.extraInfo = (void*) runtime_isSensitiveThread;
527    opt.optionString = "sensitiveThread";
528    mOptions.add(opt);
529
530    opt.extraInfo = NULL;
531
532    /* enable verbose; standard options are { jni, gc, class } */
533    //options[curOpt++].optionString = "-verbose:jni";
534    opt.optionString = "-verbose:gc";
535    mOptions.add(opt);
536    //options[curOpt++].optionString = "-verbose:class";
537
538    /*
539     * The default starting and maximum size of the heap.  Larger
540     * values should be specified in a product property override.
541     */
542    strcpy(heapstartsizeOptsBuf, "-Xms");
543    property_get("dalvik.vm.heapstartsize", heapstartsizeOptsBuf+4, "4m");
544    opt.optionString = heapstartsizeOptsBuf;
545    mOptions.add(opt);
546    strcpy(heapsizeOptsBuf, "-Xmx");
547    property_get("dalvik.vm.heapsize", heapsizeOptsBuf+4, "16m");
548    opt.optionString = heapsizeOptsBuf;
549    mOptions.add(opt);
550
551    strcpy(heapgrowthlimitOptsBuf, "-XX:HeapGrowthLimit=");
552    property_get("dalvik.vm.heapgrowthlimit", heapgrowthlimitOptsBuf+20, "");
553    if (heapgrowthlimitOptsBuf[20] != '\0') {
554        opt.optionString = heapgrowthlimitOptsBuf;
555        mOptions.add(opt);
556    }
557
558    /*
559     * Enable or disable dexopt features, such as bytecode verification and
560     * calculation of register maps for precise GC.
561     */
562    property_get("dalvik.vm.dexopt-flags", dexoptFlagsBuf, "");
563    if (dexoptFlagsBuf[0] != '\0') {
564        const char* opc;
565        const char* val;
566
567        opc = strstr(dexoptFlagsBuf, "v=");     /* verification */
568        if (opc != NULL) {
569            switch (*(opc+2)) {
570            case 'n':   val = "-Xverify:none";      break;
571            case 'r':   val = "-Xverify:remote";    break;
572            case 'a':   val = "-Xverify:all";       break;
573            default:    val = NULL;                 break;
574            }
575
576            if (val != NULL) {
577                opt.optionString = val;
578                mOptions.add(opt);
579            }
580        }
581
582        opc = strstr(dexoptFlagsBuf, "o=");     /* optimization */
583        if (opc != NULL) {
584            switch (*(opc+2)) {
585            case 'n':   val = "-Xdexopt:none";      break;
586            case 'v':   val = "-Xdexopt:verified";  break;
587            case 'a':   val = "-Xdexopt:all";       break;
588            case 'f':   val = "-Xdexopt:full";      break;
589            default:    val = NULL;                 break;
590            }
591
592            if (val != NULL) {
593                opt.optionString = val;
594                mOptions.add(opt);
595            }
596        }
597
598        opc = strstr(dexoptFlagsBuf, "m=y");    /* register map */
599        if (opc != NULL) {
600            opt.optionString = "-Xgenregmap";
601            mOptions.add(opt);
602
603            /* turn on precise GC while we're at it */
604            opt.optionString = "-Xgc:precise";
605            mOptions.add(opt);
606        }
607    }
608
609    /* enable debugging; set suspend=y to pause during VM init */
610    /* use android ADB transport */
611    opt.optionString =
612        "-agentlib:jdwp=transport=dt_android_adb,suspend=n,server=y";
613    mOptions.add(opt);
614
615    ALOGD("CheckJNI is %s\n", checkJni ? "ON" : "OFF");
616    if (checkJni) {
617        /* extended JNI checking */
618        opt.optionString = "-Xcheck:jni";
619        mOptions.add(opt);
620
621        /* set a cap on JNI global references */
622        opt.optionString = "-Xjnigreflimit:2000";
623        mOptions.add(opt);
624
625        /* with -Xcheck:jni, this provides a JNI function call trace */
626        //opt.optionString = "-verbose:jni";
627        //mOptions.add(opt);
628    }
629
630    char lockProfThresholdBuf[sizeof("-Xlockprofthreshold:") + sizeof(propBuf)];
631    property_get("dalvik.vm.lockprof.threshold", propBuf, "");
632    if (strlen(propBuf) > 0) {
633      strcpy(lockProfThresholdBuf, "-Xlockprofthreshold:");
634      strcat(lockProfThresholdBuf, propBuf);
635      opt.optionString = lockProfThresholdBuf;
636      mOptions.add(opt);
637    }
638
639#if defined(WITH_JIT)
640    /* Force interpreter-only mode for selected opcodes. Eg "1-0a,3c,f1-ff" */
641    char jitOpBuf[sizeof("-Xjitop:") + PROPERTY_VALUE_MAX];
642    property_get("dalvik.vm.jit.op", propBuf, "");
643    if (strlen(propBuf) > 0) {
644        strcpy(jitOpBuf, "-Xjitop:");
645        strcat(jitOpBuf, propBuf);
646        opt.optionString = jitOpBuf;
647        mOptions.add(opt);
648    }
649
650    /* Force interpreter-only mode for selected methods */
651    char jitMethodBuf[sizeof("-Xjitmethod:") + PROPERTY_VALUE_MAX];
652    property_get("dalvik.vm.jit.method", propBuf, "");
653    if (strlen(propBuf) > 0) {
654        strcpy(jitMethodBuf, "-Xjitmethod:");
655        strcat(jitMethodBuf, propBuf);
656        opt.optionString = jitMethodBuf;
657        mOptions.add(opt);
658    }
659#endif
660
661    if (executionMode == kEMIntPortable) {
662        opt.optionString = "-Xint:portable";
663        mOptions.add(opt);
664    } else if (executionMode == kEMIntFast) {
665        opt.optionString = "-Xint:fast";
666        mOptions.add(opt);
667#if defined(WITH_JIT)
668    } else if (executionMode == kEMJitCompiler) {
669        opt.optionString = "-Xint:jit";
670        mOptions.add(opt);
671#endif
672    }
673
674    if (checkDexSum) {
675        /* perform additional DEX checksum tests */
676        opt.optionString = "-Xcheckdexsum";
677        mOptions.add(opt);
678    }
679
680    if (logStdio) {
681        /* convert stdout/stderr to log messages */
682        opt.optionString = "-Xlog-stdio";
683        mOptions.add(opt);
684    }
685
686    if (enableAssertBuf[4] != '\0') {
687        /* accept "all" to mean "all classes and packages" */
688        if (strcmp(enableAssertBuf+4, "all") == 0)
689            enableAssertBuf[3] = '\0';
690        ALOGI("Assertions enabled: '%s'\n", enableAssertBuf);
691        opt.optionString = enableAssertBuf;
692        mOptions.add(opt);
693    } else {
694        ALOGV("Assertions disabled\n");
695    }
696
697    if (jniOptsBuf[10] != '\0') {
698        ALOGI("JNI options: '%s'\n", jniOptsBuf);
699        opt.optionString = jniOptsBuf;
700        mOptions.add(opt);
701    }
702
703    if (stackTraceFileBuf[0] != '\0') {
704        static const char* stfOptName = "-Xstacktracefile:";
705
706        stackTraceFile = (char*) malloc(strlen(stfOptName) +
707            strlen(stackTraceFileBuf) +1);
708        strcpy(stackTraceFile, stfOptName);
709        strcat(stackTraceFile, stackTraceFileBuf);
710        opt.optionString = stackTraceFile;
711        mOptions.add(opt);
712    }
713
714    /* extra options; parse this late so it overrides others */
715    property_get("dalvik.vm.extra-opts", extraOptsBuf, "");
716    parseExtraOpts(extraOptsBuf);
717
718    /* Set the properties for locale */
719    {
720        char langOption[sizeof("-Duser.language=") + 3];
721        char regionOption[sizeof("-Duser.region=") + 3];
722        strcpy(langOption, "-Duser.language=");
723        strcpy(regionOption, "-Duser.region=");
724        readLocale(langOption, regionOption);
725        opt.extraInfo = NULL;
726        opt.optionString = langOption;
727        mOptions.add(opt);
728        opt.optionString = regionOption;
729        mOptions.add(opt);
730    }
731
732    /*
733     * We don't have /tmp on the device, but we often have an SD card.  Apps
734     * shouldn't use this, but some test suites might want to exercise it.
735     */
736    opt.optionString = "-Djava.io.tmpdir=/sdcard";
737    mOptions.add(opt);
738
739    initArgs.version = JNI_VERSION_1_4;
740    initArgs.options = mOptions.editArray();
741    initArgs.nOptions = mOptions.size();
742    initArgs.ignoreUnrecognized = JNI_FALSE;
743
744    /*
745     * Initialize the VM.
746     *
747     * The JavaVM* is essentially per-process, and the JNIEnv* is per-thread.
748     * If this call succeeds, the VM is ready, and we can start issuing
749     * JNI calls.
750     */
751    if (JNI_CreateJavaVM(pJavaVM, pEnv, &initArgs) < 0) {
752        ALOGE("JNI_CreateJavaVM failed\n");
753        goto bail;
754    }
755
756    result = 0;
757
758bail:
759    free(stackTraceFile);
760    return result;
761}
762
763char* AndroidRuntime::toSlashClassName(const char* className)
764{
765    char* result = strdup(className);
766    for (char* cp = result; *cp != '\0'; cp++) {
767        if (*cp == '.') {
768            *cp = '/';
769        }
770    }
771    return result;
772}
773
774/*
775 * Start the Android runtime.  This involves starting the virtual machine
776 * and calling the "static void main(String[] args)" method in the class
777 * named by "className".
778 *
779 * Passes the main function two arguments, the class name and the specified
780 * options string.
781 */
782void AndroidRuntime::start(const char* className, const char* options)
783{
784    ALOGD("\n>>>>>> AndroidRuntime START %s <<<<<<\n",
785            className != NULL ? className : "(unknown)");
786
787    blockSigpipe();
788
789    /*
790     * 'startSystemServer == true' means runtime is obsolete and not run from
791     * init.rc anymore, so we print out the boot start event here.
792     */
793    if (strcmp(options, "start-system-server") == 0) {
794        /* track our progress through the boot sequence */
795        const int LOG_BOOT_PROGRESS_START = 3000;
796        LOG_EVENT_LONG(LOG_BOOT_PROGRESS_START,
797                       ns2ms(systemTime(SYSTEM_TIME_MONOTONIC)));
798    }
799
800    const char* rootDir = getenv("ANDROID_ROOT");
801    if (rootDir == NULL) {
802        rootDir = "/system";
803        if (!hasDir("/system")) {
804            LOG_FATAL("No root directory specified, and /android does not exist.");
805            return;
806        }
807        setenv("ANDROID_ROOT", rootDir, 1);
808    }
809
810    //const char* kernelHack = getenv("LD_ASSUME_KERNEL");
811    //ALOGD("Found LD_ASSUME_KERNEL='%s'\n", kernelHack);
812
813    /* start the virtual machine */
814    JNIEnv* env;
815    if (startVm(&mJavaVM, &env) != 0) {
816        return;
817    }
818    onVmCreated(env);
819
820    /*
821     * Register android functions.
822     */
823    if (startReg(env) < 0) {
824        ALOGE("Unable to register all android natives\n");
825        return;
826    }
827
828    /*
829     * We want to call main() with a String array with arguments in it.
830     * At present we have two arguments, the class name and an option string.
831     * Create an array to hold them.
832     */
833    jclass stringClass;
834    jobjectArray strArray;
835    jstring classNameStr;
836    jstring optionsStr;
837
838    stringClass = env->FindClass("java/lang/String");
839    assert(stringClass != NULL);
840    strArray = env->NewObjectArray(2, stringClass, NULL);
841    assert(strArray != NULL);
842    classNameStr = env->NewStringUTF(className);
843    assert(classNameStr != NULL);
844    env->SetObjectArrayElement(strArray, 0, classNameStr);
845    optionsStr = env->NewStringUTF(options);
846    env->SetObjectArrayElement(strArray, 1, optionsStr);
847
848    /*
849     * Start VM.  This thread becomes the main thread of the VM, and will
850     * not return until the VM exits.
851     */
852    char* slashClassName = toSlashClassName(className);
853    jclass startClass = env->FindClass(slashClassName);
854    if (startClass == NULL) {
855        ALOGE("JavaVM unable to locate class '%s'\n", slashClassName);
856        /* keep going */
857    } else {
858        jmethodID startMeth = env->GetStaticMethodID(startClass, "main",
859            "([Ljava/lang/String;)V");
860        if (startMeth == NULL) {
861            ALOGE("JavaVM unable to find main() in '%s'\n", className);
862            /* keep going */
863        } else {
864            env->CallStaticVoidMethod(startClass, startMeth, strArray);
865
866#if 0
867            if (env->ExceptionCheck())
868                threadExitUncaughtException(env);
869#endif
870        }
871    }
872    free(slashClassName);
873
874    ALOGD("Shutting down VM\n");
875    if (mJavaVM->DetachCurrentThread() != JNI_OK)
876        ALOGW("Warning: unable to detach main thread\n");
877    if (mJavaVM->DestroyJavaVM() != 0)
878        ALOGW("Warning: VM did not shut down cleanly\n");
879}
880
881void AndroidRuntime::exit(int code)
882{
883    if (mExitWithoutCleanup) {
884        ALOGI("VM exiting with result code %d, cleanup skipped.", code);
885        ::_exit(code);
886    } else {
887        ALOGI("VM exiting with result code %d.", code);
888        onExit(code);
889        ::exit(code);
890    }
891}
892
893void AndroidRuntime::onVmCreated(JNIEnv* env)
894{
895    // If AndroidRuntime had anything to do here, we'd have done it in 'start'.
896}
897
898/*
899 * Get the JNIEnv pointer for this thread.
900 *
901 * Returns NULL if the slot wasn't allocated or populated.
902 */
903/*static*/ JNIEnv* AndroidRuntime::getJNIEnv()
904{
905    JNIEnv* env;
906    JavaVM* vm = AndroidRuntime::getJavaVM();
907    assert(vm != NULL);
908
909    if (vm->GetEnv((void**) &env, JNI_VERSION_1_4) != JNI_OK)
910        return NULL;
911    return env;
912}
913
914/*
915 * Makes the current thread visible to the VM.
916 *
917 * The JNIEnv pointer returned is only valid for the current thread, and
918 * thus must be tucked into thread-local storage.
919 */
920static int javaAttachThread(const char* threadName, JNIEnv** pEnv)
921{
922    JavaVMAttachArgs args;
923    JavaVM* vm;
924    jint result;
925
926    vm = AndroidRuntime::getJavaVM();
927    assert(vm != NULL);
928
929    args.version = JNI_VERSION_1_4;
930    args.name = (char*) threadName;
931    args.group = NULL;
932
933    result = vm->AttachCurrentThread(pEnv, (void*) &args);
934    if (result != JNI_OK)
935        ALOGI("NOTE: attach of thread '%s' failed\n", threadName);
936
937    return result;
938}
939
940/*
941 * Detach the current thread from the set visible to the VM.
942 */
943static int javaDetachThread(void)
944{
945    JavaVM* vm;
946    jint result;
947
948    vm = AndroidRuntime::getJavaVM();
949    assert(vm != NULL);
950
951    result = vm->DetachCurrentThread();
952    if (result != JNI_OK)
953        ALOGE("ERROR: thread detach failed\n");
954    return result;
955}
956
957/*
958 * When starting a native thread that will be visible from the VM, we
959 * bounce through this to get the right attach/detach action.
960 * Note that this function calls free(args)
961 */
962/*static*/ int AndroidRuntime::javaThreadShell(void* args) {
963    void* start = ((void**)args)[0];
964    void* userData = ((void **)args)[1];
965    char* name = (char*) ((void **)args)[2];        // we own this storage
966    free(args);
967    JNIEnv* env;
968    int result;
969
970    /* hook us into the VM */
971    if (javaAttachThread(name, &env) != JNI_OK)
972        return -1;
973
974    /* start the thread running */
975    result = (*(android_thread_func_t)start)(userData);
976
977    /* unhook us */
978    javaDetachThread();
979    free(name);
980
981    return result;
982}
983
984/*
985 * This is invoked from androidCreateThreadEtc() via the callback
986 * set with androidSetCreateThreadFunc().
987 *
988 * We need to create the new thread in such a way that it gets hooked
989 * into the VM before it really starts executing.
990 */
991/*static*/ int AndroidRuntime::javaCreateThreadEtc(
992                                android_thread_func_t entryFunction,
993                                void* userData,
994                                const char* threadName,
995                                int32_t threadPriority,
996                                size_t threadStackSize,
997                                android_thread_id_t* threadId)
998{
999    void** args = (void**) malloc(3 * sizeof(void*));   // javaThreadShell must free
1000    int result;
1001
1002    assert(threadName != NULL);
1003
1004    args[0] = (void*) entryFunction;
1005    args[1] = userData;
1006    args[2] = (void*) strdup(threadName);   // javaThreadShell must free
1007
1008    result = androidCreateRawThreadEtc(AndroidRuntime::javaThreadShell, args,
1009        threadName, threadPriority, threadStackSize, threadId);
1010    return result;
1011}
1012
1013/*
1014 * Create a thread that is visible from the VM.
1015 *
1016 * This is called from elsewhere in the library.
1017 */
1018/*static*/ android_thread_id_t AndroidRuntime::createJavaThread(const char* name,
1019    void (*start)(void *), void* arg)
1020{
1021    android_thread_id_t threadId = 0;
1022    javaCreateThreadEtc((android_thread_func_t) start, arg, name,
1023        ANDROID_PRIORITY_DEFAULT, 0, &threadId);
1024    return threadId;
1025}
1026
1027#if 0
1028static void quickTest(void* arg)
1029{
1030    const char* str = (const char*) arg;
1031
1032    printf("In quickTest: %s\n", str);
1033}
1034#endif
1035
1036#ifdef NDEBUG
1037    #define REG_JNI(name)      { name }
1038    struct RegJNIRec {
1039        int (*mProc)(JNIEnv*);
1040    };
1041#else
1042    #define REG_JNI(name)      { name, #name }
1043    struct RegJNIRec {
1044        int (*mProc)(JNIEnv*);
1045        const char* mName;
1046    };
1047#endif
1048
1049typedef void (*RegJAMProc)();
1050
1051static int register_jni_procs(const RegJNIRec array[], size_t count, JNIEnv* env)
1052{
1053    for (size_t i = 0; i < count; i++) {
1054        if (array[i].mProc(env) < 0) {
1055#ifndef NDEBUG
1056            ALOGD("----------!!! %s failed to load\n", array[i].mName);
1057#endif
1058            return -1;
1059        }
1060    }
1061    return 0;
1062}
1063
1064static void register_jam_procs(const RegJAMProc array[], size_t count)
1065{
1066    for (size_t i = 0; i < count; i++) {
1067        array[i]();
1068    }
1069}
1070
1071static const RegJNIRec gRegJNI[] = {
1072    REG_JNI(register_android_debug_JNITest),
1073    REG_JNI(register_com_android_internal_os_RuntimeInit),
1074    REG_JNI(register_android_os_SystemClock),
1075    REG_JNI(register_android_util_EventLog),
1076    REG_JNI(register_android_util_Log),
1077    REG_JNI(register_android_util_FloatMath),
1078    REG_JNI(register_android_text_format_Time),
1079    REG_JNI(register_android_content_AssetManager),
1080    REG_JNI(register_android_content_StringBlock),
1081    REG_JNI(register_android_content_XmlBlock),
1082    REG_JNI(register_android_emoji_EmojiFactory),
1083    REG_JNI(register_android_text_AndroidCharacter),
1084    REG_JNI(register_android_text_AndroidBidi),
1085    REG_JNI(register_android_text_KeyCharacterMap),
1086    REG_JNI(register_android_os_Process),
1087    REG_JNI(register_android_os_SystemProperties),
1088    REG_JNI(register_android_os_Binder),
1089    REG_JNI(register_android_os_Parcel),
1090    REG_JNI(register_android_view_Display),
1091    REG_JNI(register_android_view_DisplayEventReceiver),
1092    REG_JNI(register_android_nio_utils),
1093    REG_JNI(register_android_graphics_PixelFormat),
1094    REG_JNI(register_android_graphics_Graphics),
1095    REG_JNI(register_android_view_GLES20DisplayList),
1096    REG_JNI(register_android_view_GLES20Canvas),
1097    REG_JNI(register_android_view_HardwareRenderer),
1098    REG_JNI(register_android_view_Surface),
1099    REG_JNI(register_android_view_TextureView),
1100    REG_JNI(register_com_google_android_gles_jni_EGLImpl),
1101    REG_JNI(register_com_google_android_gles_jni_GLImpl),
1102    REG_JNI(register_android_opengl_jni_GLES10),
1103    REG_JNI(register_android_opengl_jni_GLES10Ext),
1104    REG_JNI(register_android_opengl_jni_GLES11),
1105    REG_JNI(register_android_opengl_jni_GLES11Ext),
1106    REG_JNI(register_android_opengl_jni_GLES20),
1107
1108    REG_JNI(register_android_graphics_Bitmap),
1109    REG_JNI(register_android_graphics_BitmapFactory),
1110    REG_JNI(register_android_graphics_BitmapRegionDecoder),
1111    REG_JNI(register_android_graphics_Camera),
1112    REG_JNI(register_android_graphics_Canvas),
1113    REG_JNI(register_android_graphics_ColorFilter),
1114    REG_JNI(register_android_graphics_DrawFilter),
1115    REG_JNI(register_android_graphics_Interpolator),
1116    REG_JNI(register_android_graphics_LayerRasterizer),
1117    REG_JNI(register_android_graphics_MaskFilter),
1118    REG_JNI(register_android_graphics_Matrix),
1119    REG_JNI(register_android_graphics_Movie),
1120    REG_JNI(register_android_graphics_NinePatch),
1121    REG_JNI(register_android_graphics_Paint),
1122    REG_JNI(register_android_graphics_Path),
1123    REG_JNI(register_android_graphics_PathMeasure),
1124    REG_JNI(register_android_graphics_PathEffect),
1125    REG_JNI(register_android_graphics_Picture),
1126    REG_JNI(register_android_graphics_PorterDuff),
1127    REG_JNI(register_android_graphics_Rasterizer),
1128    REG_JNI(register_android_graphics_Region),
1129    REG_JNI(register_android_graphics_Shader),
1130    REG_JNI(register_android_graphics_SurfaceTexture),
1131    REG_JNI(register_android_graphics_Typeface),
1132    REG_JNI(register_android_graphics_Xfermode),
1133    REG_JNI(register_android_graphics_YuvImage),
1134
1135    REG_JNI(register_android_database_CursorWindow),
1136    REG_JNI(register_android_database_SQLiteConnection),
1137    REG_JNI(register_android_database_SQLiteGlobal),
1138    REG_JNI(register_android_database_SQLiteDebug),
1139    REG_JNI(register_android_os_Debug),
1140    REG_JNI(register_android_os_FileObserver),
1141    REG_JNI(register_android_os_FileUtils),
1142    REG_JNI(register_android_os_MessageQueue),
1143    REG_JNI(register_android_os_ParcelFileDescriptor),
1144    REG_JNI(register_android_os_Power),
1145    REG_JNI(register_android_os_StatFs),
1146    REG_JNI(register_android_os_Trace),
1147    REG_JNI(register_android_os_UEventObserver),
1148    REG_JNI(register_android_net_LocalSocketImpl),
1149    REG_JNI(register_android_net_NetworkUtils),
1150    REG_JNI(register_android_net_TrafficStats),
1151    REG_JNI(register_android_net_wifi_WifiManager),
1152    REG_JNI(register_android_os_MemoryFile),
1153    REG_JNI(register_com_android_internal_os_ZygoteInit),
1154    REG_JNI(register_android_hardware_Camera),
1155    REG_JNI(register_android_hardware_SensorManager),
1156    REG_JNI(register_android_hardware_SerialPort),
1157    REG_JNI(register_android_hardware_UsbDevice),
1158    REG_JNI(register_android_hardware_UsbDeviceConnection),
1159    REG_JNI(register_android_hardware_UsbRequest),
1160    REG_JNI(register_android_media_AudioRecord),
1161    REG_JNI(register_android_media_AudioSystem),
1162    REG_JNI(register_android_media_AudioTrack),
1163    REG_JNI(register_android_media_JetPlayer),
1164    REG_JNI(register_android_media_ToneGenerator),
1165
1166    REG_JNI(register_android_opengl_classes),
1167    REG_JNI(register_android_bluetooth_HeadsetBase),
1168    REG_JNI(register_android_bluetooth_BluetoothAudioGateway),
1169    REG_JNI(register_android_bluetooth_BluetoothSocket),
1170    REG_JNI(register_android_server_BluetoothService),
1171    REG_JNI(register_android_server_BluetoothEventLoop),
1172    REG_JNI(register_android_server_BluetoothA2dpService),
1173    REG_JNI(register_android_server_NetworkManagementSocketTagger),
1174    REG_JNI(register_android_server_Watchdog),
1175    REG_JNI(register_android_ddm_DdmHandleNativeHeap),
1176    REG_JNI(register_android_backup_BackupDataInput),
1177    REG_JNI(register_android_backup_BackupDataOutput),
1178    REG_JNI(register_android_backup_FileBackupHelperBase),
1179    REG_JNI(register_android_backup_BackupHelperDispatcher),
1180    REG_JNI(register_android_app_backup_FullBackup),
1181    REG_JNI(register_android_app_ActivityThread),
1182    REG_JNI(register_android_app_NativeActivity),
1183    REG_JNI(register_android_view_InputChannel),
1184    REG_JNI(register_android_view_InputEventReceiver),
1185    REG_JNI(register_android_view_KeyEvent),
1186    REG_JNI(register_android_view_MotionEvent),
1187    REG_JNI(register_android_view_PointerIcon),
1188    REG_JNI(register_android_view_VelocityTracker),
1189
1190    REG_JNI(register_android_content_res_ObbScanner),
1191    REG_JNI(register_android_content_res_Configuration),
1192
1193    REG_JNI(register_android_animation_PropertyValuesHolder),
1194    REG_JNI(register_com_android_internal_content_NativeLibraryHelper),
1195};
1196
1197/*
1198 * Register android native functions with the VM.
1199 */
1200/*static*/ int AndroidRuntime::startReg(JNIEnv* env)
1201{
1202    /*
1203     * This hook causes all future threads created in this process to be
1204     * attached to the JavaVM.  (This needs to go away in favor of JNI
1205     * Attach calls.)
1206     */
1207    androidSetCreateThreadFunc((android_create_thread_fn) javaCreateThreadEtc);
1208
1209    ALOGV("--- registering native functions ---\n");
1210
1211    /*
1212     * Every "register" function calls one or more things that return
1213     * a local reference (e.g. FindClass).  Because we haven't really
1214     * started the VM yet, they're all getting stored in the base frame
1215     * and never released.  Use Push/Pop to manage the storage.
1216     */
1217    env->PushLocalFrame(200);
1218
1219    if (register_jni_procs(gRegJNI, NELEM(gRegJNI), env) < 0) {
1220        env->PopLocalFrame(NULL);
1221        return -1;
1222    }
1223    env->PopLocalFrame(NULL);
1224
1225    //createJavaThread("fubar", quickTest, (void*) "hello");
1226
1227    return 0;
1228}
1229
1230AndroidRuntime* AndroidRuntime::getRuntime()
1231{
1232    return gCurRuntime;
1233}
1234
1235/**
1236 * Used by WithFramework to register native functions.
1237 */
1238extern "C"
1239jint Java_com_android_internal_util_WithFramework_registerNatives(
1240        JNIEnv* env, jclass clazz) {
1241    return register_jni_procs(gRegJNI, NELEM(gRegJNI), env);
1242}
1243
1244/**
1245 * Used by LoadClass to register native functions.
1246 */
1247extern "C"
1248jint Java_LoadClass_registerNatives(JNIEnv* env, jclass clazz) {
1249    return register_jni_procs(gRegJNI, NELEM(gRegJNI), env);
1250}
1251
1252}   // namespace android
1253