xref: /freebsd/sys/cam/ctl/ctl_frontend_ioctl.c (revision d93a896ef95946b0bf1219866fcb324b78543444)
1 /*-
2  * Copyright (c) 2003-2009 Silicon Graphics International Corp.
3  * Copyright (c) 2012 The FreeBSD Foundation
4  * Copyright (c) 2015 Alexander Motin <mav@FreeBSD.org>
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer,
12  *    without modification, immediately at the beginning of the file.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  */
28 
29 #include <sys/cdefs.h>
30 __FBSDID("$FreeBSD$");
31 
32 #include <sys/param.h>
33 #include <sys/systm.h>
34 #include <sys/kernel.h>
35 #include <sys/types.h>
36 #include <sys/lock.h>
37 #include <sys/module.h>
38 #include <sys/mutex.h>
39 #include <sys/condvar.h>
40 #include <sys/malloc.h>
41 #include <sys/conf.h>
42 #include <sys/queue.h>
43 #include <sys/sysctl.h>
44 
45 #include <cam/cam.h>
46 #include <cam/scsi/scsi_all.h>
47 #include <cam/scsi/scsi_da.h>
48 #include <cam/ctl/ctl_io.h>
49 #include <cam/ctl/ctl.h>
50 #include <cam/ctl/ctl_frontend.h>
51 #include <cam/ctl/ctl_util.h>
52 #include <cam/ctl/ctl_backend.h>
53 #include <cam/ctl/ctl_ioctl.h>
54 #include <cam/ctl/ctl_ha.h>
55 #include <cam/ctl/ctl_private.h>
56 #include <cam/ctl/ctl_debug.h>
57 #include <cam/ctl/ctl_error.h>
58 
59 typedef enum {
60 	CTL_IOCTL_INPROG,
61 	CTL_IOCTL_DATAMOVE,
62 	CTL_IOCTL_DONE
63 } ctl_fe_ioctl_state;
64 
65 struct ctl_fe_ioctl_params {
66 	struct cv		sem;
67 	struct mtx		ioctl_mtx;
68 	ctl_fe_ioctl_state	state;
69 };
70 
71 struct cfi_softc {
72 	uint32_t		cur_tag_num;
73 	struct ctl_port		port;
74 };
75 
76 static struct cfi_softc cfi_softc;
77 
78 static int cfi_init(void);
79 static int cfi_shutdown(void);
80 static void cfi_datamove(union ctl_io *io);
81 static void cfi_done(union ctl_io *io);
82 
83 static struct ctl_frontend cfi_frontend =
84 {
85 	.name = "ioctl",
86 	.init = cfi_init,
87 	.shutdown = cfi_shutdown,
88 };
89 CTL_FRONTEND_DECLARE(ctlioctl, cfi_frontend);
90 
91 static int
92 cfi_init(void)
93 {
94 	struct cfi_softc *isoftc = &cfi_softc;
95 	struct ctl_port *port;
96 	int error = 0;
97 
98 	memset(isoftc, 0, sizeof(*isoftc));
99 
100 	port = &isoftc->port;
101 	port->frontend = &cfi_frontend;
102 	port->port_type = CTL_PORT_IOCTL;
103 	port->num_requested_ctl_io = 100;
104 	port->port_name = "ioctl";
105 	port->fe_datamove = cfi_datamove;
106 	port->fe_done = cfi_done;
107 	port->targ_port = -1;
108 	port->max_initiators = 1;
109 
110 	if ((error = ctl_port_register(port)) != 0) {
111 		printf("%s: ioctl port registration failed\n", __func__);
112 		return (error);
113 	}
114 	ctl_port_online(port);
115 	return (0);
116 }
117 
118 static int
119 cfi_shutdown(void)
120 {
121 	struct cfi_softc *isoftc = &cfi_softc;
122 	struct ctl_port *port = &isoftc->port;
123 	int error = 0;
124 
125 	ctl_port_offline(port);
126 	if ((error = ctl_port_deregister(port)) != 0)
127 		printf("%s: ioctl port deregistration failed\n", __func__);
128 	return (error);
129 }
130 
131 /*
132  * Data movement routine for the CTL ioctl frontend port.
133  */
134 static int
135 ctl_ioctl_do_datamove(struct ctl_scsiio *ctsio)
136 {
137 	struct ctl_sg_entry *ext_sglist, *kern_sglist;
138 	struct ctl_sg_entry ext_entry, kern_entry;
139 	int ext_sglen, ext_sg_entries, kern_sg_entries;
140 	int ext_sg_start, ext_offset;
141 	int len_to_copy;
142 	int kern_watermark, ext_watermark;
143 	int ext_sglist_malloced;
144 	int i, j;
145 
146 	CTL_DEBUG_PRINT(("ctl_ioctl_do_datamove\n"));
147 
148 	/*
149 	 * If this flag is set, fake the data transfer.
150 	 */
151 	if (ctsio->io_hdr.flags & CTL_FLAG_NO_DATAMOVE) {
152 		ext_sglist_malloced = 0;
153 		ctsio->ext_data_filled += ctsio->kern_data_len;
154 		ctsio->kern_data_resid = 0;
155 		goto bailout;
156 	}
157 
158 	/*
159 	 * To simplify things here, if we have a single buffer, stick it in
160 	 * a S/G entry and just make it a single entry S/G list.
161 	 */
162 	if (ctsio->ext_sg_entries > 0) {
163 		int len_seen;
164 
165 		ext_sglen = ctsio->ext_sg_entries * sizeof(*ext_sglist);
166 		ext_sglist = (struct ctl_sg_entry *)malloc(ext_sglen, M_CTL,
167 							   M_WAITOK);
168 		ext_sglist_malloced = 1;
169 		if (copyin(ctsio->ext_data_ptr, ext_sglist, ext_sglen) != 0) {
170 			ctsio->io_hdr.port_status = 31343;
171 			goto bailout;
172 		}
173 		ext_sg_entries = ctsio->ext_sg_entries;
174 		ext_sg_start = ext_sg_entries;
175 		ext_offset = 0;
176 		len_seen = 0;
177 		for (i = 0; i < ext_sg_entries; i++) {
178 			if ((len_seen + ext_sglist[i].len) >=
179 			     ctsio->ext_data_filled) {
180 				ext_sg_start = i;
181 				ext_offset = ctsio->ext_data_filled - len_seen;
182 				break;
183 			}
184 			len_seen += ext_sglist[i].len;
185 		}
186 	} else {
187 		ext_sglist = &ext_entry;
188 		ext_sglist_malloced = 0;
189 		ext_sglist->addr = ctsio->ext_data_ptr;
190 		ext_sglist->len = ctsio->ext_data_len;
191 		ext_sg_entries = 1;
192 		ext_sg_start = 0;
193 		ext_offset = ctsio->ext_data_filled;
194 	}
195 
196 	if (ctsio->kern_sg_entries > 0) {
197 		kern_sglist = (struct ctl_sg_entry *)ctsio->kern_data_ptr;
198 		kern_sg_entries = ctsio->kern_sg_entries;
199 	} else {
200 		kern_sglist = &kern_entry;
201 		kern_sglist->addr = ctsio->kern_data_ptr;
202 		kern_sglist->len = ctsio->kern_data_len;
203 		kern_sg_entries = 1;
204 	}
205 
206 	kern_watermark = 0;
207 	ext_watermark = ext_offset;
208 	for (i = ext_sg_start, j = 0;
209 	     i < ext_sg_entries && j < kern_sg_entries;) {
210 		uint8_t *ext_ptr, *kern_ptr;
211 
212 		len_to_copy = MIN(ext_sglist[i].len - ext_watermark,
213 				  kern_sglist[j].len - kern_watermark);
214 
215 		ext_ptr = (uint8_t *)ext_sglist[i].addr;
216 		ext_ptr = ext_ptr + ext_watermark;
217 		if (ctsio->io_hdr.flags & CTL_FLAG_BUS_ADDR) {
218 			/*
219 			 * XXX KDM fix this!
220 			 */
221 			panic("need to implement bus address support");
222 #if 0
223 			kern_ptr = bus_to_virt(kern_sglist[j].addr);
224 #endif
225 		} else
226 			kern_ptr = (uint8_t *)kern_sglist[j].addr;
227 		kern_ptr = kern_ptr + kern_watermark;
228 
229 		if ((ctsio->io_hdr.flags & CTL_FLAG_DATA_MASK) ==
230 		     CTL_FLAG_DATA_IN) {
231 			CTL_DEBUG_PRINT(("ctl_ioctl_do_datamove: copying %d "
232 					 "bytes to user\n", len_to_copy));
233 			CTL_DEBUG_PRINT(("ctl_ioctl_do_datamove: from %p "
234 					 "to %p\n", kern_ptr, ext_ptr));
235 			if (copyout(kern_ptr, ext_ptr, len_to_copy) != 0) {
236 				ctsio->io_hdr.port_status = 31344;
237 				goto bailout;
238 			}
239 		} else {
240 			CTL_DEBUG_PRINT(("ctl_ioctl_do_datamove: copying %d "
241 					 "bytes from user\n", len_to_copy));
242 			CTL_DEBUG_PRINT(("ctl_ioctl_do_datamove: from %p "
243 					 "to %p\n", ext_ptr, kern_ptr));
244 			if (copyin(ext_ptr, kern_ptr, len_to_copy)!= 0){
245 				ctsio->io_hdr.port_status = 31345;
246 				goto bailout;
247 			}
248 		}
249 
250 		ctsio->ext_data_filled += len_to_copy;
251 		ctsio->kern_data_resid -= len_to_copy;
252 
253 		ext_watermark += len_to_copy;
254 		if (ext_sglist[i].len == ext_watermark) {
255 			i++;
256 			ext_watermark = 0;
257 		}
258 
259 		kern_watermark += len_to_copy;
260 		if (kern_sglist[j].len == kern_watermark) {
261 			j++;
262 			kern_watermark = 0;
263 		}
264 	}
265 
266 	CTL_DEBUG_PRINT(("ctl_ioctl_do_datamove: ext_sg_entries: %d, "
267 			 "kern_sg_entries: %d\n", ext_sg_entries,
268 			 kern_sg_entries));
269 	CTL_DEBUG_PRINT(("ctl_ioctl_do_datamove: ext_data_len = %d, "
270 			 "kern_data_len = %d\n", ctsio->ext_data_len,
271 			 ctsio->kern_data_len));
272 
273 bailout:
274 	if (ext_sglist_malloced != 0)
275 		free(ext_sglist, M_CTL);
276 
277 	return (CTL_RETVAL_COMPLETE);
278 }
279 
280 static void
281 cfi_datamove(union ctl_io *io)
282 {
283 	struct ctl_fe_ioctl_params *params;
284 
285 	params = (struct ctl_fe_ioctl_params *)
286 		io->io_hdr.ctl_private[CTL_PRIV_FRONTEND].ptr;
287 
288 	mtx_lock(&params->ioctl_mtx);
289 	params->state = CTL_IOCTL_DATAMOVE;
290 	cv_broadcast(&params->sem);
291 	mtx_unlock(&params->ioctl_mtx);
292 }
293 
294 static void
295 cfi_done(union ctl_io *io)
296 {
297 	struct ctl_fe_ioctl_params *params;
298 
299 	params = (struct ctl_fe_ioctl_params *)
300 		io->io_hdr.ctl_private[CTL_PRIV_FRONTEND].ptr;
301 
302 	mtx_lock(&params->ioctl_mtx);
303 	params->state = CTL_IOCTL_DONE;
304 	cv_broadcast(&params->sem);
305 	mtx_unlock(&params->ioctl_mtx);
306 }
307 
308 static int
309 cfi_submit_wait(union ctl_io *io)
310 {
311 	struct ctl_fe_ioctl_params params;
312 	ctl_fe_ioctl_state last_state;
313 	int done, retval;
314 
315 	bzero(&params, sizeof(params));
316 	mtx_init(&params.ioctl_mtx, "ctliocmtx", NULL, MTX_DEF);
317 	cv_init(&params.sem, "ctlioccv");
318 	params.state = CTL_IOCTL_INPROG;
319 	last_state = params.state;
320 
321 	io->io_hdr.ctl_private[CTL_PRIV_FRONTEND].ptr = &params;
322 
323 	CTL_DEBUG_PRINT(("cfi_submit_wait\n"));
324 
325 	/* This shouldn't happen */
326 	if ((retval = ctl_queue(io)) != CTL_RETVAL_COMPLETE)
327 		return (retval);
328 
329 	done = 0;
330 
331 	do {
332 		mtx_lock(&params.ioctl_mtx);
333 		/*
334 		 * Check the state here, and don't sleep if the state has
335 		 * already changed (i.e. wakeup has already occurred, but we
336 		 * weren't waiting yet).
337 		 */
338 		if (params.state == last_state) {
339 			/* XXX KDM cv_wait_sig instead? */
340 			cv_wait(&params.sem, &params.ioctl_mtx);
341 		}
342 		last_state = params.state;
343 
344 		switch (params.state) {
345 		case CTL_IOCTL_INPROG:
346 			/* Why did we wake up? */
347 			/* XXX KDM error here? */
348 			mtx_unlock(&params.ioctl_mtx);
349 			break;
350 		case CTL_IOCTL_DATAMOVE:
351 			CTL_DEBUG_PRINT(("got CTL_IOCTL_DATAMOVE\n"));
352 
353 			/*
354 			 * change last_state back to INPROG to avoid
355 			 * deadlock on subsequent data moves.
356 			 */
357 			params.state = last_state = CTL_IOCTL_INPROG;
358 
359 			mtx_unlock(&params.ioctl_mtx);
360 			ctl_ioctl_do_datamove(&io->scsiio);
361 			/*
362 			 * Note that in some cases, most notably writes,
363 			 * this will queue the I/O and call us back later.
364 			 * In other cases, generally reads, this routine
365 			 * will immediately call back and wake us up,
366 			 * probably using our own context.
367 			 */
368 			io->scsiio.be_move_done(io);
369 			break;
370 		case CTL_IOCTL_DONE:
371 			mtx_unlock(&params.ioctl_mtx);
372 			CTL_DEBUG_PRINT(("got CTL_IOCTL_DONE\n"));
373 			done = 1;
374 			break;
375 		default:
376 			mtx_unlock(&params.ioctl_mtx);
377 			/* XXX KDM error here? */
378 			break;
379 		}
380 	} while (done == 0);
381 
382 	mtx_destroy(&params.ioctl_mtx);
383 	cv_destroy(&params.sem);
384 
385 	return (CTL_RETVAL_COMPLETE);
386 }
387 
388 int
389 ctl_ioctl_io(struct cdev *dev, u_long cmd, caddr_t addr, int flag,
390     struct thread *td)
391 {
392 	union ctl_io *io;
393 	void *pool_tmp, *sc_tmp;
394 	int retval = 0;
395 
396 	/*
397 	 * If we haven't been "enabled", don't allow any SCSI I/O
398 	 * to this FETD.
399 	 */
400 	if ((cfi_softc.port.status & CTL_PORT_STATUS_ONLINE) == 0)
401 		return (EPERM);
402 
403 	io = ctl_alloc_io(cfi_softc.port.ctl_pool_ref);
404 
405 	/*
406 	 * Need to save the pool reference so it doesn't get
407 	 * spammed by the user's ctl_io.
408 	 */
409 	pool_tmp = io->io_hdr.pool;
410 	sc_tmp = CTL_SOFTC(io);
411 	memcpy(io, (void *)addr, sizeof(*io));
412 	io->io_hdr.pool = pool_tmp;
413 	CTL_SOFTC(io) = sc_tmp;
414 
415 	/*
416 	 * No status yet, so make sure the status is set properly.
417 	 */
418 	io->io_hdr.status = CTL_STATUS_NONE;
419 
420 	/*
421 	 * The user sets the initiator ID, target and LUN IDs.
422 	 */
423 	io->io_hdr.nexus.targ_port = cfi_softc.port.targ_port;
424 	io->io_hdr.flags |= CTL_FLAG_USER_REQ;
425 	if ((io->io_hdr.io_type == CTL_IO_SCSI) &&
426 	    (io->scsiio.tag_type != CTL_TAG_UNTAGGED))
427 		io->scsiio.tag_num = cfi_softc.cur_tag_num++;
428 
429 	retval = cfi_submit_wait(io);
430 	if (retval == 0)
431 		memcpy((void *)addr, io, sizeof(*io));
432 	ctl_free_io(io);
433 	return (retval);
434 }
435