Merge git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6
[wrt350n-kernel.git] / drivers / scsi / scsi.c
blob69a641ab89fa68518d3fca36448a807b25993cd2
1 /*
2 * scsi.c Copyright (C) 1992 Drew Eckhardt
3 * Copyright (C) 1993, 1994, 1995, 1999 Eric Youngdale
4 * Copyright (C) 2002, 2003 Christoph Hellwig
6 * generic mid-level SCSI driver
7 * Initial versions: Drew Eckhardt
8 * Subsequent revisions: Eric Youngdale
10 * <drew@colorado.edu>
12 * Bug correction thanks go to :
13 * Rik Faith <faith@cs.unc.edu>
14 * Tommy Thorn <tthorn>
15 * Thomas Wuensche <tw@fgb1.fgb.mw.tu-muenchen.de>
17 * Modified by Eric Youngdale eric@andante.org or ericy@gnu.ai.mit.edu to
18 * add scatter-gather, multiple outstanding request, and other
19 * enhancements.
21 * Native multichannel, wide scsi, /proc/scsi and hot plugging
22 * support added by Michael Neuffer <mike@i-connect.net>
24 * Added request_module("scsi_hostadapter") for kerneld:
25 * (Put an "alias scsi_hostadapter your_hostadapter" in /etc/modprobe.conf)
26 * Bjorn Ekwall <bj0rn@blox.se>
27 * (changed to kmod)
29 * Major improvements to the timeout, abort, and reset processing,
30 * as well as performance modifications for large queue depths by
31 * Leonard N. Zubkoff <lnz@dandelion.com>
33 * Converted cli() code to spinlocks, Ingo Molnar
35 * Jiffies wrap fixes (host->resetting), 3 Dec 1998 Andrea Arcangeli
37 * out_of_space hacks, D. Gilbert (dpg) 990608
40 #include <linux/module.h>
41 #include <linux/moduleparam.h>
42 #include <linux/kernel.h>
43 #include <linux/timer.h>
44 #include <linux/string.h>
45 #include <linux/slab.h>
46 #include <linux/blkdev.h>
47 #include <linux/delay.h>
48 #include <linux/init.h>
49 #include <linux/completion.h>
50 #include <linux/unistd.h>
51 #include <linux/spinlock.h>
52 #include <linux/kmod.h>
53 #include <linux/interrupt.h>
54 #include <linux/notifier.h>
55 #include <linux/cpu.h>
56 #include <linux/mutex.h>
58 #include <scsi/scsi.h>
59 #include <scsi/scsi_cmnd.h>
60 #include <scsi/scsi_dbg.h>
61 #include <scsi/scsi_device.h>
62 #include <scsi/scsi_driver.h>
63 #include <scsi/scsi_eh.h>
64 #include <scsi/scsi_host.h>
65 #include <scsi/scsi_tcq.h>
67 #include "scsi_priv.h"
68 #include "scsi_logging.h"
70 static void scsi_done(struct scsi_cmnd *cmd);
73 * Definitions and constants.
76 #define MIN_RESET_DELAY (2*HZ)
78 /* Do not call reset on error if we just did a reset within 15 sec. */
79 #define MIN_RESET_PERIOD (15*HZ)
82 * Macro to determine the size of SCSI command. This macro takes vendor
83 * unique commands into account. SCSI commands in groups 6 and 7 are
84 * vendor unique and we will depend upon the command length being
85 * supplied correctly in cmd_len.
87 #define CDB_SIZE(cmd) (((((cmd)->cmnd[0] >> 5) & 7) < 6) ? \
88 COMMAND_SIZE((cmd)->cmnd[0]) : (cmd)->cmd_len)
91 * Note - the initial logging level can be set here to log events at boot time.
92 * After the system is up, you may enable logging via the /proc interface.
94 unsigned int scsi_logging_level;
95 #if defined(CONFIG_SCSI_LOGGING)
96 EXPORT_SYMBOL(scsi_logging_level);
97 #endif
99 /* NB: These are exposed through /proc/scsi/scsi and form part of the ABI.
100 * You may not alter any existing entry (although adding new ones is
101 * encouraged once assigned by ANSI/INCITS T10
103 static const char *const scsi_device_types[] = {
104 "Direct-Access ",
105 "Sequential-Access",
106 "Printer ",
107 "Processor ",
108 "WORM ",
109 "CD-ROM ",
110 "Scanner ",
111 "Optical Device ",
112 "Medium Changer ",
113 "Communications ",
114 "ASC IT8 ",
115 "ASC IT8 ",
116 "RAID ",
117 "Enclosure ",
118 "Direct-Access-RBC",
119 "Optical card ",
120 "Bridge controller",
121 "Object storage ",
122 "Automation/Drive ",
126 * scsi_device_type - Return 17 char string indicating device type.
127 * @type: type number to look up
130 const char * scsi_device_type(unsigned type)
132 if (type == 0x1e)
133 return "Well-known LUN ";
134 if (type == 0x1f)
135 return "No Device ";
136 if (type >= ARRAY_SIZE(scsi_device_types))
137 return "Unknown ";
138 return scsi_device_types[type];
141 EXPORT_SYMBOL(scsi_device_type);
143 struct scsi_host_cmd_pool {
144 struct kmem_cache *cmd_slab;
145 struct kmem_cache *sense_slab;
146 unsigned int users;
147 char *cmd_name;
148 char *sense_name;
149 unsigned int slab_flags;
150 gfp_t gfp_mask;
153 static struct scsi_host_cmd_pool scsi_cmd_pool = {
154 .cmd_name = "scsi_cmd_cache",
155 .sense_name = "scsi_sense_cache",
156 .slab_flags = SLAB_HWCACHE_ALIGN,
159 static struct scsi_host_cmd_pool scsi_cmd_dma_pool = {
160 .cmd_name = "scsi_cmd_cache(DMA)",
161 .sense_name = "scsi_sense_cache(DMA)",
162 .slab_flags = SLAB_HWCACHE_ALIGN|SLAB_CACHE_DMA,
163 .gfp_mask = __GFP_DMA,
166 static DEFINE_MUTEX(host_cmd_pool_mutex);
169 * __scsi_get_command - Allocate a struct scsi_cmnd
170 * @shost: host to transmit command
171 * @gfp_mask: allocation mask
173 * Description: allocate a struct scsi_cmd from host's slab, recycling from the
174 * host's free_list if necessary.
176 struct scsi_cmnd *__scsi_get_command(struct Scsi_Host *shost, gfp_t gfp_mask)
178 struct scsi_cmnd *cmd;
179 unsigned char *buf;
181 cmd = kmem_cache_alloc(shost->cmd_pool->cmd_slab,
182 gfp_mask | shost->cmd_pool->gfp_mask);
184 if (unlikely(!cmd)) {
185 unsigned long flags;
187 spin_lock_irqsave(&shost->free_list_lock, flags);
188 if (likely(!list_empty(&shost->free_list))) {
189 cmd = list_entry(shost->free_list.next,
190 struct scsi_cmnd, list);
191 list_del_init(&cmd->list);
193 spin_unlock_irqrestore(&shost->free_list_lock, flags);
195 if (cmd) {
196 buf = cmd->sense_buffer;
197 memset(cmd, 0, sizeof(*cmd));
198 cmd->sense_buffer = buf;
200 } else {
201 buf = kmem_cache_alloc(shost->cmd_pool->sense_slab,
202 gfp_mask | shost->cmd_pool->gfp_mask);
203 if (likely(buf)) {
204 memset(cmd, 0, sizeof(*cmd));
205 cmd->sense_buffer = buf;
206 } else {
207 kmem_cache_free(shost->cmd_pool->cmd_slab, cmd);
208 cmd = NULL;
212 return cmd;
214 EXPORT_SYMBOL_GPL(__scsi_get_command);
217 * scsi_get_command - Allocate and setup a scsi command block
218 * @dev: parent scsi device
219 * @gfp_mask: allocator flags
221 * Returns: The allocated scsi command structure.
223 struct scsi_cmnd *scsi_get_command(struct scsi_device *dev, gfp_t gfp_mask)
225 struct scsi_cmnd *cmd;
227 /* Bail if we can't get a reference to the device */
228 if (!get_device(&dev->sdev_gendev))
229 return NULL;
231 cmd = __scsi_get_command(dev->host, gfp_mask);
233 if (likely(cmd != NULL)) {
234 unsigned long flags;
236 cmd->device = dev;
237 init_timer(&cmd->eh_timeout);
238 INIT_LIST_HEAD(&cmd->list);
239 spin_lock_irqsave(&dev->list_lock, flags);
240 list_add_tail(&cmd->list, &dev->cmd_list);
241 spin_unlock_irqrestore(&dev->list_lock, flags);
242 cmd->jiffies_at_alloc = jiffies;
243 } else
244 put_device(&dev->sdev_gendev);
246 return cmd;
248 EXPORT_SYMBOL(scsi_get_command);
251 * __scsi_put_command - Free a struct scsi_cmnd
252 * @shost: dev->host
253 * @cmd: Command to free
254 * @dev: parent scsi device
256 void __scsi_put_command(struct Scsi_Host *shost, struct scsi_cmnd *cmd,
257 struct device *dev)
259 unsigned long flags;
261 /* changing locks here, don't need to restore the irq state */
262 spin_lock_irqsave(&shost->free_list_lock, flags);
263 if (unlikely(list_empty(&shost->free_list))) {
264 list_add(&cmd->list, &shost->free_list);
265 cmd = NULL;
267 spin_unlock_irqrestore(&shost->free_list_lock, flags);
269 if (likely(cmd != NULL)) {
270 kmem_cache_free(shost->cmd_pool->sense_slab,
271 cmd->sense_buffer);
272 kmem_cache_free(shost->cmd_pool->cmd_slab, cmd);
275 put_device(dev);
277 EXPORT_SYMBOL(__scsi_put_command);
280 * scsi_put_command - Free a scsi command block
281 * @cmd: command block to free
283 * Returns: Nothing.
285 * Notes: The command must not belong to any lists.
287 void scsi_put_command(struct scsi_cmnd *cmd)
289 struct scsi_device *sdev = cmd->device;
290 unsigned long flags;
292 /* serious error if the command hasn't come from a device list */
293 spin_lock_irqsave(&cmd->device->list_lock, flags);
294 BUG_ON(list_empty(&cmd->list));
295 list_del_init(&cmd->list);
296 spin_unlock_irqrestore(&cmd->device->list_lock, flags);
298 __scsi_put_command(cmd->device->host, cmd, &sdev->sdev_gendev);
300 EXPORT_SYMBOL(scsi_put_command);
303 * scsi_setup_command_freelist - Setup the command freelist for a scsi host.
304 * @shost: host to allocate the freelist for.
306 * Description: The command freelist protects against system-wide out of memory
307 * deadlock by preallocating one SCSI command structure for each host, so the
308 * system can always write to a swap file on a device associated with that host.
310 * Returns: Nothing.
312 int scsi_setup_command_freelist(struct Scsi_Host *shost)
314 struct scsi_host_cmd_pool *pool;
315 struct scsi_cmnd *cmd;
317 spin_lock_init(&shost->free_list_lock);
318 INIT_LIST_HEAD(&shost->free_list);
321 * Select a command slab for this host and create it if not
322 * yet existent.
324 mutex_lock(&host_cmd_pool_mutex);
325 pool = (shost->unchecked_isa_dma ? &scsi_cmd_dma_pool : &scsi_cmd_pool);
326 if (!pool->users) {
327 pool->cmd_slab = kmem_cache_create(pool->cmd_name,
328 sizeof(struct scsi_cmnd), 0,
329 pool->slab_flags, NULL);
330 if (!pool->cmd_slab)
331 goto fail;
333 pool->sense_slab = kmem_cache_create(pool->sense_name,
334 SCSI_SENSE_BUFFERSIZE, 0,
335 pool->slab_flags, NULL);
336 if (!pool->sense_slab) {
337 kmem_cache_destroy(pool->cmd_slab);
338 goto fail;
342 pool->users++;
343 shost->cmd_pool = pool;
344 mutex_unlock(&host_cmd_pool_mutex);
347 * Get one backup command for this host.
349 cmd = kmem_cache_alloc(shost->cmd_pool->cmd_slab,
350 GFP_KERNEL | shost->cmd_pool->gfp_mask);
351 if (!cmd)
352 goto fail2;
354 cmd->sense_buffer = kmem_cache_alloc(shost->cmd_pool->sense_slab,
355 GFP_KERNEL |
356 shost->cmd_pool->gfp_mask);
357 if (!cmd->sense_buffer)
358 goto fail2;
360 list_add(&cmd->list, &shost->free_list);
361 return 0;
363 fail2:
364 if (cmd)
365 kmem_cache_free(shost->cmd_pool->cmd_slab, cmd);
366 mutex_lock(&host_cmd_pool_mutex);
367 if (!--pool->users) {
368 kmem_cache_destroy(pool->cmd_slab);
369 kmem_cache_destroy(pool->sense_slab);
371 fail:
372 mutex_unlock(&host_cmd_pool_mutex);
373 return -ENOMEM;
377 * scsi_destroy_command_freelist - Release the command freelist for a scsi host.
378 * @shost: host whose freelist is going to be destroyed
380 void scsi_destroy_command_freelist(struct Scsi_Host *shost)
382 while (!list_empty(&shost->free_list)) {
383 struct scsi_cmnd *cmd;
385 cmd = list_entry(shost->free_list.next, struct scsi_cmnd, list);
386 list_del_init(&cmd->list);
387 kmem_cache_free(shost->cmd_pool->sense_slab,
388 cmd->sense_buffer);
389 kmem_cache_free(shost->cmd_pool->cmd_slab, cmd);
392 mutex_lock(&host_cmd_pool_mutex);
393 if (!--shost->cmd_pool->users) {
394 kmem_cache_destroy(shost->cmd_pool->cmd_slab);
395 kmem_cache_destroy(shost->cmd_pool->sense_slab);
397 mutex_unlock(&host_cmd_pool_mutex);
400 #ifdef CONFIG_SCSI_LOGGING
401 void scsi_log_send(struct scsi_cmnd *cmd)
403 unsigned int level;
406 * If ML QUEUE log level is greater than or equal to:
408 * 1: nothing (match completion)
410 * 2: log opcode + command of all commands
412 * 3: same as 2 plus dump cmd address
414 * 4: same as 3 plus dump extra junk
416 if (unlikely(scsi_logging_level)) {
417 level = SCSI_LOG_LEVEL(SCSI_LOG_MLQUEUE_SHIFT,
418 SCSI_LOG_MLQUEUE_BITS);
419 if (level > 1) {
420 scmd_printk(KERN_INFO, cmd, "Send: ");
421 if (level > 2)
422 printk("0x%p ", cmd);
423 printk("\n");
424 scsi_print_command(cmd);
425 if (level > 3) {
426 printk(KERN_INFO "buffer = 0x%p, bufflen = %d,"
427 " queuecommand 0x%p\n",
428 scsi_sglist(cmd), scsi_bufflen(cmd),
429 cmd->device->host->hostt->queuecommand);
436 void scsi_log_completion(struct scsi_cmnd *cmd, int disposition)
438 unsigned int level;
441 * If ML COMPLETE log level is greater than or equal to:
443 * 1: log disposition, result, opcode + command, and conditionally
444 * sense data for failures or non SUCCESS dispositions.
446 * 2: same as 1 but for all command completions.
448 * 3: same as 2 plus dump cmd address
450 * 4: same as 3 plus dump extra junk
452 if (unlikely(scsi_logging_level)) {
453 level = SCSI_LOG_LEVEL(SCSI_LOG_MLCOMPLETE_SHIFT,
454 SCSI_LOG_MLCOMPLETE_BITS);
455 if (((level > 0) && (cmd->result || disposition != SUCCESS)) ||
456 (level > 1)) {
457 scmd_printk(KERN_INFO, cmd, "Done: ");
458 if (level > 2)
459 printk("0x%p ", cmd);
461 * Dump truncated values, so we usually fit within
462 * 80 chars.
464 switch (disposition) {
465 case SUCCESS:
466 printk("SUCCESS\n");
467 break;
468 case NEEDS_RETRY:
469 printk("RETRY\n");
470 break;
471 case ADD_TO_MLQUEUE:
472 printk("MLQUEUE\n");
473 break;
474 case FAILED:
475 printk("FAILED\n");
476 break;
477 case TIMEOUT_ERROR:
479 * If called via scsi_times_out.
481 printk("TIMEOUT\n");
482 break;
483 default:
484 printk("UNKNOWN\n");
486 scsi_print_result(cmd);
487 scsi_print_command(cmd);
488 if (status_byte(cmd->result) & CHECK_CONDITION)
489 scsi_print_sense("", cmd);
490 if (level > 3)
491 scmd_printk(KERN_INFO, cmd,
492 "scsi host busy %d failed %d\n",
493 cmd->device->host->host_busy,
494 cmd->device->host->host_failed);
498 #endif
501 * scsi_cmd_get_serial - Assign a serial number to a command
502 * @host: the scsi host
503 * @cmd: command to assign serial number to
505 * Description: a serial number identifies a request for error recovery
506 * and debugging purposes. Protected by the Host_Lock of host.
508 static inline void scsi_cmd_get_serial(struct Scsi_Host *host, struct scsi_cmnd *cmd)
510 cmd->serial_number = host->cmd_serial_number++;
511 if (cmd->serial_number == 0)
512 cmd->serial_number = host->cmd_serial_number++;
516 * scsi_dispatch_command - Dispatch a command to the low-level driver.
517 * @cmd: command block we are dispatching.
519 * Return: nonzero return request was rejected and device's queue needs to be
520 * plugged.
522 int scsi_dispatch_cmd(struct scsi_cmnd *cmd)
524 struct Scsi_Host *host = cmd->device->host;
525 unsigned long flags = 0;
526 unsigned long timeout;
527 int rtn = 0;
529 /* check if the device is still usable */
530 if (unlikely(cmd->device->sdev_state == SDEV_DEL)) {
531 /* in SDEV_DEL we error all commands. DID_NO_CONNECT
532 * returns an immediate error upwards, and signals
533 * that the device is no longer present */
534 cmd->result = DID_NO_CONNECT << 16;
535 atomic_inc(&cmd->device->iorequest_cnt);
536 __scsi_done(cmd);
537 /* return 0 (because the command has been processed) */
538 goto out;
541 /* Check to see if the scsi lld put this device into state SDEV_BLOCK. */
542 if (unlikely(cmd->device->sdev_state == SDEV_BLOCK)) {
544 * in SDEV_BLOCK, the command is just put back on the device
545 * queue. The suspend state has already blocked the queue so
546 * future requests should not occur until the device
547 * transitions out of the suspend state.
549 scsi_queue_insert(cmd, SCSI_MLQUEUE_DEVICE_BUSY);
551 SCSI_LOG_MLQUEUE(3, printk("queuecommand : device blocked \n"));
554 * NOTE: rtn is still zero here because we don't need the
555 * queue to be plugged on return (it's already stopped)
557 goto out;
561 * If SCSI-2 or lower, store the LUN value in cmnd.
563 if (cmd->device->scsi_level <= SCSI_2 &&
564 cmd->device->scsi_level != SCSI_UNKNOWN) {
565 cmd->cmnd[1] = (cmd->cmnd[1] & 0x1f) |
566 (cmd->device->lun << 5 & 0xe0);
570 * We will wait MIN_RESET_DELAY clock ticks after the last reset so
571 * we can avoid the drive not being ready.
573 timeout = host->last_reset + MIN_RESET_DELAY;
575 if (host->resetting && time_before(jiffies, timeout)) {
576 int ticks_remaining = timeout - jiffies;
578 * NOTE: This may be executed from within an interrupt
579 * handler! This is bad, but for now, it'll do. The irq
580 * level of the interrupt handler has been masked out by the
581 * platform dependent interrupt handling code already, so the
582 * sti() here will not cause another call to the SCSI host's
583 * interrupt handler (assuming there is one irq-level per
584 * host).
586 while (--ticks_remaining >= 0)
587 mdelay(1 + 999 / HZ);
588 host->resetting = 0;
592 * AK: unlikely race here: for some reason the timer could
593 * expire before the serial number is set up below.
595 scsi_add_timer(cmd, cmd->timeout_per_command, scsi_times_out);
597 scsi_log_send(cmd);
600 * We will use a queued command if possible, otherwise we will
601 * emulate the queuing and calling of completion function ourselves.
603 atomic_inc(&cmd->device->iorequest_cnt);
606 * Before we queue this command, check if the command
607 * length exceeds what the host adapter can handle.
609 if (CDB_SIZE(cmd) > cmd->device->host->max_cmd_len) {
610 SCSI_LOG_MLQUEUE(3,
611 printk("queuecommand : command too long.\n"));
612 cmd->result = (DID_ABORT << 16);
614 scsi_done(cmd);
615 goto out;
618 spin_lock_irqsave(host->host_lock, flags);
619 scsi_cmd_get_serial(host, cmd);
621 if (unlikely(host->shost_state == SHOST_DEL)) {
622 cmd->result = (DID_NO_CONNECT << 16);
623 scsi_done(cmd);
624 } else {
625 rtn = host->hostt->queuecommand(cmd, scsi_done);
627 spin_unlock_irqrestore(host->host_lock, flags);
628 if (rtn) {
629 if (scsi_delete_timer(cmd)) {
630 atomic_inc(&cmd->device->iodone_cnt);
631 scsi_queue_insert(cmd,
632 (rtn == SCSI_MLQUEUE_DEVICE_BUSY) ?
633 rtn : SCSI_MLQUEUE_HOST_BUSY);
635 SCSI_LOG_MLQUEUE(3,
636 printk("queuecommand : request rejected\n"));
639 out:
640 SCSI_LOG_MLQUEUE(3, printk("leaving scsi_dispatch_cmnd()\n"));
641 return rtn;
645 * scsi_req_abort_cmd -- Request command recovery for the specified command
646 * @cmd: pointer to the SCSI command of interest
648 * This function requests that SCSI Core start recovery for the
649 * command by deleting the timer and adding the command to the eh
650 * queue. It can be called by either LLDDs or SCSI Core. LLDDs who
651 * implement their own error recovery MAY ignore the timeout event if
652 * they generated scsi_req_abort_cmd.
654 void scsi_req_abort_cmd(struct scsi_cmnd *cmd)
656 if (!scsi_delete_timer(cmd))
657 return;
658 scsi_times_out(cmd);
660 EXPORT_SYMBOL(scsi_req_abort_cmd);
663 * scsi_done - Enqueue the finished SCSI command into the done queue.
664 * @cmd: The SCSI Command for which a low-level device driver (LLDD) gives
665 * ownership back to SCSI Core -- i.e. the LLDD has finished with it.
667 * Description: This function is the mid-level's (SCSI Core) interrupt routine,
668 * which regains ownership of the SCSI command (de facto) from a LLDD, and
669 * enqueues the command to the done queue for further processing.
671 * This is the producer of the done queue who enqueues at the tail.
673 * This function is interrupt context safe.
675 static void scsi_done(struct scsi_cmnd *cmd)
678 * We don't have to worry about this one timing out anymore.
679 * If we are unable to remove the timer, then the command
680 * has already timed out. In which case, we have no choice but to
681 * let the timeout function run, as we have no idea where in fact
682 * that function could really be. It might be on another processor,
683 * etc, etc.
685 if (!scsi_delete_timer(cmd))
686 return;
687 __scsi_done(cmd);
690 /* Private entry to scsi_done() to complete a command when the timer
691 * isn't running --- used by scsi_times_out */
692 void __scsi_done(struct scsi_cmnd *cmd)
694 struct request *rq = cmd->request;
697 * Set the serial numbers back to zero
699 cmd->serial_number = 0;
701 atomic_inc(&cmd->device->iodone_cnt);
702 if (cmd->result)
703 atomic_inc(&cmd->device->ioerr_cnt);
705 BUG_ON(!rq);
708 * The uptodate/nbytes values don't matter, as we allow partial
709 * completes and thus will check this in the softirq callback
711 rq->completion_data = cmd;
712 blk_complete_request(rq);
715 /* Move this to a header if it becomes more generally useful */
716 static struct scsi_driver *scsi_cmd_to_driver(struct scsi_cmnd *cmd)
718 return *(struct scsi_driver **)cmd->request->rq_disk->private_data;
722 * scsi_finish_command - cleanup and pass command back to upper layer
723 * @cmd: the command
725 * Description: Pass command off to upper layer for finishing of I/O
726 * request, waking processes that are waiting on results,
727 * etc.
729 void scsi_finish_command(struct scsi_cmnd *cmd)
731 struct scsi_device *sdev = cmd->device;
732 struct Scsi_Host *shost = sdev->host;
733 struct scsi_driver *drv;
734 unsigned int good_bytes;
736 scsi_device_unbusy(sdev);
739 * Clear the flags which say that the device/host is no longer
740 * capable of accepting new commands. These are set in scsi_queue.c
741 * for both the queue full condition on a device, and for a
742 * host full condition on the host.
744 * XXX(hch): What about locking?
746 shost->host_blocked = 0;
747 sdev->device_blocked = 0;
750 * If we have valid sense information, then some kind of recovery
751 * must have taken place. Make a note of this.
753 if (SCSI_SENSE_VALID(cmd))
754 cmd->result |= (DRIVER_SENSE << 24);
756 SCSI_LOG_MLCOMPLETE(4, sdev_printk(KERN_INFO, sdev,
757 "Notifying upper driver of completion "
758 "(result %x)\n", cmd->result));
760 <<<<<<< HEAD:drivers/scsi/scsi.c
761 good_bytes = scsi_bufflen(cmd);
762 =======
763 good_bytes = scsi_bufflen(cmd) + cmd->request->extra_len;
764 >>>>>>> 264e3e889d86e552b4191d69bb60f4f3b383135a:drivers/scsi/scsi.c
765 if (cmd->request->cmd_type != REQ_TYPE_BLOCK_PC) {
766 drv = scsi_cmd_to_driver(cmd);
767 if (drv->done)
768 good_bytes = drv->done(cmd);
770 scsi_io_completion(cmd, good_bytes);
772 EXPORT_SYMBOL(scsi_finish_command);
775 * scsi_adjust_queue_depth - Let low level drivers change a device's queue depth
776 * @sdev: SCSI Device in question
777 * @tagged: Do we use tagged queueing (non-0) or do we treat
778 * this device as an untagged device (0)
779 * @tags: Number of tags allowed if tagged queueing enabled,
780 * or number of commands the low level driver can
781 * queue up in non-tagged mode (as per cmd_per_lun).
783 * Returns: Nothing
785 * Lock Status: None held on entry
787 * Notes: Low level drivers may call this at any time and we will do
788 * the right thing depending on whether or not the device is
789 * currently active and whether or not it even has the
790 * command blocks built yet.
792 void scsi_adjust_queue_depth(struct scsi_device *sdev, int tagged, int tags)
794 unsigned long flags;
797 * refuse to set tagged depth to an unworkable size
799 if (tags <= 0)
800 return;
802 spin_lock_irqsave(sdev->request_queue->queue_lock, flags);
804 /* Check to see if the queue is managed by the block layer.
805 * If it is, and we fail to adjust the depth, exit. */
806 if (blk_queue_tagged(sdev->request_queue) &&
807 blk_queue_resize_tags(sdev->request_queue, tags) != 0)
808 goto out;
810 sdev->queue_depth = tags;
811 switch (tagged) {
812 case MSG_ORDERED_TAG:
813 sdev->ordered_tags = 1;
814 sdev->simple_tags = 1;
815 break;
816 case MSG_SIMPLE_TAG:
817 sdev->ordered_tags = 0;
818 sdev->simple_tags = 1;
819 break;
820 default:
821 sdev_printk(KERN_WARNING, sdev,
822 "scsi_adjust_queue_depth, bad queue type, "
823 "disabled\n");
824 case 0:
825 sdev->ordered_tags = sdev->simple_tags = 0;
826 sdev->queue_depth = tags;
827 break;
829 out:
830 spin_unlock_irqrestore(sdev->request_queue->queue_lock, flags);
832 EXPORT_SYMBOL(scsi_adjust_queue_depth);
835 * scsi_track_queue_full - track QUEUE_FULL events to adjust queue depth
836 * @sdev: SCSI Device in question
837 * @depth: Current number of outstanding SCSI commands on this device,
838 * not counting the one returned as QUEUE_FULL.
840 * Description: This function will track successive QUEUE_FULL events on a
841 * specific SCSI device to determine if and when there is a
842 * need to adjust the queue depth on the device.
844 * Returns: 0 - No change needed, >0 - Adjust queue depth to this new depth,
845 * -1 - Drop back to untagged operation using host->cmd_per_lun
846 * as the untagged command depth
848 * Lock Status: None held on entry
850 * Notes: Low level drivers may call this at any time and we will do
851 * "The Right Thing." We are interrupt context safe.
853 int scsi_track_queue_full(struct scsi_device *sdev, int depth)
855 if ((jiffies >> 4) == sdev->last_queue_full_time)
856 return 0;
858 sdev->last_queue_full_time = (jiffies >> 4);
859 if (sdev->last_queue_full_depth != depth) {
860 sdev->last_queue_full_count = 1;
861 sdev->last_queue_full_depth = depth;
862 } else {
863 sdev->last_queue_full_count++;
866 if (sdev->last_queue_full_count <= 10)
867 return 0;
868 if (sdev->last_queue_full_depth < 8) {
869 /* Drop back to untagged */
870 scsi_adjust_queue_depth(sdev, 0, sdev->host->cmd_per_lun);
871 return -1;
874 if (sdev->ordered_tags)
875 scsi_adjust_queue_depth(sdev, MSG_ORDERED_TAG, depth);
876 else
877 scsi_adjust_queue_depth(sdev, MSG_SIMPLE_TAG, depth);
878 return depth;
880 EXPORT_SYMBOL(scsi_track_queue_full);
883 * scsi_device_get - get an additional reference to a scsi_device
884 * @sdev: device to get a reference to
886 * Description: Gets a reference to the scsi_device and increments the use count
887 * of the underlying LLDD module. You must hold host_lock of the
888 * parent Scsi_Host or already have a reference when calling this.
890 int scsi_device_get(struct scsi_device *sdev)
892 if (sdev->sdev_state == SDEV_DEL)
893 return -ENXIO;
894 if (!get_device(&sdev->sdev_gendev))
895 return -ENXIO;
896 /* We can fail this if we're doing SCSI operations
897 * from module exit (like cache flush) */
898 try_module_get(sdev->host->hostt->module);
900 return 0;
902 EXPORT_SYMBOL(scsi_device_get);
905 * scsi_device_put - release a reference to a scsi_device
906 * @sdev: device to release a reference on.
908 * Description: Release a reference to the scsi_device and decrements the use
909 * count of the underlying LLDD module. The device is freed once the last
910 * user vanishes.
912 void scsi_device_put(struct scsi_device *sdev)
914 #ifdef CONFIG_MODULE_UNLOAD
915 struct module *module = sdev->host->hostt->module;
917 /* The module refcount will be zero if scsi_device_get()
918 * was called from a module removal routine */
919 if (module && module_refcount(module) != 0)
920 module_put(module);
921 #endif
922 put_device(&sdev->sdev_gendev);
924 EXPORT_SYMBOL(scsi_device_put);
926 /* helper for shost_for_each_device, see that for documentation */
927 struct scsi_device *__scsi_iterate_devices(struct Scsi_Host *shost,
928 struct scsi_device *prev)
930 struct list_head *list = (prev ? &prev->siblings : &shost->__devices);
931 struct scsi_device *next = NULL;
932 unsigned long flags;
934 spin_lock_irqsave(shost->host_lock, flags);
935 while (list->next != &shost->__devices) {
936 next = list_entry(list->next, struct scsi_device, siblings);
937 /* skip devices that we can't get a reference to */
938 if (!scsi_device_get(next))
939 break;
940 next = NULL;
941 list = list->next;
943 spin_unlock_irqrestore(shost->host_lock, flags);
945 if (prev)
946 scsi_device_put(prev);
947 return next;
949 EXPORT_SYMBOL(__scsi_iterate_devices);
952 * starget_for_each_device - helper to walk all devices of a target
953 * @starget: target whose devices we want to iterate over.
954 * @data: Opaque passed to each function call.
955 * @fn: Function to call on each device
957 * This traverses over each device of @starget. The devices have
958 * a reference that must be released by scsi_host_put when breaking
959 * out of the loop.
961 void starget_for_each_device(struct scsi_target *starget, void *data,
962 void (*fn)(struct scsi_device *, void *))
964 struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
965 struct scsi_device *sdev;
967 shost_for_each_device(sdev, shost) {
968 if ((sdev->channel == starget->channel) &&
969 (sdev->id == starget->id))
970 fn(sdev, data);
973 EXPORT_SYMBOL(starget_for_each_device);
976 * __starget_for_each_device - helper to walk all devices of a target (UNLOCKED)
977 * @starget: target whose devices we want to iterate over.
978 * @data: parameter for callback @fn()
979 * @fn: callback function that is invoked for each device
981 * This traverses over each device of @starget. It does _not_
982 * take a reference on the scsi_device, so the whole loop must be
983 * protected by shost->host_lock.
985 * Note: The only reason why drivers would want to use this is because
986 * they need to access the device list in irq context. Otherwise you
987 * really want to use starget_for_each_device instead.
989 void __starget_for_each_device(struct scsi_target *starget, void *data,
990 void (*fn)(struct scsi_device *, void *))
992 struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
993 struct scsi_device *sdev;
995 __shost_for_each_device(sdev, shost) {
996 if ((sdev->channel == starget->channel) &&
997 (sdev->id == starget->id))
998 fn(sdev, data);
1001 EXPORT_SYMBOL(__starget_for_each_device);
1004 * __scsi_device_lookup_by_target - find a device given the target (UNLOCKED)
1005 * @starget: SCSI target pointer
1006 * @lun: SCSI Logical Unit Number
1008 * Description: Looks up the scsi_device with the specified @lun for a given
1009 * @starget. The returned scsi_device does not have an additional
1010 * reference. You must hold the host's host_lock over this call and
1011 * any access to the returned scsi_device.
1013 * Note: The only reason why drivers should use this is because
1014 * they need to access the device list in irq context. Otherwise you
1015 * really want to use scsi_device_lookup_by_target instead.
1017 struct scsi_device *__scsi_device_lookup_by_target(struct scsi_target *starget,
1018 uint lun)
1020 struct scsi_device *sdev;
1022 list_for_each_entry(sdev, &starget->devices, same_target_siblings) {
1023 if (sdev->lun ==lun)
1024 return sdev;
1027 return NULL;
1029 EXPORT_SYMBOL(__scsi_device_lookup_by_target);
1032 * scsi_device_lookup_by_target - find a device given the target
1033 * @starget: SCSI target pointer
1034 * @lun: SCSI Logical Unit Number
1036 * Description: Looks up the scsi_device with the specified @channel, @id, @lun
1037 * for a given host. The returned scsi_device has an additional reference that
1038 * needs to be released with scsi_device_put once you're done with it.
1040 struct scsi_device *scsi_device_lookup_by_target(struct scsi_target *starget,
1041 uint lun)
1043 struct scsi_device *sdev;
1044 struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
1045 unsigned long flags;
1047 spin_lock_irqsave(shost->host_lock, flags);
1048 sdev = __scsi_device_lookup_by_target(starget, lun);
1049 if (sdev && scsi_device_get(sdev))
1050 sdev = NULL;
1051 spin_unlock_irqrestore(shost->host_lock, flags);
1053 return sdev;
1055 EXPORT_SYMBOL(scsi_device_lookup_by_target);
1058 * __scsi_device_lookup - find a device given the host (UNLOCKED)
1059 * @shost: SCSI host pointer
1060 * @channel: SCSI channel (zero if only one channel)
1061 * @id: SCSI target number (physical unit number)
1062 * @lun: SCSI Logical Unit Number
1064 * Description: Looks up the scsi_device with the specified @channel, @id, @lun
1065 * for a given host. The returned scsi_device does not have an additional
1066 * reference. You must hold the host's host_lock over this call and any access
1067 * to the returned scsi_device.
1069 * Note: The only reason why drivers would want to use this is because
1070 * they need to access the device list in irq context. Otherwise you
1071 * really want to use scsi_device_lookup instead.
1073 struct scsi_device *__scsi_device_lookup(struct Scsi_Host *shost,
1074 uint channel, uint id, uint lun)
1076 struct scsi_device *sdev;
1078 list_for_each_entry(sdev, &shost->__devices, siblings) {
1079 if (sdev->channel == channel && sdev->id == id &&
1080 sdev->lun ==lun)
1081 return sdev;
1084 return NULL;
1086 EXPORT_SYMBOL(__scsi_device_lookup);
1089 * scsi_device_lookup - find a device given the host
1090 * @shost: SCSI host pointer
1091 * @channel: SCSI channel (zero if only one channel)
1092 * @id: SCSI target number (physical unit number)
1093 * @lun: SCSI Logical Unit Number
1095 * Description: Looks up the scsi_device with the specified @channel, @id, @lun
1096 * for a given host. The returned scsi_device has an additional reference that
1097 * needs to be released with scsi_device_put once you're done with it.
1099 struct scsi_device *scsi_device_lookup(struct Scsi_Host *shost,
1100 uint channel, uint id, uint lun)
1102 struct scsi_device *sdev;
1103 unsigned long flags;
1105 spin_lock_irqsave(shost->host_lock, flags);
1106 sdev = __scsi_device_lookup(shost, channel, id, lun);
1107 if (sdev && scsi_device_get(sdev))
1108 sdev = NULL;
1109 spin_unlock_irqrestore(shost->host_lock, flags);
1111 return sdev;
1113 EXPORT_SYMBOL(scsi_device_lookup);
1115 MODULE_DESCRIPTION("SCSI core");
1116 MODULE_LICENSE("GPL");
1118 module_param(scsi_logging_level, int, S_IRUGO|S_IWUSR);
1119 MODULE_PARM_DESC(scsi_logging_level, "a bit mask of logging levels");
1121 static int __init init_scsi(void)
1123 int error;
1125 error = scsi_init_queue();
1126 if (error)
1127 return error;
1128 error = scsi_init_procfs();
1129 if (error)
1130 goto cleanup_queue;
1131 error = scsi_init_devinfo();
1132 if (error)
1133 goto cleanup_procfs;
1134 error = scsi_init_hosts();
1135 if (error)
1136 goto cleanup_devlist;
1137 error = scsi_init_sysctl();
1138 if (error)
1139 goto cleanup_hosts;
1140 error = scsi_sysfs_register();
1141 if (error)
1142 goto cleanup_sysctl;
1144 scsi_netlink_init();
1146 printk(KERN_NOTICE "SCSI subsystem initialized\n");
1147 return 0;
1149 cleanup_sysctl:
1150 scsi_exit_sysctl();
1151 cleanup_hosts:
1152 scsi_exit_hosts();
1153 cleanup_devlist:
1154 scsi_exit_devinfo();
1155 cleanup_procfs:
1156 scsi_exit_procfs();
1157 cleanup_queue:
1158 scsi_exit_queue();
1159 printk(KERN_ERR "SCSI subsystem failed to initialize, error = %d\n",
1160 -error);
1161 return error;
1164 static void __exit exit_scsi(void)
1166 scsi_netlink_exit();
1167 scsi_sysfs_unregister();
1168 scsi_exit_sysctl();
1169 scsi_exit_hosts();
1170 scsi_exit_devinfo();
1171 scsi_exit_procfs();
1172 scsi_exit_queue();
1175 subsys_initcall(init_scsi);
1176 module_exit(exit_scsi);