• file
• revisions
• annotate
• diff
• comparison
• raw

src/share/vm/oops/oop.hpp@75b0f3cb1943 (annotated)

src/share/vm/oops/oop.hpp

Thu, 13 Mar 2008 14:17:48 -0700

author

dcubed

date

Thu, 13 Mar 2008 14:17:48 -0700

changeset 487

75b0f3cb1943

parent 435

a61af66fc99e

child 548

ba764ed4b6f2

permissions

-rw-r--r--

Merge

duke@435	1	/*
duke@435	2	* Copyright 1997-2007 Sun Microsystems, Inc. All Rights Reserved.
duke@435	3	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@435	4	*
duke@435	5	* This code is free software; you can redistribute it and/or modify it
duke@435	6	* under the terms of the GNU General Public License version 2 only, as
duke@435	7	* published by the Free Software Foundation.
duke@435	8	*
duke@435	9	* This code is distributed in the hope that it will be useful, but WITHOUT
duke@435	10	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@435	11	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@435	12	* version 2 for more details (a copy is included in the LICENSE file that
duke@435	13	* accompanied this code).
duke@435	14	*
duke@435	15	* You should have received a copy of the GNU General Public License version
duke@435	16	* 2 along with this work; if not, write to the Free Software Foundation,
duke@435	17	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@435	18	*
duke@435	19	* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
duke@435	20	* CA 95054 USA or visit www.sun.com if you need additional information or
duke@435	21	* have any questions.
duke@435	22	*
duke@435	23	*/
duke@435	24
duke@435	25	// oopDesc is the top baseclass for objects classes. The {name}Desc classes describe
duke@435	26	// the format of Java objects so the fields can be accessed from C++.
duke@435	27	// oopDesc is abstract.
duke@435	28	// (see oopHierarchy for complete oop class hierarchy)
duke@435	29	//
duke@435	30	// no virtual functions allowed
duke@435	31
duke@435	32	// store into oop with store check
duke@435	33	void oop_store(oop* p, oop v);
duke@435	34	void oop_store(volatile oop* p, oop v);
duke@435	35
duke@435	36	// store into oop without store check
duke@435	37	void oop_store_without_check(oop* p, oop v);
duke@435	38	void oop_store_without_check(volatile oop* p, oop v);
duke@435	39
duke@435	40
duke@435	41	extern bool always_do_update_barrier;
duke@435	42
duke@435	43	// Forward declarations.
duke@435	44	class OopClosure;
duke@435	45	class ScanClosure;
duke@435	46	class FastScanClosure;
duke@435	47	class FilteringClosure;
duke@435	48	class BarrierSet;
duke@435	49	class CMSIsAliveClosure;
duke@435	50
duke@435	51	class PSPromotionManager;
duke@435	52	class ParCompactionManager;
duke@435	53
duke@435	54	class oopDesc {
duke@435	55	friend class VMStructs;
duke@435	56	private:
duke@435	57	volatile markOop _mark;
duke@435	58	klassOop _klass;
duke@435	59
duke@435	60	// Fast access to barrier set. Must be initialized.
duke@435	61	static BarrierSet* _bs;
duke@435	62
duke@435	63	public:
duke@435	64	markOop mark() const { return _mark; }
duke@435	65	markOop* mark_addr() const { return (markOop*) &_mark; }
duke@435	66
duke@435	67	void set_mark(volatile markOop m) { _mark = m; }
duke@435	68
duke@435	69	void release_set_mark(markOop m);
duke@435	70	markOop cas_set_mark(markOop new_mark, markOop old_mark);
duke@435	71
duke@435	72	// Used only to re-initialize the mark word (e.g., of promoted
duke@435	73	// objects during a GC) -- requires a valid klass pointer
duke@435	74	void init_mark();
duke@435	75
duke@435	76	klassOop klass() const { return _klass; }
duke@435	77	oop* klass_addr() const { return (oop*) &_klass; }
duke@435	78
duke@435	79	void set_klass(klassOop k);
duke@435	80	// For when the klass pointer is being used as a linked list "next" field.
duke@435	81	void set_klass_to_list_ptr(oop k);
duke@435	82
duke@435	83	// size of object header
duke@435	84	static int header_size() { return sizeof(oopDesc)/HeapWordSize; }
duke@435	85	static int header_size_in_bytes() { return sizeof(oopDesc); }
duke@435	86
duke@435	87	Klass* blueprint() const;
duke@435	88
duke@435	89	// Returns whether this is an instance of k or an instance of a subclass of k
duke@435	90	bool is_a(klassOop k) const;
duke@435	91
duke@435	92	// Returns the actual oop size of the object
duke@435	93	int size();
duke@435	94
duke@435	95	// Sometimes (for complicated concurrency-related reasons), it is useful
duke@435	96	// to be able to figure out the size of an object knowing its klass.
duke@435	97	int size_given_klass(Klass* klass);
duke@435	98
duke@435	99	// Some perm gen objects are not parseble immediately after
duke@435	100	// installation of their klass pointer.
duke@435	101	bool is_parsable();
duke@435	102
duke@435	103	// type test operations (inlined in oop.inline.h)
duke@435	104	bool is_instance() const;
duke@435	105	bool is_instanceRef() const;
duke@435	106	bool is_array() const;
duke@435	107	bool is_objArray() const;
duke@435	108	bool is_symbol() const;
duke@435	109	bool is_klass() const;
duke@435	110	bool is_thread() const;
duke@435	111	bool is_method() const;
duke@435	112	bool is_constMethod() const;
duke@435	113	bool is_methodData() const;
duke@435	114	bool is_constantPool() const;
duke@435	115	bool is_constantPoolCache() const;
duke@435	116	bool is_typeArray() const;
duke@435	117	bool is_javaArray() const;
duke@435	118	bool is_compiledICHolder() const;
duke@435	119
duke@435	120	private:
duke@435	121	// field addresses in oop
duke@435	122	// byte/char/bool/short fields are always stored as full words
duke@435	123	void* field_base(int offset) const;
duke@435	124
duke@435	125	jbyte* byte_field_addr(int offset) const;
duke@435	126	jchar* char_field_addr(int offset) const;
duke@435	127	jboolean* bool_field_addr(int offset) const;
duke@435	128	jint* int_field_addr(int offset) const;
duke@435	129	jshort* short_field_addr(int offset) const;
duke@435	130	jlong* long_field_addr(int offset) const;
duke@435	131	jfloat* float_field_addr(int offset) const;
duke@435	132	jdouble* double_field_addr(int offset) const;
duke@435	133
duke@435	134	public:
duke@435	135	// need this as public for garbage collection
duke@435	136	oop* obj_field_addr(int offset) const;
duke@435	137
duke@435	138	oop obj_field(int offset) const;
duke@435	139	void obj_field_put(int offset, oop value);
duke@435	140
duke@435	141	jbyte byte_field(int offset) const;
duke@435	142	void byte_field_put(int offset, jbyte contents);
duke@435	143
duke@435	144	jchar char_field(int offset) const;
duke@435	145	void char_field_put(int offset, jchar contents);
duke@435	146
duke@435	147	jboolean bool_field(int offset) const;
duke@435	148	void bool_field_put(int offset, jboolean contents);
duke@435	149
duke@435	150	jint int_field(int offset) const;
duke@435	151	void int_field_put(int offset, jint contents);
duke@435	152
duke@435	153	jshort short_field(int offset) const;
duke@435	154	void short_field_put(int offset, jshort contents);
duke@435	155
duke@435	156	jlong long_field(int offset) const;
duke@435	157	void long_field_put(int offset, jlong contents);
duke@435	158
duke@435	159	jfloat float_field(int offset) const;
duke@435	160	void float_field_put(int offset, jfloat contents);
duke@435	161
duke@435	162	jdouble double_field(int offset) const;
duke@435	163	void double_field_put(int offset, jdouble contents);
duke@435	164
duke@435	165	oop obj_field_acquire(int offset) const;
duke@435	166	void release_obj_field_put(int offset, oop value);
duke@435	167
duke@435	168	jbyte byte_field_acquire(int offset) const;
duke@435	169	void release_byte_field_put(int offset, jbyte contents);
duke@435	170
duke@435	171	jchar char_field_acquire(int offset) const;
duke@435	172	void release_char_field_put(int offset, jchar contents);
duke@435	173
duke@435	174	jboolean bool_field_acquire(int offset) const;
duke@435	175	void release_bool_field_put(int offset, jboolean contents);
duke@435	176
duke@435	177	jint int_field_acquire(int offset) const;
duke@435	178	void release_int_field_put(int offset, jint contents);
duke@435	179
duke@435	180	jshort short_field_acquire(int offset) const;
duke@435	181	void release_short_field_put(int offset, jshort contents);
duke@435	182
duke@435	183	jlong long_field_acquire(int offset) const;
duke@435	184	void release_long_field_put(int offset, jlong contents);
duke@435	185
duke@435	186	jfloat float_field_acquire(int offset) const;
duke@435	187	void release_float_field_put(int offset, jfloat contents);
duke@435	188
duke@435	189	jdouble double_field_acquire(int offset) const;
duke@435	190	void release_double_field_put(int offset, jdouble contents);
duke@435	191
duke@435	192	// printing functions for VM debugging
duke@435	193	void print_on(outputStream* st) const; // First level print
duke@435	194	void print_value_on(outputStream* st) const; // Second level print.
duke@435	195	void print_address_on(outputStream* st) const; // Address printing
duke@435	196
duke@435	197	// printing on default output stream
duke@435	198	void print();
duke@435	199	void print_value();
duke@435	200	void print_address();
duke@435	201
duke@435	202	// return the print strings
duke@435	203	char* print_string();
duke@435	204	char* print_value_string();
duke@435	205
duke@435	206	// verification operations
duke@435	207	void verify_on(outputStream* st);
duke@435	208	void verify();
duke@435	209	void verify_old_oop(oop* p, bool allow_dirty);
duke@435	210
duke@435	211	// tells whether this oop is partially constructed (gc during class loading)
duke@435	212	bool partially_loaded();
duke@435	213	void set_partially_loaded();
duke@435	214
duke@435	215	// locking operations
duke@435	216	bool is_locked() const;
duke@435	217	bool is_unlocked() const;
duke@435	218	bool has_bias_pattern() const;
duke@435	219
duke@435	220	// asserts
duke@435	221	bool is_oop(bool ignore_mark_word = false) const;
duke@435	222	bool is_oop_or_null(bool ignore_mark_word = false) const;
duke@435	223	#ifndef PRODUCT
duke@435	224	bool is_unlocked_oop() const;
duke@435	225	#endif
duke@435	226
duke@435	227	// garbage collection
duke@435	228	bool is_gc_marked() const;
duke@435	229	// Apply "MarkSweep::mark_and_push" to (the address of) every non-NULL
duke@435	230	// reference field in "this".
duke@435	231	void follow_contents();
duke@435	232	void follow_header();
duke@435	233
duke@435	234	#ifndef SERIALGC
duke@435	235	// Parallel Scavenge
duke@435	236	void copy_contents(PSPromotionManager* pm);
duke@435	237	void push_contents(PSPromotionManager* pm);
duke@435	238
duke@435	239	// Parallel Old
duke@435	240	void update_contents(ParCompactionManager* cm);
duke@435	241	void update_contents(ParCompactionManager* cm,
duke@435	242	HeapWord* begin_limit,
duke@435	243	HeapWord* end_limit);
duke@435	244	void update_contents(ParCompactionManager* cm,
duke@435	245	klassOop old_klass,
duke@435	246	HeapWord* begin_limit,
duke@435	247	HeapWord* end_limit);
duke@435	248
duke@435	249	void follow_contents(ParCompactionManager* cm);
duke@435	250	void follow_header(ParCompactionManager* cm);
duke@435	251	#endif // SERIALGC
duke@435	252
duke@435	253	bool is_perm() const;
duke@435	254	bool is_perm_or_null() const;
duke@435	255	bool is_shared() const;
duke@435	256	bool is_shared_readonly() const;
duke@435	257	bool is_shared_readwrite() const;
duke@435	258
duke@435	259	// Forward pointer operations for scavenge
duke@435	260	bool is_forwarded() const;
duke@435	261
duke@435	262	void forward_to(oop p);
duke@435	263	bool cas_forward_to(oop p, markOop compare);
duke@435	264
duke@435	265	#ifndef SERIALGC
duke@435	266	// Like "forward_to", but inserts the forwarding pointer atomically.
duke@435	267	// Exactly one thread succeeds in inserting the forwarding pointer, and
duke@435	268	// this call returns "NULL" for that thread; any other thread has the
duke@435	269	// value of the forwarding pointer returned and does not modify "this".
duke@435	270	oop forward_to_atomic(oop p);
duke@435	271	#endif // SERIALGC
duke@435	272
duke@435	273	oop forwardee() const;
duke@435	274
duke@435	275	// Age of object during scavenge
duke@435	276	int age() const;
duke@435	277	void incr_age();
duke@435	278
duke@435	279	// Adjust all pointers in this object to point at it's forwarded location and
duke@435	280	// return the size of this oop. This is used by the MarkSweep collector.
duke@435	281	int adjust_pointers();
duke@435	282	void adjust_header();
duke@435	283
duke@435	284	#ifndef SERIALGC
duke@435	285	// Parallel old
duke@435	286	void update_header();
duke@435	287	void update_header(HeapWord* beg_addr, HeapWord* end_addr);
duke@435	288	#endif // SERIALGC
duke@435	289
duke@435	290	// mark-sweep support
duke@435	291	void follow_body(int begin, int end);
duke@435	292
duke@435	293	// Fast access to barrier set
duke@435	294	static BarrierSet* bs() { return _bs; }
duke@435	295	static void set_bs(BarrierSet* bs) { _bs = bs; }
duke@435	296
duke@435	297	// iterators, returns size of object
duke@435	298	#define OOP_ITERATE_DECL(OopClosureType, nv_suffix) \
duke@435	299	int oop_iterate(OopClosureType* blk); \
duke@435	300	int oop_iterate(OopClosureType* blk, MemRegion mr); // Only in mr.
duke@435	301
duke@435	302	ALL_OOP_OOP_ITERATE_CLOSURES_1(OOP_ITERATE_DECL)
duke@435	303	ALL_OOP_OOP_ITERATE_CLOSURES_3(OOP_ITERATE_DECL)
duke@435	304
duke@435	305	void oop_iterate_header(OopClosure* blk);
duke@435	306	void oop_iterate_header(OopClosure* blk, MemRegion mr);
duke@435	307
duke@435	308	// identity hash; returns the identity hash key (computes it if necessary)
duke@435	309	// NOTE with the introduction of UseBiasedLocking that identity_hash() might reach a
duke@435	310	// safepoint if called on a biased object. Calling code must be aware of that.
duke@435	311	intptr_t identity_hash();
duke@435	312	intptr_t slow_identity_hash();
duke@435	313
duke@435	314	// marks are forwarded to stack when object is locked
duke@435	315	bool has_displaced_mark() const;
duke@435	316	markOop displaced_mark() const;
duke@435	317	void set_displaced_mark(markOop m);
duke@435	318
duke@435	319	// for code generation
duke@435	320	static int klass_offset_in_bytes() { return offset_of(oopDesc, _klass); }
duke@435	321	static int mark_offset_in_bytes() { return offset_of(oopDesc, _mark); }
duke@435	322	};