Tue, 16 Aug 2011 04:14:05 -0700
7071653: JSR 292: call site change notification should be pushed not pulled
Reviewed-by: kvn, never, bdelsart
1 /*
2 * Copyright (c) 2005, 2011, 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 */
25 #ifndef SHARE_VM_CODE_DEPENDENCIES_HPP
26 #define SHARE_VM_CODE_DEPENDENCIES_HPP
28 #include "ci/ciCallSite.hpp"
29 #include "ci/ciKlass.hpp"
30 #include "ci/ciMethodHandle.hpp"
31 #include "classfile/systemDictionary.hpp"
32 #include "code/compressedStream.hpp"
33 #include "code/nmethod.hpp"
34 #include "utilities/growableArray.hpp"
36 //** Dependencies represent assertions (approximate invariants) within
37 // the runtime system, e.g. class hierarchy changes. An example is an
38 // assertion that a given method is not overridden; another example is
39 // that a type has only one concrete subtype. Compiled code which
40 // relies on such assertions must be discarded if they are overturned
41 // by changes in the runtime system. We can think of these assertions
42 // as approximate invariants, because we expect them to be overturned
43 // very infrequently. We are willing to perform expensive recovery
44 // operations when they are overturned. The benefit, of course, is
45 // performing optimistic optimizations (!) on the object code.
46 //
47 // Changes in the class hierarchy due to dynamic linking or
48 // class evolution can violate dependencies. There is enough
49 // indexing between classes and nmethods to make dependency
50 // checking reasonably efficient.
52 class ciEnv;
53 class nmethod;
54 class OopRecorder;
55 class xmlStream;
56 class CompileLog;
57 class DepChange;
58 class KlassDepChange;
59 class CallSiteDepChange;
60 class No_Safepoint_Verifier;
62 class Dependencies: public ResourceObj {
63 public:
64 // Note: In the comments on dependency types, most uses of the terms
65 // subtype and supertype are used in a "non-strict" or "inclusive"
66 // sense, and are starred to remind the reader of this fact.
67 // Strict uses of the terms use the word "proper".
68 //
69 // Specifically, every class is its own subtype* and supertype*.
70 // (This trick is easier than continually saying things like "Y is a
71 // subtype of X or X itself".)
72 //
73 // Sometimes we write X > Y to mean X is a proper supertype of Y.
74 // The notation X > {Y, Z} means X has proper subtypes Y, Z.
75 // The notation X.m > Y means that Y inherits m from X, while
76 // X.m > Y.m means Y overrides X.m. A star denotes abstractness,
77 // as *I > A, meaning (abstract) interface I is a super type of A,
78 // or A.*m > B.m, meaning B.m implements abstract method A.m.
79 //
80 // In this module, the terms "subtype" and "supertype" refer to
81 // Java-level reference type conversions, as detected by
82 // "instanceof" and performed by "checkcast" operations. The method
83 // Klass::is_subtype_of tests these relations. Note that "subtype"
84 // is richer than "subclass" (as tested by Klass::is_subclass_of),
85 // since it takes account of relations involving interface and array
86 // types.
87 //
88 // To avoid needless complexity, dependencies involving array types
89 // are not accepted. If you need to make an assertion about an
90 // array type, make the assertion about its corresponding element
91 // types. Any assertion that might change about an array type can
92 // be converted to an assertion about its element type.
93 //
94 // Most dependencies are evaluated over a "context type" CX, which
95 // stands for the set Subtypes(CX) of every Java type that is a subtype*
96 // of CX. When the system loads a new class or interface N, it is
97 // responsible for re-evaluating changed dependencies whose context
98 // type now includes N, that is, all super types of N.
99 //
100 enum DepType {
101 end_marker = 0,
103 // An 'evol' dependency simply notes that the contents of the
104 // method were used. If it evolves (is replaced), the nmethod
105 // must be recompiled. No other dependencies are implied.
106 evol_method,
107 FIRST_TYPE = evol_method,
109 // A context type CX is a leaf it if has no proper subtype.
110 leaf_type,
112 // An abstract class CX has exactly one concrete subtype CC.
113 abstract_with_unique_concrete_subtype,
115 // The type CX is purely abstract, with no concrete subtype* at all.
116 abstract_with_no_concrete_subtype,
118 // The concrete CX is free of concrete proper subtypes.
119 concrete_with_no_concrete_subtype,
121 // Given a method M1 and a context class CX, the set MM(CX, M1) of
122 // "concrete matching methods" in CX of M1 is the set of every
123 // concrete M2 for which it is possible to create an invokevirtual
124 // or invokeinterface call site that can reach either M1 or M2.
125 // That is, M1 and M2 share a name, signature, and vtable index.
126 // We wish to notice when the set MM(CX, M1) is just {M1}, or
127 // perhaps a set of two {M1,M2}, and issue dependencies on this.
129 // The set MM(CX, M1) can be computed by starting with any matching
130 // concrete M2 that is inherited into CX, and then walking the
131 // subtypes* of CX looking for concrete definitions.
133 // The parameters to this dependency are the method M1 and the
134 // context class CX. M1 must be either inherited in CX or defined
135 // in a subtype* of CX. It asserts that MM(CX, M1) is no greater
136 // than {M1}.
137 unique_concrete_method, // one unique concrete method under CX
139 // An "exclusive" assertion concerns two methods or subtypes, and
140 // declares that there are at most two (or perhaps later N>2)
141 // specific items that jointly satisfy the restriction.
142 // We list all items explicitly rather than just giving their
143 // count, for robustness in the face of complex schema changes.
145 // A context class CX (which may be either abstract or concrete)
146 // has two exclusive concrete subtypes* C1, C2 if every concrete
147 // subtype* of CX is either C1 or C2. Note that if neither C1 or C2
148 // are equal to CX, then CX itself must be abstract. But it is
149 // also possible (for example) that C1 is CX (a concrete class)
150 // and C2 is a proper subtype of C1.
151 abstract_with_exclusive_concrete_subtypes_2,
153 // This dependency asserts that MM(CX, M1) is no greater than {M1,M2}.
154 exclusive_concrete_methods_2,
156 // This dependency asserts that no instances of class or it's
157 // subclasses require finalization registration.
158 no_finalizable_subclasses,
160 // This dependency asserts when the CallSite.target value changed.
161 call_site_target_value,
163 TYPE_LIMIT
164 };
165 enum {
166 LG2_TYPE_LIMIT = 4, // assert(TYPE_LIMIT <= (1<<LG2_TYPE_LIMIT))
168 // handy categorizations of dependency types:
169 all_types = ((1<<TYPE_LIMIT)-1) & ((-1)<<FIRST_TYPE),
170 non_ctxk_types = (1<<evol_method),
171 ctxk_types = all_types & ~non_ctxk_types,
173 max_arg_count = 3, // current maximum number of arguments (incl. ctxk)
175 // A "context type" is a class or interface that
176 // provides context for evaluating a dependency.
177 // When present, it is one of the arguments (dep_context_arg).
178 //
179 // If a dependency does not have a context type, there is a
180 // default context, depending on the type of the dependency.
181 // This bit signals that a default context has been compressed away.
182 default_context_type_bit = (1<<LG2_TYPE_LIMIT)
183 };
185 static const char* dep_name(DepType dept);
186 static int dep_args(DepType dept);
187 static int dep_context_arg(DepType dept) {
188 return dept_in_mask(dept, ctxk_types)? 0: -1;
189 }
190 static void check_valid_dependency_type(DepType dept);
192 private:
193 // State for writing a new set of dependencies:
194 GrowableArray<int>* _dep_seen; // (seen[h->ident] & (1<<dept))
195 GrowableArray<ciObject*>* _deps[TYPE_LIMIT];
197 static const char* _dep_name[TYPE_LIMIT];
198 static int _dep_args[TYPE_LIMIT];
200 static bool dept_in_mask(DepType dept, int mask) {
201 return (int)dept >= 0 && dept < TYPE_LIMIT && ((1<<dept) & mask) != 0;
202 }
204 bool note_dep_seen(int dept, ciObject* x) {
205 assert(dept < BitsPerInt, "oob");
206 int x_id = x->ident();
207 assert(_dep_seen != NULL, "deps must be writable");
208 int seen = _dep_seen->at_grow(x_id, 0);
209 _dep_seen->at_put(x_id, seen | (1<<dept));
210 // return true if we've already seen dept/x
211 return (seen & (1<<dept)) != 0;
212 }
214 bool maybe_merge_ctxk(GrowableArray<ciObject*>* deps,
215 int ctxk_i, ciKlass* ctxk);
217 void sort_all_deps();
218 size_t estimate_size_in_bytes();
220 // Initialize _deps, etc.
221 void initialize(ciEnv* env);
223 // State for making a new set of dependencies:
224 OopRecorder* _oop_recorder;
226 // Logging support
227 CompileLog* _log;
229 address _content_bytes; // everything but the oop references, encoded
230 size_t _size_in_bytes;
232 public:
233 // Make a new empty dependencies set.
234 Dependencies(ciEnv* env) {
235 initialize(env);
236 }
238 private:
239 // Check for a valid context type.
240 // Enforce the restriction against array types.
241 static void check_ctxk(ciKlass* ctxk) {
242 assert(ctxk->is_instance_klass(), "java types only");
243 }
244 static void check_ctxk_concrete(ciKlass* ctxk) {
245 assert(is_concrete_klass(ctxk->as_instance_klass()), "must be concrete");
246 }
247 static void check_ctxk_abstract(ciKlass* ctxk) {
248 check_ctxk(ctxk);
249 assert(!is_concrete_klass(ctxk->as_instance_klass()), "must be abstract");
250 }
252 void assert_common_1(DepType dept, ciObject* x);
253 void assert_common_2(DepType dept, ciKlass* ctxk, ciObject* x);
254 void assert_common_3(DepType dept, ciKlass* ctxk, ciObject* x, ciObject* x2);
256 public:
257 // Adding assertions to a new dependency set at compile time:
258 void assert_evol_method(ciMethod* m);
259 void assert_leaf_type(ciKlass* ctxk);
260 void assert_abstract_with_unique_concrete_subtype(ciKlass* ctxk, ciKlass* conck);
261 void assert_abstract_with_no_concrete_subtype(ciKlass* ctxk);
262 void assert_concrete_with_no_concrete_subtype(ciKlass* ctxk);
263 void assert_unique_concrete_method(ciKlass* ctxk, ciMethod* uniqm);
264 void assert_abstract_with_exclusive_concrete_subtypes(ciKlass* ctxk, ciKlass* k1, ciKlass* k2);
265 void assert_exclusive_concrete_methods(ciKlass* ctxk, ciMethod* m1, ciMethod* m2);
266 void assert_has_no_finalizable_subclasses(ciKlass* ctxk);
267 void assert_call_site_target_value(ciKlass* ctxk, ciCallSite* call_site, ciMethodHandle* method_handle);
269 // Define whether a given method or type is concrete.
270 // These methods define the term "concrete" as used in this module.
271 // For this module, an "abstract" class is one which is non-concrete.
272 //
273 // Future optimizations may allow some classes to remain
274 // non-concrete until their first instantiation, and allow some
275 // methods to remain non-concrete until their first invocation.
276 // In that case, there would be a middle ground between concrete
277 // and abstract (as defined by the Java language and VM).
278 static bool is_concrete_klass(klassOop k); // k is instantiable
279 static bool is_concrete_method(methodOop m); // m is invocable
280 static Klass* find_finalizable_subclass(Klass* k);
282 // These versions of the concreteness queries work through the CI.
283 // The CI versions are allowed to skew sometimes from the VM
284 // (oop-based) versions. The cost of such a difference is a
285 // (safely) aborted compilation, or a deoptimization, or a missed
286 // optimization opportunity.
287 //
288 // In order to prevent spurious assertions, query results must
289 // remain stable within any single ciEnv instance. (I.e., they must
290 // not go back into the VM to get their value; they must cache the
291 // bit in the CI, either eagerly or lazily.)
292 static bool is_concrete_klass(ciInstanceKlass* k); // k appears instantiable
293 static bool is_concrete_method(ciMethod* m); // m appears invocable
294 static bool has_finalizable_subclass(ciInstanceKlass* k);
296 // As a general rule, it is OK to compile under the assumption that
297 // a given type or method is concrete, even if it at some future
298 // point becomes abstract. So dependency checking is one-sided, in
299 // that it permits supposedly concrete classes or methods to turn up
300 // as really abstract. (This shouldn't happen, except during class
301 // evolution, but that's the logic of the checking.) However, if a
302 // supposedly abstract class or method suddenly becomes concrete, a
303 // dependency on it must fail.
305 // Checking old assertions at run-time (in the VM only):
306 static klassOop check_evol_method(methodOop m);
307 static klassOop check_leaf_type(klassOop ctxk);
308 static klassOop check_abstract_with_unique_concrete_subtype(klassOop ctxk, klassOop conck,
309 KlassDepChange* changes = NULL);
310 static klassOop check_abstract_with_no_concrete_subtype(klassOop ctxk,
311 KlassDepChange* changes = NULL);
312 static klassOop check_concrete_with_no_concrete_subtype(klassOop ctxk,
313 KlassDepChange* changes = NULL);
314 static klassOop check_unique_concrete_method(klassOop ctxk, methodOop uniqm,
315 KlassDepChange* changes = NULL);
316 static klassOop check_abstract_with_exclusive_concrete_subtypes(klassOop ctxk, klassOop k1, klassOop k2,
317 KlassDepChange* changes = NULL);
318 static klassOop check_exclusive_concrete_methods(klassOop ctxk, methodOop m1, methodOop m2,
319 KlassDepChange* changes = NULL);
320 static klassOop check_has_no_finalizable_subclasses(klassOop ctxk, KlassDepChange* changes = NULL);
321 static klassOop check_call_site_target_value(klassOop ctxk, oop call_site, oop method_handle, CallSiteDepChange* changes = NULL);
322 // A returned klassOop is NULL if the dependency assertion is still
323 // valid. A non-NULL klassOop is a 'witness' to the assertion
324 // failure, a point in the class hierarchy where the assertion has
325 // been proven false. For example, if check_leaf_type returns
326 // non-NULL, the value is a subtype of the supposed leaf type. This
327 // witness value may be useful for logging the dependency failure.
328 // Note that, when a dependency fails, there may be several possible
329 // witnesses to the failure. The value returned from the check_foo
330 // method is chosen arbitrarily.
332 // The 'changes' value, if non-null, requests a limited spot-check
333 // near the indicated recent changes in the class hierarchy.
334 // It is used by DepStream::spot_check_dependency_at.
336 // Detecting possible new assertions:
337 static klassOop find_unique_concrete_subtype(klassOop ctxk);
338 static methodOop find_unique_concrete_method(klassOop ctxk, methodOop m);
339 static int find_exclusive_concrete_subtypes(klassOop ctxk, int klen, klassOop k[]);
340 static int find_exclusive_concrete_methods(klassOop ctxk, int mlen, methodOop m[]);
342 // Create the encoding which will be stored in an nmethod.
343 void encode_content_bytes();
345 address content_bytes() {
346 assert(_content_bytes != NULL, "encode it first");
347 return _content_bytes;
348 }
349 size_t size_in_bytes() {
350 assert(_content_bytes != NULL, "encode it first");
351 return _size_in_bytes;
352 }
354 OopRecorder* oop_recorder() { return _oop_recorder; }
355 CompileLog* log() { return _log; }
357 void copy_to(nmethod* nm);
359 void log_all_dependencies();
360 void log_dependency(DepType dept, int nargs, ciObject* args[]) {
361 write_dependency_to(log(), dept, nargs, args);
362 }
363 void log_dependency(DepType dept,
364 ciObject* x0,
365 ciObject* x1 = NULL,
366 ciObject* x2 = NULL) {
367 if (log() == NULL) return;
368 ciObject* args[max_arg_count];
369 args[0] = x0;
370 args[1] = x1;
371 args[2] = x2;
372 assert(2 < max_arg_count, "");
373 log_dependency(dept, dep_args(dept), args);
374 }
376 static void write_dependency_to(CompileLog* log,
377 DepType dept,
378 int nargs, ciObject* args[],
379 klassOop witness = NULL);
380 static void write_dependency_to(CompileLog* log,
381 DepType dept,
382 int nargs, oop args[],
383 klassOop witness = NULL);
384 static void write_dependency_to(xmlStream* xtty,
385 DepType dept,
386 int nargs, oop args[],
387 klassOop witness = NULL);
388 static void print_dependency(DepType dept,
389 int nargs, oop args[],
390 klassOop witness = NULL);
392 private:
393 // helper for encoding common context types as zero:
394 static ciKlass* ctxk_encoded_as_null(DepType dept, ciObject* x);
396 static klassOop ctxk_encoded_as_null(DepType dept, oop x);
398 public:
399 // Use this to iterate over an nmethod's dependency set.
400 // Works on new and old dependency sets.
401 // Usage:
402 //
403 // ;
404 // Dependencies::DepType dept;
405 // for (Dependencies::DepStream deps(nm); deps.next(); ) {
406 // ...
407 // }
408 //
409 // The caller must be in the VM, since oops are not wrapped in handles.
410 class DepStream {
411 private:
412 nmethod* _code; // null if in a compiler thread
413 Dependencies* _deps; // null if not in a compiler thread
414 CompressedReadStream _bytes;
415 #ifdef ASSERT
416 size_t _byte_limit;
417 #endif
419 // iteration variables:
420 DepType _type;
421 int _xi[max_arg_count+1];
423 void initial_asserts(size_t byte_limit) NOT_DEBUG({});
425 inline oop recorded_oop_at(int i);
426 // => _code? _code->oop_at(i): *_deps->_oop_recorder->handle_at(i)
428 klassOop check_klass_dependency(KlassDepChange* changes);
429 klassOop check_call_site_dependency(CallSiteDepChange* changes);
431 void trace_and_log_witness(klassOop witness);
433 public:
434 DepStream(Dependencies* deps)
435 : _deps(deps),
436 _code(NULL),
437 _bytes(deps->content_bytes())
438 {
439 initial_asserts(deps->size_in_bytes());
440 }
441 DepStream(nmethod* code)
442 : _deps(NULL),
443 _code(code),
444 _bytes(code->dependencies_begin())
445 {
446 initial_asserts(code->dependencies_size());
447 }
449 bool next();
451 DepType type() { return _type; }
452 int argument_count() { return dep_args(type()); }
453 int argument_index(int i) { assert(0 <= i && i < argument_count(), "oob");
454 return _xi[i]; }
455 oop argument(int i); // => recorded_oop_at(argument_index(i))
456 klassOop context_type();
458 methodOop method_argument(int i) {
459 oop x = argument(i);
460 assert(x->is_method(), "type");
461 return (methodOop) x;
462 }
463 klassOop type_argument(int i) {
464 oop x = argument(i);
465 assert(x->is_klass(), "type");
466 return (klassOop) x;
467 }
469 // The point of the whole exercise: Is this dep still OK?
470 klassOop check_dependency() {
471 klassOop result = check_klass_dependency(NULL);
472 if (result != NULL) return result;
473 return check_call_site_dependency(NULL);
474 }
476 // A lighter version: Checks only around recent changes in a class
477 // hierarchy. (See Universe::flush_dependents_on.)
478 klassOop spot_check_dependency_at(DepChange& changes);
480 // Log the current dependency to xtty or compilation log.
481 void log_dependency(klassOop witness = NULL);
483 // Print the current dependency to tty.
484 void print_dependency(klassOop witness = NULL, bool verbose = false);
485 };
486 friend class Dependencies::DepStream;
488 static void print_statistics() PRODUCT_RETURN;
489 };
492 // Every particular DepChange is a sub-class of this class.
493 class DepChange : public StackObj {
494 public:
495 // What kind of DepChange is this?
496 virtual bool is_klass_change() const { return false; }
497 virtual bool is_call_site_change() const { return false; }
499 // Subclass casting with assertions.
500 KlassDepChange* as_klass_change() {
501 assert(is_klass_change(), "bad cast");
502 return (KlassDepChange*) this;
503 }
504 CallSiteDepChange* as_call_site_change() {
505 assert(is_call_site_change(), "bad cast");
506 return (CallSiteDepChange*) this;
507 }
509 void print();
511 public:
512 enum ChangeType {
513 NO_CHANGE = 0, // an uninvolved klass
514 Change_new_type, // a newly loaded type
515 Change_new_sub, // a super with a new subtype
516 Change_new_impl, // an interface with a new implementation
517 CHANGE_LIMIT,
518 Start_Klass = CHANGE_LIMIT // internal indicator for ContextStream
519 };
521 // Usage:
522 // for (DepChange::ContextStream str(changes); str.next(); ) {
523 // klassOop k = str.klass();
524 // switch (str.change_type()) {
525 // ...
526 // }
527 // }
528 class ContextStream : public StackObj {
529 private:
530 DepChange& _changes;
531 friend class DepChange;
533 // iteration variables:
534 ChangeType _change_type;
535 klassOop _klass;
536 objArrayOop _ti_base; // i.e., transitive_interfaces
537 int _ti_index;
538 int _ti_limit;
540 // start at the beginning:
541 void start();
543 public:
544 ContextStream(DepChange& changes)
545 : _changes(changes)
546 { start(); }
548 ContextStream(DepChange& changes, No_Safepoint_Verifier& nsv)
549 : _changes(changes)
550 // the nsv argument makes it safe to hold oops like _klass
551 { start(); }
553 bool next();
555 ChangeType change_type() { return _change_type; }
556 klassOop klass() { return _klass; }
557 };
558 friend class DepChange::ContextStream;
559 };
562 // A class hierarchy change coming through the VM (under the Compile_lock).
563 // The change is structured as a single new type with any number of supers
564 // and implemented interface types. Other than the new type, any of the
565 // super types can be context types for a relevant dependency, which the
566 // new type could invalidate.
567 class KlassDepChange : public DepChange {
568 private:
569 // each change set is rooted in exactly one new type (at present):
570 KlassHandle _new_type;
572 void initialize();
574 public:
575 // notes the new type, marks it and all its super-types
576 KlassDepChange(KlassHandle new_type)
577 : _new_type(new_type)
578 {
579 initialize();
580 }
582 // cleans up the marks
583 ~KlassDepChange();
585 // What kind of DepChange is this?
586 virtual bool is_klass_change() const { return true; }
588 klassOop new_type() { return _new_type(); }
590 // involves_context(k) is true if k is new_type or any of the super types
591 bool involves_context(klassOop k);
592 };
595 // A CallSite has changed its target.
596 class CallSiteDepChange : public DepChange {
597 private:
598 Handle _call_site;
599 Handle _method_handle;
601 public:
602 CallSiteDepChange(Handle call_site, Handle method_handle)
603 : _call_site(call_site),
604 _method_handle(method_handle)
605 {
606 assert(_call_site() ->is_a(SystemDictionary::CallSite_klass()), "must be");
607 assert(_method_handle()->is_a(SystemDictionary::MethodHandle_klass()), "must be");
608 }
610 // What kind of DepChange is this?
611 virtual bool is_call_site_change() const { return true; }
613 oop call_site() const { return _call_site(); }
614 oop method_handle() const { return _method_handle(); }
615 };
617 #endif // SHARE_VM_CODE_DEPENDENCIES_HPP