README.txt
1 Internal native functions. 2 3 All of the functions defined here make direct use of VM functions or data 4 structures, so they can't be written with JNI and shouldn't really be in 5 a separate shared library. Do not add additional functions here unless 6 they need to access VM internals directly. 7 8 All functions here either complete quickly or are used to enter a wait 9 state, so we don't set the thread status to THREAD_NATIVE when executing 10 these methods. This means that the GC will wait for these functions 11 to finish. DO NOT perform long operations or blocking I/O in here. 12 These methods should not be declared "synchronized", because we don't 13 check for that flag when issuing the call. 14 15 We use "late" binding on these, rather than explicit registration, 16 because it's easier to handle the core system classes that way. 17 18 The functions here use the DalvikNativeFunc prototype, but we can 19 also treat them as DalvikBridgeFunc, which takes two extra arguments. 20 The former represents the API that we're most likely to expose should 21 JNI performance be deemed insufficient. The Bridge version is used as 22 an optimization for a few high-volume Object calls, and should generally 23 not be used as we may drop support for it at some point. 24
