xref: /dragonfly/sys/dev/disk/dm/dm_target.c (revision 820c5b08)
1 /*        $NetBSD: dm_target.c,v 1.12 2010/01/04 00:14:41 haad Exp $      */
2 
3 /*
4  * Copyright (c) 2010-2011 Alex Hornung <alex@alexhornung.com>
5  * Copyright (c) 2008 The NetBSD Foundation, Inc.
6  * All rights reserved.
7  *
8  * This code is derived from software contributed to The NetBSD Foundation
9  * by Adam Hamsik.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code Must retain the above copyright
15  *    notice, this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright
17  *    notice, this list of conditions and the following disclaimer in the
18  *    documentation and/or other materials provided with the distribution.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 #include <sys/malloc.h>
34 #include <sys/module.h>
35 #include <sys/linker.h>
36 #include <cpu/atomic.h>
37 #include <dev/disk/dm/dm.h>
38 #include <dev/disk/dm/netbsd-dm.h>
39 
40 static dm_target_t *dm_target_lookup_name(const char *);
41 
42 static TAILQ_HEAD(, dm_target) dm_target_list;
43 
44 static struct lock dm_target_mutex;
45 
46 void
47 dm_target_busy(dm_target_t *target)
48 {
49 	atomic_add_int(&target->ref_cnt, 1);
50 }
51 
52 /*
53  * Release reference counter on target.
54  */
55 void
56 dm_target_unbusy(dm_target_t *target)
57 {
58 	KKASSERT(target->ref_cnt > 0);
59 	atomic_subtract_int(&target->ref_cnt, 1);
60 }
61 
62 /*
63  * Try to autoload the module for the requested target.
64  */
65 dm_target_t *
66 dm_target_autoload(const char *dm_target_name)
67 {
68 	char mod_name[128];
69 	dm_target_t *dmt;
70 	linker_file_t linker_file;
71 	int error;
72 
73 	ksnprintf(mod_name, sizeof(mod_name), "dm_target_%s", dm_target_name);
74 	error = linker_reference_module(mod_name, NULL, &linker_file);
75 	if (error != 0) {
76 		kprintf("dm: could not autoload module for target %s\n",
77 		    dm_target_name);
78 		return NULL;
79 	}
80 
81 	dmt = dm_target_lookup(dm_target_name);
82 	if (dmt == NULL) {
83 		linker_release_module(NULL, NULL, linker_file);
84 		return NULL;
85 	}
86 
87 	/* XXX: extra-big hack to allow users to kldunload the module */
88 	linker_file->userrefs = 1;
89 
90 	return dmt;
91 }
92 
93 /*
94  * Lookup for target in global target list.
95  */
96 dm_target_t *
97 dm_target_lookup(const char *dm_target_name)
98 {
99 	dm_target_t *dmt;
100 
101 	dmt = NULL;
102 
103 	if (dm_target_name == NULL)
104 		return NULL;
105 
106 	lockmgr(&dm_target_mutex, LK_EXCLUSIVE);
107 
108 	dmt = dm_target_lookup_name(dm_target_name);
109 	if (dmt != NULL)
110 		dm_target_busy(dmt);
111 
112 	lockmgr(&dm_target_mutex, LK_RELEASE);
113 
114 	return dmt;
115 }
116 
117 /*
118  * Search for name in TAILQ and return apropriate pointer.
119  */
120 static dm_target_t *
121 dm_target_lookup_name(const char *dm_target_name)
122 {
123 	dm_target_t *dm_target;
124 
125 	TAILQ_FOREACH(dm_target, &dm_target_list, dm_target_next) {
126 		if (strcmp(dm_target_name, dm_target->name) == 0)
127 			return dm_target;
128 	}
129 
130 	return NULL;
131 }
132 
133 /*
134  * Insert new target struct into the TAILQ.
135  * dm_target contains name, version, function pointer to specific target
136  * functions.
137  */
138 int
139 dm_target_insert(dm_target_t *dm_target)
140 {
141 	dm_target_t *dmt;
142 
143 	if (dm_target->init == NULL) {
144 		kprintf("dm: %s missing init\n", dm_target->name);
145 		return EINVAL;
146 	}
147 	if (dm_target->destroy == NULL) {
148 		kprintf("dm: %s missing destroy\n", dm_target->name);
149 		return EINVAL;
150 	}
151 	if (dm_target->strategy == NULL) {
152 		kprintf("dm: %s missing strategy\n", dm_target->name);
153 		return EINVAL;
154 	}
155 
156 	lockmgr(&dm_target_mutex, LK_EXCLUSIVE);
157 
158 	dmt = dm_target_lookup_name(dm_target->name);
159 	if (dmt != NULL) {
160 		kprintf("uhoh, target_insert EEXIST\n");
161 		lockmgr(&dm_target_mutex, LK_RELEASE);
162 		return EEXIST;
163 	}
164 	TAILQ_INSERT_TAIL(&dm_target_list, dm_target, dm_target_next);
165 
166 	lockmgr(&dm_target_mutex, LK_RELEASE);
167 
168 	return 0;
169 }
170 
171 /*
172  * Remove target from TAILQ, target is selected with it's name.
173  */
174 int
175 dm_target_remove(char *dm_target_name)
176 {
177 	dm_target_t *dmt;
178 
179 	KKASSERT(dm_target_name != NULL);
180 
181 	lockmgr(&dm_target_mutex, LK_EXCLUSIVE);
182 
183 	dmt = dm_target_lookup_name(dm_target_name);
184 	if (dmt == NULL) {
185 		lockmgr(&dm_target_mutex, LK_RELEASE);
186 		return ENOENT;
187 	}
188 	if (dmt->ref_cnt > 0) {
189 		lockmgr(&dm_target_mutex, LK_RELEASE);
190 		return EBUSY;
191 	}
192 	TAILQ_REMOVE(&dm_target_list, dmt, dm_target_next);
193 
194 	lockmgr(&dm_target_mutex, LK_RELEASE);
195 
196 	dm_target_free(dmt);
197 
198 	return 0;
199 }
200 
201 /*
202  * Allocate new target entry.
203  */
204 dm_target_t *
205 dm_target_alloc(const char *name)
206 {
207 	dm_target_t *dmt;
208 
209 	dmt = kmalloc(sizeof(*dmt), M_DM, M_WAITOK | M_ZERO);
210 	if (dmt == NULL)
211 		return NULL;
212 
213 	if (name)
214 		strlcpy(dmt->name, name, sizeof(dmt->name));
215 
216 	return dmt;
217 }
218 
219 int
220 dm_target_free(dm_target_t *dmt)
221 {
222 	KKASSERT(dmt != NULL);
223 
224 	kfree(dmt, M_DM);
225 
226 	return 0;
227 }
228 
229 /*
230  * Return prop_array of dm_target dictionaries.
231  */
232 prop_array_t
233 dm_target_prop_list(void)
234 {
235 	prop_array_t target_array, ver;
236 	prop_dictionary_t target_dict;
237 	dm_target_t *dm_target;
238 
239 	size_t i;
240 
241 	target_array = prop_array_create();
242 
243 	lockmgr(&dm_target_mutex, LK_EXCLUSIVE);
244 
245 	TAILQ_FOREACH(dm_target, &dm_target_list, dm_target_next) {
246 
247 		target_dict = prop_dictionary_create();
248 		ver = prop_array_create();
249 		prop_dictionary_set_cstring(target_dict, DM_TARGETS_NAME,
250 		    dm_target->name);
251 
252 		for (i = 0; i < 3; i++)
253 			prop_array_add_uint32(ver, dm_target->version[i]);
254 
255 		prop_dictionary_set(target_dict, DM_TARGETS_VERSION, ver);
256 		prop_array_add(target_array, target_dict);
257 
258 		prop_object_release(ver);
259 		prop_object_release(target_dict);
260 	}
261 
262 	lockmgr(&dm_target_mutex, LK_RELEASE);
263 
264 	return target_array;
265 }
266 
267 /*
268  * Initialize dm_target subsystem.
269  */
270 int
271 dm_target_init(void)
272 {
273 	TAILQ_INIT(&dm_target_list);	/* initialize global target list */
274 	lockinit(&dm_target_mutex, "dmtrgt", 0, LK_CANRECURSE);
275 
276 	return 0;
277 }
278 
279 /*
280  * Destroy all targets and remove them from queue.
281  * This routine is called from dmdestroy, before module
282  * is unloaded.
283  */
284 int
285 dm_target_uninit(void)
286 {
287 	dm_target_t *dm_target;
288 
289 	lockmgr(&dm_target_mutex, LK_EXCLUSIVE);
290 
291 	while ((dm_target = TAILQ_FIRST(&dm_target_list)) != NULL) {
292 		TAILQ_REMOVE(&dm_target_list, dm_target, dm_target_next);
293 		dm_target_free(dm_target);
294 	}
295 	KKASSERT(TAILQ_EMPTY(&dm_target_list));
296 
297 	lockmgr(&dm_target_mutex, LK_RELEASE);
298 
299 	lockuninit(&dm_target_mutex);
300 
301 	return 0;
302 }
303