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