mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-24 11:29:10 +00:00
1a109c1cb0
- Add rm_init_flags() and accept extended options only for that variation. - Add a flags space specifically for rm_init_flags(), rather than borrowing the lock_init() flag space. - Define flag RM_RECURSE to use instead of LO_RECURSABLE. - Define flag RM_NOWITNESS to allow an rmlock to be exempt from WITNESS checking; this wasn't possible previously as rm_init() always passed LO_WITNESS when initializing an rmlock's struct lock. - Add RM_SYSINIT_FLAGS(). - Rename embedded mutex in rmlocks to make it more obvious what it is. - Update consumers. - Update man page.
404 lines
12 KiB
C
404 lines
12 KiB
C
/*-
|
|
* Copyright (c) 2007 Pawel Jakub Dawidek <pjd@FreeBSD.org>
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*/
|
|
|
|
#include <sys/cdefs.h>
|
|
__FBSDID("$FreeBSD$");
|
|
|
|
#include <sys/param.h>
|
|
#include <sys/kernel.h>
|
|
#include <sys/systm.h>
|
|
#include <sys/sysctl.h>
|
|
#include <sys/errno.h>
|
|
#include <sys/jail.h>
|
|
#include <sys/malloc.h>
|
|
#include <sys/lock.h>
|
|
#include <sys/mutex.h>
|
|
#include <sys/rmlock.h>
|
|
#include <sys/sx.h>
|
|
#include <sys/queue.h>
|
|
#include <sys/proc.h>
|
|
#include <sys/osd.h>
|
|
|
|
/* OSD (Object Specific Data) */
|
|
|
|
static MALLOC_DEFINE(M_OSD, "osd", "Object Specific Data");
|
|
|
|
static int osd_debug = 0;
|
|
TUNABLE_INT("debug.osd", &osd_debug);
|
|
SYSCTL_INT(_debug, OID_AUTO, osd, CTLFLAG_RW, &osd_debug, 0, "OSD debug level");
|
|
|
|
#define OSD_DEBUG(...) do { \
|
|
if (osd_debug) { \
|
|
printf("OSD (%s:%u): ", __func__, __LINE__); \
|
|
printf(__VA_ARGS__); \
|
|
printf("\n"); \
|
|
} \
|
|
} while (0)
|
|
|
|
static void do_osd_del(u_int type, struct osd *osd, u_int slot,
|
|
int list_locked);
|
|
|
|
/*
|
|
* Lists of objects with OSD.
|
|
*
|
|
* Lock key:
|
|
* (m) osd_module_lock
|
|
* (o) osd_object_lock
|
|
* (l) osd_list_lock
|
|
*/
|
|
static LIST_HEAD(, osd) osd_list[OSD_LAST + 1]; /* (m) */
|
|
static osd_method_t *osd_methods[OSD_LAST + 1]; /* (m) */
|
|
static u_int osd_nslots[OSD_LAST + 1]; /* (m) */
|
|
static osd_destructor_t *osd_destructors[OSD_LAST + 1]; /* (o) */
|
|
static const u_int osd_nmethods[OSD_LAST + 1] = {
|
|
[OSD_JAIL] = PR_MAXMETHOD,
|
|
};
|
|
|
|
static struct sx osd_module_lock[OSD_LAST + 1];
|
|
static struct rmlock osd_object_lock[OSD_LAST + 1];
|
|
static struct mtx osd_list_lock[OSD_LAST + 1];
|
|
|
|
static void
|
|
osd_default_destructor(void *value __unused)
|
|
{
|
|
/* Do nothing. */
|
|
}
|
|
|
|
int
|
|
osd_register(u_int type, osd_destructor_t destructor, osd_method_t *methods)
|
|
{
|
|
void *newptr;
|
|
u_int i, m;
|
|
|
|
KASSERT(type >= OSD_FIRST && type <= OSD_LAST, ("Invalid type."));
|
|
|
|
/*
|
|
* If no destructor is given, use default one. We need to use some
|
|
* destructor, because NULL destructor means unused slot.
|
|
*/
|
|
if (destructor == NULL)
|
|
destructor = osd_default_destructor;
|
|
|
|
sx_xlock(&osd_module_lock[type]);
|
|
/*
|
|
* First, we try to find unused slot.
|
|
*/
|
|
for (i = 0; i < osd_nslots[type]; i++) {
|
|
if (osd_destructors[type][i] == NULL) {
|
|
OSD_DEBUG("Unused slot found (type=%u, slot=%u).",
|
|
type, i);
|
|
break;
|
|
}
|
|
}
|
|
/*
|
|
* If no unused slot was found, allocate one.
|
|
*/
|
|
if (i == osd_nslots[type]) {
|
|
osd_nslots[type]++;
|
|
if (osd_nmethods[type] != 0)
|
|
osd_methods[type] = realloc(osd_methods[type],
|
|
sizeof(osd_method_t) * osd_nslots[type] *
|
|
osd_nmethods[type], M_OSD, M_WAITOK);
|
|
newptr = malloc(sizeof(osd_destructor_t) * osd_nslots[type],
|
|
M_OSD, M_WAITOK);
|
|
rm_wlock(&osd_object_lock[type]);
|
|
bcopy(osd_destructors[type], newptr,
|
|
sizeof(osd_destructor_t) * i);
|
|
free(osd_destructors[type], M_OSD);
|
|
osd_destructors[type] = newptr;
|
|
rm_wunlock(&osd_object_lock[type]);
|
|
OSD_DEBUG("New slot allocated (type=%u, slot=%u).",
|
|
type, i + 1);
|
|
}
|
|
|
|
osd_destructors[type][i] = destructor;
|
|
if (osd_nmethods[type] != 0) {
|
|
for (m = 0; m < osd_nmethods[type]; m++)
|
|
osd_methods[type][i * osd_nmethods[type] + m] =
|
|
methods != NULL ? methods[m] : NULL;
|
|
}
|
|
sx_xunlock(&osd_module_lock[type]);
|
|
return (i + 1);
|
|
}
|
|
|
|
void
|
|
osd_deregister(u_int type, u_int slot)
|
|
{
|
|
struct osd *osd, *tosd;
|
|
|
|
KASSERT(type >= OSD_FIRST && type <= OSD_LAST, ("Invalid type."));
|
|
KASSERT(slot > 0, ("Invalid slot."));
|
|
KASSERT(osd_destructors[type][slot - 1] != NULL, ("Unused slot."));
|
|
|
|
sx_xlock(&osd_module_lock[type]);
|
|
rm_wlock(&osd_object_lock[type]);
|
|
/*
|
|
* Free all OSD for the given slot.
|
|
*/
|
|
mtx_lock(&osd_list_lock[type]);
|
|
LIST_FOREACH_SAFE(osd, &osd_list[type], osd_next, tosd)
|
|
do_osd_del(type, osd, slot, 1);
|
|
mtx_unlock(&osd_list_lock[type]);
|
|
/*
|
|
* Set destructor to NULL to free the slot.
|
|
*/
|
|
osd_destructors[type][slot - 1] = NULL;
|
|
if (slot == osd_nslots[type]) {
|
|
osd_nslots[type]--;
|
|
osd_destructors[type] = realloc(osd_destructors[type],
|
|
sizeof(osd_destructor_t) * osd_nslots[type], M_OSD,
|
|
M_NOWAIT | M_ZERO);
|
|
if (osd_nmethods[type] != 0)
|
|
osd_methods[type] = realloc(osd_methods[type],
|
|
sizeof(osd_method_t) * osd_nslots[type] *
|
|
osd_nmethods[type], M_OSD, M_NOWAIT | M_ZERO);
|
|
/*
|
|
* We always reallocate to smaller size, so we assume it will
|
|
* always succeed.
|
|
*/
|
|
KASSERT(osd_destructors[type] != NULL &&
|
|
(osd_nmethods[type] == 0 || osd_methods[type] != NULL),
|
|
("realloc() failed"));
|
|
OSD_DEBUG("Deregistration of the last slot (type=%u, slot=%u).",
|
|
type, slot);
|
|
} else {
|
|
OSD_DEBUG("Slot deregistration (type=%u, slot=%u).",
|
|
type, slot);
|
|
}
|
|
rm_wunlock(&osd_object_lock[type]);
|
|
sx_xunlock(&osd_module_lock[type]);
|
|
}
|
|
|
|
int
|
|
osd_set(u_int type, struct osd *osd, u_int slot, void *value)
|
|
{
|
|
struct rm_priotracker tracker;
|
|
|
|
KASSERT(type >= OSD_FIRST && type <= OSD_LAST, ("Invalid type."));
|
|
KASSERT(slot > 0, ("Invalid slot."));
|
|
KASSERT(osd_destructors[type][slot - 1] != NULL, ("Unused slot."));
|
|
|
|
rm_rlock(&osd_object_lock[type], &tracker);
|
|
if (slot > osd->osd_nslots) {
|
|
if (value == NULL) {
|
|
OSD_DEBUG(
|
|
"Not allocating null slot (type=%u, slot=%u).",
|
|
type, slot);
|
|
rm_runlock(&osd_object_lock[type], &tracker);
|
|
return (0);
|
|
} else if (osd->osd_nslots == 0) {
|
|
/*
|
|
* First OSD for this object, so we need to allocate
|
|
* space and put it onto the list.
|
|
*/
|
|
osd->osd_slots = malloc(sizeof(void *) * slot, M_OSD,
|
|
M_NOWAIT | M_ZERO);
|
|
if (osd->osd_slots == NULL) {
|
|
rm_runlock(&osd_object_lock[type], &tracker);
|
|
return (ENOMEM);
|
|
}
|
|
osd->osd_nslots = slot;
|
|
mtx_lock(&osd_list_lock[type]);
|
|
LIST_INSERT_HEAD(&osd_list[type], osd, osd_next);
|
|
mtx_unlock(&osd_list_lock[type]);
|
|
OSD_DEBUG("Setting first slot (type=%u).", type);
|
|
} else {
|
|
void *newptr;
|
|
|
|
/*
|
|
* Too few slots allocated here, needs to extend
|
|
* the array.
|
|
*/
|
|
newptr = realloc(osd->osd_slots, sizeof(void *) * slot,
|
|
M_OSD, M_NOWAIT | M_ZERO);
|
|
if (newptr == NULL) {
|
|
rm_runlock(&osd_object_lock[type], &tracker);
|
|
return (ENOMEM);
|
|
}
|
|
osd->osd_slots = newptr;
|
|
osd->osd_nslots = slot;
|
|
OSD_DEBUG("Growing slots array (type=%u).", type);
|
|
}
|
|
}
|
|
OSD_DEBUG("Setting slot value (type=%u, slot=%u, value=%p).", type,
|
|
slot, value);
|
|
osd->osd_slots[slot - 1] = value;
|
|
rm_runlock(&osd_object_lock[type], &tracker);
|
|
return (0);
|
|
}
|
|
|
|
void *
|
|
osd_get(u_int type, struct osd *osd, u_int slot)
|
|
{
|
|
struct rm_priotracker tracker;
|
|
void *value;
|
|
|
|
KASSERT(type >= OSD_FIRST && type <= OSD_LAST, ("Invalid type."));
|
|
KASSERT(slot > 0, ("Invalid slot."));
|
|
KASSERT(osd_destructors[type][slot - 1] != NULL, ("Unused slot."));
|
|
|
|
rm_rlock(&osd_object_lock[type], &tracker);
|
|
if (slot > osd->osd_nslots) {
|
|
value = NULL;
|
|
OSD_DEBUG("Slot doesn't exist (type=%u, slot=%u).", type, slot);
|
|
} else {
|
|
value = osd->osd_slots[slot - 1];
|
|
OSD_DEBUG("Returning slot value (type=%u, slot=%u, value=%p).",
|
|
type, slot, value);
|
|
}
|
|
rm_runlock(&osd_object_lock[type], &tracker);
|
|
return (value);
|
|
}
|
|
|
|
void
|
|
osd_del(u_int type, struct osd *osd, u_int slot)
|
|
{
|
|
struct rm_priotracker tracker;
|
|
|
|
rm_rlock(&osd_object_lock[type], &tracker);
|
|
do_osd_del(type, osd, slot, 0);
|
|
rm_runlock(&osd_object_lock[type], &tracker);
|
|
}
|
|
|
|
static void
|
|
do_osd_del(u_int type, struct osd *osd, u_int slot, int list_locked)
|
|
{
|
|
int i;
|
|
|
|
KASSERT(type >= OSD_FIRST && type <= OSD_LAST, ("Invalid type."));
|
|
KASSERT(slot > 0, ("Invalid slot."));
|
|
KASSERT(osd_destructors[type][slot - 1] != NULL, ("Unused slot."));
|
|
|
|
OSD_DEBUG("Deleting slot (type=%u, slot=%u).", type, slot);
|
|
|
|
if (slot > osd->osd_nslots) {
|
|
OSD_DEBUG("Slot doesn't exist (type=%u, slot=%u).", type, slot);
|
|
return;
|
|
}
|
|
if (osd->osd_slots[slot - 1] != NULL) {
|
|
osd_destructors[type][slot - 1](osd->osd_slots[slot - 1]);
|
|
osd->osd_slots[slot - 1] = NULL;
|
|
}
|
|
for (i = osd->osd_nslots - 1; i >= 0; i--) {
|
|
if (osd->osd_slots[i] != NULL) {
|
|
OSD_DEBUG("Slot still has a value (type=%u, slot=%u).",
|
|
type, i + 1);
|
|
break;
|
|
}
|
|
}
|
|
if (i == -1) {
|
|
/* No values left for this object. */
|
|
OSD_DEBUG("No more slots left (type=%u).", type);
|
|
if (!list_locked)
|
|
mtx_lock(&osd_list_lock[type]);
|
|
LIST_REMOVE(osd, osd_next);
|
|
if (!list_locked)
|
|
mtx_unlock(&osd_list_lock[type]);
|
|
free(osd->osd_slots, M_OSD);
|
|
osd->osd_slots = NULL;
|
|
osd->osd_nslots = 0;
|
|
} else if (slot == osd->osd_nslots) {
|
|
/* This was the last slot. */
|
|
osd->osd_slots = realloc(osd->osd_slots,
|
|
sizeof(void *) * (i + 1), M_OSD, M_NOWAIT | M_ZERO);
|
|
/*
|
|
* We always reallocate to smaller size, so we assume it will
|
|
* always succeed.
|
|
*/
|
|
KASSERT(osd->osd_slots != NULL, ("realloc() failed"));
|
|
osd->osd_nslots = i + 1;
|
|
OSD_DEBUG("Reducing slots array to %u (type=%u).",
|
|
osd->osd_nslots, type);
|
|
}
|
|
}
|
|
|
|
int
|
|
osd_call(u_int type, u_int method, void *obj, void *data)
|
|
{
|
|
osd_method_t methodfun;
|
|
int error, i;
|
|
|
|
KASSERT(type >= OSD_FIRST && type <= OSD_LAST, ("Invalid type."));
|
|
KASSERT(method < osd_nmethods[type], ("Invalid method."));
|
|
|
|
/*
|
|
* Call this method for every slot that defines it, stopping if an
|
|
* error is encountered.
|
|
*/
|
|
error = 0;
|
|
sx_slock(&osd_module_lock[type]);
|
|
for (i = 0; i < osd_nslots[type]; i++) {
|
|
methodfun =
|
|
osd_methods[type][i * osd_nmethods[type] + method];
|
|
if (methodfun != NULL && (error = methodfun(obj, data)) != 0)
|
|
break;
|
|
}
|
|
sx_sunlock(&osd_module_lock[type]);
|
|
return (error);
|
|
}
|
|
|
|
void
|
|
osd_exit(u_int type, struct osd *osd)
|
|
{
|
|
struct rm_priotracker tracker;
|
|
u_int i;
|
|
|
|
KASSERT(type >= OSD_FIRST && type <= OSD_LAST, ("Invalid type."));
|
|
|
|
if (osd->osd_nslots == 0) {
|
|
KASSERT(osd->osd_slots == NULL, ("Non-null osd_slots."));
|
|
/* No OSD attached, just leave. */
|
|
return;
|
|
}
|
|
|
|
rm_rlock(&osd_object_lock[type], &tracker);
|
|
for (i = 1; i <= osd->osd_nslots; i++) {
|
|
if (osd_destructors[type][i - 1] != NULL)
|
|
do_osd_del(type, osd, i, 0);
|
|
else
|
|
OSD_DEBUG("Unused slot (type=%u, slot=%u).", type, i);
|
|
}
|
|
rm_runlock(&osd_object_lock[type], &tracker);
|
|
OSD_DEBUG("Object exit (type=%u).", type);
|
|
}
|
|
|
|
static void
|
|
osd_init(void *arg __unused)
|
|
{
|
|
u_int i;
|
|
|
|
for (i = OSD_FIRST; i <= OSD_LAST; i++) {
|
|
osd_nslots[i] = 0;
|
|
LIST_INIT(&osd_list[i]);
|
|
sx_init(&osd_module_lock[i], "osd_module");
|
|
rm_init(&osd_object_lock[i], "osd_object");
|
|
mtx_init(&osd_list_lock[i], "osd_list", NULL, MTX_DEF);
|
|
osd_destructors[i] = NULL;
|
|
osd_methods[i] = NULL;
|
|
}
|
|
}
|
|
SYSINIT(osd, SI_SUB_LOCK, SI_ORDER_ANY, osd_init, NULL);
|