2 * Copyright (c) 2000,2003 Doug Rabson
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 #include <sys/cdefs.h>
28 __FBSDID("$FreeBSD$");
30 #include <sys/param.h>
31 #include <sys/kernel.h>
34 #include <sys/malloc.h>
35 #include <sys/mutex.h>
36 #include <sys/sysctl.h>
38 #include <sys/systm.h>
45 static MALLOC_DEFINE(M_KOBJ, "kobj", "Kernel object structures");
49 u_int kobj_lookup_hits;
50 u_int kobj_lookup_misses;
52 SYSCTL_UINT(_kern, OID_AUTO, kobj_hits, CTLFLAG_RD,
53 &kobj_lookup_hits, 0, "");
54 SYSCTL_UINT(_kern, OID_AUTO, kobj_misses, CTLFLAG_RD,
55 &kobj_lookup_misses, 0, "");
59 static struct mtx kobj_mtx;
60 static int kobj_mutex_inited;
61 static int kobj_next_id = 1;
64 * In the event that kobj_mtx has not been initialized yet,
65 * we will ignore it, and run without locks in order to support
66 * use of KOBJ before mutexes are available. This early in the boot
67 * process, everything is single threaded and so races should not
68 * happen. This is used to provide the PMAP layer on PowerPC, as well
72 #define KOBJ_LOCK() if (kobj_mutex_inited) mtx_lock(&kobj_mtx);
73 #define KOBJ_UNLOCK() if (kobj_mutex_inited) mtx_unlock(&kobj_mtx);
74 #define KOBJ_ASSERT(what) if (kobj_mutex_inited) mtx_assert(&kobj_mtx,what);
76 SYSCTL_UINT(_kern, OID_AUTO, kobj_methodcount, CTLFLAG_RD,
77 &kobj_next_id, 0, "");
80 kobj_init_mutex(void *arg)
82 if (!kobj_mutex_inited) {
83 mtx_init(&kobj_mtx, "kobj", NULL, MTX_DEF);
84 kobj_mutex_inited = 1;
88 SYSINIT(kobj, SI_SUB_LOCK, SI_ORDER_ANY, kobj_init_mutex, NULL);
91 * This method structure is used to initialise new caches. Since the
92 * desc pointer is NULL, it is guaranteed never to match any read
95 static struct kobj_method null_method = {
100 kobj_error_method(void)
107 kobj_register_method(struct kobjop_desc *desc)
109 KOBJ_ASSERT(MA_OWNED);
112 desc->id = kobj_next_id++;
117 kobj_unregister_method(struct kobjop_desc *desc)
122 kobj_class_compile_common(kobj_class_t cls, kobj_ops_t ops)
127 KOBJ_ASSERT(MA_OWNED);
130 * Don't do anything if we are already compiled.
136 * First register any methods which need it.
138 for (i = 0, m = cls->methods; m->desc; i++, m++)
139 kobj_register_method(m->desc);
142 * Then initialise the ops table.
144 for (i = 0; i < KOBJ_CACHE_SIZE; i++)
145 ops->cache[i] = &null_method;
151 kobj_class_compile(kobj_class_t cls)
155 KOBJ_ASSERT(MA_NOTOWNED);
158 * Allocate space for the compiled ops table.
160 ops = malloc(sizeof(struct kobj_ops), M_KOBJ, M_NOWAIT);
162 panic("kobj_compile_methods: out of memory");
167 * We may have lost a race for kobj_class_compile here - check
168 * to make sure someone else hasn't already compiled this
177 kobj_class_compile_common(cls, ops);
182 kobj_class_compile_static(kobj_class_t cls, kobj_ops_t ops)
185 KOBJ_ASSERT(MA_NOTOWNED);
188 * Increment refs to make sure that the ops table is not freed.
193 kobj_class_compile_common(cls, ops);
198 static kobj_method_t*
199 kobj_lookup_method_class(kobj_class_t cls, kobjop_desc_t desc)
201 kobj_method_t *methods = cls->methods;
204 for (ce = methods; ce && ce->desc; ce++) {
205 if (ce->desc == desc) {
213 static kobj_method_t*
214 kobj_lookup_method_mi(kobj_class_t cls,
220 ce = kobj_lookup_method_class(cls, desc);
224 basep = cls->baseclasses;
226 for (; *basep; basep++) {
227 ce = kobj_lookup_method_mi(*basep, desc);
237 kobj_lookup_method(kobj_class_t cls,
245 * Correct for the 'hit' assumption in KOBJOPLOOKUP and record
249 kobj_lookup_misses++;
252 ce = kobj_lookup_method_mi(cls, desc);
260 kobj_class_free(kobj_class_t cls)
266 KOBJ_ASSERT(MA_NOTOWNED);
270 * Protect against a race between kobj_create and
273 if (cls->refs == 0) {
275 * Unregister any methods which are no longer used.
277 for (i = 0, m = cls->methods; m->desc; i++, m++)
278 kobj_unregister_method(m->desc);
281 * Free memory and clean up.
294 kobj_create(kobj_class_t cls,
295 struct malloc_type *mtype,
301 * Allocate and initialise the new object.
303 obj = malloc(cls->size, mtype, mflags | M_ZERO);
312 kobj_init(kobj_t obj, kobj_class_t cls)
314 KOBJ_ASSERT(MA_NOTOWNED);
319 * Consider compiling the class' method table.
323 * kobj_class_compile doesn't want the lock held
324 * because of the call to malloc - we drop the lock
328 kobj_class_compile(cls);
339 kobj_delete(kobj_t obj, struct malloc_type *mtype)
341 kobj_class_t cls = obj->ops->cls;
345 * Consider freeing the compiled method table for the class
346 * after its last instance is deleted. As an optimisation, we
347 * should defer this for a short while to avoid thrashing.
349 KOBJ_ASSERT(MA_NOTOWNED);
356 kobj_class_free(cls);