1 /* src/threads/native/lock.h - lock implementation
3 Copyright (C) 1996-2005, 2006 R. Grafl, A. Krall, C. Kruegel,
4 C. Oates, R. Obermaisser, M. Platter, M. Probst, S. Ring,
5 E. Steiner, C. Thalinger, D. Thuernbeck, P. Tomsich, C. Ullrich,
6 J. Wenninger, Institut f. Computersprachen - TU Wien
8 This file is part of CACAO.
10 This program is free software; you can redistribute it and/or
11 modify it under the terms of the GNU General Public License as
12 published by the Free Software Foundation; either version 2, or (at
13 your option) any later version.
15 This program is distributed in the hope that it will be useful, but
16 WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program; if not, write to the Free Software
22 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
25 Contact: cacao@cacaojvm.org
27 Authors: Edwin Steiner
29 Changes: Christian Thalinger
31 $Id: threads.h 4866 2006-05-01 21:40:38Z edwin $
41 #include "vm/global.h"
46 /* typedefs *******************************************************************/
48 typedef struct lock_execution_env_t lock_execution_env_t;
49 typedef struct lock_record_t lock_record_t;
50 typedef struct lock_record_pool_header_t lock_record_pool_header_t;
51 typedef struct lock_record_pool_t lock_record_pool_t;
52 typedef struct lock_waiter_t lock_waiter_t;
53 typedef struct lock_hashtable_t lock_hashtable_t;
56 /* lock_execution_env_t ********************************************************
58 Execution environment. Contains the lock record freelist and pools.
60 *******************************************************************************/
62 struct lock_execution_env_t {
63 lock_record_t *firstfree; /* lock record freelist */
64 lock_record_pool_t *lockrecordpools; /* list of per-thread pools */
65 int lockrecordcount; /* # of records for this thread */
69 /* lock_waiter_t ***************************************************************
71 List node for storing a waiting thread.
73 *******************************************************************************/
75 struct lock_waiter_t {
76 struct threadobject *waiter; /* the waiting thread */
77 lock_waiter_t *next; /* next in list */
81 /* lock_record_t ***************************************************************
83 Lock record struct representing an inflated ("fat") lock.
85 *******************************************************************************/
87 struct lock_record_t {
88 java_objectheader *obj; /* object for which this lock is */
89 struct threadobject *owner; /* current owner of this monitor */
90 s4 count; /* recursive lock count */
91 pthread_mutex_t mutex; /* mutex for synchronizing */
92 lock_waiter_t *waiters; /* list of threads waiting */
93 lock_record_t *nextfree; /* next in free list */
94 lock_record_t *hashlink; /* next record in hash chain */
98 /* lock_hashtable_t ************************************************************
100 The global hashtable mapping objects to lock records.
102 *******************************************************************************/
104 struct lock_hashtable_t {
105 pthread_mutex_t mutex; /* mutex for synch. access to the table */
106 u4 size; /* number of slots */
107 u4 entries; /* current number of entries */
108 lock_record_t **ptr; /* the table of slots, uses ext. chain. */
112 /* lock_record_pool_header_t ***************************************************
114 Lock records are allocated in pools. Each pool has on of these headers.
116 *******************************************************************************/
118 struct lock_record_pool_header_t {
119 lock_record_pool_t *next; /* next pool */
120 int size; /* records in this pool */
124 /* lock_record_pool_t **********************************************************
126 Lock records are allocated in such pools.
128 *******************************************************************************/
130 struct lock_record_pool_t {
131 lock_record_pool_header_t header; /* pool header (see above) */
132 lock_record_t lr[1]; /* variable array of records */
135 #if defined(ENABLE_JVMTI)
136 extern pthread_mutex_t lock_global_pool_lock;
137 extern lock_record_pool_t *lock_global_pool;
141 /* functions ******************************************************************/
143 void lock_init(void);
145 void lock_init_execution_env(struct threadobject *thread);
146 void lock_record_free_pools(lock_record_pool_t *pool);
148 void lock_init_object_lock(java_objectheader *);
149 lock_record_t *lock_get_initial_lock_word(void);
151 ptrint lock_pre_compute_thinlock(s4 index);
153 void lock_monitor_enter(java_objectheader *);
154 bool lock_monitor_exit(java_objectheader *);
156 #define LOCK_monitor_enter (functionptr) lock_monitor_enter
157 #define LOCK_monitor_exit (functionptr) lock_monitor_exit
159 #define LOCK_MONITOR_ENTER(o) lock_monitor_enter((java_objectheader *) (o))
160 #define LOCK_MONITOR_EXIT(o) lock_monitor_exit((java_objectheader *) (o))
162 bool lock_is_held_by_current_thread(java_objectheader *o);
164 void lock_wait_for_object(java_objectheader *o, s8 millis, s4 nanos);
165 void lock_notify_object(java_objectheader *o);
166 void lock_notify_all_object(java_objectheader *o);
172 * These are local overrides for various environment variables in Emacs.
173 * Please do not remove this and leave it at the end of the file, where
174 * Emacs will automagically detect them.
175 * ---------------------------------------------------------------------
178 * indent-tabs-mode: t
182 * vim:noexpandtab:sw=4:ts=4: