WhiteBox.java revision 1961:f900d5afd9c8
1/* 2 * Copyright (c) 2012, 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 25package sun.hotspot; 26 27import java.lang.management.MemoryUsage; 28import java.lang.reflect.Executable; 29import java.util.Arrays; 30import java.util.List; 31import java.util.function.BiFunction; 32import java.util.function.Function; 33import java.security.BasicPermission; 34import java.util.Objects; 35 36import sun.hotspot.parser.DiagnosticCommand; 37 38public class WhiteBox { 39 @SuppressWarnings("serial") 40 public static class WhiteBoxPermission extends BasicPermission { 41 public WhiteBoxPermission(String s) { 42 super(s); 43 } 44 } 45 46 private WhiteBox() {} 47 private static final WhiteBox instance = new WhiteBox(); 48 private static native void registerNatives(); 49 50 /** 51 * Returns the singleton WhiteBox instance. 52 * 53 * The returned WhiteBox object should be carefully guarded 54 * by the caller, since it can be used to read and write data 55 * at arbitrary memory addresses. It must never be passed to 56 * untrusted code. 57 */ 58 public synchronized static WhiteBox getWhiteBox() { 59 SecurityManager sm = System.getSecurityManager(); 60 if (sm != null) { 61 sm.checkPermission(new WhiteBoxPermission("getInstance")); 62 } 63 return instance; 64 } 65 66 static { 67 registerNatives(); 68 } 69 70 // Get the maximum heap size supporting COOPs 71 public native long getCompressedOopsMaxHeapSize(); 72 // Arguments 73 public native void printHeapSizes(); 74 75 // Memory 76 private native long getObjectAddress0(Object o); 77 public long getObjectAddress(Object o) { 78 Objects.requireNonNull(o); 79 return getObjectAddress0(o); 80 } 81 82 public native int getHeapOopSize(); 83 public native int getVMPageSize(); 84 public native long getVMAllocationGranularity(); 85 public native long getVMLargePageSize(); 86 public native long getHeapSpaceAlignment(); 87 88 private native boolean isObjectInOldGen0(Object o); 89 public boolean isObjectInOldGen(Object o) { 90 Objects.requireNonNull(o); 91 return isObjectInOldGen0(o); 92 } 93 94 private native long getObjectSize0(Object o); 95 public long getObjectSize(Object o) { 96 Objects.requireNonNull(o); 97 return getObjectSize0(o); 98 } 99 100 // Runtime 101 // Make sure class name is in the correct format 102 public boolean isClassAlive(String name) { 103 return isClassAlive0(name.replace('.', '/')); 104 } 105 private native boolean isClassAlive0(String name); 106 107 private native boolean isMonitorInflated0(Object obj); 108 public boolean isMonitorInflated(Object obj) { 109 Objects.requireNonNull(obj); 110 return isMonitorInflated0(obj); 111 } 112 113 public native void forceSafepoint(); 114 115 private native long getConstantPool0(Class<?> aClass); 116 public long getConstantPool(Class<?> aClass) { 117 Objects.requireNonNull(aClass); 118 return getConstantPool0(aClass); 119 } 120 121 private native int getConstantPoolCacheIndexTag0(); 122 public int getConstantPoolCacheIndexTag() { 123 return getConstantPoolCacheIndexTag0(); 124 } 125 126 private native int getConstantPoolCacheLength0(Class<?> aClass); 127 public int getConstantPoolCacheLength(Class<?> aClass) { 128 Objects.requireNonNull(aClass); 129 return getConstantPoolCacheLength0(aClass); 130 } 131 132 private native int remapInstructionOperandFromCPCache0(Class<?> aClass, int index); 133 public int remapInstructionOperandFromCPCache(Class<?> aClass, int index) { 134 Objects.requireNonNull(aClass); 135 return remapInstructionOperandFromCPCache0(aClass, index); 136 } 137 138 private native int encodeConstantPoolIndyIndex0(int index); 139 public int encodeConstantPoolIndyIndex(int index) { 140 return encodeConstantPoolIndyIndex0(index); 141 } 142 143 // JVMTI 144 private native void addToBootstrapClassLoaderSearch0(String segment); 145 public void addToBootstrapClassLoaderSearch(String segment){ 146 Objects.requireNonNull(segment); 147 addToBootstrapClassLoaderSearch0(segment); 148 } 149 150 private native void addToSystemClassLoaderSearch0(String segment); 151 public void addToSystemClassLoaderSearch(String segment) { 152 Objects.requireNonNull(segment); 153 addToSystemClassLoaderSearch0(segment); 154 } 155 156 // G1 157 public native boolean g1InConcurrentMark(); 158 private native boolean g1IsHumongous0(Object o); 159 public boolean g1IsHumongous(Object o) { 160 Objects.requireNonNull(o); 161 return g1IsHumongous0(o); 162 } 163 164 private native boolean g1BelongsToHumongousRegion0(long adr); 165 public boolean g1BelongsToHumongousRegion(long adr) { 166 if (adr == 0) { 167 throw new IllegalArgumentException("adr argument should not be null"); 168 } 169 return g1BelongsToHumongousRegion0(adr); 170 } 171 172 173 private native boolean g1BelongsToFreeRegion0(long adr); 174 public boolean g1BelongsToFreeRegion(long adr) { 175 if (adr == 0) { 176 throw new IllegalArgumentException("adr argument should not be null"); 177 } 178 return g1BelongsToFreeRegion0(adr); 179 } 180 181 public native long g1NumMaxRegions(); 182 public native long g1NumFreeRegions(); 183 public native int g1RegionSize(); 184 public native MemoryUsage g1AuxiliaryMemoryUsage(); 185 private native Object[] parseCommandLine0(String commandline, char delim, DiagnosticCommand[] args); 186 public Object[] parseCommandLine(String commandline, char delim, DiagnosticCommand[] args) { 187 Objects.requireNonNull(args); 188 return parseCommandLine0(commandline, delim, args); 189 } 190 191 // Parallel GC 192 public native long psVirtualSpaceAlignment(); 193 public native long psHeapGenerationAlignment(); 194 195 // NMT 196 public native long NMTMalloc(long size); 197 public native void NMTFree(long mem); 198 public native long NMTReserveMemory(long size); 199 public native void NMTCommitMemory(long addr, long size); 200 public native void NMTUncommitMemory(long addr, long size); 201 public native void NMTReleaseMemory(long addr, long size); 202 public native long NMTMallocWithPseudoStack(long size, int index); 203 public native boolean NMTChangeTrackingLevel(); 204 public native int NMTGetHashSize(); 205 206 // Compiler 207 public native int matchesMethod(Executable method, String pattern); 208 public native int matchesInline(Executable method, String pattern); 209 public native boolean shouldPrintAssembly(Executable method, int comp_level); 210 public native int deoptimizeFrames(boolean makeNotEntrant); 211 public native void deoptimizeAll(); 212 213 public boolean isMethodCompiled(Executable method) { 214 return isMethodCompiled(method, false /*not osr*/); 215 } 216 private native boolean isMethodCompiled0(Executable method, boolean isOsr); 217 public boolean isMethodCompiled(Executable method, boolean isOsr){ 218 Objects.requireNonNull(method); 219 return isMethodCompiled0(method, isOsr); 220 } 221 public boolean isMethodCompilable(Executable method) { 222 return isMethodCompilable(method, -1 /*any*/); 223 } 224 public boolean isMethodCompilable(Executable method, int compLevel) { 225 return isMethodCompilable(method, compLevel, false /*not osr*/); 226 } 227 private native boolean isMethodCompilable0(Executable method, int compLevel, boolean isOsr); 228 public boolean isMethodCompilable(Executable method, int compLevel, boolean isOsr) { 229 Objects.requireNonNull(method); 230 return isMethodCompilable0(method, compLevel, isOsr); 231 } 232 private native boolean isMethodQueuedForCompilation0(Executable method); 233 public boolean isMethodQueuedForCompilation(Executable method) { 234 Objects.requireNonNull(method); 235 return isMethodQueuedForCompilation0(method); 236 } 237 // Determine if the compiler corresponding to the compilation level 'compLevel' 238 // and to the compilation context 'compilation_context' provides an intrinsic 239 // for the method 'method'. An intrinsic is available for method 'method' if: 240 // - the intrinsic is enabled (by using the appropriate command-line flag) and 241 // - the platform on which the VM is running provides the instructions necessary 242 // for the compiler to generate the intrinsic code. 243 // 244 // The compilation context is related to using the DisableIntrinsic flag on a 245 // per-method level, see hotspot/src/share/vm/compiler/abstractCompiler.hpp 246 // for more details. 247 public boolean isIntrinsicAvailable(Executable method, 248 Executable compilationContext, 249 int compLevel) { 250 Objects.requireNonNull(method); 251 return isIntrinsicAvailable0(method, compilationContext, compLevel); 252 } 253 // If usage of the DisableIntrinsic flag is not expected (or the usage can be ignored), 254 // use the below method that does not require the compilation context as argument. 255 public boolean isIntrinsicAvailable(Executable method, int compLevel) { 256 return isIntrinsicAvailable(method, null, compLevel); 257 } 258 private native boolean isIntrinsicAvailable0(Executable method, 259 Executable compilationContext, 260 int compLevel); 261 public int deoptimizeMethod(Executable method) { 262 return deoptimizeMethod(method, false /*not osr*/); 263 } 264 private native int deoptimizeMethod0(Executable method, boolean isOsr); 265 public int deoptimizeMethod(Executable method, boolean isOsr) { 266 Objects.requireNonNull(method); 267 return deoptimizeMethod0(method, isOsr); 268 } 269 public void makeMethodNotCompilable(Executable method) { 270 makeMethodNotCompilable(method, -1 /*any*/); 271 } 272 public void makeMethodNotCompilable(Executable method, int compLevel) { 273 makeMethodNotCompilable(method, compLevel, false /*not osr*/); 274 } 275 private native void makeMethodNotCompilable0(Executable method, int compLevel, boolean isOsr); 276 public void makeMethodNotCompilable(Executable method, int compLevel, boolean isOsr) { 277 Objects.requireNonNull(method); 278 makeMethodNotCompilable0(method, compLevel, isOsr); 279 } 280 public int getMethodCompilationLevel(Executable method) { 281 return getMethodCompilationLevel(method, false /*not ost*/); 282 } 283 private native int getMethodCompilationLevel0(Executable method, boolean isOsr); 284 public int getMethodCompilationLevel(Executable method, boolean isOsr) { 285 Objects.requireNonNull(method); 286 return getMethodCompilationLevel0(method, isOsr); 287 } 288 private native boolean testSetDontInlineMethod0(Executable method, boolean value); 289 public boolean testSetDontInlineMethod(Executable method, boolean value) { 290 Objects.requireNonNull(method); 291 return testSetDontInlineMethod0(method, value); 292 } 293 public int getCompileQueuesSize() { 294 return getCompileQueueSize(-1 /*any*/); 295 } 296 public native int getCompileQueueSize(int compLevel); 297 private native boolean testSetForceInlineMethod0(Executable method, boolean value); 298 public boolean testSetForceInlineMethod(Executable method, boolean value) { 299 Objects.requireNonNull(method); 300 return testSetForceInlineMethod0(method, value); 301 } 302 public boolean enqueueMethodForCompilation(Executable method, int compLevel) { 303 return enqueueMethodForCompilation(method, compLevel, -1 /*InvocationEntryBci*/); 304 } 305 private native boolean enqueueMethodForCompilation0(Executable method, int compLevel, int entry_bci); 306 public boolean enqueueMethodForCompilation(Executable method, int compLevel, int entry_bci) { 307 Objects.requireNonNull(method); 308 return enqueueMethodForCompilation0(method, compLevel, entry_bci); 309 } 310 private native void clearMethodState0(Executable method); 311 public void clearMethodState(Executable method) { 312 Objects.requireNonNull(method); 313 clearMethodState0(method); 314 } 315 public native void lockCompilation(); 316 public native void unlockCompilation(); 317 private native int getMethodEntryBci0(Executable method); 318 public int getMethodEntryBci(Executable method) { 319 Objects.requireNonNull(method); 320 return getMethodEntryBci0(method); 321 } 322 private native Object[] getNMethod0(Executable method, boolean isOsr); 323 public Object[] getNMethod(Executable method, boolean isOsr) { 324 Objects.requireNonNull(method); 325 return getNMethod0(method, isOsr); 326 } 327 public native long allocateCodeBlob(int size, int type); 328 public long allocateCodeBlob(long size, int type) { 329 int intSize = (int) size; 330 if ((long) intSize != size || size < 0) { 331 throw new IllegalArgumentException( 332 "size argument has illegal value " + size); 333 } 334 return allocateCodeBlob( intSize, type); 335 } 336 public native void freeCodeBlob(long addr); 337 public native void forceNMethodSweep(); 338 public native Object[] getCodeHeapEntries(int type); 339 public native int getCompilationActivityMode(); 340 private native long getMethodData0(Executable method); 341 public long getMethodData(Executable method) { 342 Objects.requireNonNull(method); 343 return getMethodData0(method); 344 } 345 public native Object[] getCodeBlob(long addr); 346 347 public native void clearInlineCaches(); 348 349 // Intered strings 350 public native boolean isInStringTable(String str); 351 352 // Memory 353 public native void readReservedMemory(); 354 public native long allocateMetaspace(ClassLoader classLoader, long size); 355 public native void freeMetaspace(ClassLoader classLoader, long addr, long size); 356 public native long incMetaspaceCapacityUntilGC(long increment); 357 public native long metaspaceCapacityUntilGC(); 358 359 // Force Young GC 360 public native void youngGC(); 361 362 // Force Full GC 363 public native void fullGC(); 364 365 // Method tries to start concurrent mark cycle. 366 // It returns false if CM Thread is always in concurrent cycle. 367 public native boolean g1StartConcMarkCycle(); 368 369 // Tests on ReservedSpace/VirtualSpace classes 370 public native int stressVirtualSpaceResize(long reservedSpaceSize, long magnitude, long iterations); 371 public native void runMemoryUnitTests(); 372 public native void readFromNoaccessArea(); 373 public native long getThreadStackSize(); 374 public native long getThreadRemainingStackSize(); 375 376 // CPU features 377 public native String getCPUFeatures(); 378 379 // Native extensions 380 public native long getHeapUsageForContext(int context); 381 public native long getHeapRegionCountForContext(int context); 382 private native int getContextForObject0(Object obj); 383 public int getContextForObject(Object obj) { 384 Objects.requireNonNull(obj); 385 return getContextForObject0(obj); 386 } 387 public native void printRegionInfo(int context); 388 389 // VM flags 390 public native boolean isConstantVMFlag(String name); 391 public native boolean isLockedVMFlag(String name); 392 public native void setBooleanVMFlag(String name, boolean value); 393 public native void setIntVMFlag(String name, long value); 394 public native void setUintVMFlag(String name, long value); 395 public native void setIntxVMFlag(String name, long value); 396 public native void setUintxVMFlag(String name, long value); 397 public native void setUint64VMFlag(String name, long value); 398 public native void setSizeTVMFlag(String name, long value); 399 public native void setStringVMFlag(String name, String value); 400 public native void setDoubleVMFlag(String name, double value); 401 public native Boolean getBooleanVMFlag(String name); 402 public native Long getIntVMFlag(String name); 403 public native Long getUintVMFlag(String name); 404 public native Long getIntxVMFlag(String name); 405 public native Long getUintxVMFlag(String name); 406 public native Long getUint64VMFlag(String name); 407 public native Long getSizeTVMFlag(String name); 408 public native String getStringVMFlag(String name); 409 public native Double getDoubleVMFlag(String name); 410 private final List<Function<String,Object>> flagsGetters = Arrays.asList( 411 this::getBooleanVMFlag, this::getIntVMFlag, this::getUintVMFlag, 412 this::getIntxVMFlag, this::getUintxVMFlag, this::getUint64VMFlag, 413 this::getSizeTVMFlag, this::getStringVMFlag, this::getDoubleVMFlag); 414 415 public Object getVMFlag(String name) { 416 return flagsGetters.stream() 417 .map(f -> f.apply(name)) 418 .filter(x -> x != null) 419 .findAny() 420 .orElse(null); 421 } 422 423 // Jigsaw 424 public native void DefineModule(Object module, String version, String location, 425 Object[] packages); 426 public native void AddModuleExports(Object from_module, String pkg, Object to_module); 427 public native void AddReadsModule(Object from_module, Object source_module); 428 public native boolean CanReadModule(Object asking_module, Object source_module); 429 public native boolean IsExportedToModule(Object from_module, String pkg, Object to_module); 430 public native void AddModulePackage(Object module, String pkg); 431 public native void AddModuleExportsToAllUnnamed(Object module, String pkg); 432 public native void AddModuleExportsToAll(Object module, String pkg); 433 public native Object GetModuleByPackageName(Object ldr, String pkg); 434 435 public native int getOffsetForName0(String name); 436 public int getOffsetForName(String name) throws Exception { 437 int offset = getOffsetForName0(name); 438 if (offset == -1) { 439 throw new RuntimeException(name + " not found"); 440 } 441 return offset; 442 } 443 public native Boolean getMethodBooleanOption(Executable method, String name); 444 public native Long getMethodIntxOption(Executable method, String name); 445 public native Long getMethodUintxOption(Executable method, String name); 446 public native Double getMethodDoubleOption(Executable method, String name); 447 public native String getMethodStringOption(Executable method, String name); 448 private final List<BiFunction<Executable,String,Object>> methodOptionGetters 449 = Arrays.asList(this::getMethodBooleanOption, this::getMethodIntxOption, 450 this::getMethodUintxOption, this::getMethodDoubleOption, 451 this::getMethodStringOption); 452 453 public Object getMethodOption(Executable method, String name) { 454 return methodOptionGetters.stream() 455 .map(f -> f.apply(method, name)) 456 .filter(x -> x != null) 457 .findAny() 458 .orElse(null); 459 } 460 461 // Safepoint Checking 462 public native void assertMatchingSafepointCalls(boolean mutexSafepointValue, boolean attemptedNoSafepointValue); 463 464 // Sharing 465 public native boolean isShared(Object o); 466 public native boolean isSharedClass(Class<?> c); 467 public native boolean areSharedStringsIgnored(); 468} 469