iscsi_main.c revision 1.2 1 /* $netBSD: iscsi_main.c,v 1.1.1.1 2011/05/02 07:01:11 agc Exp $ */
2
3 /*-
4 * Copyright (c) 2004,2005,2006,2011 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Wasabi Systems, Inc.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
30 */
31 #include "iscsi_globals.h"
32
33 #include <sys/systm.h>
34 #include <sys/buf.h>
35 #include <sys/kmem.h>
36 #include <sys/socketvar.h>
37
38
39 /*------------------------- Global Variables ------------------------*/
40
41 extern struct cfdriver iscsi_cd;
42
43 #if defined(ISCSI_DEBUG)
44 int debug_level = ISCSI_DEBUG;
45 #endif
46
47 #if defined(ISCSI_PERFTEST)
48 int perf_level = 0;
49 #endif
50
51 /* Device Structure */
52 iscsi_softc_t *sc = NULL;
53
54 /* the list of sessions */
55 session_list_t sessions = TAILQ_HEAD_INITIALIZER(sessions);
56
57 /* connections to clean up */
58 connection_list_t cleanup_list = TAILQ_HEAD_INITIALIZER(cleanup_list);
59 bool detaching = FALSE;
60 struct lwp *cleanproc = NULL;
61
62 /* the number of active send threads (for cleanup thread) */
63 uint32_t num_send_threads = 0;
64
65 /* Our node name, alias, and ISID */
66 uint8_t InitiatorName[ISCSI_STRING_LENGTH] = "";
67 uint8_t InitiatorAlias[ISCSI_STRING_LENGTH] = "";
68 login_isid_t InitiatorISID;
69
70 /******************************************************************************/
71
72 /*
73 System interface: autoconf and device structures
74 */
75
76 void iscsiattach(int);
77 void iscsi_attach(device_t parent, device_t self, void *aux);
78 int iscsi_match(device_t, cfdata_t, void *);
79 int iscsi_detach(device_t, int);
80
81
82 CFATTACH_DECL_NEW(iscsi, sizeof(struct iscsi_softc), iscsi_match, iscsi_attach,
83 iscsi_detach, NULL);
84
85
86 int iscsiopen(dev_t, int, int, PTHREADOBJ);
87 int iscsiclose(dev_t, int, int, PTHREADOBJ);
88
89 struct cdevsw iscsi_cdevsw = {
90 iscsiopen, iscsiclose,
91 noread, nowrite,
92 iscsiioctl, nostop, notty, nopoll, nommap, nokqfilter, D_OTHER
93 };
94
95 /******************************************************************************/
96
97 STATIC void iscsi_scsipi_request(struct scsipi_channel *,
98 scsipi_adapter_req_t, void *);
99 STATIC void iscsi_minphys(struct buf *);
100
101 /******************************************************************************/
102
103 /*******************************************************************************
104 * Open and Close device interfaces. We don't really need them, because we don't
105 * have to keep track of device opens and closes from userland. But apps can't
106 * call ioctl without a handle to the device, and the kernel doesn't hand out
107 * handles without an open routine in the driver. So here they are in all their
108 * glory...
109 *******************************************************************************/
110
111 int
112 iscsiopen(dev_t dev, int flag, int mode, PTHREADOBJ p)
113 {
114
115 DEB(99, ("ISCSI Open\n"));
116 return 0;
117 }
118
119 int
120 iscsiclose(dev_t dev, int flag, int mode, PTHREADOBJ p)
121 {
122
123 DEB(99, ("ISCSI Close\n"));
124 return 0;
125 }
126
127 /******************************************************************************/
128
129 /*
130 * The config Match routine.
131 * Not much to do here, either - this is a pseudo-device.
132 */
133
134 int
135 iscsi_match(device_t self, cfdata_t cfdata, void *arg)
136 {
137 return 1;
138 }
139
140 /*
141 * iscsiattach:
142 * Only called when statically configured into a kernel
143 */
144 void
145 iscsiattach(int n)
146 {
147 int err;
148 cfdata_t cf;
149
150 err = config_cfattach_attach(iscsi_cd.cd_name, &iscsi_ca);
151 if (err) {
152 aprint_error("%s: couldn't register cfattach: %d\n",
153 iscsi_cd.cd_name, err);
154 config_cfdriver_detach(&iscsi_cd);
155 return;
156 }
157
158 if (n > 1)
159 aprint_error("%s: only one device supported\n",
160 iscsi_cd.cd_name);
161
162 cf = kmem_alloc(sizeof(struct cfdata), KM_NOSLEEP);
163 if (cf == NULL) {
164 aprint_error("%s: couldn't allocate cfdata\n",
165 iscsi_cd.cd_name);
166 return;
167 }
168 cf->cf_name = iscsi_cd.cd_name;
169 cf->cf_atname = iscsi_cd.cd_name;
170 cf->cf_unit = 0;
171 cf->cf_fstate = FSTATE_NOTFOUND;
172
173 (void)config_attach_pseudo(cf);
174 return;
175 }
176
177 /*
178 * iscsi_attach:
179 * One-time inits go here. Not much for now, probably even less later.
180 */
181 void
182 iscsi_attach(device_t parent, device_t self, void *aux)
183 {
184
185 DEBOUT(("ISCSI: iscsi_attach, parent=%p, self=%p, aux=%p\n", parent,
186 self, aux));
187 sc = (iscsi_softc_t *) device_private(self);
188 sc->sc_dev = self;
189 if (kthread_create(PRI_NONE, 0, NULL, iscsi_cleanup_thread,
190 NULL, &cleanproc, "Cleanup") != 0) {
191 panic("Can't create cleanup thread!");
192 }
193 aprint_normal("%s: attached. major = %d\n", iscsi_cd.cd_name,
194 cdevsw_lookup_major(&iscsi_cdevsw));
195 }
196
197 /*
198 * iscsi_detach:
199 * Cleanup.
200 */
201 int
202 iscsi_detach(device_t self, int flags)
203 {
204
205 DEBOUT(("ISCSI: detach\n"));
206 kill_all_sessions();
207 detaching = TRUE;
208 while (cleanproc != NULL) {
209 wakeup(&cleanup_list);
210 tsleep(&cleanup_list, PWAIT, "detach_wait", 20);
211 }
212 return 0;
213 }
214
215 /******************************************************************************/
216
217 typedef struct quirktab_t {
218 const char *tgt;
219 size_t tgtlen;
220 const char *iqn;
221 size_t iqnlen;
222 uint32_t quirks;
223 } quirktab_t;
224
225 static const quirktab_t quirktab[] = {
226 { "StarWind", 8,
227 "iqn.2008-08.com.starwindsoftware", 32,
228 PQUIRK_ONLYBIG },
229 { "UNH", 3,
230 "iqn.2002-10.edu.unh.", 20,
231 PQUIRK_NOBIGMODESENSE |
232 PQUIRK_NOMODESENSE |
233 PQUIRK_NOSYNCCACHE },
234 { "NetBSD", 6,
235 "iqn.1994-04.org.netbsd.", 23,
236 0 },
237 { "Unknown", 7,
238 "unknown", 7,
239 0 },
240 { NULL, 0, NULL, 0, 0 }
241 };
242
243 /* loop through the quirktab looking for a match on target name */
244 static const quirktab_t *
245 getquirks(const char *iqn)
246 {
247 const quirktab_t *qp;
248
249 if (iqn == NULL) {
250 iqn = "unknown";
251 }
252 for (qp = quirktab ; qp->iqn ; qp++) {
253 if (strncmp(qp->iqn, iqn, qp->iqnlen) == 0) {
254 break;
255 }
256 }
257 return qp;
258 }
259
260 /******************************************************************************/
261
262 /*
263 * map_session
264 * This (indirectly) maps the existing LUNs for a target to SCSI devices
265 * by going through config_found to tell any child drivers that there's
266 * a new adapter.
267 * Note that each session is equivalent to a SCSI adapter.
268 *
269 * Parameter: the session pointer
270 *
271 * Returns: 1 on success, 0 on failure
272 *
273 * ToDo: Figuring out how to handle more than one LUN. It appears that
274 * the NetBSD SCSI LUN discovery doesn't use "report LUNs", and instead
275 * goes through the LUNs sequentially, stopping somewhere on the way if it
276 * gets an error. We may have to do some LUN mapping in here if this is
277 * really how things work.
278 */
279
280 int
281 map_session(session_t *session)
282 {
283 struct scsipi_adapter *adapt = &session->sc_adapter;
284 struct scsipi_channel *chan = &session->sc_channel;
285 const quirktab_t *tgt;
286
287 if (sc == NULL) {
288 /* we haven't gone through the config process */
289 /* (shouldn't happen) */
290 DEBOUT(("Map: No device pointer!\n"));
291 return 0;
292 }
293 /*
294 * Fill in the scsipi_adapter.
295 */
296 adapt->adapt_dev = sc->sc_dev;
297 adapt->adapt_nchannels = 1;
298 adapt->adapt_request = iscsi_scsipi_request;
299 adapt->adapt_minphys = iscsi_minphys;
300 adapt->adapt_openings = CCBS_PER_SESSION;
301 adapt->adapt_max_periph = CCBS_PER_SESSION;
302
303 /*
304 * Fill in the scsipi_channel.
305 */
306 if ((tgt = getquirks(chan->chan_name)) == NULL) {
307 tgt = getquirks("unknown");
308 }
309 chan->chan_name = tgt->tgt;
310 chan->chan_defquirks = tgt->quirks;
311 chan->chan_adapter = adapt;
312 chan->chan_bustype = &scsi_bustype;
313 chan->chan_channel = 0;
314 chan->chan_flags = SCSIPI_CHAN_NOSETTLE;
315 chan->chan_ntargets = 1;
316 chan->chan_nluns = 16; /* ToDo: ??? */
317 chan->chan_id = session->id;
318
319 session->child_dev = config_found(sc->sc_dev, chan, scsiprint);
320
321 return session->child_dev != NULL;
322 }
323
324
325 /*
326 * unmap_session
327 * This (indirectly) unmaps the existing all LUNs for a target by
328 * telling the config system that the adapter has detached.
329 *
330 * Parameter: the session pointer
331 */
332
333 void
334 unmap_session(session_t *session)
335 {
336 device_t dev;
337
338 if ((dev = session->child_dev) != NULL) {
339 session->child_dev = NULL;
340 config_detach(dev, DETACH_FORCE);
341 }
342 }
343
344 /******************************************************************************/
345
346 /*****************************************************************************
347 * SCSI interface routines
348 *****************************************************************************/
349
350 /*
351 * iscsi_scsipi_request:
352 * Perform a request for the SCSIPI layer.
353 */
354
355 void
356 iscsi_scsipi_request(struct scsipi_channel *chan, scsipi_adapter_req_t req,
357 void *arg)
358 {
359 struct scsipi_adapter *adapt = chan->chan_adapter;
360 struct scsipi_xfer *xs;
361 session_t *session;
362 int flags;
363
364 session = (session_t *) adapt; /* adapter is first field in session */
365
366 switch (req) {
367 case ADAPTER_REQ_RUN_XFER:
368 DEB(9, ("ISCSI: scsipi_request RUN_XFER\n"));
369 xs = arg;
370 flags = xs->xs_control;
371
372 if ((flags & XS_CTL_POLL) != 0) {
373 xs->error = XS_DRIVER_STUFFUP;
374 DEBOUT(("Run Xfer request with polling\n"));
375 scsipi_done(xs);
376 return;
377 }
378 /*
379 * NOTE: It appears that XS_CTL_DATA_UIO is not actually used anywhere.
380 * Since it really would complicate matters to handle offsets
381 * into scatter-gather lists, and a number of other drivers don't
382 * handle uio-based data as well, XS_CTL_DATA_UIO isn't
383 * implemented in this driver (at least for now).
384 */
385 if (flags & XS_CTL_DATA_UIO) {
386 xs->error = XS_DRIVER_STUFFUP;
387 DEBOUT(("Run Xfer with data in UIO\n"));
388 scsipi_done(xs);
389 return;
390 }
391
392 send_run_xfer(session, xs);
393 DEB(9, ("scsipi_req returns\n"));
394 return;
395
396 case ADAPTER_REQ_GROW_RESOURCES:
397 DEBOUT(("ISCSI: scsipi_request GROW_RESOURCES\n"));
398 return;
399
400 case ADAPTER_REQ_SET_XFER_MODE:
401 DEB(5, ("ISCSI: scsipi_request SET_XFER_MODE\n"));
402 return;
403
404 default:
405 break;
406 }
407 DEBOUT(("ISCSI: scsipi_request with invalid REQ code %d\n", req));
408 }
409
410 /* cap the transfer at 64K */
411 #define ISCSI_MAX_XFER 65536
412
413 /*
414 * iscsi_minphys:
415 * Limit a transfer to our maximum transfer size.
416 */
417
418 void
419 iscsi_minphys(struct buf *bp)
420 {
421 if (bp->b_bcount > ISCSI_MAX_XFER) {
422 bp->b_bcount = ISCSI_MAX_XFER;
423 }
424 }
425
426 /*****************************************************************************
427 * SCSI job execution helper routines
428 *****************************************************************************/
429
430 /*
431 * iscsi_done:
432 *
433 * A CCB has completed execution. Pass the status back to the
434 * upper layer.
435 */
436 void
437 iscsi_done(ccb_t *ccb)
438 {
439 struct scsipi_xfer *xs = ccb->xs;
440 /*DEBOUT (("iscsi_done\n")); */
441
442 if (xs != NULL) {
443 xs->resid = ccb->residual;
444
445 switch (ccb->status) {
446 case ISCSI_STATUS_SUCCESS:
447 xs->error = 0;
448 break;
449
450 case ISCSI_STATUS_CHECK_CONDITION:
451 xs->error = XS_SENSE;
452 xs->error = XS_SENSE;
453 #ifdef ISCSI_DEBUG
454 {
455 uint8_t *s = (uint8_t *) (&xs->sense);
456 DEB(5, ("Scsipi_done, error=XS_SENSE, sense data=%02x "
457 "%02x %02x %02x...\n",
458 s[0], s[1], s[2], s[3]));
459 }
460 #endif
461 break;
462
463 case ISCSI_STATUS_TARGET_BUSY:
464 xs->error = XS_BUSY;
465 break;
466
467 case ISCSI_STATUS_SOCKET_ERROR:
468 case ISCSI_STATUS_TIMEOUT:
469 xs->error = XS_SELTIMEOUT;
470 break;
471
472 default:
473 xs->error = XS_DRIVER_STUFFUP;
474 break;
475 }
476
477 DEB(99, ("Calling scsipi_done (%p), err = %d\n", xs, xs->error));
478 scsipi_done(xs);
479 DEB(99, ("scsipi_done returned\n"));
480 }
481
482 free_ccb(ccb);
483 }
484
485 /* Kernel Module support */
486 #ifdef _MODULE
487
488 #include <sys/module.h>
489
490 MODULE(MODULE_CLASS_DRIVER, iscsi, NULL);
491 static const struct cfiattrdata ibescsi_info = { "scsi", 1,
492 {{"channel", "-1", -1},}
493 };
494 static const struct cfiattrdata *const iscsi_attrs[] = { &ibescsi_info, NULL };
495
496 CFDRIVER_DECL(iscsi, DV_DULL, iscsi_attrs);
497
498 static struct cfdata iscsi_cfdata[] = {
499 {
500 .cf_name = "iscsi",
501 .cf_atname = "iscsi",
502 .cf_unit = 0, /* Only unit 0 is ever used */
503 .cf_fstate = FSTATE_NOTFOUND,
504 .cf_loc = NULL,
505 .cf_flags = 0,
506 .cf_pspec = NULL,
507 },
508 { NULL, NULL, 0, 0, NULL, 0, NULL }
509 };
510
511 static int
512 iscsi_modcmd(modcmd_t cmd, void *arg)
513 {
514 devmajor_t cmajor = NODEVMAJOR, bmajor = NODEVMAJOR;
515 int error;
516
517 switch (cmd) {
518 case MODULE_CMD_INIT:
519 error = config_cfdriver_attach(&iscsi_cd);
520 if (error) {
521 return error;
522 }
523
524 error = config_cfattach_attach(iscsi_cd.cd_name, &iscsi_ca);
525 if (error) {
526 config_cfdriver_detach(&iscsi_cd);
527 aprint_error("%s: unable to register cfattach\n",
528 iscsi_cd.cd_name);
529 return error;
530 }
531
532 error = config_cfdata_attach(iscsi_cfdata, 1);
533 if (error) {
534 aprint_error("%s: unable to attach cfdata\n",
535 iscsi_cd.cd_name);
536 config_cfattach_detach(iscsi_cd.cd_name, &iscsi_ca);
537 config_cfdriver_detach(&iscsi_cd);
538 return error;
539 }
540
541 error = devsw_attach(iscsi_cd.cd_name, NULL, &bmajor,
542 &iscsi_cdevsw, &cmajor);
543 if (error) {
544 aprint_error("%s: unable to register devsw\n",
545 iscsi_cd.cd_name);
546 config_cfdata_detach(iscsi_cfdata);
547 config_cfattach_detach(iscsi_cd.cd_name, &iscsi_ca);
548 config_cfdriver_detach(&iscsi_cd);
549 return error;
550 }
551
552 if (config_attach_pseudo(iscsi_cfdata) == NULL) {
553 aprint_error("%s: config_attach_pseudo failed\n",
554 iscsi_cd.cd_name);
555 config_cfattach_detach(iscsi_cd.cd_name, &iscsi_ca);
556 config_cfdriver_detach(&iscsi_cd);
557 return ENXIO;
558 }
559
560 return 0;
561 break;
562
563 case MODULE_CMD_FINI:
564 error = config_cfdata_detach(iscsi_cfdata);
565 if (error)
566 return error;
567
568 config_cfattach_detach(iscsi_cd.cd_name, &iscsi_ca);
569 config_cfdriver_detach(&iscsi_cd);
570 devsw_detach(NULL, &iscsi_cdevsw);
571
572 return 0;
573 break;
574
575 case MODULE_CMD_AUTOUNLOAD:
576 return EBUSY;
577 break;
578
579 default:
580 return ENOTTY;
581 break;
582 }
583 }
584 #endif /* _MODULE */
585