1 /*
2 * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 *
23 */
24
25 #ifndef SHARE_VM_PRIMS_JVM_H
26 #define SHARE_VM_PRIMS_JVM_H
27
28 #include "prims/jni.h"
29 #ifdef TARGET_OS_FAMILY_linux
30 # include "jvm_linux.h"
31 #endif
32 #ifdef TARGET_OS_FAMILY_solaris
33 # include "jvm_solaris.h"
34 #endif
35 #ifdef TARGET_OS_FAMILY_windows
36 # include "jvm_windows.h"
37 #endif
38 #ifdef TARGET_OS_FAMILY_aix
39 # include "jvm_aix.h"
40 #endif
41 #ifdef TARGET_OS_FAMILY_bsd
42 # include "jvm_bsd.h"
43 #endif
44
45 #ifndef _JAVASOFT_JVM_H_
46 #define _JAVASOFT_JVM_H_
47
48 // HotSpot integration note:
49 //
50 // This file and jvm.h used with the JDK are identical,
51 // except for the three includes removed below
52
53 // #include <sys/stat.h>
54 // #include "jni.h"
55 // #include "jvm_md.h"
56
57
58 #ifdef __cplusplus
59 extern "C" {
60 #endif
61
62 /*
63 * This file contains additional functions exported from the VM.
64 * These functions are complementary to the standard JNI support.
65 * There are three parts to this file:
66 *
67 * First, this file contains the VM-related functions needed by native
68 * libraries in the standard Java API. For example, the java.lang.Object
69 * class needs VM-level functions that wait for and notify monitors.
70 *
71 * Second, this file contains the functions and constant definitions
72 * needed by the byte code verifier and class file format checker.
73 * These functions allow the verifier and format checker to be written
74 * in a VM-independent way.
75 *
76 * Third, this file contains various I/O and nerwork operations needed
77 * by the standard Java I/O and network APIs.
78 */
79
80 /*
81 * Bump the version number when either of the following happens:
82 *
83 * 1. There is a change in JVM_* functions.
84 *
85 * 2. There is a change in the contract between VM and Java classes.
86 * For example, if the VM relies on a new private field in Thread
87 * class.
88 */
89
90 #define JVM_INTERFACE_VERSION 4
91
92 JNIEXPORT jobjectArray JNICALL
93 JVM_GetMethodParameters(JNIEnv *env, jobject method);
94
95 JNIEXPORT jint JNICALL
96 JVM_GetInterfaceVersion(void);
97
98 /*************************************************************************
99 PART 1: Functions for Native Libraries
100 ************************************************************************/
101 /*
102 * java.lang.Object
103 */
104 JNIEXPORT jint JNICALL
105 JVM_IHashCode(JNIEnv *env, jobject obj);
106
107 JNIEXPORT void JNICALL
108 JVM_MonitorWait(JNIEnv *env, jobject obj, jlong ms);
109
110 JNIEXPORT void JNICALL
111 JVM_MonitorNotify(JNIEnv *env, jobject obj);
112
113 JNIEXPORT void JNICALL
114 JVM_MonitorNotifyAll(JNIEnv *env, jobject obj);
115
116 JNIEXPORT jobject JNICALL
117 JVM_Clone(JNIEnv *env, jobject obj);
118
119 /*
120 * java.lang.String
121 */
122 JNIEXPORT jstring JNICALL
123 JVM_InternString(JNIEnv *env, jstring str);
124
125 /*
126 * java.lang.System
127 */
128 JNIEXPORT jlong JNICALL
129 JVM_CurrentTimeMillis(JNIEnv *env, jclass ignored);
130
131 JNIEXPORT jlong JNICALL
132 JVM_NanoTime(JNIEnv *env, jclass ignored);
133
134 JNIEXPORT jlong JNICALL
135 JVM_GetNanoTimeAdjustment(JNIEnv *env, jclass ignored, jlong offset_secs);
136
137 JNIEXPORT void JNICALL
138 JVM_ArrayCopy(JNIEnv *env, jclass ignored, jobject src, jint src_pos,
139 jobject dst, jint dst_pos, jint length);
140
141 JNIEXPORT jobject JNICALL
142 JVM_InitProperties(JNIEnv *env, jobject p);
143
144 JNIEXPORT void JNICALL
145 JVM_Halt(jint code);
146
147 JNIEXPORT void JNICALL
148 JVM_GC(void);
149
150 /* Returns the number of real-time milliseconds that have elapsed since the
151 * least-recently-inspected heap object was last inspected by the garbage
152 * collector.
153 *
154 * For simple stop-the-world collectors this value is just the time
155 * since the most recent collection. For generational collectors it is the
156 * time since the oldest generation was most recently collected. Other
157 * collectors are free to return a pessimistic estimate of the elapsed time, or
158 * simply the time since the last full collection was performed.
159 *
160 * Note that in the presence of reference objects, a given object that is no
161 * longer strongly reachable may have to be inspected multiple times before it
162 * can be reclaimed.
163 */
164 JNIEXPORT jlong JNICALL
165 JVM_MaxObjectInspectionAge(void);
166
167 JNIEXPORT jlong JNICALL
168 JVM_TotalMemory(void);
169
170 JNIEXPORT jlong JNICALL
171 JVM_FreeMemory(void);
172
173 JNIEXPORT jlong JNICALL
174 JVM_MaxMemory(void);
175
176 JNIEXPORT jint JNICALL
177 JVM_ActiveProcessorCount(void);
178
179 JNIEXPORT void * JNICALL
180 JVM_LoadLibrary(const char *name);
181
182 JNIEXPORT void JNICALL
183 JVM_UnloadLibrary(void * handle);
184
185 JNIEXPORT void * JNICALL
186 JVM_FindLibraryEntry(void *handle, const char *name);
187
188 JNIEXPORT jboolean JNICALL
189 JVM_IsSupportedJNIVersion(jint version);
190
191 /*
192 * java.lang.Throwable
193 */
194 JNIEXPORT void JNICALL
195 JVM_FillInStackTrace(JNIEnv *env, jobject throwable);
196
197 JNIEXPORT jint JNICALL
198 JVM_GetStackTraceDepth(JNIEnv *env, jobject throwable);
199
200 JNIEXPORT jobject JNICALL
201 JVM_GetStackTraceElement(JNIEnv *env, jobject throwable, jint index);
202
203 /*
204 * java.lang.Thread
205 */
206 JNIEXPORT void JNICALL
207 JVM_StartThread(JNIEnv *env, jobject thread);
208
209 JNIEXPORT void JNICALL
210 JVM_StopThread(JNIEnv *env, jobject thread, jobject exception);
211
212 JNIEXPORT jboolean JNICALL
213 JVM_IsThreadAlive(JNIEnv *env, jobject thread);
214
215 JNIEXPORT void JNICALL
216 JVM_SuspendThread(JNIEnv *env, jobject thread);
217
218 JNIEXPORT void JNICALL
219 JVM_ResumeThread(JNIEnv *env, jobject thread);
220
221 JNIEXPORT void JNICALL
222 JVM_SetThreadPriority(JNIEnv *env, jobject thread, jint prio);
223
224 JNIEXPORT void JNICALL
225 JVM_Yield(JNIEnv *env, jclass threadClass);
226
227 JNIEXPORT void JNICALL
228 JVM_Sleep(JNIEnv *env, jclass threadClass, jlong millis);
229
230 JNIEXPORT jobject JNICALL
231 JVM_CurrentThread(JNIEnv *env, jclass threadClass);
232
233 JNIEXPORT jint JNICALL
234 JVM_CountStackFrames(JNIEnv *env, jobject thread);
235
236 JNIEXPORT void JNICALL
237 JVM_Interrupt(JNIEnv *env, jobject thread);
238
239 JNIEXPORT jboolean JNICALL
240 JVM_IsInterrupted(JNIEnv *env, jobject thread, jboolean clearInterrupted);
241
242 JNIEXPORT jboolean JNICALL
243 JVM_HoldsLock(JNIEnv *env, jclass threadClass, jobject obj);
244
245 JNIEXPORT void JNICALL
246 JVM_DumpAllStacks(JNIEnv *env, jclass unused);
247
248 JNIEXPORT jobjectArray JNICALL
249 JVM_GetAllThreads(JNIEnv *env, jclass dummy);
250
251 JNIEXPORT void JNICALL
252 JVM_SetNativeThreadName(JNIEnv *env, jobject jthread, jstring name);
253
254 /* getStackTrace() and getAllStackTraces() method */
255 JNIEXPORT jobjectArray JNICALL
256 JVM_DumpThreads(JNIEnv *env, jclass threadClass, jobjectArray threads);
257
258 /*
259 * java.lang.SecurityManager
260 */
261 JNIEXPORT jclass JNICALL
262 JVM_CurrentLoadedClass(JNIEnv *env);
263
264 JNIEXPORT jobject JNICALL
265 JVM_CurrentClassLoader(JNIEnv *env);
266
267 JNIEXPORT jobjectArray JNICALL
268 JVM_GetClassContext(JNIEnv *env);
269
270 JNIEXPORT jint JNICALL
271 JVM_ClassDepth(JNIEnv *env, jstring name);
272
273 JNIEXPORT jint JNICALL
274 JVM_ClassLoaderDepth(JNIEnv *env);
275
276 /*
277 * java.lang.Package
278 */
279 JNIEXPORT jstring JNICALL
280 JVM_GetSystemPackage(JNIEnv *env, jstring name);
281
282 JNIEXPORT jobjectArray JNICALL
283 JVM_GetSystemPackages(JNIEnv *env);
284
285 /*
286 * java.io.ObjectInputStream
287 */
288 JNIEXPORT jobject JNICALL
289 JVM_LatestUserDefinedLoader(JNIEnv *env);
290
291 /*
292 * java.lang.reflect.Array
293 */
294 JNIEXPORT jint JNICALL
295 JVM_GetArrayLength(JNIEnv *env, jobject arr);
296
297 JNIEXPORT jobject JNICALL
298 JVM_GetArrayElement(JNIEnv *env, jobject arr, jint index);
299
300 JNIEXPORT jvalue JNICALL
301 JVM_GetPrimitiveArrayElement(JNIEnv *env, jobject arr, jint index, jint wCode);
302
303 JNIEXPORT void JNICALL
304 JVM_SetArrayElement(JNIEnv *env, jobject arr, jint index, jobject val);
305
306 JNIEXPORT void JNICALL
307 JVM_SetPrimitiveArrayElement(JNIEnv *env, jobject arr, jint index, jvalue v,
308 unsigned char vCode);
309
310 JNIEXPORT jobject JNICALL
311 JVM_NewArray(JNIEnv *env, jclass eltClass, jint length);
312
313 JNIEXPORT jobject JNICALL
314 JVM_NewMultiArray(JNIEnv *env, jclass eltClass, jintArray dim);
315
316 /*
317 * java.lang.Class and java.lang.ClassLoader
318 */
319
320 #define JVM_CALLER_DEPTH -1
321
322 /*
323 * Returns the class in which the code invoking the native method
324 * belongs.
325 *
326 * Note that in JDK 1.1, native methods did not create a frame.
327 * In 1.2, they do. Therefore native methods like Class.forName
328 * can no longer look at the current frame for the caller class.
329 */
330 JNIEXPORT jclass JNICALL
331 JVM_GetCallerClass(JNIEnv *env, int n);
332
333 /*
334 * Find primitive classes
335 * utf: class name
336 */
337 JNIEXPORT jclass JNICALL
338 JVM_FindPrimitiveClass(JNIEnv *env, const char *utf);
339
340 /*
341 * Find a class from a boot class loader. Returns NULL if class not found.
342 */
343 JNIEXPORT jclass JNICALL
344 JVM_FindClassFromBootLoader(JNIEnv *env, const char *name);
345
346 /*
347 * Find a class from a given class loader. Throws ClassNotFoundException.
348 * name: name of class
349 * init: whether initialization is done
350 * loader: class loader to look up the class. This may not be the same as the caller's
351 * class loader.
352 * caller: initiating class. The initiating class may be null when a security
353 * manager is not installed.
354 */
355 JNIEXPORT jclass JNICALL
356 JVM_FindClassFromCaller(JNIEnv *env, const char *name, jboolean init,
357 jobject loader, jclass caller);
358
359 /*
360 * Find a class from a given class.
361 */
362 JNIEXPORT jclass JNICALL
363 JVM_FindClassFromClass(JNIEnv *env, const char *name, jboolean init,
364 jclass from);
365
366 /* Find a loaded class cached by the VM */
367 JNIEXPORT jclass JNICALL
368 JVM_FindLoadedClass(JNIEnv *env, jobject loader, jstring name);
369
370 /* Define a class */
371 JNIEXPORT jclass JNICALL
372 JVM_DefineClass(JNIEnv *env, const char *name, jobject loader, const jbyte *buf,
373 jsize len, jobject pd);
374
375 /* Define a class with a source (added in JDK1.5) */
376 JNIEXPORT jclass JNICALL
377 JVM_DefineClassWithSource(JNIEnv *env, const char *name, jobject loader,
378 const jbyte *buf, jsize len, jobject pd,
379 const char *source);
380
381 /* Define a class with a source with conditional verification (added HSX 14)
382 * -Xverify:all will verify anyway, -Xverify:none will not verify,
383 * -Xverify:remote (default) will obey this conditional
384 * i.e. true = should_verify_class
385 */
386 JNIEXPORT jclass JNICALL
387 JVM_DefineClassWithSourceCond(JNIEnv *env, const char *name,
388 jobject loader, const jbyte *buf,
389 jsize len, jobject pd, const char *source,
390 jboolean verify);
391
392 /*
393 * Reflection support functions
394 */
395
396 JNIEXPORT jstring JNICALL
397 JVM_GetClassName(JNIEnv *env, jclass cls);
398
399 JNIEXPORT jobjectArray JNICALL
400 JVM_GetClassInterfaces(JNIEnv *env, jclass cls);
401
402 JNIEXPORT jboolean JNICALL
403 JVM_IsInterface(JNIEnv *env, jclass cls);
404
405 JNIEXPORT jobjectArray JNICALL
406 JVM_GetClassSigners(JNIEnv *env, jclass cls);
407
408 JNIEXPORT void JNICALL
409 JVM_SetClassSigners(JNIEnv *env, jclass cls, jobjectArray signers);
410
411 JNIEXPORT jobject JNICALL
412 JVM_GetProtectionDomain(JNIEnv *env, jclass cls);
413
414 JNIEXPORT jboolean JNICALL
415 JVM_IsArrayClass(JNIEnv *env, jclass cls);
416
417 JNIEXPORT jboolean JNICALL
418 JVM_IsPrimitiveClass(JNIEnv *env, jclass cls);
419
420 JNIEXPORT jint JNICALL
421 JVM_GetClassModifiers(JNIEnv *env, jclass cls);
422
423 JNIEXPORT jobjectArray JNICALL
424 JVM_GetDeclaredClasses(JNIEnv *env, jclass ofClass);
425
426 JNIEXPORT jclass JNICALL
427 JVM_GetDeclaringClass(JNIEnv *env, jclass ofClass);
428
429 JNIEXPORT jstring JNICALL
430 JVM_GetSimpleBinaryName(JNIEnv *env, jclass ofClass);
431
432 /* Generics support (JDK 1.5) */
433 JNIEXPORT jstring JNICALL
434 JVM_GetClassSignature(JNIEnv *env, jclass cls);
435
436 /* Annotations support (JDK 1.5) */
437 JNIEXPORT jbyteArray JNICALL
438 JVM_GetClassAnnotations(JNIEnv *env, jclass cls);
439
440 /* Annotations support (JDK 1.6) */
441
442 /* Type use annotations support (JDK 1.8) */
443
444 JNIEXPORT jbyteArray JNICALL
445 JVM_GetClassTypeAnnotations(JNIEnv *env, jclass cls);
446
447 // field is a handle to a java.lang.reflect.Field object
448 JNIEXPORT jbyteArray JNICALL
449 JVM_GetFieldTypeAnnotations(JNIEnv *env, jobject field);
450
451 // method is a handle to a java.lang.reflect.Method object
452 JNIEXPORT jbyteArray JNICALL
453 JVM_GetMethodTypeAnnotations(JNIEnv *env, jobject method);
454
455 /*
456 * New (JDK 1.4) reflection implementation
457 */
458
459 JNIEXPORT jobjectArray JNICALL
460 JVM_GetClassDeclaredMethods(JNIEnv *env, jclass ofClass, jboolean publicOnly);
461
462 JNIEXPORT jobjectArray JNICALL
463 JVM_GetClassDeclaredFields(JNIEnv *env, jclass ofClass, jboolean publicOnly);
464
465 JNIEXPORT jobjectArray JNICALL
466 JVM_GetClassDeclaredConstructors(JNIEnv *env, jclass ofClass, jboolean publicOnly);
467
468 /* Differs from JVM_GetClassModifiers in treatment of inner classes.
469 This returns the access flags for the class as specified in the
470 class file rather than searching the InnerClasses attribute (if
471 present) to find the source-level access flags. Only the values of
472 the low 13 bits (i.e., a mask of 0x1FFF) are guaranteed to be
473 valid. */
474 JNIEXPORT jint JNICALL
475 JVM_GetClassAccessFlags(JNIEnv *env, jclass cls);
476
477 /*
478 * Constant pool access; currently used to implement reflective access to annotations (JDK 1.5)
479 */
480
481 JNIEXPORT jobject JNICALL
482 JVM_GetClassConstantPool(JNIEnv *env, jclass cls);
483
484 JNIEXPORT jint JNICALL JVM_ConstantPoolGetSize
485 (JNIEnv *env, jobject obj, jobject unused);
486
487 JNIEXPORT jclass JNICALL JVM_ConstantPoolGetClassAt
488 (JNIEnv *env, jobject obj, jobject unused, jint index);
489
490 JNIEXPORT jclass JNICALL JVM_ConstantPoolGetClassAtIfLoaded
491 (JNIEnv *env, jobject obj, jobject unused, jint index);
492
493 JNIEXPORT jobject JNICALL JVM_ConstantPoolGetMethodAt
494 (JNIEnv *env, jobject obj, jobject unused, jint index);
495
496 JNIEXPORT jobject JNICALL JVM_ConstantPoolGetMethodAtIfLoaded
497 (JNIEnv *env, jobject obj, jobject unused, jint index);
498
499 JNIEXPORT jobject JNICALL JVM_ConstantPoolGetFieldAt
500 (JNIEnv *env, jobject obj, jobject unused, jint index);
501
502 JNIEXPORT jobject JNICALL JVM_ConstantPoolGetFieldAtIfLoaded
503 (JNIEnv *env, jobject obj, jobject unused, jint index);
504
505 JNIEXPORT jobjectArray JNICALL JVM_ConstantPoolGetMemberRefInfoAt
506 (JNIEnv *env, jobject obj, jobject unused, jint index);
507
508 JNIEXPORT jint JNICALL JVM_ConstantPoolGetIntAt
509 (JNIEnv *env, jobject obj, jobject unused, jint index);
510
511 JNIEXPORT jlong JNICALL JVM_ConstantPoolGetLongAt
512 (JNIEnv *env, jobject obj, jobject unused, jint index);
513
514 JNIEXPORT jfloat JNICALL JVM_ConstantPoolGetFloatAt
515 (JNIEnv *env, jobject obj, jobject unused, jint index);
516
517 JNIEXPORT jdouble JNICALL JVM_ConstantPoolGetDoubleAt
518 (JNIEnv *env, jobject obj, jobject unused, jint index);
519
520 JNIEXPORT jstring JNICALL JVM_ConstantPoolGetStringAt
521 (JNIEnv *env, jobject obj, jobject unused, jint index);
522
523 JNIEXPORT jstring JNICALL JVM_ConstantPoolGetUTF8At
524 (JNIEnv *env, jobject obj, jobject unused, jint index);
525
526 /*
527 * java.security.*
528 */
529
530 JNIEXPORT jobject JNICALL
531 JVM_DoPrivileged(JNIEnv *env, jclass cls,
532 jobject action, jobject context, jboolean wrapException);
533
534 JNIEXPORT jobject JNICALL
535 JVM_GetInheritedAccessControlContext(JNIEnv *env, jclass cls);
536
537 JNIEXPORT jobject JNICALL
538 JVM_GetStackAccessControlContext(JNIEnv *env, jclass cls);
539
540 /*
541 * Signal support, used to implement the shutdown sequence. Every VM must
542 * support JVM_SIGINT and JVM_SIGTERM, raising the former for user interrupts
543 * (^C) and the latter for external termination (kill, system shutdown, etc.).
544 * Other platform-dependent signal values may also be supported.
545 */
546
547 JNIEXPORT void * JNICALL
548 JVM_RegisterSignal(jint sig, void *handler);
549
550 JNIEXPORT jboolean JNICALL
551 JVM_RaiseSignal(jint sig);
552
553 JNIEXPORT jint JNICALL
554 JVM_FindSignal(const char *name);
555
556 /*
557 * Retrieve the assertion directives for the specified class.
558 */
559 JNIEXPORT jboolean JNICALL
560 JVM_DesiredAssertionStatus(JNIEnv *env, jclass unused, jclass cls);
561
562 /*
563 * Retrieve the assertion directives from the VM.
564 */
565 JNIEXPORT jobject JNICALL
566 JVM_AssertionStatusDirectives(JNIEnv *env, jclass unused);
567
568 /*
569 * java.util.concurrent.atomic.AtomicLong
570 */
571 JNIEXPORT jboolean JNICALL
572 JVM_SupportsCX8(void);
573
574 /*
575 * jdk.internal.jimage
576 * WARNING: This API is experimental and temporary during JDK 9 development
577 * cycle. It will not be supported in the eventual JDK 9 release.
578 */
579
580 JNIEXPORT jlong JNICALL
581 JVM_ImageOpen(JNIEnv *env, const char *nativePath, jboolean big_endian);
582
583 JNIEXPORT void JNICALL
584 JVM_ImageClose(JNIEnv *env, jlong id);
585
586 JNIEXPORT jlong JNICALL
587 JVM_ImageGetIndexAddress(JNIEnv *env, jlong id);
588
589 JNIEXPORT jlong JNICALL
590 JVM_ImageGetDataAddress(JNIEnv *env,jlong id);
591
592 JNIEXPORT jboolean JNICALL
593 JVM_ImageRead(JNIEnv *env, jlong id, jlong offset,
594 unsigned char* uncompressedAddress, jlong uncompressed_size);
595
596
597 JNIEXPORT jboolean JNICALL
598 JVM_ImageReadCompressed(JNIEnv *env, jlong id, jlong offset,
599 unsigned char* compressedBuffer, jlong compressed_size,
600 unsigned char* uncompressedBuffer, jlong uncompressed_size);
601
602 JNIEXPORT const char* JNICALL
603 JVM_ImageGetStringBytes(JNIEnv *env, jlong id, jint offset);
604
605 JNIEXPORT jlong* JNICALL
606 JVM_ImageGetAttributes(JNIEnv *env, jlong* rawAttributes, jlong id, jint offset);
607
608 JNIEXPORT jsize JNICALL
609 JVM_ImageGetAttributesCount(JNIEnv *env);
610
611 JNIEXPORT jlong* JNICALL
612 JVM_ImageFindAttributes(JNIEnv *env, jlong* rawAttributes, jbyte* rawBytes, jsize size, jlong id);
613
614 JNIEXPORT jint* JNICALL
615 JVM_ImageAttributeOffsets(JNIEnv *env, jint* rawOffsets, unsigned int length, jlong id);
616
617 JNIEXPORT unsigned int JNICALL
618 JVM_ImageAttributeOffsetsLength(JNIEnv *env, jlong id);
619
620 /*************************************************************************
621 PART 2: Support for the Verifier and Class File Format Checker
622 ************************************************************************/
623 /*
624 * Return the class name in UTF format. The result is valid
625 * until JVM_ReleaseUTf is called.
626 *
627 * The caller must treat the string as a constant and not modify it
628 * in any way.
629 */
630 JNIEXPORT const char * JNICALL
631 JVM_GetClassNameUTF(JNIEnv *env, jclass cb);
632
633 /*
634 * Returns the constant pool types in the buffer provided by "types."
635 */
636 JNIEXPORT void JNICALL
637 JVM_GetClassCPTypes(JNIEnv *env, jclass cb, unsigned char *types);
638
639 /*
640 * Returns the number of Constant Pool entries.
641 */
642 JNIEXPORT jint JNICALL
643 JVM_GetClassCPEntriesCount(JNIEnv *env, jclass cb);
644
645 /*
646 * Returns the number of *declared* fields or methods.
647 */
648 JNIEXPORT jint JNICALL
649 JVM_GetClassFieldsCount(JNIEnv *env, jclass cb);
650
651 JNIEXPORT jint JNICALL
652 JVM_GetClassMethodsCount(JNIEnv *env, jclass cb);
653
654 /*
655 * Returns the CP indexes of exceptions raised by a given method.
656 * Places the result in the given buffer.
657 *
658 * The method is identified by method_index.
659 */
660 JNIEXPORT void JNICALL
661 JVM_GetMethodIxExceptionIndexes(JNIEnv *env, jclass cb, jint method_index,
662 unsigned short *exceptions);
663 /*
664 * Returns the number of exceptions raised by a given method.
665 * The method is identified by method_index.
666 */
667 JNIEXPORT jint JNICALL
668 JVM_GetMethodIxExceptionsCount(JNIEnv *env, jclass cb, jint method_index);
669
670 /*
671 * Returns the byte code sequence of a given method.
672 * Places the result in the given buffer.
673 *
674 * The method is identified by method_index.
675 */
676 JNIEXPORT void JNICALL
677 JVM_GetMethodIxByteCode(JNIEnv *env, jclass cb, jint method_index,
678 unsigned char *code);
679
680 /*
681 * Returns the length of the byte code sequence of a given method.
682 * The method is identified by method_index.
683 */
684 JNIEXPORT jint JNICALL
685 JVM_GetMethodIxByteCodeLength(JNIEnv *env, jclass cb, jint method_index);
686
687 /*
688 * A structure used to a capture exception table entry in a Java method.
689 */
690 typedef struct {
691 jint start_pc;
692 jint end_pc;
693 jint handler_pc;
694 jint catchType;
695 } JVM_ExceptionTableEntryType;
696
697 /*
698 * Returns the exception table entry at entry_index of a given method.
699 * Places the result in the given buffer.
700 *
701 * The method is identified by method_index.
702 */
703 JNIEXPORT void JNICALL
704 JVM_GetMethodIxExceptionTableEntry(JNIEnv *env, jclass cb, jint method_index,
705 jint entry_index,
706 JVM_ExceptionTableEntryType *entry);
707
708 /*
709 * Returns the length of the exception table of a given method.
710 * The method is identified by method_index.
711 */
712 JNIEXPORT jint JNICALL
713 JVM_GetMethodIxExceptionTableLength(JNIEnv *env, jclass cb, int index);
714
715 /*
716 * Returns the modifiers of a given field.
717 * The field is identified by field_index.
718 */
719 JNIEXPORT jint JNICALL
720 JVM_GetFieldIxModifiers(JNIEnv *env, jclass cb, int index);
721
722 /*
723 * Returns the modifiers of a given method.
724 * The method is identified by method_index.
725 */
726 JNIEXPORT jint JNICALL
727 JVM_GetMethodIxModifiers(JNIEnv *env, jclass cb, int index);
728
729 /*
730 * Returns the number of local variables of a given method.
731 * The method is identified by method_index.
732 */
733 JNIEXPORT jint JNICALL
734 JVM_GetMethodIxLocalsCount(JNIEnv *env, jclass cb, int index);
735
736 /*
737 * Returns the number of arguments (including this pointer) of a given method.
738 * The method is identified by method_index.
739 */
740 JNIEXPORT jint JNICALL
741 JVM_GetMethodIxArgsSize(JNIEnv *env, jclass cb, int index);
742
743 /*
744 * Returns the maximum amount of stack (in words) used by a given method.
745 * The method is identified by method_index.
746 */
747 JNIEXPORT jint JNICALL
748 JVM_GetMethodIxMaxStack(JNIEnv *env, jclass cb, int index);
749
750 /*
751 * Is a given method a constructor.
752 * The method is identified by method_index.
753 */
754 JNIEXPORT jboolean JNICALL
755 JVM_IsConstructorIx(JNIEnv *env, jclass cb, int index);
756
757 /*
758 * Is the given method generated by the VM.
759 * The method is identified by method_index.
760 */
761 JNIEXPORT jboolean JNICALL
762 JVM_IsVMGeneratedMethodIx(JNIEnv *env, jclass cb, int index);
763
764 /*
765 * Returns the name of a given method in UTF format.
766 * The result remains valid until JVM_ReleaseUTF is called.
767 *
768 * The caller must treat the string as a constant and not modify it
769 * in any way.
770 */
771 JNIEXPORT const char * JNICALL
772 JVM_GetMethodIxNameUTF(JNIEnv *env, jclass cb, jint index);
773
774 /*
775 * Returns the signature of a given method in UTF format.
776 * The result remains valid until JVM_ReleaseUTF is called.
777 *
778 * The caller must treat the string as a constant and not modify it
779 * in any way.
780 */
781 JNIEXPORT const char * JNICALL
782 JVM_GetMethodIxSignatureUTF(JNIEnv *env, jclass cb, jint index);
783
784 /*
785 * Returns the name of the field refered to at a given constant pool
786 * index.
787 *
788 * The result is in UTF format and remains valid until JVM_ReleaseUTF
789 * is called.
790 *
791 * The caller must treat the string as a constant and not modify it
792 * in any way.
793 */
794 JNIEXPORT const char * JNICALL
795 JVM_GetCPFieldNameUTF(JNIEnv *env, jclass cb, jint index);
796
797 /*
798 * Returns the name of the method refered to at a given constant pool
799 * index.
800 *
801 * The result is in UTF format and remains valid until JVM_ReleaseUTF
802 * is called.
803 *
804 * The caller must treat the string as a constant and not modify it
805 * in any way.
806 */
807 JNIEXPORT const char * JNICALL
808 JVM_GetCPMethodNameUTF(JNIEnv *env, jclass cb, jint index);
809
810 /*
811 * Returns the signature of the method refered to at a given constant pool
812 * index.
813 *
814 * The result is in UTF format and remains valid until JVM_ReleaseUTF
815 * is called.
816 *
817 * The caller must treat the string as a constant and not modify it
818 * in any way.
819 */
820 JNIEXPORT const char * JNICALL
821 JVM_GetCPMethodSignatureUTF(JNIEnv *env, jclass cb, jint index);
822
823 /*
824 * Returns the signature of the field refered to at a given constant pool
825 * index.
826 *
827 * The result is in UTF format and remains valid until JVM_ReleaseUTF
828 * is called.
829 *
830 * The caller must treat the string as a constant and not modify it
831 * in any way.
832 */
833 JNIEXPORT const char * JNICALL
834 JVM_GetCPFieldSignatureUTF(JNIEnv *env, jclass cb, jint index);
835
836 /*
837 * Returns the class name refered to at a given constant pool index.
838 *
839 * The result is in UTF format and remains valid until JVM_ReleaseUTF
840 * is called.
841 *
842 * The caller must treat the string as a constant and not modify it
843 * in any way.
844 */
845 JNIEXPORT const char * JNICALL
846 JVM_GetCPClassNameUTF(JNIEnv *env, jclass cb, jint index);
847
848 /*
849 * Returns the class name refered to at a given constant pool index.
850 *
851 * The constant pool entry must refer to a CONSTANT_Fieldref.
852 *
853 * The result is in UTF format and remains valid until JVM_ReleaseUTF
854 * is called.
855 *
856 * The caller must treat the string as a constant and not modify it
857 * in any way.
858 */
859 JNIEXPORT const char * JNICALL
860 JVM_GetCPFieldClassNameUTF(JNIEnv *env, jclass cb, jint index);
861
862 /*
863 * Returns the class name refered to at a given constant pool index.
864 *
865 * The constant pool entry must refer to CONSTANT_Methodref or
866 * CONSTANT_InterfaceMethodref.
867 *
868 * The result is in UTF format and remains valid until JVM_ReleaseUTF
869 * is called.
870 *
871 * The caller must treat the string as a constant and not modify it
872 * in any way.
873 */
874 JNIEXPORT const char * JNICALL
875 JVM_GetCPMethodClassNameUTF(JNIEnv *env, jclass cb, jint index);
876
877 /*
878 * Returns the modifiers of a field in calledClass. The field is
879 * referred to in class cb at constant pool entry index.
880 *
881 * The caller must treat the string as a constant and not modify it
882 * in any way.
883 *
884 * Returns -1 if the field does not exist in calledClass.
885 */
886 JNIEXPORT jint JNICALL
887 JVM_GetCPFieldModifiers(JNIEnv *env, jclass cb, int index, jclass calledClass);
888
889 /*
890 * Returns the modifiers of a method in calledClass. The method is
891 * referred to in class cb at constant pool entry index.
892 *
893 * Returns -1 if the method does not exist in calledClass.
894 */
895 JNIEXPORT jint JNICALL
896 JVM_GetCPMethodModifiers(JNIEnv *env, jclass cb, int index, jclass calledClass);
897
898 /*
899 * Releases the UTF string obtained from the VM.
900 */
901 JNIEXPORT void JNICALL
902 JVM_ReleaseUTF(const char *utf);
903
904 /*
905 * Compare if two classes are in the same package.
906 */
907 JNIEXPORT jboolean JNICALL
908 JVM_IsSameClassPackage(JNIEnv *env, jclass class1, jclass class2);
909
910 /* Constants in class files */
911
912 #define JVM_ACC_PUBLIC 0x0001 /* visible to everyone */
913 #define JVM_ACC_PRIVATE 0x0002 /* visible only to the defining class */
914 #define JVM_ACC_PROTECTED 0x0004 /* visible to subclasses */
915 #define JVM_ACC_STATIC 0x0008 /* instance variable is static */
916 #define JVM_ACC_FINAL 0x0010 /* no further subclassing, overriding */
917 #define JVM_ACC_SYNCHRONIZED 0x0020 /* wrap method call in monitor lock */
918 #define JVM_ACC_SUPER 0x0020 /* funky handling of invokespecial */
919 #define JVM_ACC_VOLATILE 0x0040 /* can not cache in registers */
920 #define JVM_ACC_BRIDGE 0x0040 /* bridge method generated by compiler */
921 #define JVM_ACC_TRANSIENT 0x0080 /* not persistent */
922 #define JVM_ACC_VARARGS 0x0080 /* method declared with variable number of args */
923 #define JVM_ACC_NATIVE 0x0100 /* implemented in C */
924 #define JVM_ACC_INTERFACE 0x0200 /* class is an interface */
925 #define JVM_ACC_ABSTRACT 0x0400 /* no definition provided */
926 #define JVM_ACC_STRICT 0x0800 /* strict floating point */
927 #define JVM_ACC_SYNTHETIC 0x1000 /* compiler-generated class, method or field */
928 #define JVM_ACC_ANNOTATION 0x2000 /* annotation type */
929 #define JVM_ACC_ENUM 0x4000 /* field is declared as element of enum */
930
931 #define JVM_ACC_PUBLIC_BIT 0
932 #define JVM_ACC_PRIVATE_BIT 1
933 #define JVM_ACC_PROTECTED_BIT 2
934 #define JVM_ACC_STATIC_BIT 3
935 #define JVM_ACC_FINAL_BIT 4
936 #define JVM_ACC_SYNCHRONIZED_BIT 5
937 #define JVM_ACC_SUPER_BIT 5
938 #define JVM_ACC_VOLATILE_BIT 6
939 #define JVM_ACC_BRIDGE_BIT 6
940 #define JVM_ACC_TRANSIENT_BIT 7
941 #define JVM_ACC_VARARGS_BIT 7
942 #define JVM_ACC_NATIVE_BIT 8
943 #define JVM_ACC_INTERFACE_BIT 9
944 #define JVM_ACC_ABSTRACT_BIT 10
945 #define JVM_ACC_STRICT_BIT 11
946 #define JVM_ACC_SYNTHETIC_BIT 12
947 #define JVM_ACC_ANNOTATION_BIT 13
948 #define JVM_ACC_ENUM_BIT 14
949
950 // NOTE: replicated in SA in vm/agent/sun/jvm/hotspot/utilities/ConstantTag.java
951 enum {
952 JVM_CONSTANT_Utf8 = 1,
953 JVM_CONSTANT_Unicode, /* unused */
954 JVM_CONSTANT_Integer,
955 JVM_CONSTANT_Float,
956 JVM_CONSTANT_Long,
957 JVM_CONSTANT_Double,
958 JVM_CONSTANT_Class,
959 JVM_CONSTANT_String,
960 JVM_CONSTANT_Fieldref,
961 JVM_CONSTANT_Methodref,
962 JVM_CONSTANT_InterfaceMethodref,
963 JVM_CONSTANT_NameAndType,
964 JVM_CONSTANT_MethodHandle = 15, // JSR 292
965 JVM_CONSTANT_MethodType = 16, // JSR 292
966 //JVM_CONSTANT_(unused) = 17, // JSR 292 early drafts only
967 JVM_CONSTANT_InvokeDynamic = 18, // JSR 292
968 JVM_CONSTANT_ExternalMax = 18 // Last tag found in classfiles
969 };
970
971 /* JVM_CONSTANT_MethodHandle subtypes */
972 enum {
973 JVM_REF_getField = 1,
974 JVM_REF_getStatic = 2,
975 JVM_REF_putField = 3,
976 JVM_REF_putStatic = 4,
977 JVM_REF_invokeVirtual = 5,
978 JVM_REF_invokeStatic = 6,
979 JVM_REF_invokeSpecial = 7,
980 JVM_REF_newInvokeSpecial = 8,
981 JVM_REF_invokeInterface = 9
982 };
983
984 /* Used in the newarray instruction. */
985
986 #define JVM_T_BOOLEAN 4
987 #define JVM_T_CHAR 5
988 #define JVM_T_FLOAT 6
989 #define JVM_T_DOUBLE 7
990 #define JVM_T_BYTE 8
991 #define JVM_T_SHORT 9
992 #define JVM_T_INT 10
993 #define JVM_T_LONG 11
994
995 /* JVM method signatures */
996
997 #define JVM_SIGNATURE_ARRAY '['
998 #define JVM_SIGNATURE_BYTE 'B'
999 #define JVM_SIGNATURE_CHAR 'C'
1000 #define JVM_SIGNATURE_CLASS 'L'
1001 #define JVM_SIGNATURE_ENDCLASS ';'
1002 #define JVM_SIGNATURE_ENUM 'E'
1003 #define JVM_SIGNATURE_FLOAT 'F'
1004 #define JVM_SIGNATURE_DOUBLE 'D'
1005 #define JVM_SIGNATURE_FUNC '('
1006 #define JVM_SIGNATURE_ENDFUNC ')'
1007 #define JVM_SIGNATURE_INT 'I'
1008 #define JVM_SIGNATURE_LONG 'J'
1009 #define JVM_SIGNATURE_SHORT 'S'
1010 #define JVM_SIGNATURE_VOID 'V'
1011 #define JVM_SIGNATURE_BOOLEAN 'Z'
1012
1013 /*
1014 * A function defined by the byte-code verifier and called by the VM.
1015 * This is not a function implemented in the VM.
1016 *
1017 * Returns JNI_FALSE if verification fails. A detailed error message
1018 * will be places in msg_buf, whose length is specified by buf_len.
1019 */
1020 typedef jboolean (*verifier_fn_t)(JNIEnv *env,
1021 jclass cb,
1022 char * msg_buf,
1023 jint buf_len);
1024
1025
1026 /*
1027 * Support for a VM-independent class format checker.
1028 */
1029 typedef struct {
1030 unsigned long code; /* byte code */
1031 unsigned long excs; /* exceptions */
1032 unsigned long etab; /* catch table */
1033 unsigned long lnum; /* line number */
1034 unsigned long lvar; /* local vars */
1035 } method_size_info;
1036
1037 typedef struct {
1038 unsigned int constants; /* constant pool */
1039 unsigned int fields;
1040 unsigned int methods;
1041 unsigned int interfaces;
1042 unsigned int fields2; /* number of static 2-word fields */
1043 unsigned int innerclasses; /* # of records in InnerClasses attr */
1044
1045 method_size_info clinit; /* memory used in clinit */
1046 method_size_info main; /* used everywhere else */
1047 } class_size_info;
1048
1049 /*
1050 * Functions defined in libjava.so to perform string conversions.
1051 *
1052 */
1053
1054 typedef jstring (*to_java_string_fn_t)(JNIEnv *env, char *str);
1055
1056 typedef char *(*to_c_string_fn_t)(JNIEnv *env, jstring s, jboolean *b);
1057
1058 /* This is the function defined in libjava.so that performs class
1059 * format checks. This functions fills in size information about
1060 * the class file and returns:
1061 *
1062 * 0: good
1063 * -1: out of memory
1064 * -2: bad format
1065 * -3: unsupported version
1066 * -4: bad class name
1067 */
1068
1069 typedef jint (*check_format_fn_t)(char *class_name,
1070 unsigned char *data,
1071 unsigned int data_size,
1072 class_size_info *class_size,
1073 char *message_buffer,
1074 jint buffer_length,
1075 jboolean measure_only,
1076 jboolean check_relaxed);
1077
1078 #define JVM_RECOGNIZED_CLASS_MODIFIERS (JVM_ACC_PUBLIC | \
1079 JVM_ACC_FINAL | \
1080 JVM_ACC_SUPER | \
1081 JVM_ACC_INTERFACE | \
1082 JVM_ACC_ABSTRACT | \
1083 JVM_ACC_ANNOTATION | \
1084 JVM_ACC_ENUM | \
1085 JVM_ACC_SYNTHETIC)
1086
1087 #define JVM_RECOGNIZED_FIELD_MODIFIERS (JVM_ACC_PUBLIC | \
1088 JVM_ACC_PRIVATE | \
1089 JVM_ACC_PROTECTED | \
1090 JVM_ACC_STATIC | \
1091 JVM_ACC_FINAL | \
1092 JVM_ACC_VOLATILE | \
1093 JVM_ACC_TRANSIENT | \
1094 JVM_ACC_ENUM | \
1095 JVM_ACC_SYNTHETIC)
1096
1097 #define JVM_RECOGNIZED_METHOD_MODIFIERS (JVM_ACC_PUBLIC | \
1098 JVM_ACC_PRIVATE | \
1099 JVM_ACC_PROTECTED | \
1100 JVM_ACC_STATIC | \
1101 JVM_ACC_FINAL | \
1102 JVM_ACC_SYNCHRONIZED | \
1103 JVM_ACC_BRIDGE | \
1104 JVM_ACC_VARARGS | \
1105 JVM_ACC_NATIVE | \
1106 JVM_ACC_ABSTRACT | \
1107 JVM_ACC_STRICT | \
1108 JVM_ACC_SYNTHETIC)
1109
1110 /*
1111 * This is the function defined in libjava.so to perform path
1112 * canonicalization. VM call this function before opening jar files
1113 * to load system classes.
1114 *
1115 */
1116
1117 typedef int (*canonicalize_fn_t)(JNIEnv *env, char *orig, char *out, int len);
1118
1119 /*************************************************************************
1120 PART 3: I/O and Network Support
1121 ************************************************************************/
1122
1123 /*
1124 * Convert a pathname into native format. This function does syntactic
1125 * cleanup, such as removing redundant separator characters. It modifies
1126 * the given pathname string in place.
1127 */
1128 JNIEXPORT char * JNICALL
1129 JVM_NativePath(char *);
1130
1131 /*
1132 * The standard printing functions supported by the Java VM. (Should they
1133 * be renamed to JVM_* in the future?
1134 */
1135
1136 /* jio_snprintf() and jio_vsnprintf() behave like snprintf(3) and vsnprintf(3),
1137 * respectively, with the following differences:
1138 * - The string written to str is always zero-terminated, also in case of
1139 * truncation (count is too small to hold the result string), unless count
1140 * is 0. In case of truncation count-1 characters are written and '\0'
1141 * appendend.
1142 * - If count is too small to hold the whole string, -1 is returned across
1143 * all platforms. */
1144 JNIEXPORT int
1145 jio_vsnprintf(char *str, size_t count, const char *fmt, va_list args);
1146
1147 JNIEXPORT int
1148 jio_snprintf(char *str, size_t count, const char *fmt, ...);
1149
1150 JNIEXPORT int
1151 jio_fprintf(FILE *, const char *fmt, ...);
1152
1153 JNIEXPORT int
1154 jio_vfprintf(FILE *, const char *fmt, va_list args);
1155
1156
1157 JNIEXPORT void * JNICALL
1158 JVM_RawMonitorCreate(void);
1159
1160 JNIEXPORT void JNICALL
1161 JVM_RawMonitorDestroy(void *mon);
1162
1163 JNIEXPORT jint JNICALL
1164 JVM_RawMonitorEnter(void *mon);
1165
1166 JNIEXPORT void JNICALL
1167 JVM_RawMonitorExit(void *mon);
1168
1169 /*
1170 * java.lang.reflect.Method
1171 */
1172 JNIEXPORT jobject JNICALL
1173 JVM_InvokeMethod(JNIEnv *env, jobject method, jobject obj, jobjectArray args0);
1174
1175 /*
1176 * java.lang.reflect.Constructor
1177 */
1178 JNIEXPORT jobject JNICALL
1179 JVM_NewInstanceFromConstructor(JNIEnv *env, jobject c, jobjectArray args0);
1180
1181 /*
1182 * java.lang.management support
1183 */
1184 JNIEXPORT void* JNICALL
1185 JVM_GetManagement(jint version);
1186
1187 /*
1188 * com.sun.tools.attach.VirtualMachine support
1189 *
1190 * Initialize the agent properties with the properties maintained in the VM.
1191 */
1192 JNIEXPORT jobject JNICALL
1193 JVM_InitAgentProperties(JNIEnv *env, jobject agent_props);
1194
1195 JNIEXPORT jstring JNICALL
1196 JVM_GetTemporaryDirectory(JNIEnv *env);
1197
1198 /* Generics reflection support.
1199 *
1200 * Returns information about the given class's EnclosingMethod
1201 * attribute, if present, or null if the class had no enclosing
1202 * method.
1203 *
1204 * If non-null, the returned array contains three elements. Element 0
1205 * is the java.lang.Class of which the enclosing method is a member,
1206 * and elements 1 and 2 are the java.lang.Strings for the enclosing
1207 * method's name and descriptor, respectively.
1208 */
1209 JNIEXPORT jobjectArray JNICALL
1210 JVM_GetEnclosingMethodInfo(JNIEnv* env, jclass ofClass);
1211
1212 /* =========================================================================
1213 * The following defines a private JVM interface that the JDK can query
1214 * for the JVM version and capabilities. sun.misc.Version defines
1215 * the methods for getting the VM version and its capabilities.
1216 *
1217 * When a new bit is added, the following should be updated to provide
1218 * access to the new capability:
1219 * HS: JVM_GetVersionInfo and Abstract_VM_Version class
1220 * SDK: Version class
1221 *
1222 * Similary, a private JDK interface JDK_GetVersionInfo0 is defined for
1223 * JVM to query for the JDK version and capabilities.
1224 *
1225 * When a new bit is added, the following should be updated to provide
1226 * access to the new capability:
1227 * HS: JDK_Version class
1228 * SDK: JDK_GetVersionInfo0
1229 *
1230 * ==========================================================================
1231 */
1232 typedef struct {
1233 /* VM version string: follows the JDK release version naming convention */
1234 unsigned int jvm_version; /* <major_ver>.<minor_ver>.<micro_ver>[-<identifier>][-<debug_target>][-b<nn>] */
1235 unsigned int update_version : 8;
1236 unsigned int special_update_version : 8;
1237 unsigned int reserved1 : 16;
1238 unsigned int reserved2;
1239
1240 /* The following bits represents JVM supports that JDK has dependency on.
1241 * JDK can use these bits to determine which JVM version
1242 * and support it has to maintain runtime compatibility.
1243 *
1244 * When a new bit is added in a minor or update release, make sure
1245 * the new bit is also added in the main/baseline.
1246 */
1247 unsigned int is_attachable : 1;
1248 unsigned int : 31;
1249 unsigned int : 32;
1250 unsigned int : 32;
1251 } jvm_version_info;
1252
1253 #define JVM_VERSION_MAJOR(version) ((version & 0xFF000000) >> 24)
1254 #define JVM_VERSION_MINOR(version) ((version & 0x00FF0000) >> 16)
1255 #define JVM_VERSION_MICRO(version) ((version & 0x0000FF00) >> 8)
1256 #define JVM_VERSION_BUILD(version) ((version & 0x000000FF))
1257
1258 JNIEXPORT void JNICALL
1259 JVM_GetVersionInfo(JNIEnv* env, jvm_version_info* info, size_t info_size);
1260
1261 typedef struct {
1262 // Naming convention of RE build version string: n.n.n[_uu[c]][-<identifier>]-bxx
1263 unsigned int jdk_version; /* Consists of major, minor, micro (n.n.n) */
1264 /* and build number (xx) */
1265 unsigned int update_version : 8; /* Update release version (uu) */
1266 unsigned int special_update_version : 8; /* Special update release version (c)*/
1267 unsigned int reserved1 : 16;
1268 unsigned int reserved2;
1269
1270 /* The following bits represents new JDK supports that VM has dependency on.
1271 * VM implementation can use these bits to determine which JDK version
1272 * and support it has to maintain runtime compatibility.
1273 *
1274 * When a new bit is added in a minor or update release, make sure
1275 * the new bit is also added in the main/baseline.
1276 */
1277 unsigned int thread_park_blocker : 1;
1278 unsigned int post_vm_init_hook_enabled : 1;
1279 unsigned int pending_list_uses_discovered_field : 1;
1280 unsigned int : 29;
1281 unsigned int : 32;
1282 unsigned int : 32;
1283 } jdk_version_info;
1284
1285 #define JDK_VERSION_MAJOR(version) ((version & 0xFF000000) >> 24)
1286 #define JDK_VERSION_MINOR(version) ((version & 0x00FF0000) >> 16)
1287 #define JDK_VERSION_MICRO(version) ((version & 0x0000FF00) >> 8)
1288
1289 /* Build number is available only for RE build (i.e. JDK_BUILD_NUMBER is set to bNN)
1290 * It will be zero for internal builds.
1291 */
1292 #define JDK_VERSION_BUILD(version) ((version & 0x000000FF))
1293
1294 /*
1295 * This is the function JDK_GetVersionInfo0 defined in libjava.so
1296 * that is dynamically looked up by JVM.
1297 */
1298 typedef void (*jdk_version_info_fn_t)(jdk_version_info* info, size_t info_size);
1299
1300 /*
1301 * This structure is used by the launcher to get the default thread
1302 * stack size from the VM using JNI_GetDefaultJavaVMInitArgs() with a
1303 * version of 1.1. As it is not supported otherwise, it has been removed
1304 * from jni.h
1305 */
1306 typedef struct JDK1_1InitArgs {
1307 jint version;
1308
1309 char **properties;
1310 jint checkSource;
1311 jint nativeStackSize;
1312 jint javaStackSize;
1313 jint minHeapSize;
1314 jint maxHeapSize;
1315 jint verifyMode;
1316 char *classpath;
1317
1318 jint (JNICALL *vfprintf)(FILE *fp, const char *format, va_list args);
1319 void (JNICALL *exit)(jint code);
1320 void (JNICALL *abort)(void);
1321
1322 jint enableClassGC;
1323 jint enableVerboseGC;
1324 jint disableAsyncGC;
1325 jint verbose;
1326 jboolean debugging;
1327 jint debugPort;
1328 } JDK1_1InitArgs;
1329
1330 #ifdef __cplusplus
1331 } /* extern "C" */
1332 #endif /* __cplusplus */
1333
1334 #endif /* !_JAVASOFT_JVM_H_ */
1335
1336 #endif // SHARE_VM_PRIMS_JVM_H