1 /*
2 * Copyright (c) 2012, 2019, 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 package sun.hotspot;
26
27 import java.lang.management.MemoryUsage;
28 import java.lang.reflect.Executable;
29 import java.util.Arrays;
30 import java.util.List;
31 import java.util.function.Function;
32 import java.util.stream.Stream;
33 import java.security.BasicPermission;
34 import java.net.URL;
35
36 import sun.hotspot.parser.DiagnosticCommand;
37
38 public 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 long getVMLargePageSize();
81
82 public native boolean isObjectInOldGen(Object o);
83 public native long getObjectSize(Object o);
84
85 // Runtime
86 // Make sure class name is in the correct format
87 public boolean isClassAlive(String name) {
88 return isClassAlive0(name.replace('.', '/'));
89 }
90 private native boolean isClassAlive0(String name);
91 public native boolean isMonitorInflated(Object obj);
92 public native void forceSafepoint();
93
94 // Resource/Class Lookup Cache
95 public native boolean classKnownToNotExist(ClassLoader loader, String name);
96 public native URL[] getLookupCacheURLs(ClassLoader loader);
97 public native int[] getLookupCacheMatches(ClassLoader loader, String name);
98
99 // JVMTI
100 public native void addToBootstrapClassLoaderSearch(String segment);
101 public native void addToSystemClassLoaderSearch(String segment);
102
103 // G1
104 public native boolean g1InConcurrentMark();
105 public native boolean g1IsHumongous(Object o);
106 public native long g1NumMaxRegions();
107 public native long g1NumFreeRegions();
108 public native int g1RegionSize();
109 public native MemoryUsage g1AuxiliaryMemoryUsage();
110 public native Object[] parseCommandLine(String commandline, DiagnosticCommand[] args);
111
112 // NMT
113 public native long NMTMalloc(long size);
114 public native void NMTFree(long mem);
115 public native long NMTReserveMemory(long size);
116 public native void NMTCommitMemory(long addr, long size);
117 public native void NMTUncommitMemory(long addr, long size);
118 public native void NMTReleaseMemory(long addr, long size);
119 public native long NMTMallocWithPseudoStack(long size, int index);
120 public native long NMTMallocWithPseudoStackAndType(long size, int index, int type);
121 public native boolean NMTIsDetailSupported();
122 public native boolean NMTChangeTrackingLevel();
123 public native int NMTGetHashSize();
124
125 // Compiler
126 public native void deoptimizeAll();
127 public boolean isMethodCompiled(Executable method) {
128 return isMethodCompiled(method, false /*not osr*/);
129 }
130 public native boolean isMethodCompiled(Executable method, boolean isOsr);
131 public boolean isMethodCompilable(Executable method) {
132 return isMethodCompilable(method, -1 /*any*/);
133 }
134 public boolean isMethodCompilable(Executable method, int compLevel) {
135 return isMethodCompilable(method, compLevel, false /*not osr*/);
136 }
137 public native boolean isMethodCompilable(Executable method, int compLevel, boolean isOsr);
138 public native boolean isMethodQueuedForCompilation(Executable method);
139 public int deoptimizeMethod(Executable method) {
140 return deoptimizeMethod(method, false /*not osr*/);
141 }
142 public native int deoptimizeMethod(Executable method, boolean isOsr);
143 public void makeMethodNotCompilable(Executable method) {
144 makeMethodNotCompilable(method, -1 /*any*/);
145 }
146 public void makeMethodNotCompilable(Executable method, int compLevel) {
147 makeMethodNotCompilable(method, compLevel, false /*not osr*/);
148 }
149 public native void makeMethodNotCompilable(Executable method, int compLevel, boolean isOsr);
150 public int getMethodCompilationLevel(Executable method) {
151 return getMethodCompilationLevel(method, false /*not ost*/);
152 }
153 public native int getMethodCompilationLevel(Executable method, boolean isOsr);
154 public native boolean testSetDontInlineMethod(Executable method, boolean value);
155 public int getCompileQueuesSize() {
156 return getCompileQueueSize(-1 /*any*/);
157 }
158 public native int getCompileQueueSize(int compLevel);
159 public native boolean testSetForceInlineMethod(Executable method, boolean value);
160 public boolean enqueueMethodForCompilation(Executable method, int compLevel) {
161 return enqueueMethodForCompilation(method, compLevel, -1 /*InvocationEntryBci*/);
162 }
163 public native boolean enqueueMethodForCompilation(Executable method, int compLevel, int entry_bci);
164 public native void clearMethodState(Executable method);
165 public native int getMethodEntryBci(Executable method);
166 public native Object[] getNMethod(Executable method, boolean isOsr);
167
168 // Intered strings
169 public native boolean isInStringTable(String str);
170
171 // Memory
172 public native void readReservedMemory();
173 public native long allocateMetaspace(ClassLoader classLoader, long size);
174 public native void freeMetaspace(ClassLoader classLoader, long addr, long size);
175 public native long incMetaspaceCapacityUntilGC(long increment);
176 public native long metaspaceCapacityUntilGC();
177
178 // Force Young GC
179 public native void youngGC();
180
181 // Force Full GC
182 public native void fullGC();
183
184 // Method tries to start concurrent mark cycle.
185 // It returns false if CM Thread is always in concurrent cycle.
186 public native boolean g1StartConcMarkCycle();
187
188 // Tests on ReservedSpace/VirtualSpace classes
189 public native int stressVirtualSpaceResize(long reservedSpaceSize, long magnitude, long iterations);
190 public native void runMemoryUnitTests();
191 public native void readFromNoaccessArea();
192 public native long getThreadStackSize();
193 public native long getThreadRemainingStackSize();
194
195 // CPU features
196 public native String getCPUFeatures();
197
198 // Native extensions
199 public native long getHeapUsageForContext(int context);
200 public native long getHeapRegionCountForContext(int context);
201 public native int getContextForObject(Object obj);
202 public native void printRegionInfo(int context);
203
204 // VM flags
205 public native void setBooleanVMFlag(String name, boolean value);
206 public native void setIntxVMFlag(String name, long value);
207 public native void setUintxVMFlag(String name, long value);
208 public native void setUint64VMFlag(String name, long value);
209 public native void setStringVMFlag(String name, String value);
210 public native void setDoubleVMFlag(String name, double value);
211 public native Boolean getBooleanVMFlag(String name);
212 public native Long getIntxVMFlag(String name);
213 public native Long getUintxVMFlag(String name);
214 public native Long getUint64VMFlag(String name);
215 public native String getStringVMFlag(String name);
216 public native Double getDoubleVMFlag(String name);
217 private final List<Function<String,Object>> flagsGetters = Arrays.asList(
218 this::getBooleanVMFlag, this::getIntxVMFlag, this::getUintxVMFlag,
219 this::getUint64VMFlag, this::getStringVMFlag, this::getDoubleVMFlag);
220
221 public Object getVMFlag(String name) {
222 return flagsGetters.stream()
223 .map(f -> f.apply(name))
224 .filter(x -> x != null)
225 .findAny()
226 .orElse(null);
227 }
228 public native int getOffsetForName0(String name);
229 public int getOffsetForName(String name) throws Exception {
230 int offset = getOffsetForName0(name);
231 if (offset == -1) {
232 throw new RuntimeException(name + " not found");
233 }
234 return offset;
235 }
236
237 // Class Data Sharing
238 public native boolean isSharedClass(Class<?> c);
239
240 // Returns true on linux if library has the noexecstack flag set.
241 public native boolean checkLibSpecifiesNoexecstack(String libfilename);
242
243 // Container testing
244 public native boolean isContainerized();
245 public native void printOsInfo();
246
247 }