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