2 * SCSI target lib functions
4 * Copyright (C) 2005 Mike Christie <michaelc@cs.wisc.edu>
5 * Copyright (C) 2005 FUJITA Tomonori <tomof@acm.org>
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License as
9 * published by the Free Software Foundation; either version 2 of the
10 * License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
22 #include <linux/blkdev.h>
23 #include <linux/hash.h>
24 #include <linux/module.h>
25 #include <linux/pagemap.h>
26 #include <linux/slab.h>
27 #include <scsi/scsi.h>
28 #include <scsi/scsi_cmnd.h>
29 #include <scsi/scsi_device.h>
30 #include <scsi/scsi_host.h>
31 #include <scsi/scsi_transport.h>
32 #include <scsi/scsi_tgt.h>
34 #include "scsi_tgt_priv.h"
36 static struct workqueue_struct
*scsi_tgtd
;
37 static struct kmem_cache
*scsi_tgt_cmd_cache
;
40 * TODO: this struct will be killed when the block layer supports large bios
41 * and James's work struct code is in
44 /* TODO replace work with James b's code */
45 struct work_struct work
;
46 /* TODO fix limits of some drivers */
49 struct list_head hash_list
;
55 #define TGT_HASH_ORDER 4
56 #define cmd_hashfn(tag) hash_long((unsigned long) (tag), TGT_HASH_ORDER)
58 struct scsi_tgt_queuedata
{
59 struct Scsi_Host
*shost
;
60 struct list_head cmd_hash
[1 << TGT_HASH_ORDER
];
61 spinlock_t cmd_hash_lock
;
65 * Function: scsi_host_get_command()
67 * Purpose: Allocate and setup a scsi command block and blk request
69 * Arguments: shost - scsi host
70 * data_dir - dma data dir
71 * gfp_mask- allocator flags
73 * Returns: The allocated scsi command structure.
75 * This should be called by target LLDs to get a command.
77 struct scsi_cmnd
*scsi_host_get_command(struct Scsi_Host
*shost
,
78 enum dma_data_direction data_dir
,
81 int write
= (data_dir
== DMA_TO_DEVICE
);
83 struct scsi_cmnd
*cmd
;
84 struct scsi_tgt_cmd
*tcmd
;
86 /* Bail if we can't get a reference to the device */
87 if (!get_device(&shost
->shost_gendev
))
90 tcmd
= kmem_cache_alloc(scsi_tgt_cmd_cache
, GFP_ATOMIC
);
95 * The blk helpers are used to the READ/WRITE requests
96 * transferring data from a initiator point of view. Since
97 * we are in target mode we want the opposite.
99 rq
= blk_get_request(shost
->uspace_req_q
, !write
, gfp_mask
);
103 cmd
= __scsi_get_command(shost
, gfp_mask
);
107 cmd
->sc_data_direction
= data_dir
;
108 cmd
->jiffies_at_alloc
= jiffies
;
114 rq
->cmd_type
= REQ_TYPE_SPECIAL
;
115 rq
->cmd_flags
|= REQ_TYPE_BLOCK_PC
;
116 rq
->end_io_data
= tcmd
;
125 kmem_cache_free(scsi_tgt_cmd_cache
, tcmd
);
127 put_device(&shost
->shost_gendev
);
131 EXPORT_SYMBOL_GPL(scsi_host_get_command
);
134 * Function: scsi_host_put_command()
136 * Purpose: Free a scsi command block
138 * Arguments: shost - scsi host
139 * cmd - command block to free
143 * Notes: The command must not belong to any lists.
145 void scsi_host_put_command(struct Scsi_Host
*shost
, struct scsi_cmnd
*cmd
)
147 struct request_queue
*q
= shost
->uspace_req_q
;
148 struct request
*rq
= cmd
->request
;
149 struct scsi_tgt_cmd
*tcmd
= rq
->end_io_data
;
152 kmem_cache_free(scsi_tgt_cmd_cache
, tcmd
);
154 spin_lock_irqsave(q
->queue_lock
, flags
);
155 __blk_put_request(q
, rq
);
156 spin_unlock_irqrestore(q
->queue_lock
, flags
);
158 __scsi_put_command(shost
, cmd
, &shost
->shost_gendev
);
160 EXPORT_SYMBOL_GPL(scsi_host_put_command
);
162 static void cmd_hashlist_del(struct scsi_cmnd
*cmd
)
164 struct request_queue
*q
= cmd
->request
->q
;
165 struct scsi_tgt_queuedata
*qdata
= q
->queuedata
;
167 struct scsi_tgt_cmd
*tcmd
= cmd
->request
->end_io_data
;
169 spin_lock_irqsave(&qdata
->cmd_hash_lock
, flags
);
170 list_del(&tcmd
->hash_list
);
171 spin_unlock_irqrestore(&qdata
->cmd_hash_lock
, flags
);
174 static void scsi_unmap_user_pages(struct scsi_tgt_cmd
*tcmd
)
176 blk_rq_unmap_user(tcmd
->bio
);
179 static void scsi_tgt_cmd_destroy(struct work_struct
*work
)
181 struct scsi_tgt_cmd
*tcmd
=
182 container_of(work
, struct scsi_tgt_cmd
, work
);
183 struct scsi_cmnd
*cmd
= tcmd
->rq
->special
;
185 dprintk("cmd %p %d %u\n", cmd
, cmd
->sc_data_direction
,
186 rq_data_dir(cmd
->request
));
187 scsi_unmap_user_pages(tcmd
);
188 tcmd
->rq
->bio
= NULL
;
189 scsi_host_put_command(scsi_tgt_cmd_to_host(cmd
), cmd
);
192 static void init_scsi_tgt_cmd(struct request
*rq
, struct scsi_tgt_cmd
*tcmd
,
195 struct scsi_tgt_queuedata
*qdata
= rq
->q
->queuedata
;
197 struct list_head
*head
;
199 tcmd
->itn_id
= itn_id
;
202 INIT_WORK(&tcmd
->work
, scsi_tgt_cmd_destroy
);
203 spin_lock_irqsave(&qdata
->cmd_hash_lock
, flags
);
204 head
= &qdata
->cmd_hash
[cmd_hashfn(tag
)];
205 list_add(&tcmd
->hash_list
, head
);
206 spin_unlock_irqrestore(&qdata
->cmd_hash_lock
, flags
);
210 * scsi_tgt_alloc_queue - setup queue used for message passing
213 * This should be called by the LLD after host allocation.
214 * And will be released when the host is released.
216 int scsi_tgt_alloc_queue(struct Scsi_Host
*shost
)
218 struct scsi_tgt_queuedata
*queuedata
;
219 struct request_queue
*q
;
223 * Do we need to send a netlink event or should uspace
224 * just respond to the hotplug event?
226 q
= __scsi_alloc_queue(shost
, NULL
);
230 queuedata
= kzalloc(sizeof(*queuedata
), GFP_KERNEL
);
235 queuedata
->shost
= shost
;
236 q
->queuedata
= queuedata
;
239 * this is a silly hack. We should probably just queue as many
240 * command as is recvd to userspace. uspace can then make
241 * sure we do not overload the HBA
243 q
->nr_requests
= shost
->can_queue
;
245 * We currently only support software LLDs so this does
246 * not matter for now. Do we need this for the cards we support?
247 * If so we should make it a host template value.
249 blk_queue_dma_alignment(q
, 0);
250 shost
->uspace_req_q
= q
;
252 for (i
= 0; i
< ARRAY_SIZE(queuedata
->cmd_hash
); i
++)
253 INIT_LIST_HEAD(&queuedata
->cmd_hash
[i
]);
254 spin_lock_init(&queuedata
->cmd_hash_lock
);
259 blk_cleanup_queue(q
);
262 EXPORT_SYMBOL_GPL(scsi_tgt_alloc_queue
);
264 void scsi_tgt_free_queue(struct Scsi_Host
*shost
)
268 struct request_queue
*q
= shost
->uspace_req_q
;
269 struct scsi_cmnd
*cmd
;
270 struct scsi_tgt_queuedata
*qdata
= q
->queuedata
;
271 struct scsi_tgt_cmd
*tcmd
, *n
;
274 spin_lock_irqsave(&qdata
->cmd_hash_lock
, flags
);
276 for (i
= 0; i
< ARRAY_SIZE(qdata
->cmd_hash
); i
++) {
277 list_for_each_entry_safe(tcmd
, n
, &qdata
->cmd_hash
[i
],
279 list_del(&tcmd
->hash_list
);
280 list_add(&tcmd
->hash_list
, &cmds
);
284 spin_unlock_irqrestore(&qdata
->cmd_hash_lock
, flags
);
286 while (!list_empty(&cmds
)) {
287 tcmd
= list_entry(cmds
.next
, struct scsi_tgt_cmd
, hash_list
);
288 list_del(&tcmd
->hash_list
);
289 cmd
= tcmd
->rq
->special
;
291 shost
->hostt
->eh_abort_handler(cmd
);
292 scsi_tgt_cmd_destroy(&tcmd
->work
);
295 EXPORT_SYMBOL_GPL(scsi_tgt_free_queue
);
297 struct Scsi_Host
*scsi_tgt_cmd_to_host(struct scsi_cmnd
*cmd
)
299 struct scsi_tgt_queuedata
*queue
= cmd
->request
->q
->queuedata
;
302 EXPORT_SYMBOL_GPL(scsi_tgt_cmd_to_host
);
305 * scsi_tgt_queue_command - queue command for userspace processing
308 * @tag: unique value to identify this command for tmf
310 int scsi_tgt_queue_command(struct scsi_cmnd
*cmd
, u64 itn_id
,
311 struct scsi_lun
*scsilun
, u64 tag
)
313 struct scsi_tgt_cmd
*tcmd
= cmd
->request
->end_io_data
;
316 init_scsi_tgt_cmd(cmd
->request
, tcmd
, itn_id
, tag
);
317 err
= scsi_tgt_uspace_send_cmd(cmd
, itn_id
, scsilun
, tag
);
319 cmd_hashlist_del(cmd
);
323 EXPORT_SYMBOL_GPL(scsi_tgt_queue_command
);
326 * This is run from a interrupt handler normally and the unmap
327 * needs process context so we must queue
329 static void scsi_tgt_cmd_done(struct scsi_cmnd
*cmd
)
331 struct scsi_tgt_cmd
*tcmd
= cmd
->request
->end_io_data
;
333 dprintk("cmd %p %u\n", cmd
, rq_data_dir(cmd
->request
));
335 scsi_tgt_uspace_send_status(cmd
, tcmd
->itn_id
, tcmd
->tag
);
337 scsi_release_buffers(cmd
);
339 queue_work(scsi_tgtd
, &tcmd
->work
);
342 static int scsi_tgt_transfer_response(struct scsi_cmnd
*cmd
)
344 struct Scsi_Host
*shost
= scsi_tgt_cmd_to_host(cmd
);
347 dprintk("cmd %p %u\n", cmd
, rq_data_dir(cmd
->request
));
349 err
= shost
->hostt
->transfer_response(cmd
, scsi_tgt_cmd_done
);
351 case SCSI_MLQUEUE_HOST_BUSY
:
352 case SCSI_MLQUEUE_DEVICE_BUSY
:
358 /* TODO: test this crap and replace bio_map_user with new interface maybe */
359 static int scsi_map_user_pages(struct scsi_tgt_cmd
*tcmd
, struct scsi_cmnd
*cmd
,
360 unsigned long uaddr
, unsigned int len
, int rw
)
362 struct request_queue
*q
= cmd
->request
->q
;
363 struct request
*rq
= cmd
->request
;
366 dprintk("%lx %u\n", uaddr
, len
);
367 err
= blk_rq_map_user(q
, rq
, NULL
, (void *)uaddr
, len
, GFP_KERNEL
);
370 * TODO: need to fixup sg_tablesize, max_segment_size,
371 * max_sectors, etc for modern HW and software drivers
372 * where this value is bogus.
374 * TODO2: we can alloc a reserve buffer of max size
375 * we can handle and do the slow copy path for really large
378 eprintk("Could not handle request of size %u.\n", len
);
383 err
= scsi_init_io(cmd
, GFP_KERNEL
);
385 scsi_release_buffers(cmd
);
389 * we use REQ_TYPE_BLOCK_PC so scsi_init_io doesn't set the
392 cmd
->sdb
.length
= blk_rq_bytes(rq
);
397 scsi_unmap_user_pages(tcmd
);
401 static int scsi_tgt_copy_sense(struct scsi_cmnd
*cmd
, unsigned long uaddr
,
404 char __user
*p
= (char __user
*) uaddr
;
406 if (copy_from_user(cmd
->sense_buffer
, p
,
407 min_t(unsigned, SCSI_SENSE_BUFFERSIZE
, len
))) {
408 printk(KERN_ERR
"Could not copy the sense buffer\n");
414 static int scsi_tgt_abort_cmd(struct Scsi_Host
*shost
, struct scsi_cmnd
*cmd
)
416 struct scsi_tgt_cmd
*tcmd
;
419 err
= shost
->hostt
->eh_abort_handler(cmd
);
421 eprintk("fail to abort %p\n", cmd
);
423 tcmd
= cmd
->request
->end_io_data
;
424 scsi_tgt_cmd_destroy(&tcmd
->work
);
428 static struct request
*tgt_cmd_hash_lookup(struct request_queue
*q
, u64 tag
)
430 struct scsi_tgt_queuedata
*qdata
= q
->queuedata
;
431 struct request
*rq
= NULL
;
432 struct list_head
*head
;
433 struct scsi_tgt_cmd
*tcmd
;
436 head
= &qdata
->cmd_hash
[cmd_hashfn(tag
)];
437 spin_lock_irqsave(&qdata
->cmd_hash_lock
, flags
);
438 list_for_each_entry(tcmd
, head
, hash_list
) {
439 if (tcmd
->tag
== tag
) {
441 list_del(&tcmd
->hash_list
);
445 spin_unlock_irqrestore(&qdata
->cmd_hash_lock
, flags
);
450 int scsi_tgt_kspace_exec(int host_no
, u64 itn_id
, int result
, u64 tag
,
451 unsigned long uaddr
, u32 len
, unsigned long sense_uaddr
,
452 u32 sense_len
, u8 rw
)
454 struct Scsi_Host
*shost
;
455 struct scsi_cmnd
*cmd
;
457 struct scsi_tgt_cmd
*tcmd
;
460 dprintk("%d %llu %d %u %lx %u\n", host_no
, (unsigned long long) tag
,
461 result
, len
, uaddr
, rw
);
463 /* TODO: replace with a O(1) alg */
464 shost
= scsi_host_lookup(host_no
);
466 printk(KERN_ERR
"Could not find host no %d\n", host_no
);
470 if (!shost
->uspace_req_q
) {
471 printk(KERN_ERR
"Not target scsi host %d\n", host_no
);
475 rq
= tgt_cmd_hash_lookup(shost
->uspace_req_q
, tag
);
477 printk(KERN_ERR
"Could not find tag %llu\n",
478 (unsigned long long) tag
);
484 dprintk("cmd %p scb %x result %d len %d bufflen %u %u %x\n",
485 cmd
, cmd
->cmnd
[0], result
, len
, scsi_bufflen(cmd
),
486 rq_data_dir(rq
), cmd
->cmnd
[0]);
488 if (result
== TASK_ABORTED
) {
489 scsi_tgt_abort_cmd(shost
, cmd
);
493 * store the userspace values here, the working values are
494 * in the request_* values
496 tcmd
= cmd
->request
->end_io_data
;
497 cmd
->result
= result
;
499 if (cmd
->result
== SAM_STAT_CHECK_CONDITION
)
500 scsi_tgt_copy_sense(cmd
, sense_uaddr
, sense_len
);
503 err
= scsi_map_user_pages(rq
->end_io_data
, cmd
, uaddr
, len
, rw
);
506 * user-space daemon bugs or OOM
507 * TODO: we can do better for OOM.
509 struct scsi_tgt_queuedata
*qdata
;
510 struct list_head
*head
;
513 eprintk("cmd %p ret %d uaddr %lx len %d rw %d\n",
514 cmd
, err
, uaddr
, len
, rw
);
516 qdata
= shost
->uspace_req_q
->queuedata
;
517 head
= &qdata
->cmd_hash
[cmd_hashfn(tcmd
->tag
)];
519 spin_lock_irqsave(&qdata
->cmd_hash_lock
, flags
);
520 list_add(&tcmd
->hash_list
, head
);
521 spin_unlock_irqrestore(&qdata
->cmd_hash_lock
, flags
);
526 err
= scsi_tgt_transfer_response(cmd
);
528 scsi_host_put(shost
);
532 int scsi_tgt_tsk_mgmt_request(struct Scsi_Host
*shost
, u64 itn_id
,
533 int function
, u64 tag
, struct scsi_lun
*scsilun
,
538 /* TODO: need to retry if this fails. */
539 err
= scsi_tgt_uspace_send_tsk_mgmt(shost
->host_no
, itn_id
,
540 function
, tag
, scsilun
, data
);
542 eprintk("The task management request lost!\n");
545 EXPORT_SYMBOL_GPL(scsi_tgt_tsk_mgmt_request
);
547 int scsi_tgt_kspace_tsk_mgmt(int host_no
, u64 itn_id
, u64 mid
, int result
)
549 struct Scsi_Host
*shost
;
552 dprintk("%d %d %llx\n", host_no
, result
, (unsigned long long) mid
);
554 shost
= scsi_host_lookup(host_no
);
556 printk(KERN_ERR
"Could not find host no %d\n", host_no
);
560 if (!shost
->uspace_req_q
) {
561 printk(KERN_ERR
"Not target scsi host %d\n", host_no
);
565 err
= shost
->transportt
->tsk_mgmt_response(shost
, itn_id
, mid
, result
);
567 scsi_host_put(shost
);
571 int scsi_tgt_it_nexus_create(struct Scsi_Host
*shost
, u64 itn_id
,
576 /* TODO: need to retry if this fails. */
577 err
= scsi_tgt_uspace_send_it_nexus_request(shost
->host_no
, itn_id
, 0,
580 eprintk("The i_t_neuxs request lost, %d %llx!\n",
581 shost
->host_no
, (unsigned long long)itn_id
);
584 EXPORT_SYMBOL_GPL(scsi_tgt_it_nexus_create
);
586 int scsi_tgt_it_nexus_destroy(struct Scsi_Host
*shost
, u64 itn_id
)
590 /* TODO: need to retry if this fails. */
591 err
= scsi_tgt_uspace_send_it_nexus_request(shost
->host_no
,
594 eprintk("The i_t_neuxs request lost, %d %llx!\n",
595 shost
->host_no
, (unsigned long long)itn_id
);
598 EXPORT_SYMBOL_GPL(scsi_tgt_it_nexus_destroy
);
600 int scsi_tgt_kspace_it_nexus_rsp(int host_no
, u64 itn_id
, int result
)
602 struct Scsi_Host
*shost
;
605 dprintk("%d %d%llx\n", host_no
, result
, (unsigned long long)itn_id
);
607 shost
= scsi_host_lookup(host_no
);
609 printk(KERN_ERR
"Could not find host no %d\n", host_no
);
613 if (!shost
->uspace_req_q
) {
614 printk(KERN_ERR
"Not target scsi host %d\n", host_no
);
618 err
= shost
->transportt
->it_nexus_response(shost
, itn_id
, result
);
620 scsi_host_put(shost
);
624 static int __init
scsi_tgt_init(void)
628 scsi_tgt_cmd_cache
= KMEM_CACHE(scsi_tgt_cmd
, 0);
629 if (!scsi_tgt_cmd_cache
)
632 scsi_tgtd
= alloc_workqueue("scsi_tgtd", 0, 1);
638 err
= scsi_tgt_if_init();
645 destroy_workqueue(scsi_tgtd
);
647 kmem_cache_destroy(scsi_tgt_cmd_cache
);
651 static void __exit
scsi_tgt_exit(void)
653 destroy_workqueue(scsi_tgtd
);
655 kmem_cache_destroy(scsi_tgt_cmd_cache
);
658 module_init(scsi_tgt_init
);
659 module_exit(scsi_tgt_exit
);
661 MODULE_DESCRIPTION("SCSI target core");
662 MODULE_LICENSE("GPL");