WhiteBox.java revision 1462:f584bb30d4bd 
1/*
2 * Copyright (c) 2012, 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
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.util.stream.Stream;
34import java.security.BasicPermission;
35
36import sun.hotspot.parser.DiagnosticCommand;
37
38public class WhiteBox {
39
40  @SuppressWarnings("serial")
41  public static class WhiteBoxPermission extends BasicPermission {
42    public WhiteBoxPermission(String s) {
43      super(s);
44    }
45  }
46
47  private WhiteBox() {}
48  private static final WhiteBox instance = new WhiteBox();
49  private static native void registerNatives();
50
51  /**
52   * Returns the singleton WhiteBox instance.
53   *
54   * The returned WhiteBox object should be carefully guarded
55   * by the caller, since it can be used to read and write data
56   * at arbitrary memory addresses. It must never be passed to
57   * untrusted code.
58   */
59  public synchronized static WhiteBox getWhiteBox() {
60    SecurityManager sm = System.getSecurityManager();
61    if (sm != null) {
62      sm.checkPermission(new WhiteBoxPermission("getInstance"));
63    }
64    return instance;
65  }
66
67  static {
68    registerNatives();
69  }
70
71  // Get the maximum heap size supporting COOPs
72  public native long getCompressedOopsMaxHeapSize();
73  // Arguments
74  public native void printHeapSizes();
75
76  // Memory
77  public native long getObjectAddress(Object o);
78  public native int  getHeapOopSize();
79  public native int  getVMPageSize();
80  public native boolean isObjectInOldGen(Object o);
81  public native long getObjectSize(Object o);
82
83  // Runtime
84  // Make sure class name is in the correct format
85  public boolean isClassAlive(String name) {
86    return isClassAlive0(name.replace('.', '/'));
87  }
88  private native boolean isClassAlive0(String name);
89  public native boolean isMonitorInflated(Object obj);
90  public native void forceSafepoint();
91
92  // JVMTI
93  public native void addToBootstrapClassLoaderSearch(String segment);
94  public native void addToSystemClassLoaderSearch(String segment);
95
96  // G1
97  public native boolean g1InConcurrentMark();
98  public native boolean g1IsHumongous(Object o);
99  public native long    g1NumMaxRegions();
100  public native long    g1NumFreeRegions();
101  public native int     g1RegionSize();
102  public native MemoryUsage g1AuxiliaryMemoryUsage();
103  public native Object[]    parseCommandLine(String commandline, char delim, DiagnosticCommand[] args);
104
105  // NMT
106  public native long NMTMalloc(long size);
107  public native void NMTFree(long mem);
108  public native long NMTReserveMemory(long size);
109  public native void NMTCommitMemory(long addr, long size);
110  public native void NMTUncommitMemory(long addr, long size);
111  public native void NMTReleaseMemory(long addr, long size);
112  public native long NMTMallocWithPseudoStack(long size, int index);
113  public native boolean NMTChangeTrackingLevel();
114  public native int NMTGetHashSize();
115
116  // Compiler
117  public native int     deoptimizeFrames(boolean makeNotEntrant);
118  public native void    deoptimizeAll();
119  public        boolean isMethodCompiled(Executable method) {
120    return isMethodCompiled(method, false /*not osr*/);
121  }
122  public native boolean isMethodCompiled(Executable method, boolean isOsr);
123  public        boolean isMethodCompilable(Executable method) {
124    return isMethodCompilable(method, -1 /*any*/);
125  }
126  public        boolean isMethodCompilable(Executable method, int compLevel) {
127    return isMethodCompilable(method, compLevel, false /*not osr*/);
128  }
129  public native boolean isMethodCompilable(Executable method, int compLevel, boolean isOsr);
130  public native boolean isMethodQueuedForCompilation(Executable method);
131  public        int     deoptimizeMethod(Executable method) {
132    return deoptimizeMethod(method, false /*not osr*/);
133  }
134  public native int     deoptimizeMethod(Executable method, boolean isOsr);
135  public        void    makeMethodNotCompilable(Executable method) {
136    makeMethodNotCompilable(method, -1 /*any*/);
137  }
138  public        void    makeMethodNotCompilable(Executable method, int compLevel) {
139    makeMethodNotCompilable(method, compLevel, false /*not osr*/);
140  }
141  public native void    makeMethodNotCompilable(Executable method, int compLevel, boolean isOsr);
142  public        int     getMethodCompilationLevel(Executable method) {
143    return getMethodCompilationLevel(method, false /*not ost*/);
144  }
145  public native int     getMethodCompilationLevel(Executable method, boolean isOsr);
146  public native boolean testSetDontInlineMethod(Executable method, boolean value);
147  public        int     getCompileQueuesSize() {
148    return getCompileQueueSize(-1 /*any*/);
149  }
150  public native int     getCompileQueueSize(int compLevel);
151  public native boolean testSetForceInlineMethod(Executable method, boolean value);
152  public        boolean enqueueMethodForCompilation(Executable method, int compLevel) {
153    return enqueueMethodForCompilation(method, compLevel, -1 /*InvocationEntryBci*/);
154  }
155  public native boolean enqueueMethodForCompilation(Executable method, int compLevel, int entry_bci);
156  public native void    clearMethodState(Executable method);
157  public native void    lockCompilation();
158  public native void    unlockCompilation();
159  public native int     getMethodEntryBci(Executable method);
160  public native Object[] getNMethod(Executable method, boolean isOsr);
161  public native long    allocateCodeBlob(int size, int type);
162  public        long    allocateCodeBlob(long size, int type) {
163      int intSize = (int) size;
164      if ((long) intSize != size || size < 0) {
165          throw new IllegalArgumentException(
166                "size argument has illegal value " + size);
167      }
168      return allocateCodeBlob( intSize, type);
169  }
170  public native void    freeCodeBlob(long addr);
171  public native void    forceNMethodSweep();
172  public native Object[] getCodeHeapEntries(int type);
173  public native int     getCompilationActivityMode();
174  public native Object[] getCodeBlob(long addr);
175
176  // Intered strings
177  public native boolean isInStringTable(String str);
178
179  // Memory
180  public native void readReservedMemory();
181  public native long allocateMetaspace(ClassLoader classLoader, long size);
182  public native void freeMetaspace(ClassLoader classLoader, long addr, long size);
183  public native long incMetaspaceCapacityUntilGC(long increment);
184  public native long metaspaceCapacityUntilGC();
185
186  // Force Young GC
187  public native void youngGC();
188
189  // Force Full GC
190  public native void fullGC();
191
192  // Method tries to start concurrent mark cycle.
193  // It returns false if CM Thread is always in concurrent cycle.
194  public native boolean g1StartConcMarkCycle();
195
196  // Tests on ReservedSpace/VirtualSpace classes
197  public native int stressVirtualSpaceResize(long reservedSpaceSize, long magnitude, long iterations);
198  public native void runMemoryUnitTests();
199  public native void readFromNoaccessArea();
200  public native long getThreadStackSize();
201  public native long getThreadRemainingStackSize();
202
203  // CPU features
204  public native String getCPUFeatures();
205
206  // Native extensions
207  public native long getHeapUsageForContext(int context);
208  public native long getHeapRegionCountForContext(int context);
209  public native int getContextForObject(Object obj);
210  public native void printRegionInfo(int context);
211
212  // VM flags
213  public native boolean isConstantVMFlag(String name);
214  public native boolean isLockedVMFlag(String name);
215  public native void    setBooleanVMFlag(String name, boolean value);
216  public native void    setIntxVMFlag(String name, long value);
217  public native void    setUintxVMFlag(String name, long value);
218  public native void    setUint64VMFlag(String name, long value);
219  public native void    setSizeTVMFlag(String name, long value);
220  public native void    setStringVMFlag(String name, String value);
221  public native void    setDoubleVMFlag(String name, double value);
222  public native Boolean getBooleanVMFlag(String name);
223  public native Long    getIntxVMFlag(String name);
224  public native Long    getUintxVMFlag(String name);
225  public native Long    getUint64VMFlag(String name);
226  public native Long    getSizeTVMFlag(String name);
227  public native String  getStringVMFlag(String name);
228  public native Double  getDoubleVMFlag(String name);
229  private final List<Function<String,Object>> flagsGetters = Arrays.asList(
230    this::getBooleanVMFlag, this::getIntxVMFlag, this::getUintxVMFlag,
231    this::getUint64VMFlag, this::getSizeTVMFlag, this::getStringVMFlag,
232    this::getDoubleVMFlag);
233
234  public Object getVMFlag(String name) {
235    return flagsGetters.stream()
236                       .map(f -> f.apply(name))
237                       .filter(x -> x != null)
238                       .findAny()
239                       .orElse(null);
240  }
241  public native int getOffsetForName0(String name);
242  public int getOffsetForName(String name) throws Exception {
243    int offset = getOffsetForName0(name);
244    if (offset == -1) {
245      throw new RuntimeException(name + " not found");
246    }
247    return offset;
248  }
249  public native Boolean getMethodBooleanOption(Executable method, String name);
250  public native Long    getMethodIntxOption(Executable method, String name);
251  public native Long    getMethodUintxOption(Executable method, String name);
252  public native Double  getMethodDoubleOption(Executable method, String name);
253  public native String  getMethodStringOption(Executable method, String name);
254  private final List<BiFunction<Executable,String,Object>> methodOptionGetters
255      = Arrays.asList(this::getMethodBooleanOption, this::getMethodIntxOption,
256          this::getMethodUintxOption, this::getMethodDoubleOption,
257          this::getMethodStringOption);
258
259  public Object getMethodOption(Executable method, String name) {
260    return methodOptionGetters.stream()
261                              .map(f -> f.apply(method, name))
262                              .filter(x -> x != null)
263                              .findAny()
264                              .orElse(null);
265  }
266
267  // Safepoint Checking
268  public native void assertMatchingSafepointCalls(boolean mutexSafepointValue, boolean attemptedNoSafepointValue);
269}
270