WhiteBox.java revision 1387:c6b8dc6a00d1 
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.reflect.Executable;
28import java.util.Arrays;
29import java.util.List;
30import java.util.function.BiFunction;
31import java.util.function.Function;
32import java.util.stream.Stream;
33import java.security.BasicPermission;
34
35import sun.hotspot.parser.DiagnosticCommand;
36
37public class WhiteBox {
38
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  public native long getObjectAddress(Object o);
77  public native int  getHeapOopSize();
78  public native int  getVMPageSize();
79  public native boolean isObjectInOldGen(Object o);
80  public native long getObjectSize(Object o);
81
82  // Runtime
83  // Make sure class name is in the correct format
84  public boolean isClassAlive(String name) {
85    return isClassAlive0(name.replace('.', '/'));
86  }
87  private native boolean isClassAlive0(String name);
88  public native boolean isMonitorInflated(Object obj);
89  public native void forceSafepoint();
90
91  // JVMTI
92  public native void addToBootstrapClassLoaderSearch(String segment);
93  public native void addToSystemClassLoaderSearch(String segment);
94
95  // G1
96  public native boolean g1InConcurrentMark();
97  public native boolean g1IsHumongous(Object o);
98  public native long    g1NumFreeRegions();
99  public native int     g1RegionSize();
100  public native Object[]    parseCommandLine(String commandline, char delim, DiagnosticCommand[] args);
101
102  // NMT
103  public native long NMTMalloc(long size);
104  public native void NMTFree(long mem);
105  public native long NMTReserveMemory(long size);
106  public native void NMTCommitMemory(long addr, long size);
107  public native void NMTUncommitMemory(long addr, long size);
108  public native void NMTReleaseMemory(long addr, long size);
109  public native long NMTMallocWithPseudoStack(long size, int index);
110  public native boolean NMTIsDetailSupported();
111  public native boolean NMTChangeTrackingLevel();
112  public native int NMTGetHashSize();
113
114  // Compiler
115  public native int     deoptimizeFrames(boolean makeNotEntrant);
116  public native void    deoptimizeAll();
117  public        boolean isMethodCompiled(Executable method) {
118    return isMethodCompiled(method, false /*not osr*/);
119  }
120  public native boolean isMethodCompiled(Executable method, boolean isOsr);
121  public        boolean isMethodCompilable(Executable method) {
122    return isMethodCompilable(method, -1 /*any*/);
123  }
124  public        boolean isMethodCompilable(Executable method, int compLevel) {
125    return isMethodCompilable(method, compLevel, false /*not osr*/);
126  }
127  public native boolean isMethodCompilable(Executable method, int compLevel, boolean isOsr);
128  public native boolean isMethodQueuedForCompilation(Executable method);
129  public        int     deoptimizeMethod(Executable method) {
130    return deoptimizeMethod(method, false /*not osr*/);
131  }
132  public native int     deoptimizeMethod(Executable method, boolean isOsr);
133  public        void    makeMethodNotCompilable(Executable method) {
134    makeMethodNotCompilable(method, -1 /*any*/);
135  }
136  public        void    makeMethodNotCompilable(Executable method, int compLevel) {
137    makeMethodNotCompilable(method, compLevel, false /*not osr*/);
138  }
139  public native void    makeMethodNotCompilable(Executable method, int compLevel, boolean isOsr);
140  public        int     getMethodCompilationLevel(Executable method) {
141    return getMethodCompilationLevel(method, false /*not ost*/);
142  }
143  public native int     getMethodCompilationLevel(Executable method, boolean isOsr);
144  public native boolean testSetDontInlineMethod(Executable method, boolean value);
145  public        int     getCompileQueuesSize() {
146    return getCompileQueueSize(-1 /*any*/);
147  }
148  public native int     getCompileQueueSize(int compLevel);
149  public native boolean testSetForceInlineMethod(Executable method, boolean value);
150  public        boolean enqueueMethodForCompilation(Executable method, int compLevel) {
151    return enqueueMethodForCompilation(method, compLevel, -1 /*InvocationEntryBci*/);
152  }
153  public native boolean enqueueMethodForCompilation(Executable method, int compLevel, int entry_bci);
154  public native void    clearMethodState(Executable method);
155  public native void    lockCompilation();
156  public native void    unlockCompilation();
157  public native int     getMethodEntryBci(Executable method);
158  public native Object[] getNMethod(Executable method, boolean isOsr);
159  public native long    allocateCodeBlob(int size, int type);
160  public        long    allocateCodeBlob(long size, int type) {
161      int intSize = (int) size;
162      if ((long) intSize != size || size < 0) {
163          throw new IllegalArgumentException(
164                "size argument has illegal value " + size);
165      }
166      return allocateCodeBlob( intSize, type);
167  }
168  public native void    freeCodeBlob(long addr);
169  public        void    forceNMethodSweep() {
170    try {
171        forceNMethodSweep0().join();
172    } catch (InterruptedException e) {
173        Thread.currentThread().interrupt();
174    }
175  }
176  public native Thread  forceNMethodSweep0();
177  public native Object[] getCodeHeapEntries(int type);
178  public native int     getCompilationActivityMode();
179  public native Object[] getCodeBlob(long addr);
180
181  // Intered strings
182  public native boolean isInStringTable(String str);
183
184  // Memory
185  public native void readReservedMemory();
186  public native long allocateMetaspace(ClassLoader classLoader, long size);
187  public native void freeMetaspace(ClassLoader classLoader, long addr, long size);
188  public native long incMetaspaceCapacityUntilGC(long increment);
189  public native long metaspaceCapacityUntilGC();
190
191  // Force Young GC
192  public native void youngGC();
193
194  // Force Full GC
195  public native void fullGC();
196
197  // Method tries to start concurrent mark cycle.
198  // It returns false if CM Thread is always in concurrent cycle.
199  public native boolean g1StartConcMarkCycle();
200
201  // Tests on ReservedSpace/VirtualSpace classes
202  public native int stressVirtualSpaceResize(long reservedSpaceSize, long magnitude, long iterations);
203  public native void runMemoryUnitTests();
204  public native void readFromNoaccessArea();
205  public native long getThreadStackSize();
206  public native long getThreadRemainingStackSize();
207
208  // CPU features
209  public native String getCPUFeatures();
210
211  // Native extensions
212  public native long getHeapUsageForContext(int context);
213  public native long getHeapRegionCountForContext(int context);
214  public native int getContextForObject(Object obj);
215  public native void printRegionInfo(int context);
216
217  // VM flags
218  public native boolean isConstantVMFlag(String name);
219  public native boolean isLockedVMFlag(String name);
220  public native void    setBooleanVMFlag(String name, boolean value);
221  public native void    setIntxVMFlag(String name, long value);
222  public native void    setUintxVMFlag(String name, long value);
223  public native void    setUint64VMFlag(String name, long value);
224  public native void    setSizeTVMFlag(String name, long value);
225  public native void    setStringVMFlag(String name, String value);
226  public native void    setDoubleVMFlag(String name, double value);
227  public native Boolean getBooleanVMFlag(String name);
228  public native Long    getIntxVMFlag(String name);
229  public native Long    getUintxVMFlag(String name);
230  public native Long    getUint64VMFlag(String name);
231  public native Long    getSizeTVMFlag(String name);
232  public native String  getStringVMFlag(String name);
233  public native Double  getDoubleVMFlag(String name);
234  private final List<Function<String,Object>> flagsGetters = Arrays.asList(
235    this::getBooleanVMFlag, this::getIntxVMFlag, this::getUintxVMFlag,
236    this::getUint64VMFlag, this::getSizeTVMFlag, this::getStringVMFlag,
237    this::getDoubleVMFlag);
238
239  public Object getVMFlag(String name) {
240    return flagsGetters.stream()
241                       .map(f -> f.apply(name))
242                       .filter(x -> x != null)
243                       .findAny()
244                       .orElse(null);
245  }
246  public native int getOffsetForName0(String name);
247  public int getOffsetForName(String name) throws Exception {
248    int offset = getOffsetForName0(name);
249    if (offset == -1) {
250      throw new RuntimeException(name + " not found");
251    }
252    return offset;
253  }
254  public native Boolean getMethodBooleanOption(Executable method, String name);
255  public native Long    getMethodIntxOption(Executable method, String name);
256  public native Long    getMethodUintxOption(Executable method, String name);
257  public native Double  getMethodDoubleOption(Executable method, String name);
258  public native String  getMethodStringOption(Executable method, String name);
259  private final List<BiFunction<Executable,String,Object>> methodOptionGetters
260      = Arrays.asList(this::getMethodBooleanOption, this::getMethodIntxOption,
261          this::getMethodUintxOption, this::getMethodDoubleOption,
262          this::getMethodStringOption);
263
264  public Object getMethodOption(Executable method, String name) {
265    return methodOptionGetters.stream()
266                              .map(f -> f.apply(method, name))
267                              .filter(x -> x != null)
268                              .findAny()
269                              .orElse(null);
270  }
271
272  // Safepoint Checking
273  public native void assertMatchingSafepointCalls(boolean mutexSafepointValue, boolean attemptedNoSafepointValue);
274}
275