2 * iSCSI transport class definitions
4 * Copyright (C) IBM Corporation, 2004
5 * Copyright (C) Mike Christie, 2004 - 2005
6 * Copyright (C) Dmitry Yusupov, 2004 - 2005
7 * Copyright (C) Alex Aizman, 2004 - 2005
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
23 #include <linux/module.h>
24 #include <linux/mutex.h>
26 #include <scsi/scsi.h>
27 #include <scsi/scsi_host.h>
28 #include <scsi/scsi_device.h>
29 #include <scsi/scsi_transport.h>
30 #include <scsi/scsi_transport_iscsi.h>
31 #include <scsi/iscsi_if.h>
33 #define ISCSI_SESSION_ATTRS 21
34 #define ISCSI_CONN_ATTRS 13
35 #define ISCSI_HOST_ATTRS 4
37 #define ISCSI_TRANSPORT_VERSION "2.0-870"
39 struct iscsi_internal {
41 struct scsi_transport_template t;
42 struct iscsi_transport *iscsi_transport;
43 struct list_head list;
46 struct device_attribute *host_attrs[ISCSI_HOST_ATTRS + 1];
47 struct transport_container conn_cont;
48 struct device_attribute *conn_attrs[ISCSI_CONN_ATTRS + 1];
49 struct transport_container session_cont;
50 struct device_attribute *session_attrs[ISCSI_SESSION_ATTRS + 1];
53 static atomic_t iscsi_session_nr; /* sysfs session id for next new session */
54 static struct workqueue_struct *iscsi_eh_timer_workq;
57 * list of registered transports and lock that must
58 * be held while accessing list. The iscsi_transport_lock must
59 * be acquired after the rx_queue_mutex.
61 static LIST_HEAD(iscsi_transports);
62 static DEFINE_SPINLOCK(iscsi_transport_lock);
64 #define to_iscsi_internal(tmpl) \
65 container_of(tmpl, struct iscsi_internal, t)
67 #define dev_to_iscsi_internal(_dev) \
68 container_of(_dev, struct iscsi_internal, dev)
70 static void iscsi_transport_release(struct device *dev)
72 struct iscsi_internal *priv = dev_to_iscsi_internal(dev);
77 * iscsi_transport_class represents the iscsi_transports that are
80 static struct class iscsi_transport_class = {
81 .name = "iscsi_transport",
82 .dev_release = iscsi_transport_release,
86 show_transport_handle(struct device *dev, struct device_attribute *attr,
89 struct iscsi_internal *priv = dev_to_iscsi_internal(dev);
90 return sprintf(buf, "%llu\n", (unsigned long long)iscsi_handle(priv->iscsi_transport));
92 static DEVICE_ATTR(handle, S_IRUGO, show_transport_handle, NULL);
94 #define show_transport_attr(name, format) \
96 show_transport_##name(struct device *dev, \
97 struct device_attribute *attr,char *buf) \
99 struct iscsi_internal *priv = dev_to_iscsi_internal(dev); \
100 return sprintf(buf, format"\n", priv->iscsi_transport->name); \
102 static DEVICE_ATTR(name, S_IRUGO, show_transport_##name, NULL);
104 show_transport_attr(caps, "0x%x");
106 static struct attribute *iscsi_transport_attrs[] = {
107 &dev_attr_handle.attr,
112 static struct attribute_group iscsi_transport_group = {
113 .attrs = iscsi_transport_attrs,
117 * iSCSI endpoint attrs
119 #define iscsi_dev_to_endpoint(_dev) \
120 container_of(_dev, struct iscsi_endpoint, dev)
122 #define ISCSI_ATTR(_prefix,_name,_mode,_show,_store) \
123 struct device_attribute dev_attr_##_prefix##_##_name = \
124 __ATTR(_name,_mode,_show,_store)
126 static void iscsi_endpoint_release(struct device *dev)
128 struct iscsi_endpoint *ep = iscsi_dev_to_endpoint(dev);
132 static struct class iscsi_endpoint_class = {
133 .name = "iscsi_endpoint",
134 .dev_release = iscsi_endpoint_release,
138 show_ep_handle(struct device *dev, struct device_attribute *attr, char *buf)
140 struct iscsi_endpoint *ep = iscsi_dev_to_endpoint(dev);
141 return sprintf(buf, "%llu\n", (unsigned long long) ep->id);
143 static ISCSI_ATTR(ep, handle, S_IRUGO, show_ep_handle, NULL);
145 static struct attribute *iscsi_endpoint_attrs[] = {
146 &dev_attr_ep_handle.attr,
150 static struct attribute_group iscsi_endpoint_group = {
151 .attrs = iscsi_endpoint_attrs,
154 #define ISCSI_MAX_EPID -1
156 static int iscsi_match_epid(struct device *dev, void *data)
158 struct iscsi_endpoint *ep = iscsi_dev_to_endpoint(dev);
159 uint64_t *epid = (uint64_t *) data;
161 return *epid == ep->id;
164 struct iscsi_endpoint *
165 iscsi_create_endpoint(int dd_size)
168 struct iscsi_endpoint *ep;
172 for (id = 1; id < ISCSI_MAX_EPID; id++) {
173 dev = class_find_device(&iscsi_endpoint_class, NULL, &id,
178 if (id == ISCSI_MAX_EPID) {
179 printk(KERN_ERR "Too many connections. Max supported %u\n",
184 ep = kzalloc(sizeof(*ep) + dd_size, GFP_KERNEL);
189 ep->dev.class = &iscsi_endpoint_class;
190 dev_set_name(&ep->dev, "ep-%llu", (unsigned long long) id);
191 err = device_register(&ep->dev);
195 err = sysfs_create_group(&ep->dev.kobj, &iscsi_endpoint_group);
200 ep->dd_data = &ep[1];
204 device_unregister(&ep->dev);
211 EXPORT_SYMBOL_GPL(iscsi_create_endpoint);
213 void iscsi_destroy_endpoint(struct iscsi_endpoint *ep)
215 sysfs_remove_group(&ep->dev.kobj, &iscsi_endpoint_group);
216 device_unregister(&ep->dev);
218 EXPORT_SYMBOL_GPL(iscsi_destroy_endpoint);
220 struct iscsi_endpoint *iscsi_lookup_endpoint(u64 handle)
222 struct iscsi_endpoint *ep;
225 dev = class_find_device(&iscsi_endpoint_class, NULL, &handle,
230 ep = iscsi_dev_to_endpoint(dev);
232 * we can drop this now because the interface will prevent
233 * removals and lookups from racing.
238 EXPORT_SYMBOL_GPL(iscsi_lookup_endpoint);
240 static int iscsi_setup_host(struct transport_container *tc, struct device *dev,
243 struct Scsi_Host *shost = dev_to_shost(dev);
244 struct iscsi_cls_host *ihost = shost->shost_data;
246 memset(ihost, 0, sizeof(*ihost));
247 atomic_set(&ihost->nr_scans, 0);
248 mutex_init(&ihost->mutex);
250 snprintf(ihost->scan_workq_name, sizeof(ihost->scan_workq_name),
251 "iscsi_scan_%d", shost->host_no);
252 ihost->scan_workq = create_singlethread_workqueue(
253 ihost->scan_workq_name);
254 if (!ihost->scan_workq)
259 static int iscsi_remove_host(struct transport_container *tc, struct device *dev,
262 struct Scsi_Host *shost = dev_to_shost(dev);
263 struct iscsi_cls_host *ihost = shost->shost_data;
265 destroy_workqueue(ihost->scan_workq);
269 static DECLARE_TRANSPORT_CLASS(iscsi_host_class,
275 static DECLARE_TRANSPORT_CLASS(iscsi_session_class,
281 static DECLARE_TRANSPORT_CLASS(iscsi_connection_class,
287 static struct sock *nls;
288 static DEFINE_MUTEX(rx_queue_mutex);
290 static LIST_HEAD(sesslist);
291 static DEFINE_SPINLOCK(sesslock);
292 static LIST_HEAD(connlist);
293 static DEFINE_SPINLOCK(connlock);
295 static uint32_t iscsi_conn_get_sid(struct iscsi_cls_conn *conn)
297 struct iscsi_cls_session *sess = iscsi_dev_to_session(conn->dev.parent);
302 * Returns the matching session to a given sid
304 static struct iscsi_cls_session *iscsi_session_lookup(uint32_t sid)
307 struct iscsi_cls_session *sess;
309 spin_lock_irqsave(&sesslock, flags);
310 list_for_each_entry(sess, &sesslist, sess_list) {
311 if (sess->sid == sid) {
312 spin_unlock_irqrestore(&sesslock, flags);
316 spin_unlock_irqrestore(&sesslock, flags);
321 * Returns the matching connection to a given sid / cid tuple
323 static struct iscsi_cls_conn *iscsi_conn_lookup(uint32_t sid, uint32_t cid)
326 struct iscsi_cls_conn *conn;
328 spin_lock_irqsave(&connlock, flags);
329 list_for_each_entry(conn, &connlist, conn_list) {
330 if ((conn->cid == cid) && (iscsi_conn_get_sid(conn) == sid)) {
331 spin_unlock_irqrestore(&connlock, flags);
335 spin_unlock_irqrestore(&connlock, flags);
340 * The following functions can be used by LLDs that allocate
341 * their own scsi_hosts or by software iscsi LLDs
346 } iscsi_session_state_names[] = {
347 { ISCSI_SESSION_LOGGED_IN, "LOGGED_IN" },
348 { ISCSI_SESSION_FAILED, "FAILED" },
349 { ISCSI_SESSION_FREE, "FREE" },
352 static const char *iscsi_session_state_name(int state)
357 for (i = 0; i < ARRAY_SIZE(iscsi_session_state_names); i++) {
358 if (iscsi_session_state_names[i].value == state) {
359 name = iscsi_session_state_names[i].name;
366 int iscsi_session_chkready(struct iscsi_cls_session *session)
371 spin_lock_irqsave(&session->lock, flags);
372 switch (session->state) {
373 case ISCSI_SESSION_LOGGED_IN:
376 case ISCSI_SESSION_FAILED:
377 err = DID_TRANSPORT_DISRUPTED << 16;
379 case ISCSI_SESSION_FREE:
380 err = DID_TRANSPORT_FAILFAST << 16;
383 err = DID_NO_CONNECT << 16;
386 spin_unlock_irqrestore(&session->lock, flags);
389 EXPORT_SYMBOL_GPL(iscsi_session_chkready);
391 static void iscsi_session_release(struct device *dev)
393 struct iscsi_cls_session *session = iscsi_dev_to_session(dev);
394 struct Scsi_Host *shost;
396 shost = iscsi_session_to_shost(session);
397 scsi_host_put(shost);
401 static int iscsi_is_session_dev(const struct device *dev)
403 return dev->release == iscsi_session_release;
406 static int iscsi_iter_session_fn(struct device *dev, void *data)
408 void (* fn) (struct iscsi_cls_session *) = data;
410 if (!iscsi_is_session_dev(dev))
412 fn(iscsi_dev_to_session(dev));
416 void iscsi_host_for_each_session(struct Scsi_Host *shost,
417 void (*fn)(struct iscsi_cls_session *))
419 device_for_each_child(&shost->shost_gendev, fn,
420 iscsi_iter_session_fn);
422 EXPORT_SYMBOL_GPL(iscsi_host_for_each_session);
425 * iscsi_scan_finished - helper to report when running scans are done
427 * @time: scan run time
429 * This function can be used by drives like qla4xxx to report to the scsi
430 * layer when the scans it kicked off at module load time are done.
432 int iscsi_scan_finished(struct Scsi_Host *shost, unsigned long time)
434 struct iscsi_cls_host *ihost = shost->shost_data;
436 * qla4xxx will have kicked off some session unblocks before calling
437 * scsi_scan_host, so just wait for them to complete.
439 return !atomic_read(&ihost->nr_scans);
441 EXPORT_SYMBOL_GPL(iscsi_scan_finished);
443 struct iscsi_scan_data {
444 unsigned int channel;
449 static int iscsi_user_scan_session(struct device *dev, void *data)
451 struct iscsi_scan_data *scan_data = data;
452 struct iscsi_cls_session *session;
453 struct Scsi_Host *shost;
454 struct iscsi_cls_host *ihost;
458 if (!iscsi_is_session_dev(dev))
461 session = iscsi_dev_to_session(dev);
462 shost = iscsi_session_to_shost(session);
463 ihost = shost->shost_data;
465 mutex_lock(&ihost->mutex);
466 spin_lock_irqsave(&session->lock, flags);
467 if (session->state != ISCSI_SESSION_LOGGED_IN) {
468 spin_unlock_irqrestore(&session->lock, flags);
469 mutex_unlock(&ihost->mutex);
472 id = session->target_id;
473 spin_unlock_irqrestore(&session->lock, flags);
475 if (id != ISCSI_MAX_TARGET) {
476 if ((scan_data->channel == SCAN_WILD_CARD ||
477 scan_data->channel == 0) &&
478 (scan_data->id == SCAN_WILD_CARD ||
479 scan_data->id == id))
480 scsi_scan_target(&session->dev, 0, id,
483 mutex_unlock(&ihost->mutex);
487 static int iscsi_user_scan(struct Scsi_Host *shost, uint channel,
490 struct iscsi_scan_data scan_data;
492 scan_data.channel = channel;
496 return device_for_each_child(&shost->shost_gendev, &scan_data,
497 iscsi_user_scan_session);
500 static void iscsi_scan_session(struct work_struct *work)
502 struct iscsi_cls_session *session =
503 container_of(work, struct iscsi_cls_session, scan_work);
504 struct Scsi_Host *shost = iscsi_session_to_shost(session);
505 struct iscsi_cls_host *ihost = shost->shost_data;
506 struct iscsi_scan_data scan_data;
508 scan_data.channel = 0;
509 scan_data.id = SCAN_WILD_CARD;
510 scan_data.lun = SCAN_WILD_CARD;
512 iscsi_user_scan_session(&session->dev, &scan_data);
513 atomic_dec(&ihost->nr_scans);
516 static void session_recovery_timedout(struct work_struct *work)
518 struct iscsi_cls_session *session =
519 container_of(work, struct iscsi_cls_session,
523 iscsi_cls_session_printk(KERN_INFO, session,
524 "session recovery timed out after %d secs\n",
525 session->recovery_tmo);
527 spin_lock_irqsave(&session->lock, flags);
528 switch (session->state) {
529 case ISCSI_SESSION_FAILED:
530 session->state = ISCSI_SESSION_FREE;
532 case ISCSI_SESSION_LOGGED_IN:
533 case ISCSI_SESSION_FREE:
534 /* we raced with the unblock's flush */
535 spin_unlock_irqrestore(&session->lock, flags);
538 spin_unlock_irqrestore(&session->lock, flags);
540 if (session->transport->session_recovery_timedout)
541 session->transport->session_recovery_timedout(session);
543 scsi_target_unblock(&session->dev);
546 static void __iscsi_unblock_session(struct work_struct *work)
548 struct iscsi_cls_session *session =
549 container_of(work, struct iscsi_cls_session,
551 struct Scsi_Host *shost = iscsi_session_to_shost(session);
552 struct iscsi_cls_host *ihost = shost->shost_data;
556 * The recovery and unblock work get run from the same workqueue,
557 * so try to cancel it if it was going to run after this unblock.
559 cancel_delayed_work(&session->recovery_work);
560 spin_lock_irqsave(&session->lock, flags);
561 session->state = ISCSI_SESSION_LOGGED_IN;
562 spin_unlock_irqrestore(&session->lock, flags);
564 scsi_target_unblock(&session->dev);
566 * Only do kernel scanning if the driver is properly hooked into
567 * the async scanning code (drivers like iscsi_tcp do login and
568 * scanning from userspace).
570 if (shost->hostt->scan_finished) {
571 if (queue_work(ihost->scan_workq, &session->scan_work))
572 atomic_inc(&ihost->nr_scans);
577 * iscsi_unblock_session - set a session as logged in and start IO.
578 * @session: iscsi session
580 * Mark a session as ready to accept IO.
582 void iscsi_unblock_session(struct iscsi_cls_session *session)
584 queue_work(iscsi_eh_timer_workq, &session->unblock_work);
586 * make sure all the events have completed before tell the driver
589 flush_workqueue(iscsi_eh_timer_workq);
591 EXPORT_SYMBOL_GPL(iscsi_unblock_session);
593 static void __iscsi_block_session(struct work_struct *work)
595 struct iscsi_cls_session *session =
596 container_of(work, struct iscsi_cls_session,
600 spin_lock_irqsave(&session->lock, flags);
601 session->state = ISCSI_SESSION_FAILED;
602 spin_unlock_irqrestore(&session->lock, flags);
603 scsi_target_block(&session->dev);
604 queue_delayed_work(iscsi_eh_timer_workq, &session->recovery_work,
605 session->recovery_tmo * HZ);
608 void iscsi_block_session(struct iscsi_cls_session *session)
610 queue_work(iscsi_eh_timer_workq, &session->block_work);
612 EXPORT_SYMBOL_GPL(iscsi_block_session);
614 static void __iscsi_unbind_session(struct work_struct *work)
616 struct iscsi_cls_session *session =
617 container_of(work, struct iscsi_cls_session,
619 struct Scsi_Host *shost = iscsi_session_to_shost(session);
620 struct iscsi_cls_host *ihost = shost->shost_data;
623 /* Prevent new scans and make sure scanning is not in progress */
624 mutex_lock(&ihost->mutex);
625 spin_lock_irqsave(&session->lock, flags);
626 if (session->target_id == ISCSI_MAX_TARGET) {
627 spin_unlock_irqrestore(&session->lock, flags);
628 mutex_unlock(&ihost->mutex);
631 session->target_id = ISCSI_MAX_TARGET;
632 spin_unlock_irqrestore(&session->lock, flags);
633 mutex_unlock(&ihost->mutex);
635 scsi_remove_target(&session->dev);
636 iscsi_session_event(session, ISCSI_KEVENT_UNBIND_SESSION);
639 static int iscsi_unbind_session(struct iscsi_cls_session *session)
641 struct Scsi_Host *shost = iscsi_session_to_shost(session);
642 struct iscsi_cls_host *ihost = shost->shost_data;
644 return queue_work(ihost->scan_workq, &session->unbind_work);
647 struct iscsi_cls_session *
648 iscsi_alloc_session(struct Scsi_Host *shost, struct iscsi_transport *transport,
651 struct iscsi_cls_session *session;
653 session = kzalloc(sizeof(*session) + dd_size,
658 session->transport = transport;
659 session->recovery_tmo = 120;
660 session->state = ISCSI_SESSION_FREE;
661 INIT_DELAYED_WORK(&session->recovery_work, session_recovery_timedout);
662 INIT_LIST_HEAD(&session->sess_list);
663 INIT_WORK(&session->unblock_work, __iscsi_unblock_session);
664 INIT_WORK(&session->block_work, __iscsi_block_session);
665 INIT_WORK(&session->unbind_work, __iscsi_unbind_session);
666 INIT_WORK(&session->scan_work, iscsi_scan_session);
667 spin_lock_init(&session->lock);
669 /* this is released in the dev's release function */
670 scsi_host_get(shost);
671 session->dev.parent = &shost->shost_gendev;
672 session->dev.release = iscsi_session_release;
673 device_initialize(&session->dev);
675 session->dd_data = &session[1];
678 EXPORT_SYMBOL_GPL(iscsi_alloc_session);
680 static int iscsi_get_next_target_id(struct device *dev, void *data)
682 struct iscsi_cls_session *session;
686 if (!iscsi_is_session_dev(dev))
689 session = iscsi_dev_to_session(dev);
690 spin_lock_irqsave(&session->lock, flags);
691 if (*((unsigned int *) data) == session->target_id)
693 spin_unlock_irqrestore(&session->lock, flags);
697 int iscsi_add_session(struct iscsi_cls_session *session, unsigned int target_id)
699 struct Scsi_Host *shost = iscsi_session_to_shost(session);
700 struct iscsi_cls_host *ihost;
702 unsigned int id = target_id;
705 ihost = shost->shost_data;
706 session->sid = atomic_add_return(1, &iscsi_session_nr);
708 if (id == ISCSI_MAX_TARGET) {
709 for (id = 0; id < ISCSI_MAX_TARGET; id++) {
710 err = device_for_each_child(&shost->shost_gendev, &id,
711 iscsi_get_next_target_id);
716 if (id == ISCSI_MAX_TARGET) {
717 iscsi_cls_session_printk(KERN_ERR, session,
718 "Too many iscsi targets. Max "
719 "number of targets is %d.\n",
720 ISCSI_MAX_TARGET - 1);
724 session->target_id = id;
726 dev_set_name(&session->dev, "session%u", session->sid);
727 err = device_add(&session->dev);
729 iscsi_cls_session_printk(KERN_ERR, session,
730 "could not register session's dev\n");
733 transport_register_device(&session->dev);
735 spin_lock_irqsave(&sesslock, flags);
736 list_add(&session->sess_list, &sesslist);
737 spin_unlock_irqrestore(&sesslock, flags);
739 iscsi_session_event(session, ISCSI_KEVENT_CREATE_SESSION);
743 scsi_host_put(shost);
746 EXPORT_SYMBOL_GPL(iscsi_add_session);
749 * iscsi_create_session - create iscsi class session
751 * @transport: iscsi transport
752 * @dd_size: private driver data size
753 * @target_id: which target
755 * This can be called from a LLD or iscsi_transport.
757 struct iscsi_cls_session *
758 iscsi_create_session(struct Scsi_Host *shost, struct iscsi_transport *transport,
759 int dd_size, unsigned int target_id)
761 struct iscsi_cls_session *session;
763 session = iscsi_alloc_session(shost, transport, dd_size);
767 if (iscsi_add_session(session, target_id)) {
768 iscsi_free_session(session);
773 EXPORT_SYMBOL_GPL(iscsi_create_session);
775 static void iscsi_conn_release(struct device *dev)
777 struct iscsi_cls_conn *conn = iscsi_dev_to_conn(dev);
778 struct device *parent = conn->dev.parent;
784 static int iscsi_is_conn_dev(const struct device *dev)
786 return dev->release == iscsi_conn_release;
789 static int iscsi_iter_destroy_conn_fn(struct device *dev, void *data)
791 if (!iscsi_is_conn_dev(dev))
793 return iscsi_destroy_conn(iscsi_dev_to_conn(dev));
796 void iscsi_remove_session(struct iscsi_cls_session *session)
798 struct Scsi_Host *shost = iscsi_session_to_shost(session);
799 struct iscsi_cls_host *ihost = shost->shost_data;
803 spin_lock_irqsave(&sesslock, flags);
804 list_del(&session->sess_list);
805 spin_unlock_irqrestore(&sesslock, flags);
807 /* make sure there are no blocks/unblocks queued */
808 flush_workqueue(iscsi_eh_timer_workq);
809 /* make sure the timedout callout is not running */
810 if (!cancel_delayed_work(&session->recovery_work))
811 flush_workqueue(iscsi_eh_timer_workq);
813 * If we are blocked let commands flow again. The lld or iscsi
814 * layer should set up the queuecommand to fail commands.
815 * We assume that LLD will not be calling block/unblock while
816 * removing the session.
818 spin_lock_irqsave(&session->lock, flags);
819 session->state = ISCSI_SESSION_FREE;
820 spin_unlock_irqrestore(&session->lock, flags);
822 scsi_target_unblock(&session->dev);
823 /* flush running scans then delete devices */
824 flush_workqueue(ihost->scan_workq);
825 __iscsi_unbind_session(&session->unbind_work);
827 /* hw iscsi may not have removed all connections from session */
828 err = device_for_each_child(&session->dev, NULL,
829 iscsi_iter_destroy_conn_fn);
831 iscsi_cls_session_printk(KERN_ERR, session,
832 "Could not delete all connections "
833 "for session. Error %d.\n", err);
835 transport_unregister_device(&session->dev);
836 device_del(&session->dev);
838 EXPORT_SYMBOL_GPL(iscsi_remove_session);
840 void iscsi_free_session(struct iscsi_cls_session *session)
842 iscsi_session_event(session, ISCSI_KEVENT_DESTROY_SESSION);
843 put_device(&session->dev);
845 EXPORT_SYMBOL_GPL(iscsi_free_session);
848 * iscsi_destroy_session - destroy iscsi session
849 * @session: iscsi_session
851 * Can be called by a LLD or iscsi_transport. There must not be
852 * any running connections.
854 int iscsi_destroy_session(struct iscsi_cls_session *session)
856 iscsi_remove_session(session);
857 iscsi_free_session(session);
860 EXPORT_SYMBOL_GPL(iscsi_destroy_session);
863 * iscsi_create_conn - create iscsi class connection
864 * @session: iscsi cls session
865 * @dd_size: private driver data size
866 * @cid: connection id
868 * This can be called from a LLD or iscsi_transport. The connection
869 * is child of the session so cid must be unique for all connections
872 * Since we do not support MCS, cid will normally be zero. In some cases
873 * for software iscsi we could be trying to preallocate a connection struct
874 * in which case there could be two connection structs and cid would be
877 struct iscsi_cls_conn *
878 iscsi_create_conn(struct iscsi_cls_session *session, int dd_size, uint32_t cid)
880 struct iscsi_transport *transport = session->transport;
881 struct iscsi_cls_conn *conn;
885 conn = kzalloc(sizeof(*conn) + dd_size, GFP_KERNEL);
889 conn->dd_data = &conn[1];
891 INIT_LIST_HEAD(&conn->conn_list);
892 conn->transport = transport;
895 /* this is released in the dev's release function */
896 if (!get_device(&session->dev))
899 dev_set_name(&conn->dev, "connection%d:%u", session->sid, cid);
900 conn->dev.parent = &session->dev;
901 conn->dev.release = iscsi_conn_release;
902 err = device_register(&conn->dev);
904 iscsi_cls_session_printk(KERN_ERR, session, "could not "
905 "register connection's dev\n");
906 goto release_parent_ref;
908 transport_register_device(&conn->dev);
910 spin_lock_irqsave(&connlock, flags);
911 list_add(&conn->conn_list, &connlist);
913 spin_unlock_irqrestore(&connlock, flags);
917 put_device(&session->dev);
923 EXPORT_SYMBOL_GPL(iscsi_create_conn);
926 * iscsi_destroy_conn - destroy iscsi class connection
927 * @conn: iscsi cls session
929 * This can be called from a LLD or iscsi_transport.
931 int iscsi_destroy_conn(struct iscsi_cls_conn *conn)
935 spin_lock_irqsave(&connlock, flags);
937 list_del(&conn->conn_list);
938 spin_unlock_irqrestore(&connlock, flags);
940 transport_unregister_device(&conn->dev);
941 device_unregister(&conn->dev);
944 EXPORT_SYMBOL_GPL(iscsi_destroy_conn);
947 * iscsi interface functions
949 static struct iscsi_internal *
950 iscsi_if_transport_lookup(struct iscsi_transport *tt)
952 struct iscsi_internal *priv;
955 spin_lock_irqsave(&iscsi_transport_lock, flags);
956 list_for_each_entry(priv, &iscsi_transports, list) {
957 if (tt == priv->iscsi_transport) {
958 spin_unlock_irqrestore(&iscsi_transport_lock, flags);
962 spin_unlock_irqrestore(&iscsi_transport_lock, flags);
967 iscsi_broadcast_skb(struct sk_buff *skb, gfp_t gfp)
969 return netlink_broadcast(nls, skb, 0, 1, gfp);
973 iscsi_unicast_skb(struct sk_buff *skb, int pid)
977 rc = netlink_unicast(nls, skb, pid, MSG_DONTWAIT);
979 printk(KERN_ERR "iscsi: can not unicast skb (%d)\n", rc);
986 int iscsi_recv_pdu(struct iscsi_cls_conn *conn, struct iscsi_hdr *hdr,
987 char *data, uint32_t data_size)
989 struct nlmsghdr *nlh;
991 struct iscsi_uevent *ev;
993 struct iscsi_internal *priv;
994 int len = NLMSG_SPACE(sizeof(*ev) + sizeof(struct iscsi_hdr) +
997 priv = iscsi_if_transport_lookup(conn->transport);
1001 skb = alloc_skb(len, GFP_ATOMIC);
1003 iscsi_conn_error_event(conn, ISCSI_ERR_CONN_FAILED);
1004 iscsi_cls_conn_printk(KERN_ERR, conn, "can not deliver "
1005 "control PDU: OOM\n");
1009 nlh = __nlmsg_put(skb, priv->daemon_pid, 0, 0, (len - sizeof(*nlh)), 0);
1010 ev = NLMSG_DATA(nlh);
1011 memset(ev, 0, sizeof(*ev));
1012 ev->transport_handle = iscsi_handle(conn->transport);
1013 ev->type = ISCSI_KEVENT_RECV_PDU;
1014 ev->r.recv_req.cid = conn->cid;
1015 ev->r.recv_req.sid = iscsi_conn_get_sid(conn);
1016 pdu = (char*)ev + sizeof(*ev);
1017 memcpy(pdu, hdr, sizeof(struct iscsi_hdr));
1018 memcpy(pdu + sizeof(struct iscsi_hdr), data, data_size);
1020 return iscsi_unicast_skb(skb, priv->daemon_pid);
1022 EXPORT_SYMBOL_GPL(iscsi_recv_pdu);
1024 void iscsi_conn_error_event(struct iscsi_cls_conn *conn, enum iscsi_err error)
1026 struct nlmsghdr *nlh;
1027 struct sk_buff *skb;
1028 struct iscsi_uevent *ev;
1029 struct iscsi_internal *priv;
1030 int len = NLMSG_SPACE(sizeof(*ev));
1032 priv = iscsi_if_transport_lookup(conn->transport);
1036 skb = alloc_skb(len, GFP_ATOMIC);
1038 iscsi_cls_conn_printk(KERN_ERR, conn, "gracefully ignored "
1039 "conn error (%d)\n", error);
1043 nlh = __nlmsg_put(skb, priv->daemon_pid, 0, 0, (len - sizeof(*nlh)), 0);
1044 ev = NLMSG_DATA(nlh);
1045 ev->transport_handle = iscsi_handle(conn->transport);
1046 ev->type = ISCSI_KEVENT_CONN_ERROR;
1047 ev->r.connerror.error = error;
1048 ev->r.connerror.cid = conn->cid;
1049 ev->r.connerror.sid = iscsi_conn_get_sid(conn);
1051 iscsi_broadcast_skb(skb, GFP_ATOMIC);
1053 iscsi_cls_conn_printk(KERN_INFO, conn, "detected conn error (%d)\n",
1056 EXPORT_SYMBOL_GPL(iscsi_conn_error_event);
1059 iscsi_if_send_reply(int pid, int seq, int type, int done, int multi,
1060 void *payload, int size)
1062 struct sk_buff *skb;
1063 struct nlmsghdr *nlh;
1064 int len = NLMSG_SPACE(size);
1065 int flags = multi ? NLM_F_MULTI : 0;
1066 int t = done ? NLMSG_DONE : type;
1068 skb = alloc_skb(len, GFP_ATOMIC);
1070 printk(KERN_ERR "Could not allocate skb to send reply.\n");
1074 nlh = __nlmsg_put(skb, pid, seq, t, (len - sizeof(*nlh)), 0);
1075 nlh->nlmsg_flags = flags;
1076 memcpy(NLMSG_DATA(nlh), payload, size);
1077 return iscsi_unicast_skb(skb, pid);
1081 iscsi_if_get_stats(struct iscsi_transport *transport, struct nlmsghdr *nlh)
1083 struct iscsi_uevent *ev = NLMSG_DATA(nlh);
1084 struct iscsi_stats *stats;
1085 struct sk_buff *skbstat;
1086 struct iscsi_cls_conn *conn;
1087 struct nlmsghdr *nlhstat;
1088 struct iscsi_uevent *evstat;
1089 struct iscsi_internal *priv;
1090 int len = NLMSG_SPACE(sizeof(*ev) +
1091 sizeof(struct iscsi_stats) +
1092 sizeof(struct iscsi_stats_custom) *
1093 ISCSI_STATS_CUSTOM_MAX);
1096 priv = iscsi_if_transport_lookup(transport);
1100 conn = iscsi_conn_lookup(ev->u.get_stats.sid, ev->u.get_stats.cid);
1107 skbstat = alloc_skb(len, GFP_ATOMIC);
1109 iscsi_cls_conn_printk(KERN_ERR, conn, "can not "
1110 "deliver stats: OOM\n");
1114 nlhstat = __nlmsg_put(skbstat, priv->daemon_pid, 0, 0,
1115 (len - sizeof(*nlhstat)), 0);
1116 evstat = NLMSG_DATA(nlhstat);
1117 memset(evstat, 0, sizeof(*evstat));
1118 evstat->transport_handle = iscsi_handle(conn->transport);
1119 evstat->type = nlh->nlmsg_type;
1120 evstat->u.get_stats.cid =
1121 ev->u.get_stats.cid;
1122 evstat->u.get_stats.sid =
1123 ev->u.get_stats.sid;
1124 stats = (struct iscsi_stats *)
1125 ((char*)evstat + sizeof(*evstat));
1126 memset(stats, 0, sizeof(*stats));
1128 transport->get_stats(conn, stats);
1129 actual_size = NLMSG_SPACE(sizeof(struct iscsi_uevent) +
1130 sizeof(struct iscsi_stats) +
1131 sizeof(struct iscsi_stats_custom) *
1132 stats->custom_length);
1133 actual_size -= sizeof(*nlhstat);
1134 actual_size = NLMSG_LENGTH(actual_size);
1135 skb_trim(skbstat, NLMSG_ALIGN(actual_size));
1136 nlhstat->nlmsg_len = actual_size;
1138 err = iscsi_unicast_skb(skbstat, priv->daemon_pid);
1139 } while (err < 0 && err != -ECONNREFUSED);
1145 * iscsi_session_event - send session destr. completion event
1146 * @session: iscsi class session
1147 * @event: type of event
1149 int iscsi_session_event(struct iscsi_cls_session *session,
1150 enum iscsi_uevent_e event)
1152 struct iscsi_internal *priv;
1153 struct Scsi_Host *shost;
1154 struct iscsi_uevent *ev;
1155 struct sk_buff *skb;
1156 struct nlmsghdr *nlh;
1157 int rc, len = NLMSG_SPACE(sizeof(*ev));
1159 priv = iscsi_if_transport_lookup(session->transport);
1162 shost = iscsi_session_to_shost(session);
1164 skb = alloc_skb(len, GFP_KERNEL);
1166 iscsi_cls_session_printk(KERN_ERR, session,
1167 "Cannot notify userspace of session "
1168 "event %u\n", event);
1172 nlh = __nlmsg_put(skb, priv->daemon_pid, 0, 0, (len - sizeof(*nlh)), 0);
1173 ev = NLMSG_DATA(nlh);
1174 ev->transport_handle = iscsi_handle(session->transport);
1178 case ISCSI_KEVENT_DESTROY_SESSION:
1179 ev->r.d_session.host_no = shost->host_no;
1180 ev->r.d_session.sid = session->sid;
1182 case ISCSI_KEVENT_CREATE_SESSION:
1183 ev->r.c_session_ret.host_no = shost->host_no;
1184 ev->r.c_session_ret.sid = session->sid;
1186 case ISCSI_KEVENT_UNBIND_SESSION:
1187 ev->r.unbind_session.host_no = shost->host_no;
1188 ev->r.unbind_session.sid = session->sid;
1191 iscsi_cls_session_printk(KERN_ERR, session, "Invalid event "
1198 * this will occur if the daemon is not up, so we just warn
1199 * the user and when the daemon is restarted it will handle it
1201 rc = iscsi_broadcast_skb(skb, GFP_KERNEL);
1203 iscsi_cls_session_printk(KERN_ERR, session,
1204 "Cannot notify userspace of session "
1205 "event %u. Check iscsi daemon\n",
1209 EXPORT_SYMBOL_GPL(iscsi_session_event);
1212 iscsi_if_create_session(struct iscsi_internal *priv, struct iscsi_endpoint *ep,
1213 struct iscsi_uevent *ev, uint32_t initial_cmdsn,
1214 uint16_t cmds_max, uint16_t queue_depth)
1216 struct iscsi_transport *transport = priv->iscsi_transport;
1217 struct iscsi_cls_session *session;
1220 session = transport->create_session(ep, cmds_max, queue_depth,
1221 initial_cmdsn, &host_no);
1225 ev->r.c_session_ret.host_no = host_no;
1226 ev->r.c_session_ret.sid = session->sid;
1231 iscsi_if_create_conn(struct iscsi_transport *transport, struct iscsi_uevent *ev)
1233 struct iscsi_cls_conn *conn;
1234 struct iscsi_cls_session *session;
1236 session = iscsi_session_lookup(ev->u.c_conn.sid);
1238 printk(KERN_ERR "iscsi: invalid session %d.\n",
1243 conn = transport->create_conn(session, ev->u.c_conn.cid);
1245 iscsi_cls_session_printk(KERN_ERR, session,
1246 "couldn't create a new connection.");
1250 ev->r.c_conn_ret.sid = session->sid;
1251 ev->r.c_conn_ret.cid = conn->cid;
1256 iscsi_if_destroy_conn(struct iscsi_transport *transport, struct iscsi_uevent *ev)
1258 struct iscsi_cls_conn *conn;
1260 conn = iscsi_conn_lookup(ev->u.d_conn.sid, ev->u.d_conn.cid);
1264 if (transport->destroy_conn)
1265 transport->destroy_conn(conn);
1270 iscsi_set_param(struct iscsi_transport *transport, struct iscsi_uevent *ev)
1272 char *data = (char*)ev + sizeof(*ev);
1273 struct iscsi_cls_conn *conn;
1274 struct iscsi_cls_session *session;
1275 int err = 0, value = 0;
1277 session = iscsi_session_lookup(ev->u.set_param.sid);
1278 conn = iscsi_conn_lookup(ev->u.set_param.sid, ev->u.set_param.cid);
1279 if (!conn || !session)
1282 switch (ev->u.set_param.param) {
1283 case ISCSI_PARAM_SESS_RECOVERY_TMO:
1284 sscanf(data, "%d", &value);
1286 session->recovery_tmo = value;
1289 err = transport->set_param(conn, ev->u.set_param.param,
1290 data, ev->u.set_param.len);
1297 iscsi_if_transport_ep(struct iscsi_transport *transport,
1298 struct iscsi_uevent *ev, int msg_type)
1300 struct iscsi_endpoint *ep;
1301 struct sockaddr *dst_addr;
1305 case ISCSI_UEVENT_TRANSPORT_EP_CONNECT:
1306 if (!transport->ep_connect)
1309 dst_addr = (struct sockaddr *)((char*)ev + sizeof(*ev));
1310 ep = transport->ep_connect(dst_addr,
1311 ev->u.ep_connect.non_blocking);
1315 ev->r.ep_connect_ret.handle = ep->id;
1317 case ISCSI_UEVENT_TRANSPORT_EP_POLL:
1318 if (!transport->ep_poll)
1321 ep = iscsi_lookup_endpoint(ev->u.ep_poll.ep_handle);
1325 ev->r.retcode = transport->ep_poll(ep,
1326 ev->u.ep_poll.timeout_ms);
1328 case ISCSI_UEVENT_TRANSPORT_EP_DISCONNECT:
1329 if (!transport->ep_disconnect)
1332 ep = iscsi_lookup_endpoint(ev->u.ep_disconnect.ep_handle);
1336 transport->ep_disconnect(ep);
1343 iscsi_tgt_dscvr(struct iscsi_transport *transport,
1344 struct iscsi_uevent *ev)
1346 struct Scsi_Host *shost;
1347 struct sockaddr *dst_addr;
1350 if (!transport->tgt_dscvr)
1353 shost = scsi_host_lookup(ev->u.tgt_dscvr.host_no);
1355 printk(KERN_ERR "target discovery could not find host no %u\n",
1356 ev->u.tgt_dscvr.host_no);
1361 dst_addr = (struct sockaddr *)((char*)ev + sizeof(*ev));
1362 err = transport->tgt_dscvr(shost, ev->u.tgt_dscvr.type,
1363 ev->u.tgt_dscvr.enable, dst_addr);
1364 scsi_host_put(shost);
1369 iscsi_set_host_param(struct iscsi_transport *transport,
1370 struct iscsi_uevent *ev)
1372 char *data = (char*)ev + sizeof(*ev);
1373 struct Scsi_Host *shost;
1376 if (!transport->set_host_param)
1379 shost = scsi_host_lookup(ev->u.set_host_param.host_no);
1381 printk(KERN_ERR "set_host_param could not find host no %u\n",
1382 ev->u.set_host_param.host_no);
1386 err = transport->set_host_param(shost, ev->u.set_host_param.param,
1387 data, ev->u.set_host_param.len);
1388 scsi_host_put(shost);
1393 iscsi_if_recv_msg(struct sk_buff *skb, struct nlmsghdr *nlh)
1396 struct iscsi_uevent *ev = NLMSG_DATA(nlh);
1397 struct iscsi_transport *transport = NULL;
1398 struct iscsi_internal *priv;
1399 struct iscsi_cls_session *session;
1400 struct iscsi_cls_conn *conn;
1401 struct iscsi_endpoint *ep = NULL;
1403 priv = iscsi_if_transport_lookup(iscsi_ptr(ev->transport_handle));
1406 transport = priv->iscsi_transport;
1408 if (!try_module_get(transport->owner))
1411 priv->daemon_pid = NETLINK_CREDS(skb)->pid;
1413 switch (nlh->nlmsg_type) {
1414 case ISCSI_UEVENT_CREATE_SESSION:
1415 err = iscsi_if_create_session(priv, ep, ev,
1416 ev->u.c_session.initial_cmdsn,
1417 ev->u.c_session.cmds_max,
1418 ev->u.c_session.queue_depth);
1420 case ISCSI_UEVENT_CREATE_BOUND_SESSION:
1421 ep = iscsi_lookup_endpoint(ev->u.c_bound_session.ep_handle);
1427 err = iscsi_if_create_session(priv, ep, ev,
1428 ev->u.c_bound_session.initial_cmdsn,
1429 ev->u.c_bound_session.cmds_max,
1430 ev->u.c_bound_session.queue_depth);
1432 case ISCSI_UEVENT_DESTROY_SESSION:
1433 session = iscsi_session_lookup(ev->u.d_session.sid);
1435 transport->destroy_session(session);
1439 case ISCSI_UEVENT_UNBIND_SESSION:
1440 session = iscsi_session_lookup(ev->u.d_session.sid);
1442 iscsi_unbind_session(session);
1446 case ISCSI_UEVENT_CREATE_CONN:
1447 err = iscsi_if_create_conn(transport, ev);
1449 case ISCSI_UEVENT_DESTROY_CONN:
1450 err = iscsi_if_destroy_conn(transport, ev);
1452 case ISCSI_UEVENT_BIND_CONN:
1453 session = iscsi_session_lookup(ev->u.b_conn.sid);
1454 conn = iscsi_conn_lookup(ev->u.b_conn.sid, ev->u.b_conn.cid);
1456 if (session && conn)
1457 ev->r.retcode = transport->bind_conn(session, conn,
1458 ev->u.b_conn.transport_eph,
1459 ev->u.b_conn.is_leading);
1463 case ISCSI_UEVENT_SET_PARAM:
1464 err = iscsi_set_param(transport, ev);
1466 case ISCSI_UEVENT_START_CONN:
1467 conn = iscsi_conn_lookup(ev->u.start_conn.sid, ev->u.start_conn.cid);
1469 ev->r.retcode = transport->start_conn(conn);
1473 case ISCSI_UEVENT_STOP_CONN:
1474 conn = iscsi_conn_lookup(ev->u.stop_conn.sid, ev->u.stop_conn.cid);
1476 transport->stop_conn(conn, ev->u.stop_conn.flag);
1480 case ISCSI_UEVENT_SEND_PDU:
1481 conn = iscsi_conn_lookup(ev->u.send_pdu.sid, ev->u.send_pdu.cid);
1483 ev->r.retcode = transport->send_pdu(conn,
1484 (struct iscsi_hdr*)((char*)ev + sizeof(*ev)),
1485 (char*)ev + sizeof(*ev) + ev->u.send_pdu.hdr_size,
1486 ev->u.send_pdu.data_size);
1490 case ISCSI_UEVENT_GET_STATS:
1491 err = iscsi_if_get_stats(transport, nlh);
1493 case ISCSI_UEVENT_TRANSPORT_EP_CONNECT:
1494 case ISCSI_UEVENT_TRANSPORT_EP_POLL:
1495 case ISCSI_UEVENT_TRANSPORT_EP_DISCONNECT:
1496 err = iscsi_if_transport_ep(transport, ev, nlh->nlmsg_type);
1498 case ISCSI_UEVENT_TGT_DSCVR:
1499 err = iscsi_tgt_dscvr(transport, ev);
1501 case ISCSI_UEVENT_SET_HOST_PARAM:
1502 err = iscsi_set_host_param(transport, ev);
1509 module_put(transport->owner);
1514 * Get message from skb. Each message is processed by iscsi_if_recv_msg.
1515 * Malformed skbs with wrong lengths or invalid creds are not processed.
1518 iscsi_if_rx(struct sk_buff *skb)
1520 mutex_lock(&rx_queue_mutex);
1521 while (skb->len >= NLMSG_SPACE(0)) {
1524 struct nlmsghdr *nlh;
1525 struct iscsi_uevent *ev;
1527 nlh = nlmsg_hdr(skb);
1528 if (nlh->nlmsg_len < sizeof(*nlh) ||
1529 skb->len < nlh->nlmsg_len) {
1533 ev = NLMSG_DATA(nlh);
1534 rlen = NLMSG_ALIGN(nlh->nlmsg_len);
1535 if (rlen > skb->len)
1538 err = iscsi_if_recv_msg(skb, nlh);
1540 ev->type = ISCSI_KEVENT_IF_ERROR;
1545 * special case for GET_STATS:
1546 * on success - sending reply and stats from
1547 * inside of if_recv_msg(),
1548 * on error - fall through.
1550 if (ev->type == ISCSI_UEVENT_GET_STATS && !err)
1552 err = iscsi_if_send_reply(
1553 NETLINK_CREDS(skb)->pid, nlh->nlmsg_seq,
1554 nlh->nlmsg_type, 0, 0, ev, sizeof(*ev));
1555 } while (err < 0 && err != -ECONNREFUSED);
1556 skb_pull(skb, rlen);
1558 mutex_unlock(&rx_queue_mutex);
1561 #define ISCSI_CLASS_ATTR(_prefix,_name,_mode,_show,_store) \
1562 struct device_attribute dev_attr_##_prefix##_##_name = \
1563 __ATTR(_name,_mode,_show,_store)
1566 * iSCSI connection attrs
1568 #define iscsi_conn_attr_show(param) \
1570 show_conn_param_##param(struct device *dev, \
1571 struct device_attribute *attr, char *buf) \
1573 struct iscsi_cls_conn *conn = iscsi_dev_to_conn(dev->parent); \
1574 struct iscsi_transport *t = conn->transport; \
1575 return t->get_conn_param(conn, param, buf); \
1578 #define iscsi_conn_attr(field, param) \
1579 iscsi_conn_attr_show(param) \
1580 static ISCSI_CLASS_ATTR(conn, field, S_IRUGO, show_conn_param_##param, \
1583 iscsi_conn_attr(max_recv_dlength, ISCSI_PARAM_MAX_RECV_DLENGTH);
1584 iscsi_conn_attr(max_xmit_dlength, ISCSI_PARAM_MAX_XMIT_DLENGTH);
1585 iscsi_conn_attr(header_digest, ISCSI_PARAM_HDRDGST_EN);
1586 iscsi_conn_attr(data_digest, ISCSI_PARAM_DATADGST_EN);
1587 iscsi_conn_attr(ifmarker, ISCSI_PARAM_IFMARKER_EN);
1588 iscsi_conn_attr(ofmarker, ISCSI_PARAM_OFMARKER_EN);
1589 iscsi_conn_attr(persistent_port, ISCSI_PARAM_PERSISTENT_PORT);
1590 iscsi_conn_attr(port, ISCSI_PARAM_CONN_PORT);
1591 iscsi_conn_attr(exp_statsn, ISCSI_PARAM_EXP_STATSN);
1592 iscsi_conn_attr(persistent_address, ISCSI_PARAM_PERSISTENT_ADDRESS);
1593 iscsi_conn_attr(address, ISCSI_PARAM_CONN_ADDRESS);
1594 iscsi_conn_attr(ping_tmo, ISCSI_PARAM_PING_TMO);
1595 iscsi_conn_attr(recv_tmo, ISCSI_PARAM_RECV_TMO);
1598 * iSCSI session attrs
1600 #define iscsi_session_attr_show(param, perm) \
1602 show_session_param_##param(struct device *dev, \
1603 struct device_attribute *attr, char *buf) \
1605 struct iscsi_cls_session *session = \
1606 iscsi_dev_to_session(dev->parent); \
1607 struct iscsi_transport *t = session->transport; \
1609 if (perm && !capable(CAP_SYS_ADMIN)) \
1611 return t->get_session_param(session, param, buf); \
1614 #define iscsi_session_attr(field, param, perm) \
1615 iscsi_session_attr_show(param, perm) \
1616 static ISCSI_CLASS_ATTR(sess, field, S_IRUGO, show_session_param_##param, \
1619 iscsi_session_attr(targetname, ISCSI_PARAM_TARGET_NAME, 0);
1620 iscsi_session_attr(initial_r2t, ISCSI_PARAM_INITIAL_R2T_EN, 0);
1621 iscsi_session_attr(max_outstanding_r2t, ISCSI_PARAM_MAX_R2T, 0);
1622 iscsi_session_attr(immediate_data, ISCSI_PARAM_IMM_DATA_EN, 0);
1623 iscsi_session_attr(first_burst_len, ISCSI_PARAM_FIRST_BURST, 0);
1624 iscsi_session_attr(max_burst_len, ISCSI_PARAM_MAX_BURST, 0);
1625 iscsi_session_attr(data_pdu_in_order, ISCSI_PARAM_PDU_INORDER_EN, 0);
1626 iscsi_session_attr(data_seq_in_order, ISCSI_PARAM_DATASEQ_INORDER_EN, 0);
1627 iscsi_session_attr(erl, ISCSI_PARAM_ERL, 0);
1628 iscsi_session_attr(tpgt, ISCSI_PARAM_TPGT, 0);
1629 iscsi_session_attr(username, ISCSI_PARAM_USERNAME, 1);
1630 iscsi_session_attr(username_in, ISCSI_PARAM_USERNAME_IN, 1);
1631 iscsi_session_attr(password, ISCSI_PARAM_PASSWORD, 1);
1632 iscsi_session_attr(password_in, ISCSI_PARAM_PASSWORD_IN, 1);
1633 iscsi_session_attr(fast_abort, ISCSI_PARAM_FAST_ABORT, 0);
1634 iscsi_session_attr(abort_tmo, ISCSI_PARAM_ABORT_TMO, 0);
1635 iscsi_session_attr(lu_reset_tmo, ISCSI_PARAM_LU_RESET_TMO, 0);
1636 iscsi_session_attr(ifacename, ISCSI_PARAM_IFACE_NAME, 0);
1637 iscsi_session_attr(initiatorname, ISCSI_PARAM_INITIATOR_NAME, 0)
1640 show_priv_session_state(struct device *dev, struct device_attribute *attr,
1643 struct iscsi_cls_session *session = iscsi_dev_to_session(dev->parent);
1644 return sprintf(buf, "%s\n", iscsi_session_state_name(session->state));
1646 static ISCSI_CLASS_ATTR(priv_sess, state, S_IRUGO, show_priv_session_state,
1649 #define iscsi_priv_session_attr_show(field, format) \
1651 show_priv_session_##field(struct device *dev, \
1652 struct device_attribute *attr, char *buf) \
1654 struct iscsi_cls_session *session = \
1655 iscsi_dev_to_session(dev->parent); \
1656 return sprintf(buf, format"\n", session->field); \
1659 #define iscsi_priv_session_attr(field, format) \
1660 iscsi_priv_session_attr_show(field, format) \
1661 static ISCSI_CLASS_ATTR(priv_sess, field, S_IRUGO, show_priv_session_##field, \
1663 iscsi_priv_session_attr(recovery_tmo, "%d");
1668 #define iscsi_host_attr_show(param) \
1670 show_host_param_##param(struct device *dev, \
1671 struct device_attribute *attr, char *buf) \
1673 struct Scsi_Host *shost = transport_class_to_shost(dev); \
1674 struct iscsi_internal *priv = to_iscsi_internal(shost->transportt); \
1675 return priv->iscsi_transport->get_host_param(shost, param, buf); \
1678 #define iscsi_host_attr(field, param) \
1679 iscsi_host_attr_show(param) \
1680 static ISCSI_CLASS_ATTR(host, field, S_IRUGO, show_host_param_##param, \
1683 iscsi_host_attr(netdev, ISCSI_HOST_PARAM_NETDEV_NAME);
1684 iscsi_host_attr(hwaddress, ISCSI_HOST_PARAM_HWADDRESS);
1685 iscsi_host_attr(ipaddress, ISCSI_HOST_PARAM_IPADDRESS);
1686 iscsi_host_attr(initiatorname, ISCSI_HOST_PARAM_INITIATOR_NAME);
1688 #define SETUP_PRIV_SESSION_RD_ATTR(field) \
1690 priv->session_attrs[count] = &dev_attr_priv_sess_##field; \
1695 #define SETUP_SESSION_RD_ATTR(field, param_flag) \
1697 if (tt->param_mask & param_flag) { \
1698 priv->session_attrs[count] = &dev_attr_sess_##field; \
1703 #define SETUP_CONN_RD_ATTR(field, param_flag) \
1705 if (tt->param_mask & param_flag) { \
1706 priv->conn_attrs[count] = &dev_attr_conn_##field; \
1711 #define SETUP_HOST_RD_ATTR(field, param_flag) \
1713 if (tt->host_param_mask & param_flag) { \
1714 priv->host_attrs[count] = &dev_attr_host_##field; \
1719 static int iscsi_session_match(struct attribute_container *cont,
1722 struct iscsi_cls_session *session;
1723 struct Scsi_Host *shost;
1724 struct iscsi_internal *priv;
1726 if (!iscsi_is_session_dev(dev))
1729 session = iscsi_dev_to_session(dev);
1730 shost = iscsi_session_to_shost(session);
1731 if (!shost->transportt)
1734 priv = to_iscsi_internal(shost->transportt);
1735 if (priv->session_cont.ac.class != &iscsi_session_class.class)
1738 return &priv->session_cont.ac == cont;
1741 static int iscsi_conn_match(struct attribute_container *cont,
1744 struct iscsi_cls_session *session;
1745 struct iscsi_cls_conn *conn;
1746 struct Scsi_Host *shost;
1747 struct iscsi_internal *priv;
1749 if (!iscsi_is_conn_dev(dev))
1752 conn = iscsi_dev_to_conn(dev);
1753 session = iscsi_dev_to_session(conn->dev.parent);
1754 shost = iscsi_session_to_shost(session);
1756 if (!shost->transportt)
1759 priv = to_iscsi_internal(shost->transportt);
1760 if (priv->conn_cont.ac.class != &iscsi_connection_class.class)
1763 return &priv->conn_cont.ac == cont;
1766 static int iscsi_host_match(struct attribute_container *cont,
1769 struct Scsi_Host *shost;
1770 struct iscsi_internal *priv;
1772 if (!scsi_is_host_device(dev))
1775 shost = dev_to_shost(dev);
1776 if (!shost->transportt ||
1777 shost->transportt->host_attrs.ac.class != &iscsi_host_class.class)
1780 priv = to_iscsi_internal(shost->transportt);
1781 return &priv->t.host_attrs.ac == cont;
1784 struct scsi_transport_template *
1785 iscsi_register_transport(struct iscsi_transport *tt)
1787 struct iscsi_internal *priv;
1788 unsigned long flags;
1793 priv = iscsi_if_transport_lookup(tt);
1797 priv = kzalloc(sizeof(*priv), GFP_KERNEL);
1800 INIT_LIST_HEAD(&priv->list);
1801 priv->daemon_pid = -1;
1802 priv->iscsi_transport = tt;
1803 priv->t.user_scan = iscsi_user_scan;
1804 if (!(tt->caps & CAP_DATA_PATH_OFFLOAD))
1805 priv->t.create_work_queue = 1;
1807 priv->dev.class = &iscsi_transport_class;
1808 dev_set_name(&priv->dev, "%s", tt->name);
1809 err = device_register(&priv->dev);
1813 err = sysfs_create_group(&priv->dev.kobj, &iscsi_transport_group);
1815 goto unregister_dev;
1817 /* host parameters */
1818 priv->t.host_attrs.ac.attrs = &priv->host_attrs[0];
1819 priv->t.host_attrs.ac.class = &iscsi_host_class.class;
1820 priv->t.host_attrs.ac.match = iscsi_host_match;
1821 priv->t.host_size = sizeof(struct iscsi_cls_host);
1822 transport_container_register(&priv->t.host_attrs);
1824 SETUP_HOST_RD_ATTR(netdev, ISCSI_HOST_NETDEV_NAME);
1825 SETUP_HOST_RD_ATTR(ipaddress, ISCSI_HOST_IPADDRESS);
1826 SETUP_HOST_RD_ATTR(hwaddress, ISCSI_HOST_HWADDRESS);
1827 SETUP_HOST_RD_ATTR(initiatorname, ISCSI_HOST_INITIATOR_NAME);
1828 BUG_ON(count > ISCSI_HOST_ATTRS);
1829 priv->host_attrs[count] = NULL;
1832 /* connection parameters */
1833 priv->conn_cont.ac.attrs = &priv->conn_attrs[0];
1834 priv->conn_cont.ac.class = &iscsi_connection_class.class;
1835 priv->conn_cont.ac.match = iscsi_conn_match;
1836 transport_container_register(&priv->conn_cont);
1838 SETUP_CONN_RD_ATTR(max_recv_dlength, ISCSI_MAX_RECV_DLENGTH);
1839 SETUP_CONN_RD_ATTR(max_xmit_dlength, ISCSI_MAX_XMIT_DLENGTH);
1840 SETUP_CONN_RD_ATTR(header_digest, ISCSI_HDRDGST_EN);
1841 SETUP_CONN_RD_ATTR(data_digest, ISCSI_DATADGST_EN);
1842 SETUP_CONN_RD_ATTR(ifmarker, ISCSI_IFMARKER_EN);
1843 SETUP_CONN_RD_ATTR(ofmarker, ISCSI_OFMARKER_EN);
1844 SETUP_CONN_RD_ATTR(address, ISCSI_CONN_ADDRESS);
1845 SETUP_CONN_RD_ATTR(port, ISCSI_CONN_PORT);
1846 SETUP_CONN_RD_ATTR(exp_statsn, ISCSI_EXP_STATSN);
1847 SETUP_CONN_RD_ATTR(persistent_address, ISCSI_PERSISTENT_ADDRESS);
1848 SETUP_CONN_RD_ATTR(persistent_port, ISCSI_PERSISTENT_PORT);
1849 SETUP_CONN_RD_ATTR(ping_tmo, ISCSI_PING_TMO);
1850 SETUP_CONN_RD_ATTR(recv_tmo, ISCSI_RECV_TMO);
1852 BUG_ON(count > ISCSI_CONN_ATTRS);
1853 priv->conn_attrs[count] = NULL;
1856 /* session parameters */
1857 priv->session_cont.ac.attrs = &priv->session_attrs[0];
1858 priv->session_cont.ac.class = &iscsi_session_class.class;
1859 priv->session_cont.ac.match = iscsi_session_match;
1860 transport_container_register(&priv->session_cont);
1862 SETUP_SESSION_RD_ATTR(initial_r2t, ISCSI_INITIAL_R2T_EN);
1863 SETUP_SESSION_RD_ATTR(max_outstanding_r2t, ISCSI_MAX_R2T);
1864 SETUP_SESSION_RD_ATTR(immediate_data, ISCSI_IMM_DATA_EN);
1865 SETUP_SESSION_RD_ATTR(first_burst_len, ISCSI_FIRST_BURST);
1866 SETUP_SESSION_RD_ATTR(max_burst_len, ISCSI_MAX_BURST);
1867 SETUP_SESSION_RD_ATTR(data_pdu_in_order, ISCSI_PDU_INORDER_EN);
1868 SETUP_SESSION_RD_ATTR(data_seq_in_order, ISCSI_DATASEQ_INORDER_EN);
1869 SETUP_SESSION_RD_ATTR(erl, ISCSI_ERL);
1870 SETUP_SESSION_RD_ATTR(targetname, ISCSI_TARGET_NAME);
1871 SETUP_SESSION_RD_ATTR(tpgt, ISCSI_TPGT);
1872 SETUP_SESSION_RD_ATTR(password, ISCSI_USERNAME);
1873 SETUP_SESSION_RD_ATTR(password_in, ISCSI_USERNAME_IN);
1874 SETUP_SESSION_RD_ATTR(username, ISCSI_PASSWORD);
1875 SETUP_SESSION_RD_ATTR(username_in, ISCSI_PASSWORD_IN);
1876 SETUP_SESSION_RD_ATTR(fast_abort, ISCSI_FAST_ABORT);
1877 SETUP_SESSION_RD_ATTR(abort_tmo, ISCSI_ABORT_TMO);
1878 SETUP_SESSION_RD_ATTR(lu_reset_tmo,ISCSI_LU_RESET_TMO);
1879 SETUP_SESSION_RD_ATTR(ifacename, ISCSI_IFACE_NAME);
1880 SETUP_SESSION_RD_ATTR(initiatorname, ISCSI_INITIATOR_NAME);
1881 SETUP_PRIV_SESSION_RD_ATTR(recovery_tmo);
1882 SETUP_PRIV_SESSION_RD_ATTR(state);
1884 BUG_ON(count > ISCSI_SESSION_ATTRS);
1885 priv->session_attrs[count] = NULL;
1887 spin_lock_irqsave(&iscsi_transport_lock, flags);
1888 list_add(&priv->list, &iscsi_transports);
1889 spin_unlock_irqrestore(&iscsi_transport_lock, flags);
1891 printk(KERN_NOTICE "iscsi: registered transport (%s)\n", tt->name);
1895 device_unregister(&priv->dev);
1901 EXPORT_SYMBOL_GPL(iscsi_register_transport);
1903 int iscsi_unregister_transport(struct iscsi_transport *tt)
1905 struct iscsi_internal *priv;
1906 unsigned long flags;
1910 mutex_lock(&rx_queue_mutex);
1912 priv = iscsi_if_transport_lookup(tt);
1915 spin_lock_irqsave(&iscsi_transport_lock, flags);
1916 list_del(&priv->list);
1917 spin_unlock_irqrestore(&iscsi_transport_lock, flags);
1919 transport_container_unregister(&priv->conn_cont);
1920 transport_container_unregister(&priv->session_cont);
1921 transport_container_unregister(&priv->t.host_attrs);
1923 sysfs_remove_group(&priv->dev.kobj, &iscsi_transport_group);
1924 device_unregister(&priv->dev);
1925 mutex_unlock(&rx_queue_mutex);
1929 EXPORT_SYMBOL_GPL(iscsi_unregister_transport);
1931 static __init int iscsi_transport_init(void)
1935 printk(KERN_INFO "Loading iSCSI transport class v%s.\n",
1936 ISCSI_TRANSPORT_VERSION);
1938 atomic_set(&iscsi_session_nr, 0);
1940 err = class_register(&iscsi_transport_class);
1944 err = class_register(&iscsi_endpoint_class);
1946 goto unregister_transport_class;
1948 err = transport_class_register(&iscsi_host_class);
1950 goto unregister_endpoint_class;
1952 err = transport_class_register(&iscsi_connection_class);
1954 goto unregister_host_class;
1956 err = transport_class_register(&iscsi_session_class);
1958 goto unregister_conn_class;
1960 nls = netlink_kernel_create(&init_net, NETLINK_ISCSI, 1, iscsi_if_rx,
1964 goto unregister_session_class;
1967 iscsi_eh_timer_workq = create_singlethread_workqueue("iscsi_eh");
1968 if (!iscsi_eh_timer_workq)
1974 netlink_kernel_release(nls);
1975 unregister_session_class:
1976 transport_class_unregister(&iscsi_session_class);
1977 unregister_conn_class:
1978 transport_class_unregister(&iscsi_connection_class);
1979 unregister_host_class:
1980 transport_class_unregister(&iscsi_host_class);
1981 unregister_endpoint_class:
1982 class_unregister(&iscsi_endpoint_class);
1983 unregister_transport_class:
1984 class_unregister(&iscsi_transport_class);
1988 static void __exit iscsi_transport_exit(void)
1990 destroy_workqueue(iscsi_eh_timer_workq);
1991 netlink_kernel_release(nls);
1992 transport_class_unregister(&iscsi_connection_class);
1993 transport_class_unregister(&iscsi_session_class);
1994 transport_class_unregister(&iscsi_host_class);
1995 class_unregister(&iscsi_endpoint_class);
1996 class_unregister(&iscsi_transport_class);
1999 module_init(iscsi_transport_init);
2000 module_exit(iscsi_transport_exit);
2002 MODULE_AUTHOR("Mike Christie <michaelc@cs.wisc.edu>, "
2003 "Dmitry Yusupov <dmitry_yus@yahoo.com>, "
2004 "Alex Aizman <itn780@yahoo.com>");
2005 MODULE_DESCRIPTION("iSCSI Transport Interface");
2006 MODULE_LICENSE("GPL");
2007 MODULE_VERSION(ISCSI_TRANSPORT_VERSION);