]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blob - drivers/scsi/megaraid.c
Linux-2.6.12-rc2
[mirror_ubuntu-artful-kernel.git] / drivers / scsi / megaraid.c
1 /*
2 *
3 * Linux MegaRAID device driver
4 *
5 * Copyright © 2002 LSI Logic Corporation.
6 *
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version
10 * 2 of the License, or (at your option) any later version.
11 *
12 * Copyright (c) 2002 Red Hat, Inc. All rights reserved.
13 * - fixes
14 * - speed-ups (list handling fixes, issued_list, optimizations.)
15 * - lots of cleanups.
16 *
17 * Copyright (c) 2003 Christoph Hellwig <hch@lst.de>
18 * - new-style, hotplug-aware pci probing and scsi registration
19 *
20 * Version : v2.00.3 (Feb 19, 2003) - Atul Mukker <Atul.Mukker@lsil.com>
21 *
22 * Description: Linux device driver for LSI Logic MegaRAID controller
23 *
24 * Supported controllers: MegaRAID 418, 428, 438, 466, 762, 467, 471, 490, 493
25 * 518, 520, 531, 532
26 *
27 * This driver is supported by LSI Logic, with assistance from Red Hat, Dell,
28 * and others. Please send updates to the mailing list
29 * linux-scsi@vger.kernel.org .
30 *
31 */
32
33 #include <linux/mm.h>
34 #include <linux/fs.h>
35 #include <linux/blkdev.h>
36 #include <asm/uaccess.h>
37 #include <asm/io.h>
38 #include <linux/delay.h>
39 #include <linux/proc_fs.h>
40 #include <linux/reboot.h>
41 #include <linux/module.h>
42 #include <linux/list.h>
43 #include <linux/interrupt.h>
44 #include <linux/pci.h>
45 #include <linux/init.h>
46 #include <scsi/scsicam.h>
47
48 #include "scsi.h"
49 #include <scsi/scsi_host.h>
50
51 #include "megaraid.h"
52
53 #define MEGARAID_MODULE_VERSION "2.00.3"
54
55 MODULE_AUTHOR ("LSI Logic Corporation");
56 MODULE_DESCRIPTION ("LSI Logic MegaRAID driver");
57 MODULE_LICENSE ("GPL");
58 MODULE_VERSION(MEGARAID_MODULE_VERSION);
59
60 static unsigned int max_cmd_per_lun = DEF_CMD_PER_LUN;
61 module_param(max_cmd_per_lun, uint, 0);
62 MODULE_PARM_DESC(max_cmd_per_lun, "Maximum number of commands which can be issued to a single LUN (default=DEF_CMD_PER_LUN=63)");
63
64 static unsigned short int max_sectors_per_io = MAX_SECTORS_PER_IO;
65 module_param(max_sectors_per_io, ushort, 0);
66 MODULE_PARM_DESC(max_sectors_per_io, "Maximum number of sectors per I/O request (default=MAX_SECTORS_PER_IO=128)");
67
68
69 static unsigned short int max_mbox_busy_wait = MBOX_BUSY_WAIT;
70 module_param(max_mbox_busy_wait, ushort, 0);
71 MODULE_PARM_DESC(max_mbox_busy_wait, "Maximum wait for mailbox in microseconds if busy (default=MBOX_BUSY_WAIT=10)");
72
73 #define RDINDOOR(adapter) readl((adapter)->base + 0x20)
74 #define RDOUTDOOR(adapter) readl((adapter)->base + 0x2C)
75 #define WRINDOOR(adapter,value) writel(value, (adapter)->base + 0x20)
76 #define WROUTDOOR(adapter,value) writel(value, (adapter)->base + 0x2C)
77
78 /*
79 * Global variables
80 */
81
82 static int hba_count;
83 static adapter_t *hba_soft_state[MAX_CONTROLLERS];
84 static struct proc_dir_entry *mega_proc_dir_entry;
85
86 /* For controller re-ordering */
87 static struct mega_hbas mega_hbas[MAX_CONTROLLERS];
88
89 /*
90 * The File Operations structure for the serial/ioctl interface of the driver
91 */
92 static struct file_operations megadev_fops = {
93 .owner = THIS_MODULE,
94 .ioctl = megadev_ioctl,
95 .open = megadev_open,
96 };
97
98 /*
99 * Array to structures for storing the information about the controllers. This
100 * information is sent to the user level applications, when they do an ioctl
101 * for this information.
102 */
103 static struct mcontroller mcontroller[MAX_CONTROLLERS];
104
105 /* The current driver version */
106 static u32 driver_ver = 0x02000000;
107
108 /* major number used by the device for character interface */
109 static int major;
110
111 #define IS_RAID_CH(hba, ch) (((hba)->mega_ch_class >> (ch)) & 0x01)
112
113
114 /*
115 * Debug variable to print some diagnostic messages
116 */
117 static int trace_level;
118
119 /**
120 * mega_setup_mailbox()
121 * @adapter - pointer to our soft state
122 *
123 * Allocates a 8 byte aligned memory for the handshake mailbox.
124 */
125 static int
126 mega_setup_mailbox(adapter_t *adapter)
127 {
128 unsigned long align;
129
130 adapter->una_mbox64 = pci_alloc_consistent(adapter->dev,
131 sizeof(mbox64_t), &adapter->una_mbox64_dma);
132
133 if( !adapter->una_mbox64 ) return -1;
134
135 adapter->mbox = &adapter->una_mbox64->mbox;
136
137 adapter->mbox = (mbox_t *)((((unsigned long) adapter->mbox) + 15) &
138 (~0UL ^ 0xFUL));
139
140 adapter->mbox64 = (mbox64_t *)(((unsigned long)adapter->mbox) - 8);
141
142 align = ((void *)adapter->mbox) - ((void *)&adapter->una_mbox64->mbox);
143
144 adapter->mbox_dma = adapter->una_mbox64_dma + 8 + align;
145
146 /*
147 * Register the mailbox if the controller is an io-mapped controller
148 */
149 if( adapter->flag & BOARD_IOMAP ) {
150
151 outb_p(adapter->mbox_dma & 0xFF,
152 adapter->host->io_port + MBOX_PORT0);
153
154 outb_p((adapter->mbox_dma >> 8) & 0xFF,
155 adapter->host->io_port + MBOX_PORT1);
156
157 outb_p((adapter->mbox_dma >> 16) & 0xFF,
158 adapter->host->io_port + MBOX_PORT2);
159
160 outb_p((adapter->mbox_dma >> 24) & 0xFF,
161 adapter->host->io_port + MBOX_PORT3);
162
163 outb_p(ENABLE_MBOX_BYTE,
164 adapter->host->io_port + ENABLE_MBOX_REGION);
165
166 irq_ack(adapter);
167
168 irq_enable(adapter);
169 }
170
171 return 0;
172 }
173
174
175 /*
176 * mega_query_adapter()
177 * @adapter - pointer to our soft state
178 *
179 * Issue the adapter inquiry commands to the controller and find out
180 * information and parameter about the devices attached
181 */
182 static int
183 mega_query_adapter(adapter_t *adapter)
184 {
185 dma_addr_t prod_info_dma_handle;
186 mega_inquiry3 *inquiry3;
187 u8 raw_mbox[sizeof(struct mbox_out)];
188 mbox_t *mbox;
189 int retval;
190
191 /* Initialize adapter inquiry mailbox */
192
193 mbox = (mbox_t *)raw_mbox;
194
195 memset((void *)adapter->mega_buffer, 0, MEGA_BUFFER_SIZE);
196 memset(&mbox->m_out, 0, sizeof(raw_mbox));
197
198 /*
199 * Try to issue Inquiry3 command
200 * if not succeeded, then issue MEGA_MBOXCMD_ADAPTERINQ command and
201 * update enquiry3 structure
202 */
203 mbox->m_out.xferaddr = (u32)adapter->buf_dma_handle;
204
205 inquiry3 = (mega_inquiry3 *)adapter->mega_buffer;
206
207 raw_mbox[0] = FC_NEW_CONFIG; /* i.e. mbox->cmd=0xA1 */
208 raw_mbox[2] = NC_SUBOP_ENQUIRY3; /* i.e. 0x0F */
209 raw_mbox[3] = ENQ3_GET_SOLICITED_FULL; /* i.e. 0x02 */
210
211 /* Issue a blocking command to the card */
212 if ((retval = issue_scb_block(adapter, raw_mbox))) {
213 /* the adapter does not support 40ld */
214
215 mraid_ext_inquiry *ext_inq;
216 mraid_inquiry *inq;
217 dma_addr_t dma_handle;
218
219 ext_inq = pci_alloc_consistent(adapter->dev,
220 sizeof(mraid_ext_inquiry), &dma_handle);
221
222 if( ext_inq == NULL ) return -1;
223
224 inq = &ext_inq->raid_inq;
225
226 mbox->m_out.xferaddr = (u32)dma_handle;
227
228 /*issue old 0x04 command to adapter */
229 mbox->m_out.cmd = MEGA_MBOXCMD_ADPEXTINQ;
230
231 issue_scb_block(adapter, raw_mbox);
232
233 /*
234 * update Enquiry3 and ProductInfo structures with
235 * mraid_inquiry structure
236 */
237 mega_8_to_40ld(inq, inquiry3,
238 (mega_product_info *)&adapter->product_info);
239
240 pci_free_consistent(adapter->dev, sizeof(mraid_ext_inquiry),
241 ext_inq, dma_handle);
242
243 } else { /*adapter supports 40ld */
244 adapter->flag |= BOARD_40LD;
245
246 /*
247 * get product_info, which is static information and will be
248 * unchanged
249 */
250 prod_info_dma_handle = pci_map_single(adapter->dev, (void *)
251 &adapter->product_info,
252 sizeof(mega_product_info), PCI_DMA_FROMDEVICE);
253
254 mbox->m_out.xferaddr = prod_info_dma_handle;
255
256 raw_mbox[0] = FC_NEW_CONFIG; /* i.e. mbox->cmd=0xA1 */
257 raw_mbox[2] = NC_SUBOP_PRODUCT_INFO; /* i.e. 0x0E */
258
259 if ((retval = issue_scb_block(adapter, raw_mbox)))
260 printk(KERN_WARNING
261 "megaraid: Product_info cmd failed with error: %d\n",
262 retval);
263
264 pci_unmap_single(adapter->dev, prod_info_dma_handle,
265 sizeof(mega_product_info), PCI_DMA_FROMDEVICE);
266 }
267
268
269 /*
270 * kernel scans the channels from 0 to <= max_channel
271 */
272 adapter->host->max_channel =
273 adapter->product_info.nchannels + NVIRT_CHAN -1;
274
275 adapter->host->max_id = 16; /* max targets per channel */
276
277 adapter->host->max_lun = 7; /* Upto 7 luns for non disk devices */
278
279 adapter->host->cmd_per_lun = max_cmd_per_lun;
280
281 adapter->numldrv = inquiry3->num_ldrv;
282
283 adapter->max_cmds = adapter->product_info.max_commands;
284
285 if(adapter->max_cmds > MAX_COMMANDS)
286 adapter->max_cmds = MAX_COMMANDS;
287
288 adapter->host->can_queue = adapter->max_cmds - 1;
289
290 /*
291 * Get the maximum number of scatter-gather elements supported by this
292 * firmware
293 */
294 mega_get_max_sgl(adapter);
295
296 adapter->host->sg_tablesize = adapter->sglen;
297
298
299 /* use HP firmware and bios version encoding */
300 if (adapter->product_info.subsysvid == HP_SUBSYS_VID) {
301 sprintf (adapter->fw_version, "%c%d%d.%d%d",
302 adapter->product_info.fw_version[2],
303 adapter->product_info.fw_version[1] >> 8,
304 adapter->product_info.fw_version[1] & 0x0f,
305 adapter->product_info.fw_version[0] >> 8,
306 adapter->product_info.fw_version[0] & 0x0f);
307 sprintf (adapter->bios_version, "%c%d%d.%d%d",
308 adapter->product_info.bios_version[2],
309 adapter->product_info.bios_version[1] >> 8,
310 adapter->product_info.bios_version[1] & 0x0f,
311 adapter->product_info.bios_version[0] >> 8,
312 adapter->product_info.bios_version[0] & 0x0f);
313 } else {
314 memcpy(adapter->fw_version,
315 (char *)adapter->product_info.fw_version, 4);
316 adapter->fw_version[4] = 0;
317
318 memcpy(adapter->bios_version,
319 (char *)adapter->product_info.bios_version, 4);
320
321 adapter->bios_version[4] = 0;
322 }
323
324 printk(KERN_NOTICE "megaraid: [%s:%s] detected %d logical drives.\n",
325 adapter->fw_version, adapter->bios_version, adapter->numldrv);
326
327 /*
328 * Do we support extended (>10 bytes) cdbs
329 */
330 adapter->support_ext_cdb = mega_support_ext_cdb(adapter);
331 if (adapter->support_ext_cdb)
332 printk(KERN_NOTICE "megaraid: supports extended CDBs.\n");
333
334
335 return 0;
336 }
337
338 /**
339 * mega_runpendq()
340 * @adapter - pointer to our soft state
341 *
342 * Runs through the list of pending requests.
343 */
344 static inline void
345 mega_runpendq(adapter_t *adapter)
346 {
347 if(!list_empty(&adapter->pending_list))
348 __mega_runpendq(adapter);
349 }
350
351 /*
352 * megaraid_queue()
353 * @scmd - Issue this scsi command
354 * @done - the callback hook into the scsi mid-layer
355 *
356 * The command queuing entry point for the mid-layer.
357 */
358 static int
359 megaraid_queue(Scsi_Cmnd *scmd, void (*done)(Scsi_Cmnd *))
360 {
361 adapter_t *adapter;
362 scb_t *scb;
363 int busy=0;
364
365 adapter = (adapter_t *)scmd->device->host->hostdata;
366
367 scmd->scsi_done = done;
368
369
370 /*
371 * Allocate and build a SCB request
372 * busy flag will be set if mega_build_cmd() command could not
373 * allocate scb. We will return non-zero status in that case.
374 * NOTE: scb can be null even though certain commands completed
375 * successfully, e.g., MODE_SENSE and TEST_UNIT_READY, we would
376 * return 0 in that case.
377 */
378
379 scb = mega_build_cmd(adapter, scmd, &busy);
380
381 if(scb) {
382 scb->state |= SCB_PENDQ;
383 list_add_tail(&scb->list, &adapter->pending_list);
384
385 /*
386 * Check if the HBA is in quiescent state, e.g., during a
387 * delete logical drive opertion. If it is, don't run
388 * the pending_list.
389 */
390 if(atomic_read(&adapter->quiescent) == 0) {
391 mega_runpendq(adapter);
392 }
393 return 0;
394 }
395
396 return busy;
397 }
398
399 /**
400 * mega_allocate_scb()
401 * @adapter - pointer to our soft state
402 * @cmd - scsi command from the mid-layer
403 *
404 * Allocate a SCB structure. This is the central structure for controller
405 * commands.
406 */
407 static inline scb_t *
408 mega_allocate_scb(adapter_t *adapter, Scsi_Cmnd *cmd)
409 {
410 struct list_head *head = &adapter->free_list;
411 scb_t *scb;
412
413 /* Unlink command from Free List */
414 if( !list_empty(head) ) {
415
416 scb = list_entry(head->next, scb_t, list);
417
418 list_del_init(head->next);
419
420 scb->state = SCB_ACTIVE;
421 scb->cmd = cmd;
422 scb->dma_type = MEGA_DMA_TYPE_NONE;
423
424 return scb;
425 }
426
427 return NULL;
428 }
429
430 /**
431 * mega_get_ldrv_num()
432 * @adapter - pointer to our soft state
433 * @cmd - scsi mid layer command
434 * @channel - channel on the controller
435 *
436 * Calculate the logical drive number based on the information in scsi command
437 * and the channel number.
438 */
439 static inline int
440 mega_get_ldrv_num(adapter_t *adapter, Scsi_Cmnd *cmd, int channel)
441 {
442 int tgt;
443 int ldrv_num;
444
445 tgt = cmd->device->id;
446
447 if ( tgt > adapter->this_id )
448 tgt--; /* we do not get inquires for initiator id */
449
450 ldrv_num = (channel * 15) + tgt;
451
452
453 /*
454 * If we have a logical drive with boot enabled, project it first
455 */
456 if( adapter->boot_ldrv_enabled ) {
457 if( ldrv_num == 0 ) {
458 ldrv_num = adapter->boot_ldrv;
459 }
460 else {
461 if( ldrv_num <= adapter->boot_ldrv ) {
462 ldrv_num--;
463 }
464 }
465 }
466
467 /*
468 * If "delete logical drive" feature is enabled on this controller.
469 * Do only if at least one delete logical drive operation was done.
470 *
471 * Also, after logical drive deletion, instead of logical drive number,
472 * the value returned should be 0x80+logical drive id.
473 *
474 * These is valid only for IO commands.
475 */
476
477 if (adapter->support_random_del && adapter->read_ldidmap )
478 switch (cmd->cmnd[0]) {
479 case READ_6: /* fall through */
480 case WRITE_6: /* fall through */
481 case READ_10: /* fall through */
482 case WRITE_10:
483 ldrv_num += 0x80;
484 }
485
486 return ldrv_num;
487 }
488
489 /**
490 * mega_build_cmd()
491 * @adapter - pointer to our soft state
492 * @cmd - Prepare using this scsi command
493 * @busy - busy flag if no resources
494 *
495 * Prepares a command and scatter gather list for the controller. This routine
496 * also finds out if the commands is intended for a logical drive or a
497 * physical device and prepares the controller command accordingly.
498 *
499 * We also re-order the logical drives and physical devices based on their
500 * boot settings.
501 */
502 static scb_t *
503 mega_build_cmd(adapter_t *adapter, Scsi_Cmnd *cmd, int *busy)
504 {
505 mega_ext_passthru *epthru;
506 mega_passthru *pthru;
507 scb_t *scb;
508 mbox_t *mbox;
509 long seg;
510 char islogical;
511 int max_ldrv_num;
512 int channel = 0;
513 int target = 0;
514 int ldrv_num = 0; /* logical drive number */
515
516
517 /*
518 * filter the internal and ioctl commands
519 */
520 if((cmd->cmnd[0] == MEGA_INTERNAL_CMD)) {
521 return cmd->buffer;
522 }
523
524
525 /*
526 * We know what channels our logical drives are on - mega_find_card()
527 */
528 islogical = adapter->logdrv_chan[cmd->device->channel];
529
530 /*
531 * The theory: If physical drive is chosen for boot, all the physical
532 * devices are exported before the logical drives, otherwise physical
533 * devices are pushed after logical drives, in which case - Kernel sees
534 * the physical devices on virtual channel which is obviously converted
535 * to actual channel on the HBA.
536 */
537 if( adapter->boot_pdrv_enabled ) {
538 if( islogical ) {
539 /* logical channel */
540 channel = cmd->device->channel -
541 adapter->product_info.nchannels;
542 }
543 else {
544 /* this is physical channel */
545 channel = cmd->device->channel;
546 target = cmd->device->id;
547
548 /*
549 * boot from a physical disk, that disk needs to be
550 * exposed first IF both the channels are SCSI, then
551 * booting from the second channel is not allowed.
552 */
553 if( target == 0 ) {
554 target = adapter->boot_pdrv_tgt;
555 }
556 else if( target == adapter->boot_pdrv_tgt ) {
557 target = 0;
558 }
559 }
560 }
561 else {
562 if( islogical ) {
563 /* this is the logical channel */
564 channel = cmd->device->channel;
565 }
566 else {
567 /* physical channel */
568 channel = cmd->device->channel - NVIRT_CHAN;
569 target = cmd->device->id;
570 }
571 }
572
573
574 if(islogical) {
575
576 /* have just LUN 0 for each target on virtual channels */
577 if (cmd->device->lun) {
578 cmd->result = (DID_BAD_TARGET << 16);
579 cmd->scsi_done(cmd);
580 return NULL;
581 }
582
583 ldrv_num = mega_get_ldrv_num(adapter, cmd, channel);
584
585
586 max_ldrv_num = (adapter->flag & BOARD_40LD) ?
587 MAX_LOGICAL_DRIVES_40LD : MAX_LOGICAL_DRIVES_8LD;
588
589 /*
590 * max_ldrv_num increases by 0x80 if some logical drive was
591 * deleted.
592 */
593 if(adapter->read_ldidmap)
594 max_ldrv_num += 0x80;
595
596 if(ldrv_num > max_ldrv_num ) {
597 cmd->result = (DID_BAD_TARGET << 16);
598 cmd->scsi_done(cmd);
599 return NULL;
600 }
601
602 }
603 else {
604 if( cmd->device->lun > 7) {
605 /*
606 * Do not support lun >7 for physically accessed
607 * devices
608 */
609 cmd->result = (DID_BAD_TARGET << 16);
610 cmd->scsi_done(cmd);
611 return NULL;
612 }
613 }
614
615 /*
616 *
617 * Logical drive commands
618 *
619 */
620 if(islogical) {
621 switch (cmd->cmnd[0]) {
622 case TEST_UNIT_READY:
623 memset(cmd->request_buffer, 0, cmd->request_bufflen);
624
625 #if MEGA_HAVE_CLUSTERING
626 /*
627 * Do we support clustering and is the support enabled
628 * If no, return success always
629 */
630 if( !adapter->has_cluster ) {
631 cmd->result = (DID_OK << 16);
632 cmd->scsi_done(cmd);
633 return NULL;
634 }
635
636 if(!(scb = mega_allocate_scb(adapter, cmd))) {
637 *busy = 1;
638 return NULL;
639 }
640
641 scb->raw_mbox[0] = MEGA_CLUSTER_CMD;
642 scb->raw_mbox[2] = MEGA_RESERVATION_STATUS;
643 scb->raw_mbox[3] = ldrv_num;
644
645 scb->dma_direction = PCI_DMA_NONE;
646
647 return scb;
648 #else
649 cmd->result = (DID_OK << 16);
650 cmd->scsi_done(cmd);
651 return NULL;
652 #endif
653
654 case MODE_SENSE:
655 memset(cmd->request_buffer, 0, cmd->cmnd[4]);
656 cmd->result = (DID_OK << 16);
657 cmd->scsi_done(cmd);
658 return NULL;
659
660 case READ_CAPACITY:
661 case INQUIRY:
662
663 if(!(adapter->flag & (1L << cmd->device->channel))) {
664
665 printk(KERN_NOTICE
666 "scsi%d: scanning scsi channel %d ",
667 adapter->host->host_no,
668 cmd->device->channel);
669 printk("for logical drives.\n");
670
671 adapter->flag |= (1L << cmd->device->channel);
672 }
673
674 /* Allocate a SCB and initialize passthru */
675 if(!(scb = mega_allocate_scb(adapter, cmd))) {
676 *busy = 1;
677 return NULL;
678 }
679 pthru = scb->pthru;
680
681 mbox = (mbox_t *)scb->raw_mbox;
682 memset(mbox, 0, sizeof(scb->raw_mbox));
683 memset(pthru, 0, sizeof(mega_passthru));
684
685 pthru->timeout = 0;
686 pthru->ars = 1;
687 pthru->reqsenselen = 14;
688 pthru->islogical = 1;
689 pthru->logdrv = ldrv_num;
690 pthru->cdblen = cmd->cmd_len;
691 memcpy(pthru->cdb, cmd->cmnd, cmd->cmd_len);
692
693 if( adapter->has_64bit_addr ) {
694 mbox->m_out.cmd = MEGA_MBOXCMD_PASSTHRU64;
695 }
696 else {
697 mbox->m_out.cmd = MEGA_MBOXCMD_PASSTHRU;
698 }
699
700 scb->dma_direction = PCI_DMA_FROMDEVICE;
701
702 pthru->numsgelements = mega_build_sglist(adapter, scb,
703 &pthru->dataxferaddr, &pthru->dataxferlen);
704
705 mbox->m_out.xferaddr = scb->pthru_dma_addr;
706
707 return scb;
708
709 case READ_6:
710 case WRITE_6:
711 case READ_10:
712 case WRITE_10:
713 case READ_12:
714 case WRITE_12:
715
716 /* Allocate a SCB and initialize mailbox */
717 if(!(scb = mega_allocate_scb(adapter, cmd))) {
718 *busy = 1;
719 return NULL;
720 }
721 mbox = (mbox_t *)scb->raw_mbox;
722
723 memset(mbox, 0, sizeof(scb->raw_mbox));
724 mbox->m_out.logdrv = ldrv_num;
725
726 /*
727 * A little hack: 2nd bit is zero for all scsi read
728 * commands and is set for all scsi write commands
729 */
730 if( adapter->has_64bit_addr ) {
731 mbox->m_out.cmd = (*cmd->cmnd & 0x02) ?
732 MEGA_MBOXCMD_LWRITE64:
733 MEGA_MBOXCMD_LREAD64 ;
734 }
735 else {
736 mbox->m_out.cmd = (*cmd->cmnd & 0x02) ?
737 MEGA_MBOXCMD_LWRITE:
738 MEGA_MBOXCMD_LREAD ;
739 }
740
741 /*
742 * 6-byte READ(0x08) or WRITE(0x0A) cdb
743 */
744 if( cmd->cmd_len == 6 ) {
745 mbox->m_out.numsectors = (u32) cmd->cmnd[4];
746 mbox->m_out.lba =
747 ((u32)cmd->cmnd[1] << 16) |
748 ((u32)cmd->cmnd[2] << 8) |
749 (u32)cmd->cmnd[3];
750
751 mbox->m_out.lba &= 0x1FFFFF;
752
753 #if MEGA_HAVE_STATS
754 /*
755 * Take modulo 0x80, since the logical drive
756 * number increases by 0x80 when a logical
757 * drive was deleted
758 */
759 if (*cmd->cmnd == READ_6) {
760 adapter->nreads[ldrv_num%0x80]++;
761 adapter->nreadblocks[ldrv_num%0x80] +=
762 mbox->m_out.numsectors;
763 } else {
764 adapter->nwrites[ldrv_num%0x80]++;
765 adapter->nwriteblocks[ldrv_num%0x80] +=
766 mbox->m_out.numsectors;
767 }
768 #endif
769 }
770
771 /*
772 * 10-byte READ(0x28) or WRITE(0x2A) cdb
773 */
774 if( cmd->cmd_len == 10 ) {
775 mbox->m_out.numsectors =
776 (u32)cmd->cmnd[8] |
777 ((u32)cmd->cmnd[7] << 8);
778 mbox->m_out.lba =
779 ((u32)cmd->cmnd[2] << 24) |
780 ((u32)cmd->cmnd[3] << 16) |
781 ((u32)cmd->cmnd[4] << 8) |
782 (u32)cmd->cmnd[5];
783
784 #if MEGA_HAVE_STATS
785 if (*cmd->cmnd == READ_10) {
786 adapter->nreads[ldrv_num%0x80]++;
787 adapter->nreadblocks[ldrv_num%0x80] +=
788 mbox->m_out.numsectors;
789 } else {
790 adapter->nwrites[ldrv_num%0x80]++;
791 adapter->nwriteblocks[ldrv_num%0x80] +=
792 mbox->m_out.numsectors;
793 }
794 #endif
795 }
796
797 /*
798 * 12-byte READ(0xA8) or WRITE(0xAA) cdb
799 */
800 if( cmd->cmd_len == 12 ) {
801 mbox->m_out.lba =
802 ((u32)cmd->cmnd[2] << 24) |
803 ((u32)cmd->cmnd[3] << 16) |
804 ((u32)cmd->cmnd[4] << 8) |
805 (u32)cmd->cmnd[5];
806
807 mbox->m_out.numsectors =
808 ((u32)cmd->cmnd[6] << 24) |
809 ((u32)cmd->cmnd[7] << 16) |
810 ((u32)cmd->cmnd[8] << 8) |
811 (u32)cmd->cmnd[9];
812
813 #if MEGA_HAVE_STATS
814 if (*cmd->cmnd == READ_12) {
815 adapter->nreads[ldrv_num%0x80]++;
816 adapter->nreadblocks[ldrv_num%0x80] +=
817 mbox->m_out.numsectors;
818 } else {
819 adapter->nwrites[ldrv_num%0x80]++;
820 adapter->nwriteblocks[ldrv_num%0x80] +=
821 mbox->m_out.numsectors;
822 }
823 #endif
824 }
825
826 /*
827 * If it is a read command
828 */
829 if( (*cmd->cmnd & 0x0F) == 0x08 ) {
830 scb->dma_direction = PCI_DMA_FROMDEVICE;
831 }
832 else {
833 scb->dma_direction = PCI_DMA_TODEVICE;
834 }
835
836 /* Calculate Scatter-Gather info */
837 mbox->m_out.numsgelements = mega_build_sglist(adapter, scb,
838 (u32 *)&mbox->m_out.xferaddr, (u32 *)&seg);
839
840 return scb;
841
842 #if MEGA_HAVE_CLUSTERING
843 case RESERVE: /* Fall through */
844 case RELEASE:
845
846 /*
847 * Do we support clustering and is the support enabled
848 */
849 if( ! adapter->has_cluster ) {
850
851 cmd->result = (DID_BAD_TARGET << 16);
852 cmd->scsi_done(cmd);
853 return NULL;
854 }
855
856 /* Allocate a SCB and initialize mailbox */
857 if(!(scb = mega_allocate_scb(adapter, cmd))) {
858 *busy = 1;
859 return NULL;
860 }
861
862 scb->raw_mbox[0] = MEGA_CLUSTER_CMD;
863 scb->raw_mbox[2] = ( *cmd->cmnd == RESERVE ) ?
864 MEGA_RESERVE_LD : MEGA_RELEASE_LD;
865
866 scb->raw_mbox[3] = ldrv_num;
867
868 scb->dma_direction = PCI_DMA_NONE;
869
870 return scb;
871 #endif
872
873 default:
874 cmd->result = (DID_BAD_TARGET << 16);
875 cmd->scsi_done(cmd);
876 return NULL;
877 }
878 }
879
880 /*
881 * Passthru drive commands
882 */
883 else {
884 /* Allocate a SCB and initialize passthru */
885 if(!(scb = mega_allocate_scb(adapter, cmd))) {
886 *busy = 1;
887 return NULL;
888 }
889
890 mbox = (mbox_t *)scb->raw_mbox;
891 memset(mbox, 0, sizeof(scb->raw_mbox));
892
893 if( adapter->support_ext_cdb ) {
894
895 epthru = mega_prepare_extpassthru(adapter, scb, cmd,
896 channel, target);
897
898 mbox->m_out.cmd = MEGA_MBOXCMD_EXTPTHRU;
899
900 mbox->m_out.xferaddr = scb->epthru_dma_addr;
901
902 }
903 else {
904
905 pthru = mega_prepare_passthru(adapter, scb, cmd,
906 channel, target);
907
908 /* Initialize mailbox */
909 if( adapter->has_64bit_addr ) {
910 mbox->m_out.cmd = MEGA_MBOXCMD_PASSTHRU64;
911 }
912 else {
913 mbox->m_out.cmd = MEGA_MBOXCMD_PASSTHRU;
914 }
915
916 mbox->m_out.xferaddr = scb->pthru_dma_addr;
917
918 }
919 return scb;
920 }
921 return NULL;
922 }
923
924
925 /**
926 * mega_prepare_passthru()
927 * @adapter - pointer to our soft state
928 * @scb - our scsi control block
929 * @cmd - scsi command from the mid-layer
930 * @channel - actual channel on the controller
931 * @target - actual id on the controller.
932 *
933 * prepare a command for the scsi physical devices.
934 */
935 static mega_passthru *
936 mega_prepare_passthru(adapter_t *adapter, scb_t *scb, Scsi_Cmnd *cmd,
937 int channel, int target)
938 {
939 mega_passthru *pthru;
940
941 pthru = scb->pthru;
942 memset(pthru, 0, sizeof (mega_passthru));
943
944 /* 0=6sec/1=60sec/2=10min/3=3hrs */
945 pthru->timeout = 2;
946
947 pthru->ars = 1;
948 pthru->reqsenselen = 14;
949 pthru->islogical = 0;
950
951 pthru->channel = (adapter->flag & BOARD_40LD) ? 0 : channel;
952
953 pthru->target = (adapter->flag & BOARD_40LD) ?
954 (channel << 4) | target : target;
955
956 pthru->cdblen = cmd->cmd_len;
957 pthru->logdrv = cmd->device->lun;
958
959 memcpy(pthru->cdb, cmd->cmnd, cmd->cmd_len);
960
961 /* Not sure about the direction */
962 scb->dma_direction = PCI_DMA_BIDIRECTIONAL;
963
964 /* Special Code for Handling READ_CAPA/ INQ using bounce buffers */
965 switch (cmd->cmnd[0]) {
966 case INQUIRY:
967 case READ_CAPACITY:
968 if(!(adapter->flag & (1L << cmd->device->channel))) {
969
970 printk(KERN_NOTICE
971 "scsi%d: scanning scsi channel %d [P%d] ",
972 adapter->host->host_no,
973 cmd->device->channel, channel);
974 printk("for physical devices.\n");
975
976 adapter->flag |= (1L << cmd->device->channel);
977 }
978 /* Fall through */
979 default:
980 pthru->numsgelements = mega_build_sglist(adapter, scb,
981 &pthru->dataxferaddr, &pthru->dataxferlen);
982 break;
983 }
984 return pthru;
985 }
986
987
988 /**
989 * mega_prepare_extpassthru()
990 * @adapter - pointer to our soft state
991 * @scb - our scsi control block
992 * @cmd - scsi command from the mid-layer
993 * @channel - actual channel on the controller
994 * @target - actual id on the controller.
995 *
996 * prepare a command for the scsi physical devices. This rountine prepares
997 * commands for devices which can take extended CDBs (>10 bytes)
998 */
999 static mega_ext_passthru *
1000 mega_prepare_extpassthru(adapter_t *adapter, scb_t *scb, Scsi_Cmnd *cmd,
1001 int channel, int target)
1002 {
1003 mega_ext_passthru *epthru;
1004
1005 epthru = scb->epthru;
1006 memset(epthru, 0, sizeof(mega_ext_passthru));
1007
1008 /* 0=6sec/1=60sec/2=10min/3=3hrs */
1009 epthru->timeout = 2;
1010
1011 epthru->ars = 1;
1012 epthru->reqsenselen = 14;
1013 epthru->islogical = 0;
1014
1015 epthru->channel = (adapter->flag & BOARD_40LD) ? 0 : channel;
1016 epthru->target = (adapter->flag & BOARD_40LD) ?
1017 (channel << 4) | target : target;
1018
1019 epthru->cdblen = cmd->cmd_len;
1020 epthru->logdrv = cmd->device->lun;
1021
1022 memcpy(epthru->cdb, cmd->cmnd, cmd->cmd_len);
1023
1024 /* Not sure about the direction */
1025 scb->dma_direction = PCI_DMA_BIDIRECTIONAL;
1026
1027 switch(cmd->cmnd[0]) {
1028 case INQUIRY:
1029 case READ_CAPACITY:
1030 if(!(adapter->flag & (1L << cmd->device->channel))) {
1031
1032 printk(KERN_NOTICE
1033 "scsi%d: scanning scsi channel %d [P%d] ",
1034 adapter->host->host_no,
1035 cmd->device->channel, channel);
1036 printk("for physical devices.\n");
1037
1038 adapter->flag |= (1L << cmd->device->channel);
1039 }
1040 /* Fall through */
1041 default:
1042 epthru->numsgelements = mega_build_sglist(adapter, scb,
1043 &epthru->dataxferaddr, &epthru->dataxferlen);
1044 break;
1045 }
1046
1047 return epthru;
1048 }
1049
1050 static void
1051 __mega_runpendq(adapter_t *adapter)
1052 {
1053 scb_t *scb;
1054 struct list_head *pos, *next;
1055
1056 /* Issue any pending commands to the card */
1057 list_for_each_safe(pos, next, &adapter->pending_list) {
1058
1059 scb = list_entry(pos, scb_t, list);
1060
1061 if( !(scb->state & SCB_ISSUED) ) {
1062
1063 if( issue_scb(adapter, scb) != 0 )
1064 return;
1065 }
1066 }
1067
1068 return;
1069 }
1070
1071
1072 /**
1073 * issue_scb()
1074 * @adapter - pointer to our soft state
1075 * @scb - scsi control block
1076 *
1077 * Post a command to the card if the mailbox is available, otherwise return
1078 * busy. We also take the scb from the pending list if the mailbox is
1079 * available.
1080 */
1081 static int
1082 issue_scb(adapter_t *adapter, scb_t *scb)
1083 {
1084 volatile mbox64_t *mbox64 = adapter->mbox64;
1085 volatile mbox_t *mbox = adapter->mbox;
1086 unsigned int i = 0;
1087
1088 if(unlikely(mbox->m_in.busy)) {
1089 do {
1090 udelay(1);
1091 i++;
1092 } while( mbox->m_in.busy && (i < max_mbox_busy_wait) );
1093
1094 if(mbox->m_in.busy) return -1;
1095 }
1096
1097 /* Copy mailbox data into host structure */
1098 memcpy((char *)&mbox->m_out, (char *)scb->raw_mbox,
1099 sizeof(struct mbox_out));
1100
1101 mbox->m_out.cmdid = scb->idx; /* Set cmdid */
1102 mbox->m_in.busy = 1; /* Set busy */
1103
1104
1105 /*
1106 * Increment the pending queue counter
1107 */
1108 atomic_inc(&adapter->pend_cmds);
1109
1110 switch (mbox->m_out.cmd) {
1111 case MEGA_MBOXCMD_LREAD64:
1112 case MEGA_MBOXCMD_LWRITE64:
1113 case MEGA_MBOXCMD_PASSTHRU64:
1114 case MEGA_MBOXCMD_EXTPTHRU:
1115 mbox64->xfer_segment_lo = mbox->m_out.xferaddr;
1116 mbox64->xfer_segment_hi = 0;
1117 mbox->m_out.xferaddr = 0xFFFFFFFF;
1118 break;
1119 default:
1120 mbox64->xfer_segment_lo = 0;
1121 mbox64->xfer_segment_hi = 0;
1122 }
1123
1124 /*
1125 * post the command
1126 */
1127 scb->state |= SCB_ISSUED;
1128
1129 if( likely(adapter->flag & BOARD_MEMMAP) ) {
1130 mbox->m_in.poll = 0;
1131 mbox->m_in.ack = 0;
1132 WRINDOOR(adapter, adapter->mbox_dma | 0x1);
1133 }
1134 else {
1135 irq_enable(adapter);
1136 issue_command(adapter);
1137 }
1138
1139 return 0;
1140 }
1141
1142 /*
1143 * Wait until the controller's mailbox is available
1144 */
1145 static inline int
1146 mega_busywait_mbox (adapter_t *adapter)
1147 {
1148 if (adapter->mbox->m_in.busy)
1149 return __mega_busywait_mbox(adapter);
1150 return 0;
1151 }
1152
1153 /**
1154 * issue_scb_block()
1155 * @adapter - pointer to our soft state
1156 * @raw_mbox - the mailbox
1157 *
1158 * Issue a scb in synchronous and non-interrupt mode
1159 */
1160 static int
1161 issue_scb_block(adapter_t *adapter, u_char *raw_mbox)
1162 {
1163 volatile mbox64_t *mbox64 = adapter->mbox64;
1164 volatile mbox_t *mbox = adapter->mbox;
1165 u8 byte;
1166
1167 /* Wait until mailbox is free */
1168 if(mega_busywait_mbox (adapter))
1169 goto bug_blocked_mailbox;
1170
1171 /* Copy mailbox data into host structure */
1172 memcpy((char *) mbox, raw_mbox, sizeof(struct mbox_out));
1173 mbox->m_out.cmdid = 0xFE;
1174 mbox->m_in.busy = 1;
1175
1176 switch (raw_mbox[0]) {
1177 case MEGA_MBOXCMD_LREAD64:
1178 case MEGA_MBOXCMD_LWRITE64:
1179 case MEGA_MBOXCMD_PASSTHRU64:
1180 case MEGA_MBOXCMD_EXTPTHRU:
1181 mbox64->xfer_segment_lo = mbox->m_out.xferaddr;
1182 mbox64->xfer_segment_hi = 0;
1183 mbox->m_out.xferaddr = 0xFFFFFFFF;
1184 break;
1185 default:
1186 mbox64->xfer_segment_lo = 0;
1187 mbox64->xfer_segment_hi = 0;
1188 }
1189
1190 if( likely(adapter->flag & BOARD_MEMMAP) ) {
1191 mbox->m_in.poll = 0;
1192 mbox->m_in.ack = 0;
1193 mbox->m_in.numstatus = 0xFF;
1194 mbox->m_in.status = 0xFF;
1195 WRINDOOR(adapter, adapter->mbox_dma | 0x1);
1196
1197 while((volatile u8)mbox->m_in.numstatus == 0xFF)
1198 cpu_relax();
1199
1200 mbox->m_in.numstatus = 0xFF;
1201
1202 while( (volatile u8)mbox->m_in.poll != 0x77 )
1203 cpu_relax();
1204
1205 mbox->m_in.poll = 0;
1206 mbox->m_in.ack = 0x77;
1207
1208 WRINDOOR(adapter, adapter->mbox_dma | 0x2);
1209
1210 while(RDINDOOR(adapter) & 0x2)
1211 cpu_relax();
1212 }
1213 else {
1214 irq_disable(adapter);
1215 issue_command(adapter);
1216
1217 while (!((byte = irq_state(adapter)) & INTR_VALID))
1218 cpu_relax();
1219
1220 set_irq_state(adapter, byte);
1221 irq_enable(adapter);
1222 irq_ack(adapter);
1223 }
1224
1225 return mbox->m_in.status;
1226
1227 bug_blocked_mailbox:
1228 printk(KERN_WARNING "megaraid: Blocked mailbox......!!\n");
1229 udelay (1000);
1230 return -1;
1231 }
1232
1233
1234 /**
1235 * megaraid_isr_iomapped()
1236 * @irq - irq
1237 * @devp - pointer to our soft state
1238 * @regs - unused
1239 *
1240 * Interrupt service routine for io-mapped controllers.
1241 * Find out if our device is interrupting. If yes, acknowledge the interrupt
1242 * and service the completed commands.
1243 */
1244 static irqreturn_t
1245 megaraid_isr_iomapped(int irq, void *devp, struct pt_regs *regs)
1246 {
1247 adapter_t *adapter = devp;
1248 unsigned long flags;
1249 u8 status;
1250 u8 nstatus;
1251 u8 completed[MAX_FIRMWARE_STATUS];
1252 u8 byte;
1253 int handled = 0;
1254
1255
1256 /*
1257 * loop till F/W has more commands for us to complete.
1258 */
1259 spin_lock_irqsave(&adapter->lock, flags);
1260
1261 do {
1262 /* Check if a valid interrupt is pending */
1263 byte = irq_state(adapter);
1264 if( (byte & VALID_INTR_BYTE) == 0 ) {
1265 /*
1266 * No more pending commands
1267 */
1268 goto out_unlock;
1269 }
1270 set_irq_state(adapter, byte);
1271
1272 while((nstatus = (volatile u8)adapter->mbox->m_in.numstatus)
1273 == 0xFF)
1274 cpu_relax();
1275 adapter->mbox->m_in.numstatus = 0xFF;
1276
1277 status = adapter->mbox->m_in.status;
1278
1279 /*
1280 * decrement the pending queue counter
1281 */
1282 atomic_sub(nstatus, &adapter->pend_cmds);
1283
1284 memcpy(completed, (void *)adapter->mbox->m_in.completed,
1285 nstatus);
1286
1287 /* Acknowledge interrupt */
1288 irq_ack(adapter);
1289
1290 mega_cmd_done(adapter, completed, nstatus, status);
1291
1292 mega_rundoneq(adapter);
1293
1294 handled = 1;
1295
1296 /* Loop through any pending requests */
1297 if(atomic_read(&adapter->quiescent) == 0) {
1298 mega_runpendq(adapter);
1299 }
1300
1301 } while(1);
1302
1303 out_unlock:
1304
1305 spin_unlock_irqrestore(&adapter->lock, flags);
1306
1307 return IRQ_RETVAL(handled);
1308 }
1309
1310
1311 /**
1312 * megaraid_isr_memmapped()
1313 * @irq - irq
1314 * @devp - pointer to our soft state
1315 * @regs - unused
1316 *
1317 * Interrupt service routine for memory-mapped controllers.
1318 * Find out if our device is interrupting. If yes, acknowledge the interrupt
1319 * and service the completed commands.
1320 */
1321 static irqreturn_t
1322 megaraid_isr_memmapped(int irq, void *devp, struct pt_regs *regs)
1323 {
1324 adapter_t *adapter = devp;
1325 unsigned long flags;
1326 u8 status;
1327 u32 dword = 0;
1328 u8 nstatus;
1329 u8 completed[MAX_FIRMWARE_STATUS];
1330 int handled = 0;
1331
1332
1333 /*
1334 * loop till F/W has more commands for us to complete.
1335 */
1336 spin_lock_irqsave(&adapter->lock, flags);
1337
1338 do {
1339 /* Check if a valid interrupt is pending */
1340 dword = RDOUTDOOR(adapter);
1341 if(dword != 0x10001234) {
1342 /*
1343 * No more pending commands
1344 */
1345 goto out_unlock;
1346 }
1347 WROUTDOOR(adapter, 0x10001234);
1348
1349 while((nstatus = (volatile u8)adapter->mbox->m_in.numstatus)
1350 == 0xFF) {
1351 cpu_relax();
1352 }
1353 adapter->mbox->m_in.numstatus = 0xFF;
1354
1355 status = adapter->mbox->m_in.status;
1356
1357 /*
1358 * decrement the pending queue counter
1359 */
1360 atomic_sub(nstatus, &adapter->pend_cmds);
1361
1362 memcpy(completed, (void *)adapter->mbox->m_in.completed,
1363 nstatus);
1364
1365 /* Acknowledge interrupt */
1366 WRINDOOR(adapter, 0x2);
1367
1368 handled = 1;
1369
1370 while( RDINDOOR(adapter) & 0x02 ) cpu_relax();
1371
1372 mega_cmd_done(adapter, completed, nstatus, status);
1373
1374 mega_rundoneq(adapter);
1375
1376 /* Loop through any pending requests */
1377 if(atomic_read(&adapter->quiescent) == 0) {
1378 mega_runpendq(adapter);
1379 }
1380
1381 } while(1);
1382
1383 out_unlock:
1384
1385 spin_unlock_irqrestore(&adapter->lock, flags);
1386
1387 return IRQ_RETVAL(handled);
1388 }
1389 /**
1390 * mega_cmd_done()
1391 * @adapter - pointer to our soft state
1392 * @completed - array of ids of completed commands
1393 * @nstatus - number of completed commands
1394 * @status - status of the last command completed
1395 *
1396 * Complete the comamnds and call the scsi mid-layer callback hooks.
1397 */
1398 static void
1399 mega_cmd_done(adapter_t *adapter, u8 completed[], int nstatus, int status)
1400 {
1401 mega_ext_passthru *epthru = NULL;
1402 struct scatterlist *sgl;
1403 Scsi_Cmnd *cmd = NULL;
1404 mega_passthru *pthru = NULL;
1405 mbox_t *mbox = NULL;
1406 u8 c;
1407 scb_t *scb;
1408 int islogical;
1409 int cmdid;
1410 int i;
1411
1412 /*
1413 * for all the commands completed, call the mid-layer callback routine
1414 * and free the scb.
1415 */
1416 for( i = 0; i < nstatus; i++ ) {
1417
1418 cmdid = completed[i];
1419
1420 if( cmdid == CMDID_INT_CMDS ) { /* internal command */
1421 scb = &adapter->int_scb;
1422 cmd = scb->cmd;
1423 mbox = (mbox_t *)scb->raw_mbox;
1424
1425 /*
1426 * Internal command interface do not fire the extended
1427 * passthru or 64-bit passthru
1428 */
1429 pthru = scb->pthru;
1430
1431 }
1432 else {
1433 scb = &adapter->scb_list[cmdid];
1434
1435 /*
1436 * Make sure f/w has completed a valid command
1437 */
1438 if( !(scb->state & SCB_ISSUED) || scb->cmd == NULL ) {
1439 printk(KERN_CRIT
1440 "megaraid: invalid command ");
1441 printk("Id %d, scb->state:%x, scsi cmd:%p\n",
1442 cmdid, scb->state, scb->cmd);
1443
1444 continue;
1445 }
1446
1447 /*
1448 * Was a abort issued for this command
1449 */
1450 if( scb->state & SCB_ABORT ) {
1451
1452 printk(KERN_WARNING
1453 "megaraid: aborted cmd %lx[%x] complete.\n",
1454 scb->cmd->serial_number, scb->idx);
1455
1456 scb->cmd->result = (DID_ABORT << 16);
1457
1458 list_add_tail(SCSI_LIST(scb->cmd),
1459 &adapter->completed_list);
1460
1461 mega_free_scb(adapter, scb);
1462
1463 continue;
1464 }
1465
1466 /*
1467 * Was a reset issued for this command
1468 */
1469 if( scb->state & SCB_RESET ) {
1470
1471 printk(KERN_WARNING
1472 "megaraid: reset cmd %lx[%x] complete.\n",
1473 scb->cmd->serial_number, scb->idx);
1474
1475 scb->cmd->result = (DID_RESET << 16);
1476
1477 list_add_tail(SCSI_LIST(scb->cmd),
1478 &adapter->completed_list);
1479
1480 mega_free_scb (adapter, scb);
1481
1482 continue;
1483 }
1484
1485 cmd = scb->cmd;
1486 pthru = scb->pthru;
1487 epthru = scb->epthru;
1488 mbox = (mbox_t *)scb->raw_mbox;
1489
1490 #if MEGA_HAVE_STATS
1491 {
1492
1493 int logdrv = mbox->m_out.logdrv;
1494
1495 islogical = adapter->logdrv_chan[cmd->channel];
1496 /*
1497 * Maintain an error counter for the logical drive.
1498 * Some application like SNMP agent need such
1499 * statistics
1500 */
1501 if( status && islogical && (cmd->cmnd[0] == READ_6 ||
1502 cmd->cmnd[0] == READ_10 ||
1503 cmd->cmnd[0] == READ_12)) {
1504 /*
1505 * Logical drive number increases by 0x80 when
1506 * a logical drive is deleted
1507 */
1508 adapter->rd_errors[logdrv%0x80]++;
1509 }
1510
1511 if( status && islogical && (cmd->cmnd[0] == WRITE_6 ||
1512 cmd->cmnd[0] == WRITE_10 ||
1513 cmd->cmnd[0] == WRITE_12)) {
1514 /*
1515 * Logical drive number increases by 0x80 when
1516 * a logical drive is deleted
1517 */
1518 adapter->wr_errors[logdrv%0x80]++;
1519 }
1520
1521 }
1522 #endif
1523 }
1524
1525 /*
1526 * Do not return the presence of hard disk on the channel so,
1527 * inquiry sent, and returned data==hard disk or removable
1528 * hard disk and not logical, request should return failure! -
1529 * PJ
1530 */
1531 islogical = adapter->logdrv_chan[cmd->device->channel];
1532 if( cmd->cmnd[0] == INQUIRY && !islogical ) {
1533
1534 if( cmd->use_sg ) {
1535 sgl = (struct scatterlist *)
1536 cmd->request_buffer;
1537
1538 if( sgl->page ) {
1539 c = *(unsigned char *)
1540 page_address((&sgl[0])->page) +
1541 (&sgl[0])->offset;
1542 }
1543 else {
1544 printk(KERN_WARNING
1545 "megaraid: invalid sg.\n");
1546 c = 0;
1547 }
1548 }
1549 else {
1550 c = *(u8 *)cmd->request_buffer;
1551 }
1552
1553 if(IS_RAID_CH(adapter, cmd->device->channel) &&
1554 ((c & 0x1F ) == TYPE_DISK)) {
1555 status = 0xF0;
1556 }
1557 }
1558
1559 /* clear result; otherwise, success returns corrupt value */
1560 cmd->result = 0;
1561
1562 /* Convert MegaRAID status to Linux error code */
1563 switch (status) {
1564 case 0x00: /* SUCCESS , i.e. SCSI_STATUS_GOOD */
1565 cmd->result |= (DID_OK << 16);
1566 break;
1567
1568 case 0x02: /* ERROR_ABORTED, i.e.
1569 SCSI_STATUS_CHECK_CONDITION */
1570
1571 /* set sense_buffer and result fields */
1572 if( mbox->m_out.cmd == MEGA_MBOXCMD_PASSTHRU ||
1573 mbox->m_out.cmd == MEGA_MBOXCMD_PASSTHRU64 ) {
1574
1575 memcpy(cmd->sense_buffer, pthru->reqsensearea,
1576 14);
1577
1578 cmd->result = (DRIVER_SENSE << 24) |
1579 (DID_OK << 16) |
1580 (CHECK_CONDITION << 1);
1581 }
1582 else {
1583 if (mbox->m_out.cmd == MEGA_MBOXCMD_EXTPTHRU) {
1584
1585 memcpy(cmd->sense_buffer,
1586 epthru->reqsensearea, 14);
1587
1588 cmd->result = (DRIVER_SENSE << 24) |
1589 (DID_OK << 16) |
1590 (CHECK_CONDITION << 1);
1591 } else {
1592 cmd->sense_buffer[0] = 0x70;
1593 cmd->sense_buffer[2] = ABORTED_COMMAND;
1594 cmd->result |= (CHECK_CONDITION << 1);
1595 }
1596 }
1597 break;
1598
1599 case 0x08: /* ERR_DEST_DRIVE_FAILED, i.e.
1600 SCSI_STATUS_BUSY */
1601 cmd->result |= (DID_BUS_BUSY << 16) | status;
1602 break;
1603
1604 default:
1605 #if MEGA_HAVE_CLUSTERING
1606 /*
1607 * If TEST_UNIT_READY fails, we know
1608 * MEGA_RESERVATION_STATUS failed
1609 */
1610 if( cmd->cmnd[0] == TEST_UNIT_READY ) {
1611 cmd->result |= (DID_ERROR << 16) |
1612 (RESERVATION_CONFLICT << 1);
1613 }
1614 else
1615 /*
1616 * Error code returned is 1 if Reserve or Release
1617 * failed or the input parameter is invalid
1618 */
1619 if( status == 1 &&
1620 (cmd->cmnd[0] == RESERVE ||
1621 cmd->cmnd[0] == RELEASE) ) {
1622
1623 cmd->result |= (DID_ERROR << 16) |
1624 (RESERVATION_CONFLICT << 1);
1625 }
1626 else
1627 #endif
1628 cmd->result |= (DID_BAD_TARGET << 16)|status;
1629 }
1630
1631 /*
1632 * Only free SCBs for the commands coming down from the
1633 * mid-layer, not for which were issued internally
1634 *
1635 * For internal command, restore the status returned by the
1636 * firmware so that user can interpret it.
1637 */
1638 if( cmdid == CMDID_INT_CMDS ) { /* internal command */
1639 cmd->result = status;
1640
1641 /*
1642 * Remove the internal command from the pending list
1643 */
1644 list_del_init(&scb->list);
1645 scb->state = SCB_FREE;
1646 }
1647 else {
1648 mega_free_scb(adapter, scb);
1649 }
1650
1651 /* Add Scsi_Command to end of completed queue */
1652 list_add_tail(SCSI_LIST(cmd), &adapter->completed_list);
1653 }
1654 }
1655
1656
1657 /*
1658 * mega_runpendq()
1659 *
1660 * Run through the list of completed requests and finish it
1661 */
1662 static void
1663 mega_rundoneq (adapter_t *adapter)
1664 {
1665 Scsi_Cmnd *cmd;
1666 struct list_head *pos;
1667
1668 list_for_each(pos, &adapter->completed_list) {
1669
1670 Scsi_Pointer* spos = (Scsi_Pointer *)pos;
1671
1672 cmd = list_entry(spos, Scsi_Cmnd, SCp);
1673 cmd->scsi_done(cmd);
1674 }
1675
1676 INIT_LIST_HEAD(&adapter->completed_list);
1677 }
1678
1679
1680 /*
1681 * Free a SCB structure
1682 * Note: We assume the scsi commands associated with this scb is not free yet.
1683 */
1684 static void
1685 mega_free_scb(adapter_t *adapter, scb_t *scb)
1686 {
1687 switch( scb->dma_type ) {
1688
1689 case MEGA_DMA_TYPE_NONE:
1690 break;
1691
1692 case MEGA_BULK_DATA:
1693 pci_unmap_page(adapter->dev, scb->dma_h_bulkdata,
1694 scb->cmd->request_bufflen, scb->dma_direction);
1695 break;
1696
1697 case MEGA_SGLIST:
1698 pci_unmap_sg(adapter->dev, scb->cmd->request_buffer,
1699 scb->cmd->use_sg, scb->dma_direction);
1700 break;
1701
1702 default:
1703 break;
1704 }
1705
1706 /*
1707 * Remove from the pending list
1708 */
1709 list_del_init(&scb->list);
1710
1711 /* Link the scb back into free list */
1712 scb->state = SCB_FREE;
1713 scb->cmd = NULL;
1714
1715 list_add(&scb->list, &adapter->free_list);
1716 }
1717
1718
1719 static int
1720 __mega_busywait_mbox (adapter_t *adapter)
1721 {
1722 volatile mbox_t *mbox = adapter->mbox;
1723 long counter;
1724
1725 for (counter = 0; counter < 10000; counter++) {
1726 if (!mbox->m_in.busy)
1727 return 0;
1728 udelay(100); yield();
1729 }
1730 return -1; /* give up after 1 second */
1731 }
1732
1733 /*
1734 * Copies data to SGLIST
1735 * Note: For 64 bit cards, we need a minimum of one SG element for read/write
1736 */
1737 static int
1738 mega_build_sglist(adapter_t *adapter, scb_t *scb, u32 *buf, u32 *len)
1739 {
1740 struct scatterlist *sgl;
1741 struct page *page;
1742 unsigned long offset;
1743 Scsi_Cmnd *cmd;
1744 int sgcnt;
1745 int idx;
1746
1747 cmd = scb->cmd;
1748
1749 /* Scatter-gather not used */
1750 if( !cmd->use_sg ) {
1751
1752 page = virt_to_page(cmd->request_buffer);
1753 offset = offset_in_page(cmd->request_buffer);
1754
1755 scb->dma_h_bulkdata = pci_map_page(adapter->dev,
1756 page, offset,
1757 cmd->request_bufflen,
1758 scb->dma_direction);
1759 scb->dma_type = MEGA_BULK_DATA;
1760
1761 /*
1762 * We need to handle special 64-bit commands that need a
1763 * minimum of 1 SG
1764 */
1765 if( adapter->has_64bit_addr ) {
1766 scb->sgl64[0].address = scb->dma_h_bulkdata;
1767 scb->sgl64[0].length = cmd->request_bufflen;
1768 *buf = (u32)scb->sgl_dma_addr;
1769 *len = (u32)cmd->request_bufflen;
1770 return 1;
1771 }
1772 else {
1773 *buf = (u32)scb->dma_h_bulkdata;
1774 *len = (u32)cmd->request_bufflen;
1775 }
1776 return 0;
1777 }
1778
1779 sgl = (struct scatterlist *)cmd->request_buffer;
1780
1781 /*
1782 * Copy Scatter-Gather list info into controller structure.
1783 *
1784 * The number of sg elements returned must not exceed our limit
1785 */
1786 sgcnt = pci_map_sg(adapter->dev, sgl, cmd->use_sg,
1787 scb->dma_direction);
1788
1789 scb->dma_type = MEGA_SGLIST;
1790
1791 if( sgcnt > adapter->sglen ) BUG();
1792
1793 for( idx = 0; idx < sgcnt; idx++, sgl++ ) {
1794
1795 if( adapter->has_64bit_addr ) {
1796 scb->sgl64[idx].address = sg_dma_address(sgl);
1797 scb->sgl64[idx].length = sg_dma_len(sgl);
1798 }
1799 else {
1800 scb->sgl[idx].address = sg_dma_address(sgl);
1801 scb->sgl[idx].length = sg_dma_len(sgl);
1802 }
1803 }
1804
1805 /* Reset pointer and length fields */
1806 *buf = scb->sgl_dma_addr;
1807
1808 /*
1809 * For passthru command, dataxferlen must be set, even for commands
1810 * with a sg list
1811 */
1812 *len = (u32)cmd->request_bufflen;
1813
1814 /* Return count of SG requests */
1815 return sgcnt;
1816 }
1817
1818
1819 /*
1820 * mega_8_to_40ld()
1821 *
1822 * takes all info in AdapterInquiry structure and puts it into ProductInfo and
1823 * Enquiry3 structures for later use
1824 */
1825 static void
1826 mega_8_to_40ld(mraid_inquiry *inquiry, mega_inquiry3 *enquiry3,
1827 mega_product_info *product_info)
1828 {
1829 int i;
1830
1831 product_info->max_commands = inquiry->adapter_info.max_commands;
1832 enquiry3->rebuild_rate = inquiry->adapter_info.rebuild_rate;
1833 product_info->nchannels = inquiry->adapter_info.nchannels;
1834
1835 for (i = 0; i < 4; i++) {
1836 product_info->fw_version[i] =
1837 inquiry->adapter_info.fw_version[i];
1838
1839 product_info->bios_version[i] =
1840 inquiry->adapter_info.bios_version[i];
1841 }
1842 enquiry3->cache_flush_interval =
1843 inquiry->adapter_info.cache_flush_interval;
1844
1845 product_info->dram_size = inquiry->adapter_info.dram_size;
1846
1847 enquiry3->num_ldrv = inquiry->logdrv_info.num_ldrv;
1848
1849 for (i = 0; i < MAX_LOGICAL_DRIVES_8LD; i++) {
1850 enquiry3->ldrv_size[i] = inquiry->logdrv_info.ldrv_size[i];
1851 enquiry3->ldrv_prop[i] = inquiry->logdrv_info.ldrv_prop[i];
1852 enquiry3->ldrv_state[i] = inquiry->logdrv_info.ldrv_state[i];
1853 }
1854
1855 for (i = 0; i < (MAX_PHYSICAL_DRIVES); i++)
1856 enquiry3->pdrv_state[i] = inquiry->pdrv_info.pdrv_state[i];
1857 }
1858
1859 static inline void
1860 mega_free_sgl(adapter_t *adapter)
1861 {
1862 scb_t *scb;
1863 int i;
1864
1865 for(i = 0; i < adapter->max_cmds; i++) {
1866
1867 scb = &adapter->scb_list[i];
1868
1869 if( scb->sgl64 ) {
1870 pci_free_consistent(adapter->dev,
1871 sizeof(mega_sgl64) * adapter->sglen,
1872 scb->sgl64,
1873 scb->sgl_dma_addr);
1874
1875 scb->sgl64 = NULL;
1876 }
1877
1878 if( scb->pthru ) {
1879 pci_free_consistent(adapter->dev, sizeof(mega_passthru),
1880 scb->pthru, scb->pthru_dma_addr);
1881
1882 scb->pthru = NULL;
1883 }
1884
1885 if( scb->epthru ) {
1886 pci_free_consistent(adapter->dev,
1887 sizeof(mega_ext_passthru),
1888 scb->epthru, scb->epthru_dma_addr);
1889
1890 scb->epthru = NULL;
1891 }
1892
1893 }
1894 }
1895
1896
1897 /*
1898 * Get information about the card/driver
1899 */
1900 const char *
1901 megaraid_info(struct Scsi_Host *host)
1902 {
1903 static char buffer[512];
1904 adapter_t *adapter;
1905
1906 adapter = (adapter_t *)host->hostdata;
1907
1908 sprintf (buffer,
1909 "LSI Logic MegaRAID %s %d commands %d targs %d chans %d luns",
1910 adapter->fw_version, adapter->product_info.max_commands,
1911 adapter->host->max_id, adapter->host->max_channel,
1912 adapter->host->max_lun);
1913 return buffer;
1914 }
1915
1916 /*
1917 * Abort a previous SCSI request. Only commands on the pending list can be
1918 * aborted. All the commands issued to the F/W must complete.
1919 */
1920 static int
1921 megaraid_abort(Scsi_Cmnd *cmd)
1922 {
1923 adapter_t *adapter;
1924 int rval;
1925
1926 adapter = (adapter_t *)cmd->device->host->hostdata;
1927
1928 rval = megaraid_abort_and_reset(adapter, cmd, SCB_ABORT);
1929
1930 /*
1931 * This is required here to complete any completed requests
1932 * to be communicated over to the mid layer.
1933 */
1934 mega_rundoneq(adapter);
1935
1936 return rval;
1937 }
1938
1939
1940 static int
1941 megaraid_reset(Scsi_Cmnd *cmd)
1942 {
1943 adapter_t *adapter;
1944 megacmd_t mc;
1945 int rval;
1946
1947 adapter = (adapter_t *)cmd->device->host->hostdata;
1948
1949 #if MEGA_HAVE_CLUSTERING
1950 mc.cmd = MEGA_CLUSTER_CMD;
1951 mc.opcode = MEGA_RESET_RESERVATIONS;
1952
1953 spin_unlock_irq(&adapter->lock);
1954 if( mega_internal_command(adapter, LOCK_INT, &mc, NULL) != 0 ) {
1955 printk(KERN_WARNING
1956 "megaraid: reservation reset failed.\n");
1957 }
1958 else {
1959 printk(KERN_INFO "megaraid: reservation reset.\n");
1960 }
1961 spin_lock_irq(&adapter->lock);
1962 #endif
1963
1964 rval = megaraid_abort_and_reset(adapter, cmd, SCB_RESET);
1965
1966 /*
1967 * This is required here to complete any completed requests
1968 * to be communicated over to the mid layer.
1969 */
1970 mega_rundoneq(adapter);
1971
1972 return rval;
1973 }
1974
1975
1976
1977 /**
1978 * megaraid_abort_and_reset()
1979 * @adapter - megaraid soft state
1980 * @cmd - scsi command to be aborted or reset
1981 * @aor - abort or reset flag
1982 *
1983 * Try to locate the scsi command in the pending queue. If found and is not
1984 * issued to the controller, abort/reset it. Otherwise return failure
1985 */
1986 static int
1987 megaraid_abort_and_reset(adapter_t *adapter, Scsi_Cmnd *cmd, int aor)
1988 {
1989 struct list_head *pos, *next;
1990 scb_t *scb;
1991
1992 printk(KERN_WARNING "megaraid: %s-%lx cmd=%x <c=%d t=%d l=%d>\n",
1993 (aor == SCB_ABORT)? "ABORTING":"RESET", cmd->serial_number,
1994 cmd->cmnd[0], cmd->device->channel,
1995 cmd->device->id, cmd->device->lun);
1996
1997 if(list_empty(&adapter->pending_list))
1998 return FALSE;
1999
2000 list_for_each_safe(pos, next, &adapter->pending_list) {
2001
2002 scb = list_entry(pos, scb_t, list);
2003
2004 if (scb->cmd == cmd) { /* Found command */
2005
2006 scb->state |= aor;
2007
2008 /*
2009 * Check if this command has firmare owenership. If
2010 * yes, we cannot reset this command. Whenever, f/w
2011 * completes this command, we will return appropriate
2012 * status from ISR.
2013 */
2014 if( scb->state & SCB_ISSUED ) {
2015
2016 printk(KERN_WARNING
2017 "megaraid: %s-%lx[%x], fw owner.\n",
2018 (aor==SCB_ABORT) ? "ABORTING":"RESET",
2019 cmd->serial_number, scb->idx);
2020
2021 return FALSE;
2022 }
2023 else {
2024
2025 /*
2026 * Not yet issued! Remove from the pending
2027 * list
2028 */
2029 printk(KERN_WARNING
2030 "megaraid: %s-%lx[%x], driver owner.\n",
2031 (aor==SCB_ABORT) ? "ABORTING":"RESET",
2032 cmd->serial_number, scb->idx);
2033
2034 mega_free_scb(adapter, scb);
2035
2036 if( aor == SCB_ABORT ) {
2037 cmd->result = (DID_ABORT << 16);
2038 }
2039 else {
2040 cmd->result = (DID_RESET << 16);
2041 }
2042
2043 list_add_tail(SCSI_LIST(cmd),
2044 &adapter->completed_list);
2045
2046 return TRUE;
2047 }
2048 }
2049 }
2050
2051 return FALSE;
2052 }
2053
2054 static inline int
2055 make_local_pdev(adapter_t *adapter, struct pci_dev **pdev)
2056 {
2057 *pdev = kmalloc(sizeof(struct pci_dev), GFP_KERNEL);
2058
2059 if( *pdev == NULL ) return -1;
2060
2061 memcpy(*pdev, adapter->dev, sizeof(struct pci_dev));
2062
2063 if( pci_set_dma_mask(*pdev, 0xffffffff) != 0 ) {
2064 kfree(*pdev);
2065 return -1;
2066 }
2067
2068 return 0;
2069 }
2070
2071 static inline void
2072 free_local_pdev(struct pci_dev *pdev)
2073 {
2074 kfree(pdev);
2075 }
2076
2077 /**
2078 * mega_allocate_inquiry()
2079 * @dma_handle - handle returned for dma address
2080 * @pdev - handle to pci device
2081 *
2082 * allocates memory for inquiry structure
2083 */
2084 static inline void *
2085 mega_allocate_inquiry(dma_addr_t *dma_handle, struct pci_dev *pdev)
2086 {
2087 return pci_alloc_consistent(pdev, sizeof(mega_inquiry3), dma_handle);
2088 }
2089
2090
2091 static inline void
2092 mega_free_inquiry(void *inquiry, dma_addr_t dma_handle, struct pci_dev *pdev)
2093 {
2094 pci_free_consistent(pdev, sizeof(mega_inquiry3), inquiry, dma_handle);
2095 }
2096
2097
2098 #ifdef CONFIG_PROC_FS
2099 /* Following code handles /proc fs */
2100
2101 #define CREATE_READ_PROC(string, func) create_proc_read_entry(string, \
2102 S_IRUSR | S_IFREG, \
2103 controller_proc_dir_entry, \
2104 func, adapter)
2105
2106 /**
2107 * mega_create_proc_entry()
2108 * @index - index in soft state array
2109 * @parent - parent node for this /proc entry
2110 *
2111 * Creates /proc entries for our controllers.
2112 */
2113 static void
2114 mega_create_proc_entry(int index, struct proc_dir_entry *parent)
2115 {
2116 struct proc_dir_entry *controller_proc_dir_entry = NULL;
2117 u8 string[64] = { 0 };
2118 adapter_t *adapter = hba_soft_state[index];
2119
2120 sprintf(string, "hba%d", adapter->host->host_no);
2121
2122 controller_proc_dir_entry =
2123 adapter->controller_proc_dir_entry = proc_mkdir(string, parent);
2124
2125 if(!controller_proc_dir_entry) {
2126 printk(KERN_WARNING "\nmegaraid: proc_mkdir failed\n");
2127 return;
2128 }
2129 adapter->proc_read = CREATE_READ_PROC("config", proc_read_config);
2130 adapter->proc_stat = CREATE_READ_PROC("stat", proc_read_stat);
2131 adapter->proc_mbox = CREATE_READ_PROC("mailbox", proc_read_mbox);
2132 #if MEGA_HAVE_ENH_PROC
2133 adapter->proc_rr = CREATE_READ_PROC("rebuild-rate", proc_rebuild_rate);
2134 adapter->proc_battery = CREATE_READ_PROC("battery-status",
2135 proc_battery);
2136
2137 /*
2138 * Display each physical drive on its channel
2139 */
2140 adapter->proc_pdrvstat[0] = CREATE_READ_PROC("diskdrives-ch0",
2141 proc_pdrv_ch0);
2142 adapter->proc_pdrvstat[1] = CREATE_READ_PROC("diskdrives-ch1",
2143 proc_pdrv_ch1);
2144 adapter->proc_pdrvstat[2] = CREATE_READ_PROC("diskdrives-ch2",
2145 proc_pdrv_ch2);
2146 adapter->proc_pdrvstat[3] = CREATE_READ_PROC("diskdrives-ch3",
2147 proc_pdrv_ch3);
2148
2149 /*
2150 * Display a set of up to 10 logical drive through each of following
2151 * /proc entries
2152 */
2153 adapter->proc_rdrvstat[0] = CREATE_READ_PROC("raiddrives-0-9",
2154 proc_rdrv_10);
2155 adapter->proc_rdrvstat[1] = CREATE_READ_PROC("raiddrives-10-19",
2156 proc_rdrv_20);
2157 adapter->proc_rdrvstat[2] = CREATE_READ_PROC("raiddrives-20-29",
2158 proc_rdrv_30);
2159 adapter->proc_rdrvstat[3] = CREATE_READ_PROC("raiddrives-30-39",
2160 proc_rdrv_40);
2161 #endif
2162 }
2163
2164
2165 /**
2166 * proc_read_config()
2167 * @page - buffer to write the data in
2168 * @start - where the actual data has been written in page
2169 * @offset - same meaning as the read system call
2170 * @count - same meaning as the read system call
2171 * @eof - set if no more data needs to be returned
2172 * @data - pointer to our soft state
2173 *
2174 * Display configuration information about the controller.
2175 */
2176 static int
2177 proc_read_config(char *page, char **start, off_t offset, int count, int *eof,
2178 void *data)
2179 {
2180
2181 adapter_t *adapter = (adapter_t *)data;
2182 int len = 0;
2183
2184 len += sprintf(page+len, "%s", MEGARAID_VERSION);
2185
2186 if(adapter->product_info.product_name[0])
2187 len += sprintf(page+len, "%s\n",
2188 adapter->product_info.product_name);
2189
2190 len += sprintf(page+len, "Controller Type: ");
2191
2192 if( adapter->flag & BOARD_MEMMAP ) {
2193 len += sprintf(page+len,
2194 "438/466/467/471/493/518/520/531/532\n");
2195 }
2196 else {
2197 len += sprintf(page+len,
2198 "418/428/434\n");
2199 }
2200
2201 if(adapter->flag & BOARD_40LD) {
2202 len += sprintf(page+len,
2203 "Controller Supports 40 Logical Drives\n");
2204 }
2205
2206 if(adapter->flag & BOARD_64BIT) {
2207 len += sprintf(page+len,
2208 "Controller capable of 64-bit memory addressing\n");
2209 }
2210 if( adapter->has_64bit_addr ) {
2211 len += sprintf(page+len,
2212 "Controller using 64-bit memory addressing\n");
2213 }
2214 else {
2215 len += sprintf(page+len,
2216 "Controller is not using 64-bit memory addressing\n");
2217 }
2218
2219 len += sprintf(page+len, "Base = %08lx, Irq = %d, ", adapter->base,
2220 adapter->host->irq);
2221
2222 len += sprintf(page+len, "Logical Drives = %d, Channels = %d\n",
2223 adapter->numldrv, adapter->product_info.nchannels);
2224
2225 len += sprintf(page+len, "Version =%s:%s, DRAM = %dMb\n",
2226 adapter->fw_version, adapter->bios_version,
2227 adapter->product_info.dram_size);
2228
2229 len += sprintf(page+len,
2230 "Controller Queue Depth = %d, Driver Queue Depth = %d\n",
2231 adapter->product_info.max_commands, adapter->max_cmds);
2232
2233 len += sprintf(page+len, "support_ext_cdb = %d\n",
2234 adapter->support_ext_cdb);
2235 len += sprintf(page+len, "support_random_del = %d\n",
2236 adapter->support_random_del);
2237 len += sprintf(page+len, "boot_ldrv_enabled = %d\n",
2238 adapter->boot_ldrv_enabled);
2239 len += sprintf(page+len, "boot_ldrv = %d\n",
2240 adapter->boot_ldrv);
2241 len += sprintf(page+len, "boot_pdrv_enabled = %d\n",
2242 adapter->boot_pdrv_enabled);
2243 len += sprintf(page+len, "boot_pdrv_ch = %d\n",
2244 adapter->boot_pdrv_ch);
2245 len += sprintf(page+len, "boot_pdrv_tgt = %d\n",
2246 adapter->boot_pdrv_tgt);
2247 len += sprintf(page+len, "quiescent = %d\n",
2248 atomic_read(&adapter->quiescent));
2249 len += sprintf(page+len, "has_cluster = %d\n",
2250 adapter->has_cluster);
2251
2252 len += sprintf(page+len, "\nModule Parameters:\n");
2253 len += sprintf(page+len, "max_cmd_per_lun = %d\n",
2254 max_cmd_per_lun);
2255 len += sprintf(page+len, "max_sectors_per_io = %d\n",
2256 max_sectors_per_io);
2257
2258 *eof = 1;
2259
2260 return len;
2261 }
2262
2263
2264
2265 /**
2266 * proc_read_stat()
2267 * @page - buffer to write the data in
2268 * @start - where the actual data has been written in page
2269 * @offset - same meaning as the read system call
2270 * @count - same meaning as the read system call
2271 * @eof - set if no more data needs to be returned
2272 * @data - pointer to our soft state
2273 *
2274 * Diaplay statistical information about the I/O activity.
2275 */
2276 static int
2277 proc_read_stat(char *page, char **start, off_t offset, int count, int *eof,
2278 void *data)
2279 {
2280 adapter_t *adapter;
2281 int len;
2282 int i;
2283
2284 i = 0; /* avoid compilation warnings */
2285 len = 0;
2286 adapter = (adapter_t *)data;
2287
2288 len = sprintf(page, "Statistical Information for this controller\n");
2289 len += sprintf(page+len, "pend_cmds = %d\n",
2290 atomic_read(&adapter->pend_cmds));
2291 #if MEGA_HAVE_STATS
2292 for(i = 0; i < adapter->numldrv; i++) {
2293 len += sprintf(page+len, "Logical Drive %d:\n", i);
2294
2295 len += sprintf(page+len,
2296 "\tReads Issued = %lu, Writes Issued = %lu\n",
2297 adapter->nreads[i], adapter->nwrites[i]);
2298
2299 len += sprintf(page+len,
2300 "\tSectors Read = %lu, Sectors Written = %lu\n",
2301 adapter->nreadblocks[i], adapter->nwriteblocks[i]);
2302
2303 len += sprintf(page+len,
2304 "\tRead errors = %lu, Write errors = %lu\n\n",
2305 adapter->rd_errors[i], adapter->wr_errors[i]);
2306 }
2307 #else
2308 len += sprintf(page+len,
2309 "IO and error counters not compiled in driver.\n");
2310 #endif
2311
2312 *eof = 1;
2313
2314 return len;
2315 }
2316
2317
2318 /**
2319 * proc_read_mbox()
2320 * @page - buffer to write the data in
2321 * @start - where the actual data has been written in page
2322 * @offset - same meaning as the read system call
2323 * @count - same meaning as the read system call
2324 * @eof - set if no more data needs to be returned
2325 * @data - pointer to our soft state
2326 *
2327 * Display mailbox information for the last command issued. This information
2328 * is good for debugging.
2329 */
2330 static int
2331 proc_read_mbox(char *page, char **start, off_t offset, int count, int *eof,
2332 void *data)
2333 {
2334
2335 adapter_t *adapter = (adapter_t *)data;
2336 volatile mbox_t *mbox = adapter->mbox;
2337 int len = 0;
2338
2339 len = sprintf(page, "Contents of Mail Box Structure\n");
2340 len += sprintf(page+len, " Fw Command = 0x%02x\n",
2341 mbox->m_out.cmd);
2342 len += sprintf(page+len, " Cmd Sequence = 0x%02x\n",
2343 mbox->m_out.cmdid);
2344 len += sprintf(page+len, " No of Sectors= %04d\n",
2345 mbox->m_out.numsectors);
2346 len += sprintf(page+len, " LBA = 0x%02x\n",
2347 mbox->m_out.lba);
2348 len += sprintf(page+len, " DTA = 0x%08x\n",
2349 mbox->m_out.xferaddr);
2350 len += sprintf(page+len, " Logical Drive= 0x%02x\n",
2351 mbox->m_out.logdrv);
2352 len += sprintf(page+len, " No of SG Elmt= 0x%02x\n",
2353 mbox->m_out.numsgelements);
2354 len += sprintf(page+len, " Busy = %01x\n",
2355 mbox->m_in.busy);
2356 len += sprintf(page+len, " Status = 0x%02x\n",
2357 mbox->m_in.status);
2358
2359 *eof = 1;
2360
2361 return len;
2362 }
2363
2364
2365 /**
2366 * proc_rebuild_rate()
2367 * @page - buffer to write the data in
2368 * @start - where the actual data has been written in page
2369 * @offset - same meaning as the read system call
2370 * @count - same meaning as the read system call
2371 * @eof - set if no more data needs to be returned
2372 * @data - pointer to our soft state
2373 *
2374 * Display current rebuild rate
2375 */
2376 static int
2377 proc_rebuild_rate(char *page, char **start, off_t offset, int count, int *eof,
2378 void *data)
2379 {
2380 adapter_t *adapter = (adapter_t *)data;
2381 dma_addr_t dma_handle;
2382 caddr_t inquiry;
2383 struct pci_dev *pdev;
2384 int len = 0;
2385
2386 if( make_local_pdev(adapter, &pdev) != 0 ) {
2387 *eof = 1;
2388 return len;
2389 }
2390
2391 if( (inquiry = mega_allocate_inquiry(&dma_handle, pdev)) == NULL ) {
2392 free_local_pdev(pdev);
2393 *eof = 1;
2394 return len;
2395 }
2396
2397 if( mega_adapinq(adapter, dma_handle) != 0 ) {
2398
2399 len = sprintf(page, "Adapter inquiry failed.\n");
2400
2401 printk(KERN_WARNING "megaraid: inquiry failed.\n");
2402
2403 mega_free_inquiry(inquiry, dma_handle, pdev);
2404
2405 free_local_pdev(pdev);
2406
2407 *eof = 1;
2408
2409 return len;
2410 }
2411
2412 if( adapter->flag & BOARD_40LD ) {
2413 len = sprintf(page, "Rebuild Rate: [%d%%]\n",
2414 ((mega_inquiry3 *)inquiry)->rebuild_rate);
2415 }
2416 else {
2417 len = sprintf(page, "Rebuild Rate: [%d%%]\n",
2418 ((mraid_ext_inquiry *)
2419 inquiry)->raid_inq.adapter_info.rebuild_rate);
2420 }
2421
2422
2423 mega_free_inquiry(inquiry, dma_handle, pdev);
2424
2425 free_local_pdev(pdev);
2426
2427 *eof = 1;
2428
2429 return len;
2430 }
2431
2432
2433 /**
2434 * proc_battery()
2435 * @page - buffer to write the data in
2436 * @start - where the actual data has been written in page
2437 * @offset - same meaning as the read system call
2438 * @count - same meaning as the read system call
2439 * @eof - set if no more data needs to be returned
2440 * @data - pointer to our soft state
2441 *
2442 * Display information about the battery module on the controller.
2443 */
2444 static int
2445 proc_battery(char *page, char **start, off_t offset, int count, int *eof,
2446 void *data)
2447 {
2448 adapter_t *adapter = (adapter_t *)data;
2449 dma_addr_t dma_handle;
2450 caddr_t inquiry;
2451 struct pci_dev *pdev;
2452 u8 battery_status = 0;
2453 char str[256];
2454 int len = 0;
2455
2456 if( make_local_pdev(adapter, &pdev) != 0 ) {
2457 *eof = 1;
2458 return len;
2459 }
2460
2461 if( (inquiry = mega_allocate_inquiry(&dma_handle, pdev)) == NULL ) {
2462 free_local_pdev(pdev);
2463 *eof = 1;
2464 return len;
2465 }
2466
2467 if( mega_adapinq(adapter, dma_handle) != 0 ) {
2468
2469 len = sprintf(page, "Adapter inquiry failed.\n");
2470
2471 printk(KERN_WARNING "megaraid: inquiry failed.\n");
2472
2473 mega_free_inquiry(inquiry, dma_handle, pdev);
2474
2475 free_local_pdev(pdev);
2476
2477 *eof = 1;
2478
2479 return len;
2480 }
2481
2482 if( adapter->flag & BOARD_40LD ) {
2483 battery_status = ((mega_inquiry3 *)inquiry)->battery_status;
2484 }
2485 else {
2486 battery_status = ((mraid_ext_inquiry *)inquiry)->
2487 raid_inq.adapter_info.battery_status;
2488 }
2489
2490 /*
2491 * Decode the battery status
2492 */
2493 sprintf(str, "Battery Status:[%d]", battery_status);
2494
2495 if(battery_status == MEGA_BATT_CHARGE_DONE)
2496 strcat(str, " Charge Done");
2497
2498 if(battery_status & MEGA_BATT_MODULE_MISSING)
2499 strcat(str, " Module Missing");
2500
2501 if(battery_status & MEGA_BATT_LOW_VOLTAGE)
2502 strcat(str, " Low Voltage");
2503
2504 if(battery_status & MEGA_BATT_TEMP_HIGH)
2505 strcat(str, " Temperature High");
2506
2507 if(battery_status & MEGA_BATT_PACK_MISSING)
2508 strcat(str, " Pack Missing");
2509
2510 if(battery_status & MEGA_BATT_CHARGE_INPROG)
2511 strcat(str, " Charge In-progress");
2512
2513 if(battery_status & MEGA_BATT_CHARGE_FAIL)
2514 strcat(str, " Charge Fail");
2515
2516 if(battery_status & MEGA_BATT_CYCLES_EXCEEDED)
2517 strcat(str, " Cycles Exceeded");
2518
2519 len = sprintf(page, "%s\n", str);
2520
2521
2522 mega_free_inquiry(inquiry, dma_handle, pdev);
2523
2524 free_local_pdev(pdev);
2525
2526 *eof = 1;
2527
2528 return len;
2529 }
2530
2531
2532 /**
2533 * proc_pdrv_ch0()
2534 * @page - buffer to write the data in
2535 * @start - where the actual data has been written in page
2536 * @offset - same meaning as the read system call
2537 * @count - same meaning as the read system call
2538 * @eof - set if no more data needs to be returned
2539 * @data - pointer to our soft state
2540 *
2541 * Display information about the physical drives on physical channel 0.
2542 */
2543 static int
2544 proc_pdrv_ch0(char *page, char **start, off_t offset, int count, int *eof,
2545 void *data)
2546 {
2547 adapter_t *adapter = (adapter_t *)data;
2548
2549 *eof = 1;
2550
2551 return (proc_pdrv(adapter, page, 0));
2552 }
2553
2554
2555 /**
2556 * proc_pdrv_ch1()
2557 * @page - buffer to write the data in
2558 * @start - where the actual data has been written in page
2559 * @offset - same meaning as the read system call
2560 * @count - same meaning as the read system call
2561 * @eof - set if no more data needs to be returned
2562 * @data - pointer to our soft state
2563 *
2564 * Display information about the physical drives on physical channel 1.
2565 */
2566 static int
2567 proc_pdrv_ch1(char *page, char **start, off_t offset, int count, int *eof,
2568 void *data)
2569 {
2570 adapter_t *adapter = (adapter_t *)data;
2571
2572 *eof = 1;
2573
2574 return (proc_pdrv(adapter, page, 1));
2575 }
2576
2577
2578 /**
2579 * proc_pdrv_ch2()
2580 * @page - buffer to write the data in
2581 * @start - where the actual data has been written in page
2582 * @offset - same meaning as the read system call
2583 * @count - same meaning as the read system call
2584 * @eof - set if no more data needs to be returned
2585 * @data - pointer to our soft state
2586 *
2587 * Display information about the physical drives on physical channel 2.
2588 */
2589 static int
2590 proc_pdrv_ch2(char *page, char **start, off_t offset, int count, int *eof,
2591 void *data)
2592 {
2593 adapter_t *adapter = (adapter_t *)data;
2594
2595 *eof = 1;
2596
2597 return (proc_pdrv(adapter, page, 2));
2598 }
2599
2600
2601 /**
2602 * proc_pdrv_ch3()
2603 * @page - buffer to write the data in
2604 * @start - where the actual data has been written in page
2605 * @offset - same meaning as the read system call
2606 * @count - same meaning as the read system call
2607 * @eof - set if no more data needs to be returned
2608 * @data - pointer to our soft state
2609 *
2610 * Display information about the physical drives on physical channel 3.
2611 */
2612 static int
2613 proc_pdrv_ch3(char *page, char **start, off_t offset, int count, int *eof,
2614 void *data)
2615 {
2616 adapter_t *adapter = (adapter_t *)data;
2617
2618 *eof = 1;
2619
2620 return (proc_pdrv(adapter, page, 3));
2621 }
2622
2623
2624 /**
2625 * proc_pdrv()
2626 * @page - buffer to write the data in
2627 * @adapter - pointer to our soft state
2628 *
2629 * Display information about the physical drives.
2630 */
2631 static int
2632 proc_pdrv(adapter_t *adapter, char *page, int channel)
2633 {
2634 dma_addr_t dma_handle;
2635 char *scsi_inq;
2636 dma_addr_t scsi_inq_dma_handle;
2637 caddr_t inquiry;
2638 struct pci_dev *pdev;
2639 u8 *pdrv_state;
2640 u8 state;
2641 int tgt;
2642 int max_channels;
2643 int len = 0;
2644 char str[80];
2645 int i;
2646
2647 if( make_local_pdev(adapter, &pdev) != 0 ) {
2648 return len;
2649 }
2650
2651 if( (inquiry = mega_allocate_inquiry(&dma_handle, pdev)) == NULL ) {
2652 goto free_pdev;
2653 }
2654
2655 if( mega_adapinq(adapter, dma_handle) != 0 ) {
2656 len = sprintf(page, "Adapter inquiry failed.\n");
2657
2658 printk(KERN_WARNING "megaraid: inquiry failed.\n");
2659
2660 goto free_inquiry;
2661 }
2662
2663
2664 scsi_inq = pci_alloc_consistent(pdev, 256, &scsi_inq_dma_handle);
2665
2666 if( scsi_inq == NULL ) {
2667 len = sprintf(page, "memory not available for scsi inq.\n");
2668
2669 goto free_inquiry;
2670 }
2671
2672 if( adapter->flag & BOARD_40LD ) {
2673 pdrv_state = ((mega_inquiry3 *)inquiry)->pdrv_state;
2674 }
2675 else {
2676 pdrv_state = ((mraid_ext_inquiry *)inquiry)->
2677 raid_inq.pdrv_info.pdrv_state;
2678 }
2679
2680 max_channels = adapter->product_info.nchannels;
2681
2682 if( channel >= max_channels ) {
2683 goto free_pci;
2684 }
2685
2686 for( tgt = 0; tgt <= MAX_TARGET; tgt++ ) {
2687
2688 i = channel*16 + tgt;
2689
2690 state = *(pdrv_state + i);
2691
2692 switch( state & 0x0F ) {
2693
2694 case PDRV_ONLINE:
2695 sprintf(str,
2696 "Channel:%2d Id:%2d State: Online",
2697 channel, tgt);
2698 break;
2699
2700 case PDRV_FAILED:
2701 sprintf(str,
2702 "Channel:%2d Id:%2d State: Failed",
2703 channel, tgt);
2704 break;
2705
2706 case PDRV_RBLD:
2707 sprintf(str,
2708 "Channel:%2d Id:%2d State: Rebuild",
2709 channel, tgt);
2710 break;
2711
2712 case PDRV_HOTSPARE:
2713 sprintf(str,
2714 "Channel:%2d Id:%2d State: Hot spare",
2715 channel, tgt);
2716 break;
2717
2718 default:
2719 sprintf(str,
2720 "Channel:%2d Id:%2d State: Un-configured",
2721 channel, tgt);
2722 break;
2723
2724 }
2725
2726 /*
2727 * This interface displays inquiries for disk drives
2728 * only. Inquries for logical drives and non-disk
2729 * devices are available through /proc/scsi/scsi
2730 */
2731 memset(scsi_inq, 0, 256);
2732 if( mega_internal_dev_inquiry(adapter, channel, tgt,
2733 scsi_inq_dma_handle) ||
2734 (scsi_inq[0] & 0x1F) != TYPE_DISK ) {
2735 continue;
2736 }
2737
2738 /*
2739 * Check for overflow. We print less than 240
2740 * characters for inquiry
2741 */
2742 if( (len + 240) >= PAGE_SIZE ) break;
2743
2744 len += sprintf(page+len, "%s.\n", str);
2745
2746 len += mega_print_inquiry(page+len, scsi_inq);
2747 }
2748
2749 free_pci:
2750 pci_free_consistent(pdev, 256, scsi_inq, scsi_inq_dma_handle);
2751 free_inquiry:
2752 mega_free_inquiry(inquiry, dma_handle, pdev);
2753 free_pdev:
2754 free_local_pdev(pdev);
2755
2756 return len;
2757 }
2758
2759
2760 /*
2761 * Display scsi inquiry
2762 */
2763 static int
2764 mega_print_inquiry(char *page, char *scsi_inq)
2765 {
2766 int len = 0;
2767 int i;
2768
2769 len = sprintf(page, " Vendor: ");
2770 for( i = 8; i < 16; i++ ) {
2771 len += sprintf(page+len, "%c", scsi_inq[i]);
2772 }
2773
2774 len += sprintf(page+len, " Model: ");
2775
2776 for( i = 16; i < 32; i++ ) {
2777 len += sprintf(page+len, "%c", scsi_inq[i]);
2778 }
2779
2780 len += sprintf(page+len, " Rev: ");
2781
2782 for( i = 32; i < 36; i++ ) {
2783 len += sprintf(page+len, "%c", scsi_inq[i]);
2784 }
2785
2786 len += sprintf(page+len, "\n");
2787
2788 i = scsi_inq[0] & 0x1f;
2789
2790 len += sprintf(page+len, " Type: %s ",
2791 i < MAX_SCSI_DEVICE_CODE ? scsi_device_types[i] :
2792 "Unknown ");
2793
2794 len += sprintf(page+len,
2795 " ANSI SCSI revision: %02x", scsi_inq[2] & 0x07);
2796
2797 if( (scsi_inq[2] & 0x07) == 1 && (scsi_inq[3] & 0x0f) == 1 )
2798 len += sprintf(page+len, " CCS\n");
2799 else
2800 len += sprintf(page+len, "\n");
2801
2802 return len;
2803 }
2804
2805
2806 /**
2807 * proc_rdrv_10()
2808 * @page - buffer to write the data in
2809 * @start - where the actual data has been written in page
2810 * @offset - same meaning as the read system call
2811 * @count - same meaning as the read system call
2812 * @eof - set if no more data needs to be returned
2813 * @data - pointer to our soft state
2814 *
2815 * Display real time information about the logical drives 0 through 9.
2816 */
2817 static int
2818 proc_rdrv_10(char *page, char **start, off_t offset, int count, int *eof,
2819 void *data)
2820 {
2821 adapter_t *adapter = (adapter_t *)data;
2822
2823 *eof = 1;
2824
2825 return (proc_rdrv(adapter, page, 0, 9));
2826 }
2827
2828
2829 /**
2830 * proc_rdrv_20()
2831 * @page - buffer to write the data in
2832 * @start - where the actual data has been written in page
2833 * @offset - same meaning as the read system call
2834 * @count - same meaning as the read system call
2835 * @eof - set if no more data needs to be returned
2836 * @data - pointer to our soft state
2837 *
2838 * Display real time information about the logical drives 0 through 9.
2839 */
2840 static int
2841 proc_rdrv_20(char *page, char **start, off_t offset, int count, int *eof,
2842 void *data)
2843 {
2844 adapter_t *adapter = (adapter_t *)data;
2845
2846 *eof = 1;
2847
2848 return (proc_rdrv(adapter, page, 10, 19));
2849 }
2850
2851
2852 /**
2853 * proc_rdrv_30()
2854 * @page - buffer to write the data in
2855 * @start - where the actual data has been written in page
2856 * @offset - same meaning as the read system call
2857 * @count - same meaning as the read system call
2858 * @eof - set if no more data needs to be returned
2859 * @data - pointer to our soft state
2860 *
2861 * Display real time information about the logical drives 0 through 9.
2862 */
2863 static int
2864 proc_rdrv_30(char *page, char **start, off_t offset, int count, int *eof,
2865 void *data)
2866 {
2867 adapter_t *adapter = (adapter_t *)data;
2868
2869 *eof = 1;
2870
2871 return (proc_rdrv(adapter, page, 20, 29));
2872 }
2873
2874
2875 /**
2876 * proc_rdrv_40()
2877 * @page - buffer to write the data in
2878 * @start - where the actual data has been written in page
2879 * @offset - same meaning as the read system call
2880 * @count - same meaning as the read system call
2881 * @eof - set if no more data needs to be returned
2882 * @data - pointer to our soft state
2883 *
2884 * Display real time information about the logical drives 0 through 9.
2885 */
2886 static int
2887 proc_rdrv_40(char *page, char **start, off_t offset, int count, int *eof,
2888 void *data)
2889 {
2890 adapter_t *adapter = (adapter_t *)data;
2891
2892 *eof = 1;
2893
2894 return (proc_rdrv(adapter, page, 30, 39));
2895 }
2896
2897
2898 /**
2899 * proc_rdrv()
2900 * @page - buffer to write the data in
2901 * @adapter - pointer to our soft state
2902 * @start - starting logical drive to display
2903 * @end - ending logical drive to display
2904 *
2905 * We do not print the inquiry information since its already available through
2906 * /proc/scsi/scsi interface
2907 */
2908 static int
2909 proc_rdrv(adapter_t *adapter, char *page, int start, int end )
2910 {
2911 dma_addr_t dma_handle;
2912 logdrv_param *lparam;
2913 megacmd_t mc;
2914 char *disk_array;
2915 dma_addr_t disk_array_dma_handle;
2916 caddr_t inquiry;
2917 struct pci_dev *pdev;
2918 u8 *rdrv_state;
2919 int num_ldrv;
2920 u32 array_sz;
2921 int len = 0;
2922 int i;
2923
2924 if( make_local_pdev(adapter, &pdev) != 0 ) {
2925 return len;
2926 }
2927
2928 if( (inquiry = mega_allocate_inquiry(&dma_handle, pdev)) == NULL ) {
2929 free_local_pdev(pdev);
2930 return len;
2931 }
2932
2933 if( mega_adapinq(adapter, dma_handle) != 0 ) {
2934
2935 len = sprintf(page, "Adapter inquiry failed.\n");
2936
2937 printk(KERN_WARNING "megaraid: inquiry failed.\n");
2938
2939 mega_free_inquiry(inquiry, dma_handle, pdev);
2940
2941 free_local_pdev(pdev);
2942
2943 return len;
2944 }
2945
2946 memset(&mc, 0, sizeof(megacmd_t));
2947
2948 if( adapter->flag & BOARD_40LD ) {
2949 array_sz = sizeof(disk_array_40ld);
2950
2951 rdrv_state = ((mega_inquiry3 *)inquiry)->ldrv_state;
2952
2953 num_ldrv = ((mega_inquiry3 *)inquiry)->num_ldrv;
2954 }
2955 else {
2956 array_sz = sizeof(disk_array_8ld);
2957
2958 rdrv_state = ((mraid_ext_inquiry *)inquiry)->
2959 raid_inq.logdrv_info.ldrv_state;
2960
2961 num_ldrv = ((mraid_ext_inquiry *)inquiry)->
2962 raid_inq.logdrv_info.num_ldrv;
2963 }
2964
2965 disk_array = pci_alloc_consistent(pdev, array_sz,
2966 &disk_array_dma_handle);
2967
2968 if( disk_array == NULL ) {
2969 len = sprintf(page, "memory not available.\n");
2970
2971 mega_free_inquiry(inquiry, dma_handle, pdev);
2972
2973 free_local_pdev(pdev);
2974
2975 return len;
2976 }
2977
2978 mc.xferaddr = (u32)disk_array_dma_handle;
2979
2980 if( adapter->flag & BOARD_40LD ) {
2981 mc.cmd = FC_NEW_CONFIG;
2982 mc.opcode = OP_DCMD_READ_CONFIG;
2983
2984 if( mega_internal_command(adapter, LOCK_INT, &mc, NULL) ) {
2985
2986 len = sprintf(page, "40LD read config failed.\n");
2987
2988 mega_free_inquiry(inquiry, dma_handle, pdev);
2989
2990 pci_free_consistent(pdev, array_sz, disk_array,
2991 disk_array_dma_handle);
2992
2993 free_local_pdev(pdev);
2994
2995 return len;
2996 }
2997
2998 }
2999 else {
3000 mc.cmd = NEW_READ_CONFIG_8LD;
3001
3002 if( mega_internal_command(adapter, LOCK_INT, &mc, NULL) ) {
3003
3004 mc.cmd = READ_CONFIG_8LD;
3005
3006 if( mega_internal_command(adapter, LOCK_INT, &mc,
3007 NULL) ){
3008
3009 len = sprintf(page,
3010 "8LD read config failed.\n");
3011
3012 mega_free_inquiry(inquiry, dma_handle, pdev);
3013
3014 pci_free_consistent(pdev, array_sz,
3015 disk_array,
3016 disk_array_dma_handle);
3017
3018 free_local_pdev(pdev);
3019
3020 return len;
3021 }
3022 }
3023 }
3024
3025 for( i = start; i < ( (end+1 < num_ldrv) ? end+1 : num_ldrv ); i++ ) {
3026
3027 if( adapter->flag & BOARD_40LD ) {
3028 lparam =
3029 &((disk_array_40ld *)disk_array)->ldrv[i].lparam;
3030 }
3031 else {
3032 lparam =
3033 &((disk_array_8ld *)disk_array)->ldrv[i].lparam;
3034 }
3035
3036 /*
3037 * Check for overflow. We print less than 240 characters for
3038 * information about each logical drive.
3039 */
3040 if( (len + 240) >= PAGE_SIZE ) break;
3041
3042 len += sprintf(page+len, "Logical drive:%2d:, ", i);
3043
3044 switch( rdrv_state[i] & 0x0F ) {
3045 case RDRV_OFFLINE:
3046 len += sprintf(page+len, "state: offline");
3047 break;
3048
3049 case RDRV_DEGRADED:
3050 len += sprintf(page+len, "state: degraded");
3051 break;
3052
3053 case RDRV_OPTIMAL:
3054 len += sprintf(page+len, "state: optimal");
3055 break;
3056
3057 case RDRV_DELETED:
3058 len += sprintf(page+len, "state: deleted");
3059 break;
3060
3061 default:
3062 len += sprintf(page+len, "state: unknown");
3063 break;
3064 }
3065
3066 /*
3067 * Check if check consistency or initialization is going on
3068 * for this logical drive.
3069 */
3070 if( (rdrv_state[i] & 0xF0) == 0x20 ) {
3071 len += sprintf(page+len,
3072 ", check-consistency in progress");
3073 }
3074 else if( (rdrv_state[i] & 0xF0) == 0x10 ) {
3075 len += sprintf(page+len,
3076 ", initialization in progress");
3077 }
3078
3079 len += sprintf(page+len, "\n");
3080
3081 len += sprintf(page+len, "Span depth:%3d, ",
3082 lparam->span_depth);
3083
3084 len += sprintf(page+len, "RAID level:%3d, ",
3085 lparam->level);
3086
3087 len += sprintf(page+len, "Stripe size:%3d, ",
3088 lparam->stripe_sz ? lparam->stripe_sz/2: 128);
3089
3090 len += sprintf(page+len, "Row size:%3d\n",
3091 lparam->row_size);
3092
3093
3094 len += sprintf(page+len, "Read Policy: ");
3095
3096 switch(lparam->read_ahead) {
3097
3098 case NO_READ_AHEAD:
3099 len += sprintf(page+len, "No read ahead, ");
3100 break;
3101
3102 case READ_AHEAD:
3103 len += sprintf(page+len, "Read ahead, ");
3104 break;
3105
3106 case ADAP_READ_AHEAD:
3107 len += sprintf(page+len, "Adaptive, ");
3108 break;
3109
3110 }
3111
3112 len += sprintf(page+len, "Write Policy: ");
3113
3114 switch(lparam->write_mode) {
3115
3116 case WRMODE_WRITE_THRU:
3117 len += sprintf(page+len, "Write thru, ");
3118 break;
3119
3120 case WRMODE_WRITE_BACK:
3121 len += sprintf(page+len, "Write back, ");
3122 break;
3123 }
3124
3125 len += sprintf(page+len, "Cache Policy: ");
3126
3127 switch(lparam->direct_io) {
3128
3129 case CACHED_IO:
3130 len += sprintf(page+len, "Cached IO\n\n");
3131 break;
3132
3133 case DIRECT_IO:
3134 len += sprintf(page+len, "Direct IO\n\n");
3135 break;
3136 }
3137 }
3138
3139 mega_free_inquiry(inquiry, dma_handle, pdev);
3140
3141 pci_free_consistent(pdev, array_sz, disk_array,
3142 disk_array_dma_handle);
3143
3144 free_local_pdev(pdev);
3145
3146 return len;
3147 }
3148
3149 #endif
3150
3151
3152 /**
3153 * megaraid_biosparam()
3154 *
3155 * Return the disk geometry for a particular disk
3156 */
3157 static int
3158 megaraid_biosparam(struct scsi_device *sdev, struct block_device *bdev,
3159 sector_t capacity, int geom[])
3160 {
3161 adapter_t *adapter;
3162 unsigned char *bh;
3163 int heads;
3164 int sectors;
3165 int cylinders;
3166 int rval;
3167
3168 /* Get pointer to host config structure */
3169 adapter = (adapter_t *)sdev->host->hostdata;
3170
3171 if (IS_RAID_CH(adapter, sdev->channel)) {
3172 /* Default heads (64) & sectors (32) */
3173 heads = 64;
3174 sectors = 32;
3175 cylinders = (ulong)capacity / (heads * sectors);
3176
3177 /*
3178 * Handle extended translation size for logical drives
3179 * > 1Gb
3180 */
3181 if ((ulong)capacity >= 0x200000) {
3182 heads = 255;
3183 sectors = 63;
3184 cylinders = (ulong)capacity / (heads * sectors);
3185 }
3186
3187 /* return result */
3188 geom[0] = heads;
3189 geom[1] = sectors;
3190 geom[2] = cylinders;
3191 }
3192 else {
3193 bh = scsi_bios_ptable(bdev);
3194
3195 if( bh ) {
3196 rval = scsi_partsize(bh, capacity,
3197 &geom[2], &geom[0], &geom[1]);
3198 kfree(bh);
3199 if( rval != -1 )
3200 return rval;
3201 }
3202
3203 printk(KERN_INFO
3204 "megaraid: invalid partition on this disk on channel %d\n",
3205 sdev->channel);
3206
3207 /* Default heads (64) & sectors (32) */
3208 heads = 64;
3209 sectors = 32;
3210 cylinders = (ulong)capacity / (heads * sectors);
3211
3212 /* Handle extended translation size for logical drives > 1Gb */
3213 if ((ulong)capacity >= 0x200000) {
3214 heads = 255;
3215 sectors = 63;
3216 cylinders = (ulong)capacity / (heads * sectors);
3217 }
3218
3219 /* return result */
3220 geom[0] = heads;
3221 geom[1] = sectors;
3222 geom[2] = cylinders;
3223 }
3224
3225 return 0;
3226 }
3227
3228 /**
3229 * mega_init_scb()
3230 * @adapter - pointer to our soft state
3231 *
3232 * Allocate memory for the various pointers in the scb structures:
3233 * scatter-gather list pointer, passthru and extended passthru structure
3234 * pointers.
3235 */
3236 static int
3237 mega_init_scb(adapter_t *adapter)
3238 {
3239 scb_t *scb;
3240 int i;
3241
3242 for( i = 0; i < adapter->max_cmds; i++ ) {
3243
3244 scb = &adapter->scb_list[i];
3245
3246 scb->sgl64 = NULL;
3247 scb->sgl = NULL;
3248 scb->pthru = NULL;
3249 scb->epthru = NULL;
3250 }
3251
3252 for( i = 0; i < adapter->max_cmds; i++ ) {
3253
3254 scb = &adapter->scb_list[i];
3255
3256 scb->idx = i;
3257
3258 scb->sgl64 = pci_alloc_consistent(adapter->dev,
3259 sizeof(mega_sgl64) * adapter->sglen,
3260 &scb->sgl_dma_addr);
3261
3262 scb->sgl = (mega_sglist *)scb->sgl64;
3263
3264 if( !scb->sgl ) {
3265 printk(KERN_WARNING "RAID: Can't allocate sglist.\n");
3266 mega_free_sgl(adapter);
3267 return -1;
3268 }
3269
3270 scb->pthru = pci_alloc_consistent(adapter->dev,
3271 sizeof(mega_passthru),
3272 &scb->pthru_dma_addr);
3273
3274 if( !scb->pthru ) {
3275 printk(KERN_WARNING "RAID: Can't allocate passthru.\n");
3276 mega_free_sgl(adapter);
3277 return -1;
3278 }
3279
3280 scb->epthru = pci_alloc_consistent(adapter->dev,
3281 sizeof(mega_ext_passthru),
3282 &scb->epthru_dma_addr);
3283
3284 if( !scb->epthru ) {
3285 printk(KERN_WARNING
3286 "Can't allocate extended passthru.\n");
3287 mega_free_sgl(adapter);
3288 return -1;
3289 }
3290
3291
3292 scb->dma_type = MEGA_DMA_TYPE_NONE;
3293
3294 /*
3295 * Link to free list
3296 * lock not required since we are loading the driver, so no
3297 * commands possible right now.
3298 */
3299 scb->state = SCB_FREE;
3300 scb->cmd = NULL;
3301 list_add(&scb->list, &adapter->free_list);
3302 }
3303
3304 return 0;
3305 }
3306
3307
3308 /**
3309 * megadev_open()
3310 * @inode - unused
3311 * @filep - unused
3312 *
3313 * Routines for the character/ioctl interface to the driver. Find out if this
3314 * is a valid open. If yes, increment the module use count so that it cannot
3315 * be unloaded.
3316 */
3317 static int
3318 megadev_open (struct inode *inode, struct file *filep)
3319 {
3320 /*
3321 * Only allow superuser to access private ioctl interface
3322 */
3323 if( !capable(CAP_SYS_ADMIN) ) return -EACCES;
3324
3325 return 0;
3326 }
3327
3328
3329 /**
3330 * megadev_ioctl()
3331 * @inode - Our device inode
3332 * @filep - unused
3333 * @cmd - ioctl command
3334 * @arg - user buffer
3335 *
3336 * ioctl entry point for our private ioctl interface. We move the data in from
3337 * the user space, prepare the command (if necessary, convert the old MIMD
3338 * ioctl to new ioctl command), and issue a synchronous command to the
3339 * controller.
3340 */
3341 static int
3342 megadev_ioctl(struct inode *inode, struct file *filep, unsigned int cmd,
3343 unsigned long arg)
3344 {
3345 adapter_t *adapter;
3346 nitioctl_t uioc;
3347 int adapno;
3348 int rval;
3349 mega_passthru __user *upthru; /* user address for passthru */
3350 mega_passthru *pthru; /* copy user passthru here */
3351 dma_addr_t pthru_dma_hndl;
3352 void *data = NULL; /* data to be transferred */
3353 dma_addr_t data_dma_hndl; /* dma handle for data xfer area */
3354 megacmd_t mc;
3355 megastat_t __user *ustats;
3356 int num_ldrv;
3357 u32 uxferaddr = 0;
3358 struct pci_dev *pdev;
3359
3360 ustats = NULL; /* avoid compilation warnings */
3361 num_ldrv = 0;
3362
3363 /*
3364 * Make sure only USCSICMD are issued through this interface.
3365 * MIMD application would still fire different command.
3366 */
3367 if( (_IOC_TYPE(cmd) != MEGAIOC_MAGIC) && (cmd != USCSICMD) ) {
3368 return -EINVAL;
3369 }
3370
3371 /*
3372 * Check and convert a possible MIMD command to NIT command.
3373 * mega_m_to_n() copies the data from the user space, so we do not
3374 * have to do it here.
3375 * NOTE: We will need some user address to copyout the data, therefore
3376 * the inteface layer will also provide us with the required user
3377 * addresses.
3378 */
3379 memset(&uioc, 0, sizeof(nitioctl_t));
3380 if( (rval = mega_m_to_n( (void __user *)arg, &uioc)) != 0 )
3381 return rval;
3382
3383
3384 switch( uioc.opcode ) {
3385
3386 case GET_DRIVER_VER:
3387 if( put_user(driver_ver, (u32 __user *)uioc.uioc_uaddr) )
3388 return (-EFAULT);
3389
3390 break;
3391
3392 case GET_N_ADAP:
3393 if( put_user(hba_count, (u32 __user *)uioc.uioc_uaddr) )
3394 return (-EFAULT);
3395
3396 /*
3397 * Shucks. MIMD interface returns a positive value for number
3398 * of adapters. TODO: Change it to return 0 when there is no
3399 * applicatio using mimd interface.
3400 */
3401 return hba_count;
3402
3403 case GET_ADAP_INFO:
3404
3405 /*
3406 * Which adapter
3407 */
3408 if( (adapno = GETADAP(uioc.adapno)) >= hba_count )
3409 return (-ENODEV);
3410
3411 if( copy_to_user(uioc.uioc_uaddr, mcontroller+adapno,
3412 sizeof(struct mcontroller)) )
3413 return (-EFAULT);
3414 break;
3415
3416 #if MEGA_HAVE_STATS
3417
3418 case GET_STATS:
3419 /*
3420 * Which adapter
3421 */
3422 if( (adapno = GETADAP(uioc.adapno)) >= hba_count )
3423 return (-ENODEV);
3424
3425 adapter = hba_soft_state[adapno];
3426
3427 ustats = uioc.uioc_uaddr;
3428
3429 if( copy_from_user(&num_ldrv, &ustats->num_ldrv, sizeof(int)) )
3430 return (-EFAULT);
3431
3432 /*
3433 * Check for the validity of the logical drive number
3434 */
3435 if( num_ldrv >= MAX_LOGICAL_DRIVES_40LD ) return -EINVAL;
3436
3437 if( copy_to_user(ustats->nreads, adapter->nreads,
3438 num_ldrv*sizeof(u32)) )
3439 return -EFAULT;
3440
3441 if( copy_to_user(ustats->nreadblocks, adapter->nreadblocks,
3442 num_ldrv*sizeof(u32)) )
3443 return -EFAULT;
3444
3445 if( copy_to_user(ustats->nwrites, adapter->nwrites,
3446 num_ldrv*sizeof(u32)) )
3447 return -EFAULT;
3448
3449 if( copy_to_user(ustats->nwriteblocks, adapter->nwriteblocks,
3450 num_ldrv*sizeof(u32)) )
3451 return -EFAULT;
3452
3453 if( copy_to_user(ustats->rd_errors, adapter->rd_errors,
3454 num_ldrv*sizeof(u32)) )
3455 return -EFAULT;
3456
3457 if( copy_to_user(ustats->wr_errors, adapter->wr_errors,
3458 num_ldrv*sizeof(u32)) )
3459 return -EFAULT;
3460
3461 return 0;
3462
3463 #endif
3464 case MBOX_CMD:
3465
3466 /*
3467 * Which adapter
3468 */
3469 if( (adapno = GETADAP(uioc.adapno)) >= hba_count )
3470 return (-ENODEV);
3471
3472 adapter = hba_soft_state[adapno];
3473
3474 /*
3475 * Deletion of logical drive is a special case. The adapter
3476 * should be quiescent before this command is issued.
3477 */
3478 if( uioc.uioc_rmbox[0] == FC_DEL_LOGDRV &&
3479 uioc.uioc_rmbox[2] == OP_DEL_LOGDRV ) {
3480
3481 /*
3482 * Do we support this feature
3483 */
3484 if( !adapter->support_random_del ) {
3485 printk(KERN_WARNING "megaraid: logdrv ");
3486 printk("delete on non-supporting F/W.\n");
3487
3488 return (-EINVAL);
3489 }
3490
3491 rval = mega_del_logdrv( adapter, uioc.uioc_rmbox[3] );
3492
3493 if( rval == 0 ) {
3494 memset(&mc, 0, sizeof(megacmd_t));
3495
3496 mc.status = rval;
3497
3498 rval = mega_n_to_m((void __user *)arg, &mc);
3499 }
3500
3501 return rval;
3502 }
3503 /*
3504 * This interface only support the regular passthru commands.
3505 * Reject extended passthru and 64-bit passthru
3506 */
3507 if( uioc.uioc_rmbox[0] == MEGA_MBOXCMD_PASSTHRU64 ||
3508 uioc.uioc_rmbox[0] == MEGA_MBOXCMD_EXTPTHRU ) {
3509
3510 printk(KERN_WARNING "megaraid: rejected passthru.\n");
3511
3512 return (-EINVAL);
3513 }
3514
3515 /*
3516 * For all internal commands, the buffer must be allocated in
3517 * <4GB address range
3518 */
3519 if( make_local_pdev(adapter, &pdev) != 0 )
3520 return -EIO;
3521
3522 /* Is it a passthru command or a DCMD */
3523 if( uioc.uioc_rmbox[0] == MEGA_MBOXCMD_PASSTHRU ) {
3524 /* Passthru commands */
3525
3526 pthru = pci_alloc_consistent(pdev,
3527 sizeof(mega_passthru),
3528 &pthru_dma_hndl);
3529
3530 if( pthru == NULL ) {
3531 free_local_pdev(pdev);
3532 return (-ENOMEM);
3533 }
3534
3535 /*
3536 * The user passthru structure
3537 */
3538 upthru = (mega_passthru __user *)MBOX(uioc)->xferaddr;
3539
3540 /*
3541 * Copy in the user passthru here.
3542 */
3543 if( copy_from_user(pthru, upthru,
3544 sizeof(mega_passthru)) ) {
3545
3546 pci_free_consistent(pdev,
3547 sizeof(mega_passthru), pthru,
3548 pthru_dma_hndl);
3549
3550 free_local_pdev(pdev);
3551
3552 return (-EFAULT);
3553 }
3554
3555 /*
3556 * Is there a data transfer
3557 */
3558 if( pthru->dataxferlen ) {
3559 data = pci_alloc_consistent(pdev,
3560 pthru->dataxferlen,
3561 &data_dma_hndl);
3562
3563 if( data == NULL ) {
3564 pci_free_consistent(pdev,
3565 sizeof(mega_passthru),
3566 pthru,
3567 pthru_dma_hndl);
3568
3569 free_local_pdev(pdev);
3570
3571 return (-ENOMEM);
3572 }
3573
3574 /*
3575 * Save the user address and point the kernel
3576 * address at just allocated memory
3577 */
3578 uxferaddr = pthru->dataxferaddr;
3579 pthru->dataxferaddr = data_dma_hndl;
3580 }
3581
3582
3583 /*
3584 * Is data coming down-stream
3585 */
3586 if( pthru->dataxferlen && (uioc.flags & UIOC_WR) ) {
3587 /*
3588 * Get the user data
3589 */
3590 if( copy_from_user(data, (char __user *)uxferaddr,
3591 pthru->dataxferlen) ) {
3592 rval = (-EFAULT);
3593 goto freemem_and_return;
3594 }
3595 }
3596
3597 memset(&mc, 0, sizeof(megacmd_t));
3598
3599 mc.cmd = MEGA_MBOXCMD_PASSTHRU;
3600 mc.xferaddr = (u32)pthru_dma_hndl;
3601
3602 /*
3603 * Issue the command
3604 */
3605 mega_internal_command(adapter, LOCK_INT, &mc, pthru);
3606
3607 rval = mega_n_to_m((void __user *)arg, &mc);
3608
3609 if( rval ) goto freemem_and_return;
3610
3611
3612 /*
3613 * Is data going up-stream
3614 */
3615 if( pthru->dataxferlen && (uioc.flags & UIOC_RD) ) {
3616 if( copy_to_user((char __user *)uxferaddr, data,
3617 pthru->dataxferlen) ) {
3618 rval = (-EFAULT);
3619 }
3620 }
3621
3622 /*
3623 * Send the request sense data also, irrespective of
3624 * whether the user has asked for it or not.
3625 */
3626 copy_to_user(upthru->reqsensearea,
3627 pthru->reqsensearea, 14);
3628
3629 freemem_and_return:
3630 if( pthru->dataxferlen ) {
3631 pci_free_consistent(pdev,
3632 pthru->dataxferlen, data,
3633 data_dma_hndl);
3634 }
3635
3636 pci_free_consistent(pdev, sizeof(mega_passthru),
3637 pthru, pthru_dma_hndl);
3638
3639 free_local_pdev(pdev);
3640
3641 return rval;
3642 }
3643 else {
3644 /* DCMD commands */
3645
3646 /*
3647 * Is there a data transfer
3648 */
3649 if( uioc.xferlen ) {
3650 data = pci_alloc_consistent(pdev,
3651 uioc.xferlen, &data_dma_hndl);
3652
3653 if( data == NULL ) {
3654 free_local_pdev(pdev);
3655 return (-ENOMEM);
3656 }
3657
3658 uxferaddr = MBOX(uioc)->xferaddr;
3659 }
3660
3661 /*
3662 * Is data coming down-stream
3663 */
3664 if( uioc.xferlen && (uioc.flags & UIOC_WR) ) {
3665 /*
3666 * Get the user data
3667 */
3668 if( copy_from_user(data, (char __user *)uxferaddr,
3669 uioc.xferlen) ) {
3670
3671 pci_free_consistent(pdev,
3672 uioc.xferlen,
3673 data, data_dma_hndl);
3674
3675 free_local_pdev(pdev);
3676
3677 return (-EFAULT);
3678 }
3679 }
3680
3681 memcpy(&mc, MBOX(uioc), sizeof(megacmd_t));
3682
3683 mc.xferaddr = (u32)data_dma_hndl;
3684
3685 /*
3686 * Issue the command
3687 */
3688 mega_internal_command(adapter, LOCK_INT, &mc, NULL);
3689
3690 rval = mega_n_to_m((void __user *)arg, &mc);
3691
3692 if( rval ) {
3693 if( uioc.xferlen ) {
3694 pci_free_consistent(pdev,
3695 uioc.xferlen, data,
3696 data_dma_hndl);
3697 }
3698
3699 free_local_pdev(pdev);
3700
3701 return rval;
3702 }
3703
3704 /*
3705 * Is data going up-stream
3706 */
3707 if( uioc.xferlen && (uioc.flags & UIOC_RD) ) {
3708 if( copy_to_user((char __user *)uxferaddr, data,
3709 uioc.xferlen) ) {
3710
3711 rval = (-EFAULT);
3712 }
3713 }
3714
3715 if( uioc.xferlen ) {
3716 pci_free_consistent(pdev,
3717 uioc.xferlen, data,
3718 data_dma_hndl);
3719 }
3720
3721 free_local_pdev(pdev);
3722
3723 return rval;
3724 }
3725
3726 default:
3727 return (-EINVAL);
3728 }
3729
3730 return 0;
3731 }
3732
3733 /**
3734 * mega_m_to_n()
3735 * @arg - user address
3736 * @uioc - new ioctl structure
3737 *
3738 * A thin layer to convert older mimd interface ioctl structure to NIT ioctl
3739 * structure
3740 *
3741 * Converts the older mimd ioctl structure to newer NIT structure
3742 */
3743 static int
3744 mega_m_to_n(void __user *arg, nitioctl_t *uioc)
3745 {
3746 struct uioctl_t uioc_mimd;
3747 char signature[8] = {0};
3748 u8 opcode;
3749 u8 subopcode;
3750
3751
3752 /*
3753 * check is the application conforms to NIT. We do not have to do much
3754 * in that case.
3755 * We exploit the fact that the signature is stored in the very
3756 * begining of the structure.
3757 */
3758
3759 if( copy_from_user(signature, arg, 7) )
3760 return (-EFAULT);
3761
3762 if( memcmp(signature, "MEGANIT", 7) == 0 ) {
3763
3764 /*
3765 * NOTE NOTE: The nit ioctl is still under flux because of
3766 * change of mailbox definition, in HPE. No applications yet
3767 * use this interface and let's not have applications use this
3768 * interface till the new specifitions are in place.
3769 */
3770 return -EINVAL;
3771 #if 0
3772 if( copy_from_user(uioc, arg, sizeof(nitioctl_t)) )
3773 return (-EFAULT);
3774 return 0;
3775 #endif
3776 }
3777
3778 /*
3779 * Else assume we have mimd uioctl_t as arg. Convert to nitioctl_t
3780 *
3781 * Get the user ioctl structure
3782 */
3783 if( copy_from_user(&uioc_mimd, arg, sizeof(struct uioctl_t)) )
3784 return (-EFAULT);
3785
3786
3787 /*
3788 * Get the opcode and subopcode for the commands
3789 */
3790 opcode = uioc_mimd.ui.fcs.opcode;
3791 subopcode = uioc_mimd.ui.fcs.subopcode;
3792
3793 switch (opcode) {
3794 case 0x82:
3795
3796 switch (subopcode) {
3797
3798 case MEGAIOC_QDRVRVER: /* Query driver version */
3799 uioc->opcode = GET_DRIVER_VER;
3800 uioc->uioc_uaddr = uioc_mimd.data;
3801 break;
3802
3803 case MEGAIOC_QNADAP: /* Get # of adapters */
3804 uioc->opcode = GET_N_ADAP;
3805 uioc->uioc_uaddr = uioc_mimd.data;
3806 break;
3807
3808 case MEGAIOC_QADAPINFO: /* Get adapter information */
3809 uioc->opcode = GET_ADAP_INFO;
3810 uioc->adapno = uioc_mimd.ui.fcs.adapno;
3811 uioc->uioc_uaddr = uioc_mimd.data;
3812 break;
3813
3814 default:
3815 return(-EINVAL);
3816 }
3817
3818 break;
3819
3820
3821 case 0x81:
3822
3823 uioc->opcode = MBOX_CMD;
3824 uioc->adapno = uioc_mimd.ui.fcs.adapno;
3825
3826 memcpy(uioc->uioc_rmbox, uioc_mimd.mbox, 18);
3827
3828 uioc->xferlen = uioc_mimd.ui.fcs.length;
3829
3830 if( uioc_mimd.outlen ) uioc->flags = UIOC_RD;
3831 if( uioc_mimd.inlen ) uioc->flags |= UIOC_WR;
3832
3833 break;
3834
3835 case 0x80:
3836
3837 uioc->opcode = MBOX_CMD;
3838 uioc->adapno = uioc_mimd.ui.fcs.adapno;
3839
3840 memcpy(uioc->uioc_rmbox, uioc_mimd.mbox, 18);
3841
3842 /*
3843 * Choose the xferlen bigger of input and output data
3844 */
3845 uioc->xferlen = uioc_mimd.outlen > uioc_mimd.inlen ?
3846 uioc_mimd.outlen : uioc_mimd.inlen;
3847
3848 if( uioc_mimd.outlen ) uioc->flags = UIOC_RD;
3849 if( uioc_mimd.inlen ) uioc->flags |= UIOC_WR;
3850
3851 break;
3852
3853 default:
3854 return (-EINVAL);
3855
3856 }
3857
3858 return 0;
3859 }
3860
3861 /*
3862 * mega_n_to_m()
3863 * @arg - user address
3864 * @mc - mailbox command
3865 *
3866 * Updates the status information to the application, depending on application
3867 * conforms to older mimd ioctl interface or newer NIT ioctl interface
3868 */
3869 static int
3870 mega_n_to_m(void __user *arg, megacmd_t *mc)
3871 {
3872 nitioctl_t __user *uiocp;
3873 megacmd_t __user *umc;
3874 mega_passthru __user *upthru;
3875 struct uioctl_t __user *uioc_mimd;
3876 char signature[8] = {0};
3877
3878 /*
3879 * check is the application conforms to NIT.
3880 */
3881 if( copy_from_user(signature, arg, 7) )
3882 return -EFAULT;
3883
3884 if( memcmp(signature, "MEGANIT", 7) == 0 ) {
3885
3886 uiocp = arg;
3887
3888 if( put_user(mc->status, (u8 __user *)&MBOX_P(uiocp)->status) )
3889 return (-EFAULT);
3890
3891 if( mc->cmd == MEGA_MBOXCMD_PASSTHRU ) {
3892
3893 umc = MBOX_P(uiocp);
3894
3895 if (get_user(upthru, (mega_passthru __user * __user *)&umc->xferaddr))
3896 return -EFAULT;
3897
3898 if( put_user(mc->status, (u8 __user *)&upthru->scsistatus))
3899 return (-EFAULT);
3900 }
3901 }
3902 else {
3903 uioc_mimd = arg;
3904
3905 if( put_user(mc->status, (u8 __user *)&uioc_mimd->mbox[17]) )
3906 return (-EFAULT);
3907
3908 if( mc->cmd == MEGA_MBOXCMD_PASSTHRU ) {
3909
3910 umc = (megacmd_t __user *)uioc_mimd->mbox;
3911
3912 if (get_user(upthru, (mega_passthru __user * __user *)&umc->xferaddr))
3913 return (-EFAULT);
3914
3915 if( put_user(mc->status, (u8 __user *)&upthru->scsistatus) )
3916 return (-EFAULT);
3917 }
3918 }
3919
3920 return 0;
3921 }
3922
3923
3924 /*
3925 * MEGARAID 'FW' commands.
3926 */
3927
3928 /**
3929 * mega_is_bios_enabled()
3930 * @adapter - pointer to our soft state
3931 *
3932 * issue command to find out if the BIOS is enabled for this controller
3933 */
3934 static int
3935 mega_is_bios_enabled(adapter_t *adapter)
3936 {
3937 unsigned char raw_mbox[sizeof(struct mbox_out)];
3938 mbox_t *mbox;
3939 int ret;
3940
3941 mbox = (mbox_t *)raw_mbox;
3942
3943 memset(&mbox->m_out, 0, sizeof(raw_mbox));
3944
3945 memset((void *)adapter->mega_buffer, 0, MEGA_BUFFER_SIZE);
3946
3947 mbox->m_out.xferaddr = (u32)adapter->buf_dma_handle;
3948
3949 raw_mbox[0] = IS_BIOS_ENABLED;
3950 raw_mbox[2] = GET_BIOS;
3951
3952
3953 ret = issue_scb_block(adapter, raw_mbox);
3954
3955 return *(char *)adapter->mega_buffer;
3956 }
3957
3958
3959 /**
3960 * mega_enum_raid_scsi()
3961 * @adapter - pointer to our soft state
3962 *
3963 * Find out what channels are RAID/SCSI. This information is used to
3964 * differentiate the virtual channels and physical channels and to support
3965 * ROMB feature and non-disk devices.
3966 */
3967 static void
3968 mega_enum_raid_scsi(adapter_t *adapter)
3969 {
3970 unsigned char raw_mbox[sizeof(struct mbox_out)];
3971 mbox_t *mbox;
3972 int i;
3973
3974 mbox = (mbox_t *)raw_mbox;
3975
3976 memset(&mbox->m_out, 0, sizeof(raw_mbox));
3977
3978 /*
3979 * issue command to find out what channels are raid/scsi
3980 */
3981 raw_mbox[0] = CHNL_CLASS;
3982 raw_mbox[2] = GET_CHNL_CLASS;
3983
3984 memset((void *)adapter->mega_buffer, 0, MEGA_BUFFER_SIZE);
3985
3986 mbox->m_out.xferaddr = (u32)adapter->buf_dma_handle;
3987
3988 /*
3989 * Non-ROMB firmware fail this command, so all channels
3990 * must be shown RAID
3991 */
3992 adapter->mega_ch_class = 0xFF;
3993
3994 if(!issue_scb_block(adapter, raw_mbox)) {
3995 adapter->mega_ch_class = *((char *)adapter->mega_buffer);
3996
3997 }
3998
3999 for( i = 0; i < adapter->product_info.nchannels; i++ ) {
4000 if( (adapter->mega_ch_class >> i) & 0x01 ) {
4001 printk(KERN_INFO "megaraid: channel[%d] is raid.\n",
4002 i);
4003 }
4004 else {
4005 printk(KERN_INFO "megaraid: channel[%d] is scsi.\n",
4006 i);
4007 }
4008 }
4009
4010 return;
4011 }
4012
4013
4014 /**
4015 * mega_get_boot_drv()
4016 * @adapter - pointer to our soft state
4017 *
4018 * Find out which device is the boot device. Note, any logical drive or any
4019 * phyical device (e.g., a CDROM) can be designated as a boot device.
4020 */
4021 static void
4022 mega_get_boot_drv(adapter_t *adapter)
4023 {
4024 struct private_bios_data *prv_bios_data;
4025 unsigned char raw_mbox[sizeof(struct mbox_out)];
4026 mbox_t *mbox;
4027 u16 cksum = 0;
4028 u8 *cksum_p;
4029 u8 boot_pdrv;
4030 int i;
4031
4032 mbox = (mbox_t *)raw_mbox;
4033
4034 memset(&mbox->m_out, 0, sizeof(raw_mbox));
4035
4036 raw_mbox[0] = BIOS_PVT_DATA;
4037 raw_mbox[2] = GET_BIOS_PVT_DATA;
4038
4039 memset((void *)adapter->mega_buffer, 0, MEGA_BUFFER_SIZE);
4040
4041 mbox->m_out.xferaddr = (u32)adapter->buf_dma_handle;
4042
4043 adapter->boot_ldrv_enabled = 0;
4044 adapter->boot_ldrv = 0;
4045
4046 adapter->boot_pdrv_enabled = 0;
4047 adapter->boot_pdrv_ch = 0;
4048 adapter->boot_pdrv_tgt = 0;
4049
4050 if(issue_scb_block(adapter, raw_mbox) == 0) {
4051 prv_bios_data =
4052 (struct private_bios_data *)adapter->mega_buffer;
4053
4054 cksum = 0;
4055 cksum_p = (char *)prv_bios_data;
4056 for (i = 0; i < 14; i++ ) {
4057 cksum += (u16)(*cksum_p++);
4058 }
4059
4060 if (prv_bios_data->cksum == (u16)(0-cksum) ) {
4061
4062 /*
4063 * If MSB is set, a physical drive is set as boot
4064 * device
4065 */
4066 if( prv_bios_data->boot_drv & 0x80 ) {
4067 adapter->boot_pdrv_enabled = 1;
4068 boot_pdrv = prv_bios_data->boot_drv & 0x7F;
4069 adapter->boot_pdrv_ch = boot_pdrv / 16;
4070 adapter->boot_pdrv_tgt = boot_pdrv % 16;
4071 }
4072 else {
4073 adapter->boot_ldrv_enabled = 1;
4074 adapter->boot_ldrv = prv_bios_data->boot_drv;
4075 }
4076 }
4077 }
4078
4079 }
4080
4081 /**
4082 * mega_support_random_del()
4083 * @adapter - pointer to our soft state
4084 *
4085 * Find out if this controller supports random deletion and addition of
4086 * logical drives
4087 */
4088 static int
4089 mega_support_random_del(adapter_t *adapter)
4090 {
4091 unsigned char raw_mbox[sizeof(struct mbox_out)];
4092 mbox_t *mbox;
4093 int rval;
4094
4095 mbox = (mbox_t *)raw_mbox;
4096
4097 memset(&mbox->m_out, 0, sizeof(raw_mbox));
4098
4099 /*
4100 * issue command
4101 */
4102 raw_mbox[0] = FC_DEL_LOGDRV;
4103 raw_mbox[2] = OP_SUP_DEL_LOGDRV;
4104
4105 rval = issue_scb_block(adapter, raw_mbox);
4106
4107 return !rval;
4108 }
4109
4110
4111 /**
4112 * mega_support_ext_cdb()
4113 * @adapter - pointer to our soft state
4114 *
4115 * Find out if this firmware support cdblen > 10
4116 */
4117 static int
4118 mega_support_ext_cdb(adapter_t *adapter)
4119 {
4120 unsigned char raw_mbox[sizeof(struct mbox_out)];
4121 mbox_t *mbox;
4122 int rval;
4123
4124 mbox = (mbox_t *)raw_mbox;
4125
4126 memset(&mbox->m_out, 0, sizeof(raw_mbox));
4127 /*
4128 * issue command to find out if controller supports extended CDBs.
4129 */
4130 raw_mbox[0] = 0xA4;
4131 raw_mbox[2] = 0x16;
4132
4133 rval = issue_scb_block(adapter, raw_mbox);
4134
4135 return !rval;
4136 }
4137
4138
4139 /**
4140 * mega_del_logdrv()
4141 * @adapter - pointer to our soft state
4142 * @logdrv - logical drive to be deleted
4143 *
4144 * Delete the specified logical drive. It is the responsibility of the user
4145 * app to let the OS know about this operation.
4146 */
4147 static int
4148 mega_del_logdrv(adapter_t *adapter, int logdrv)
4149 {
4150 unsigned long flags;
4151 scb_t *scb;
4152 int rval;
4153
4154 /*
4155 * Stop sending commands to the controller, queue them internally.
4156 * When deletion is complete, ISR will flush the queue.
4157 */
4158 atomic_set(&adapter->quiescent, 1);
4159
4160 /*
4161 * Wait till all the issued commands are complete and there are no
4162 * commands in the pending queue
4163 */
4164 while (atomic_read(&adapter->pend_cmds) > 0 ||
4165 !list_empty(&adapter->pending_list))
4166 msleep(1000); /* sleep for 1s */
4167
4168 rval = mega_do_del_logdrv(adapter, logdrv);
4169
4170 spin_lock_irqsave(&adapter->lock, flags);
4171
4172 /*
4173 * If delete operation was successful, add 0x80 to the logical drive
4174 * ids for commands in the pending queue.
4175 */
4176 if (adapter->read_ldidmap) {
4177 struct list_head *pos;
4178 list_for_each(pos, &adapter->pending_list) {
4179 scb = list_entry(pos, scb_t, list);
4180 if (scb->pthru->logdrv < 0x80 )
4181 scb->pthru->logdrv += 0x80;
4182 }
4183 }
4184
4185 atomic_set(&adapter->quiescent, 0);
4186
4187 mega_runpendq(adapter);
4188
4189 spin_unlock_irqrestore(&adapter->lock, flags);
4190
4191 return rval;
4192 }
4193
4194
4195 static int
4196 mega_do_del_logdrv(adapter_t *adapter, int logdrv)
4197 {
4198 megacmd_t mc;
4199 int rval;
4200
4201 memset( &mc, 0, sizeof(megacmd_t));
4202
4203 mc.cmd = FC_DEL_LOGDRV;
4204 mc.opcode = OP_DEL_LOGDRV;
4205 mc.subopcode = logdrv;
4206
4207 rval = mega_internal_command(adapter, LOCK_INT, &mc, NULL);
4208
4209 /* log this event */
4210 if(rval) {
4211 printk(KERN_WARNING "megaraid: Delete LD-%d failed.", logdrv);
4212 return rval;
4213 }
4214
4215 /*
4216 * After deleting first logical drive, the logical drives must be
4217 * addressed by adding 0x80 to the logical drive id.
4218 */
4219 adapter->read_ldidmap = 1;
4220
4221 return rval;
4222 }
4223
4224
4225 /**
4226 * mega_get_max_sgl()
4227 * @adapter - pointer to our soft state
4228 *
4229 * Find out the maximum number of scatter-gather elements supported by this
4230 * version of the firmware
4231 */
4232 static void
4233 mega_get_max_sgl(adapter_t *adapter)
4234 {
4235 unsigned char raw_mbox[sizeof(struct mbox_out)];
4236 mbox_t *mbox;
4237
4238 mbox = (mbox_t *)raw_mbox;
4239
4240 memset(mbox, 0, sizeof(raw_mbox));
4241
4242 memset((void *)adapter->mega_buffer, 0, MEGA_BUFFER_SIZE);
4243
4244 mbox->m_out.xferaddr = (u32)adapter->buf_dma_handle;
4245
4246 raw_mbox[0] = MAIN_MISC_OPCODE;
4247 raw_mbox[2] = GET_MAX_SG_SUPPORT;
4248
4249
4250 if( issue_scb_block(adapter, raw_mbox) ) {
4251 /*
4252 * f/w does not support this command. Choose the default value
4253 */
4254 adapter->sglen = MIN_SGLIST;
4255 }
4256 else {
4257 adapter->sglen = *((char *)adapter->mega_buffer);
4258
4259 /*
4260 * Make sure this is not more than the resources we are
4261 * planning to allocate
4262 */
4263 if ( adapter->sglen > MAX_SGLIST )
4264 adapter->sglen = MAX_SGLIST;
4265 }
4266
4267 return;
4268 }
4269
4270
4271 /**
4272 * mega_support_cluster()
4273 * @adapter - pointer to our soft state
4274 *
4275 * Find out if this firmware support cluster calls.
4276 */
4277 static int
4278 mega_support_cluster(adapter_t *adapter)
4279 {
4280 unsigned char raw_mbox[sizeof(struct mbox_out)];
4281 mbox_t *mbox;
4282
4283 mbox = (mbox_t *)raw_mbox;
4284
4285 memset(mbox, 0, sizeof(raw_mbox));
4286
4287 memset((void *)adapter->mega_buffer, 0, MEGA_BUFFER_SIZE);
4288
4289 mbox->m_out.xferaddr = (u32)adapter->buf_dma_handle;
4290
4291 /*
4292 * Try to get the initiator id. This command will succeed iff the
4293 * clustering is available on this HBA.
4294 */
4295 raw_mbox[0] = MEGA_GET_TARGET_ID;
4296
4297 if( issue_scb_block(adapter, raw_mbox) == 0 ) {
4298
4299 /*
4300 * Cluster support available. Get the initiator target id.
4301 * Tell our id to mid-layer too.
4302 */
4303 adapter->this_id = *(u32 *)adapter->mega_buffer;
4304 adapter->host->this_id = adapter->this_id;
4305
4306 return 1;
4307 }
4308
4309 return 0;
4310 }
4311
4312
4313 /**
4314 * mega_adapinq()
4315 * @adapter - pointer to our soft state
4316 * @dma_handle - DMA address of the buffer
4317 *
4318 * Issue internal comamnds while interrupts are available.
4319 * We only issue direct mailbox commands from within the driver. ioctl()
4320 * interface using these routines can issue passthru commands.
4321 */
4322 static int
4323 mega_adapinq(adapter_t *adapter, dma_addr_t dma_handle)
4324 {
4325 megacmd_t mc;
4326
4327 memset(&mc, 0, sizeof(megacmd_t));
4328
4329 if( adapter->flag & BOARD_40LD ) {
4330 mc.cmd = FC_NEW_CONFIG;
4331 mc.opcode = NC_SUBOP_ENQUIRY3;
4332 mc.subopcode = ENQ3_GET_SOLICITED_FULL;
4333 }
4334 else {
4335 mc.cmd = MEGA_MBOXCMD_ADPEXTINQ;
4336 }
4337
4338 mc.xferaddr = (u32)dma_handle;
4339
4340 if ( mega_internal_command(adapter, LOCK_INT, &mc, NULL) != 0 ) {
4341 return -1;
4342 }
4343
4344 return 0;
4345 }
4346
4347
4348 /** mega_internal_dev_inquiry()
4349 * @adapter - pointer to our soft state
4350 * @ch - channel for this device
4351 * @tgt - ID of this device
4352 * @buf_dma_handle - DMA address of the buffer
4353 *
4354 * Issue the scsi inquiry for the specified device.
4355 */
4356 static int
4357 mega_internal_dev_inquiry(adapter_t *adapter, u8 ch, u8 tgt,
4358 dma_addr_t buf_dma_handle)
4359 {
4360 mega_passthru *pthru;
4361 dma_addr_t pthru_dma_handle;
4362 megacmd_t mc;
4363 int rval;
4364 struct pci_dev *pdev;
4365
4366
4367 /*
4368 * For all internal commands, the buffer must be allocated in <4GB
4369 * address range
4370 */
4371 if( make_local_pdev(adapter, &pdev) != 0 ) return -1;
4372
4373 pthru = pci_alloc_consistent(pdev, sizeof(mega_passthru),
4374 &pthru_dma_handle);
4375
4376 if( pthru == NULL ) {
4377 free_local_pdev(pdev);
4378 return -1;
4379 }
4380
4381 pthru->timeout = 2;
4382 pthru->ars = 1;
4383 pthru->reqsenselen = 14;
4384 pthru->islogical = 0;
4385
4386 pthru->channel = (adapter->flag & BOARD_40LD) ? 0 : ch;
4387
4388 pthru->target = (adapter->flag & BOARD_40LD) ? (ch << 4)|tgt : tgt;
4389
4390 pthru->cdblen = 6;
4391
4392 pthru->cdb[0] = INQUIRY;
4393 pthru->cdb[1] = 0;
4394 pthru->cdb[2] = 0;
4395 pthru->cdb[3] = 0;
4396 pthru->cdb[4] = 255;
4397 pthru->cdb[5] = 0;
4398
4399
4400 pthru->dataxferaddr = (u32)buf_dma_handle;
4401 pthru->dataxferlen = 256;
4402
4403 memset(&mc, 0, sizeof(megacmd_t));
4404
4405 mc.cmd = MEGA_MBOXCMD_PASSTHRU;
4406 mc.xferaddr = (u32)pthru_dma_handle;
4407
4408 rval = mega_internal_command(adapter, LOCK_INT, &mc, pthru);
4409
4410 pci_free_consistent(pdev, sizeof(mega_passthru), pthru,
4411 pthru_dma_handle);
4412
4413 free_local_pdev(pdev);
4414
4415 return rval;
4416 }
4417
4418
4419 /**
4420 * mega_internal_command()
4421 * @adapter - pointer to our soft state
4422 * @ls - the scope of the exclusion lock.
4423 * @mc - the mailbox command
4424 * @pthru - Passthru structure for DCDB commands
4425 *
4426 * Issue the internal commands in interrupt mode.
4427 * The last argument is the address of the passthru structure if the command
4428 * to be fired is a passthru command
4429 *
4430 * lockscope specifies whether the caller has already acquired the lock. Of
4431 * course, the caller must know which lock we are talking about.
4432 *
4433 * Note: parameter 'pthru' is null for non-passthru commands.
4434 */
4435 static int
4436 mega_internal_command(adapter_t *adapter, lockscope_t ls, megacmd_t *mc,
4437 mega_passthru *pthru )
4438 {
4439 Scsi_Cmnd *scmd;
4440 struct scsi_device *sdev;
4441 unsigned long flags = 0;
4442 scb_t *scb;
4443 int rval;
4444
4445 /*
4446 * The internal commands share one command id and hence are
4447 * serialized. This is so because we want to reserve maximum number of
4448 * available command ids for the I/O commands.
4449 */
4450 down(&adapter->int_mtx);
4451
4452 scb = &adapter->int_scb;
4453 memset(scb, 0, sizeof(scb_t));
4454
4455 scmd = &adapter->int_scmd;
4456 memset(scmd, 0, sizeof(Scsi_Cmnd));
4457
4458 sdev = kmalloc(sizeof(struct scsi_device), GFP_KERNEL);
4459 memset(sdev, 0, sizeof(struct scsi_device));
4460 scmd->device = sdev;
4461
4462 scmd->device->host = adapter->host;
4463 scmd->buffer = (void *)scb;
4464 scmd->cmnd[0] = MEGA_INTERNAL_CMD;
4465
4466 scb->state |= SCB_ACTIVE;
4467 scb->cmd = scmd;
4468
4469 memcpy(scb->raw_mbox, mc, sizeof(megacmd_t));
4470
4471 /*
4472 * Is it a passthru command
4473 */
4474 if( mc->cmd == MEGA_MBOXCMD_PASSTHRU ) {
4475
4476 scb->pthru = pthru;
4477 }
4478
4479 scb->idx = CMDID_INT_CMDS;
4480
4481 scmd->state = 0;
4482
4483 /*
4484 * Get the lock only if the caller has not acquired it already
4485 */
4486 if( ls == LOCK_INT ) spin_lock_irqsave(&adapter->lock, flags);
4487
4488 megaraid_queue(scmd, mega_internal_done);
4489
4490 if( ls == LOCK_INT ) spin_unlock_irqrestore(&adapter->lock, flags);
4491
4492 /*
4493 * Wait till this command finishes. Do not use
4494 * wait_event_interruptible(). It causes panic if CTRL-C is hit when
4495 * dumping e.g., physical disk information through /proc interface.
4496 */
4497 #if 0
4498 wait_event_interruptible(adapter->int_waitq, scmd->state);
4499 #endif
4500 wait_event(adapter->int_waitq, scmd->state);
4501
4502 rval = scmd->result;
4503 mc->status = scmd->result;
4504 kfree(sdev);
4505
4506 /*
4507 * Print a debug message for all failed commands. Applications can use
4508 * this information.
4509 */
4510 if( scmd->result && trace_level ) {
4511 printk("megaraid: cmd [%x, %x, %x] status:[%x]\n",
4512 mc->cmd, mc->opcode, mc->subopcode, scmd->result);
4513 }
4514
4515 up(&adapter->int_mtx);
4516
4517 return rval;
4518 }
4519
4520
4521 /**
4522 * mega_internal_done()
4523 * @scmd - internal scsi command
4524 *
4525 * Callback routine for internal commands.
4526 */
4527 static void
4528 mega_internal_done(Scsi_Cmnd *scmd)
4529 {
4530 adapter_t *adapter;
4531
4532 adapter = (adapter_t *)scmd->device->host->hostdata;
4533
4534 scmd->state = 1; /* thread waiting for its command to complete */
4535
4536 /*
4537 * See comment in mega_internal_command() routine for
4538 * wait_event_interruptible()
4539 */
4540 #if 0
4541 wake_up_interruptible(&adapter->int_waitq);
4542 #endif
4543 wake_up(&adapter->int_waitq);
4544
4545 }
4546
4547
4548 static struct scsi_host_template megaraid_template = {
4549 .module = THIS_MODULE,
4550 .name = "MegaRAID",
4551 .proc_name = "megaraid",
4552 .info = megaraid_info,
4553 .queuecommand = megaraid_queue,
4554 .bios_param = megaraid_biosparam,
4555 .max_sectors = MAX_SECTORS_PER_IO,
4556 .can_queue = MAX_COMMANDS,
4557 .this_id = DEFAULT_INITIATOR_ID,
4558 .sg_tablesize = MAX_SGLIST,
4559 .cmd_per_lun = DEF_CMD_PER_LUN,
4560 .use_clustering = ENABLE_CLUSTERING,
4561 .eh_abort_handler = megaraid_abort,
4562 .eh_device_reset_handler = megaraid_reset,
4563 .eh_bus_reset_handler = megaraid_reset,
4564 .eh_host_reset_handler = megaraid_reset,
4565 };
4566
4567 static int __devinit
4568 megaraid_probe_one(struct pci_dev *pdev, const struct pci_device_id *id)
4569 {
4570 struct Scsi_Host *host;
4571 adapter_t *adapter;
4572 unsigned long mega_baseport, tbase, flag = 0;
4573 u16 subsysid, subsysvid;
4574 u8 pci_bus, pci_dev_func;
4575 int irq, i, j;
4576 int error = -ENODEV;
4577
4578 if (pci_enable_device(pdev))
4579 goto out;
4580 pci_set_master(pdev);
4581
4582 pci_bus = pdev->bus->number;
4583 pci_dev_func = pdev->devfn;
4584
4585 /*
4586 * The megaraid3 stuff reports the ID of the Intel part which is not
4587 * remotely specific to the megaraid
4588 */
4589 if (pdev->vendor == PCI_VENDOR_ID_INTEL) {
4590 u16 magic;
4591 /*
4592 * Don't fall over the Compaq management cards using the same
4593 * PCI identifier
4594 */
4595 if (pdev->subsystem_vendor == PCI_VENDOR_ID_COMPAQ &&
4596 pdev->subsystem_device == 0xC000)
4597 return -ENODEV;
4598 /* Now check the magic signature byte */
4599 pci_read_config_word(pdev, PCI_CONF_AMISIG, &magic);
4600 if (magic != HBA_SIGNATURE_471 && magic != HBA_SIGNATURE)
4601 return -ENODEV;
4602 /* Ok it is probably a megaraid */
4603 }
4604
4605 /*
4606 * For these vendor and device ids, signature offsets are not
4607 * valid and 64 bit is implicit
4608 */
4609 if (id->driver_data & BOARD_64BIT)
4610 flag |= BOARD_64BIT;
4611 else {
4612 u32 magic64;
4613
4614 pci_read_config_dword(pdev, PCI_CONF_AMISIG64, &magic64);
4615 if (magic64 == HBA_SIGNATURE_64BIT)
4616 flag |= BOARD_64BIT;
4617 }
4618
4619 subsysvid = pdev->subsystem_vendor;
4620 subsysid = pdev->subsystem_device;
4621
4622 printk(KERN_NOTICE "megaraid: found 0x%4.04x:0x%4.04x:bus %d:",
4623 id->vendor, id->device, pci_bus);
4624
4625 printk("slot %d:func %d\n",
4626 PCI_SLOT(pci_dev_func), PCI_FUNC(pci_dev_func));
4627
4628 /* Read the base port and IRQ from PCI */
4629 mega_baseport = pci_resource_start(pdev, 0);
4630 irq = pdev->irq;
4631
4632 tbase = mega_baseport;
4633 if (pci_resource_flags(pdev, 0) & IORESOURCE_MEM) {
4634 flag |= BOARD_MEMMAP;
4635
4636 if (!request_mem_region(mega_baseport, 128, "megaraid")) {
4637 printk(KERN_WARNING "megaraid: mem region busy!\n");
4638 goto out_disable_device;
4639 }
4640
4641 mega_baseport = (unsigned long)ioremap(mega_baseport, 128);
4642 if (!mega_baseport) {
4643 printk(KERN_WARNING
4644 "megaraid: could not map hba memory\n");
4645 goto out_release_region;
4646 }
4647 } else {
4648 flag |= BOARD_IOMAP;
4649 mega_baseport += 0x10;
4650
4651 if (!request_region(mega_baseport, 16, "megaraid"))
4652 goto out_disable_device;
4653 }
4654
4655 /* Initialize SCSI Host structure */
4656 host = scsi_host_alloc(&megaraid_template, sizeof(adapter_t));
4657 if (!host)
4658 goto out_iounmap;
4659
4660 adapter = (adapter_t *)host->hostdata;
4661 memset(adapter, 0, sizeof(adapter_t));
4662
4663 printk(KERN_NOTICE
4664 "scsi%d:Found MegaRAID controller at 0x%lx, IRQ:%d\n",
4665 host->host_no, mega_baseport, irq);
4666
4667 adapter->base = mega_baseport;
4668
4669 INIT_LIST_HEAD(&adapter->free_list);
4670 INIT_LIST_HEAD(&adapter->pending_list);
4671 INIT_LIST_HEAD(&adapter->completed_list);
4672
4673 adapter->flag = flag;
4674 spin_lock_init(&adapter->lock);
4675 scsi_assign_lock(host, &adapter->lock);
4676
4677 host->cmd_per_lun = max_cmd_per_lun;
4678 host->max_sectors = max_sectors_per_io;
4679
4680 adapter->dev = pdev;
4681 adapter->host = host;
4682
4683 adapter->host->irq = irq;
4684
4685 if (flag & BOARD_MEMMAP)
4686 adapter->host->base = tbase;
4687 else {
4688 adapter->host->io_port = tbase;
4689 adapter->host->n_io_port = 16;
4690 }
4691
4692 adapter->host->unique_id = (pci_bus << 8) | pci_dev_func;
4693
4694 /*
4695 * Allocate buffer to issue internal commands.
4696 */
4697 adapter->mega_buffer = pci_alloc_consistent(adapter->dev,
4698 MEGA_BUFFER_SIZE, &adapter->buf_dma_handle);
4699 if (!adapter->mega_buffer) {
4700 printk(KERN_WARNING "megaraid: out of RAM.\n");
4701 goto out_host_put;
4702 }
4703
4704 adapter->scb_list = kmalloc(sizeof(scb_t) * MAX_COMMANDS, GFP_KERNEL);
4705 if (!adapter->scb_list) {
4706 printk(KERN_WARNING "megaraid: out of RAM.\n");
4707 goto out_free_cmd_buffer;
4708 }
4709
4710 if (request_irq(irq, (adapter->flag & BOARD_MEMMAP) ?
4711 megaraid_isr_memmapped : megaraid_isr_iomapped,
4712 SA_SHIRQ, "megaraid", adapter)) {
4713 printk(KERN_WARNING
4714 "megaraid: Couldn't register IRQ %d!\n", irq);
4715 goto out_free_scb_list;
4716 }
4717
4718 if (mega_setup_mailbox(adapter))
4719 goto out_free_irq;
4720
4721 if (mega_query_adapter(adapter))
4722 goto out_free_mbox;
4723
4724 /*
4725 * Have checks for some buggy f/w
4726 */
4727 if ((subsysid == 0x1111) && (subsysvid == 0x1111)) {
4728 /*
4729 * Which firmware
4730 */
4731 if (!strcmp(adapter->fw_version, "3.00") ||
4732 !strcmp(adapter->fw_version, "3.01")) {
4733
4734 printk( KERN_WARNING
4735 "megaraid: Your card is a Dell PERC "
4736 "2/SC RAID controller with "
4737 "firmware\nmegaraid: 3.00 or 3.01. "
4738 "This driver is known to have "
4739 "corruption issues\nmegaraid: with "
4740 "those firmware versions on this "
4741 "specific card. In order\nmegaraid: "
4742 "to protect your data, please upgrade "
4743 "your firmware to version\nmegaraid: "
4744 "3.10 or later, available from the "
4745 "Dell Technical Support web\n"
4746 "megaraid: site at\nhttp://support."
4747 "dell.com/us/en/filelib/download/"
4748 "index.asp?fileid=2940\n"
4749 );
4750 }
4751 }
4752
4753 /*
4754 * If we have a HP 1M(0x60E7)/2M(0x60E8) controller with
4755 * firmware H.01.07, H.01.08, and H.01.09 disable 64 bit
4756 * support, since this firmware cannot handle 64 bit
4757 * addressing
4758 */
4759 if ((subsysvid == HP_SUBSYS_VID) &&
4760 ((subsysid == 0x60E7) || (subsysid == 0x60E8))) {
4761 /*
4762 * which firmware
4763 */
4764 if (!strcmp(adapter->fw_version, "H01.07") ||
4765 !strcmp(adapter->fw_version, "H01.08") ||
4766 !strcmp(adapter->fw_version, "H01.09") ) {
4767 printk(KERN_WARNING
4768 "megaraid: Firmware H.01.07, "
4769 "H.01.08, and H.01.09 on 1M/2M "
4770 "controllers\n"
4771 "megaraid: do not support 64 bit "
4772 "addressing.\nmegaraid: DISABLING "
4773 "64 bit support.\n");
4774 adapter->flag &= ~BOARD_64BIT;
4775 }
4776 }
4777
4778 if (mega_is_bios_enabled(adapter))
4779 mega_hbas[hba_count].is_bios_enabled = 1;
4780 mega_hbas[hba_count].hostdata_addr = adapter;
4781
4782 /*
4783 * Find out which channel is raid and which is scsi. This is
4784 * for ROMB support.
4785 */
4786 mega_enum_raid_scsi(adapter);
4787
4788 /*
4789 * Find out if a logical drive is set as the boot drive. If
4790 * there is one, will make that as the first logical drive.
4791 * ROMB: Do we have to boot from a physical drive. Then all
4792 * the physical drives would appear before the logical disks.
4793 * Else, all the physical drives would be exported to the mid
4794 * layer after logical drives.
4795 */
4796 mega_get_boot_drv(adapter);
4797
4798 if (adapter->boot_pdrv_enabled) {
4799 j = adapter->product_info.nchannels;
4800 for( i = 0; i < j; i++ )
4801 adapter->logdrv_chan[i] = 0;
4802 for( i = j; i < NVIRT_CHAN + j; i++ )
4803 adapter->logdrv_chan[i] = 1;
4804 } else {
4805 for (i = 0; i < NVIRT_CHAN; i++)
4806 adapter->logdrv_chan[i] = 1;
4807 for (i = NVIRT_CHAN; i < MAX_CHANNELS+NVIRT_CHAN; i++)
4808 adapter->logdrv_chan[i] = 0;
4809 adapter->mega_ch_class <<= NVIRT_CHAN;
4810 }
4811
4812 /*
4813 * Do we support random deletion and addition of logical
4814 * drives
4815 */
4816 adapter->read_ldidmap = 0; /* set it after first logdrv
4817 delete cmd */
4818 adapter->support_random_del = mega_support_random_del(adapter);
4819
4820 /* Initialize SCBs */
4821 if (mega_init_scb(adapter))
4822 goto out_free_mbox;
4823
4824 /*
4825 * Reset the pending commands counter
4826 */
4827 atomic_set(&adapter->pend_cmds, 0);
4828
4829 /*
4830 * Reset the adapter quiescent flag
4831 */
4832 atomic_set(&adapter->quiescent, 0);
4833
4834 hba_soft_state[hba_count] = adapter;
4835
4836 /*
4837 * Fill in the structure which needs to be passed back to the
4838 * application when it does an ioctl() for controller related
4839 * information.
4840 */
4841 i = hba_count;
4842
4843 mcontroller[i].base = mega_baseport;
4844 mcontroller[i].irq = irq;
4845 mcontroller[i].numldrv = adapter->numldrv;
4846 mcontroller[i].pcibus = pci_bus;
4847 mcontroller[i].pcidev = id->device;
4848 mcontroller[i].pcifun = PCI_FUNC (pci_dev_func);
4849 mcontroller[i].pciid = -1;
4850 mcontroller[i].pcivendor = id->vendor;
4851 mcontroller[i].pcislot = PCI_SLOT(pci_dev_func);
4852 mcontroller[i].uid = (pci_bus << 8) | pci_dev_func;
4853
4854
4855 /* Set the Mode of addressing to 64 bit if we can */
4856 if ((adapter->flag & BOARD_64BIT) && (sizeof(dma_addr_t) == 8)) {
4857 pci_set_dma_mask(pdev, 0xffffffffffffffffULL);
4858 adapter->has_64bit_addr = 1;
4859 } else {
4860 pci_set_dma_mask(pdev, 0xffffffff);
4861 adapter->has_64bit_addr = 0;
4862 }
4863
4864 init_MUTEX(&adapter->int_mtx);
4865 init_waitqueue_head(&adapter->int_waitq);
4866
4867 adapter->this_id = DEFAULT_INITIATOR_ID;
4868 adapter->host->this_id = DEFAULT_INITIATOR_ID;
4869
4870 #if MEGA_HAVE_CLUSTERING
4871 /*
4872 * Is cluster support enabled on this controller
4873 * Note: In a cluster the HBAs ( the initiators ) will have
4874 * different target IDs and we cannot assume it to be 7. Call
4875 * to mega_support_cluster() will get the target ids also if
4876 * the cluster support is available
4877 */
4878 adapter->has_cluster = mega_support_cluster(adapter);
4879 if (adapter->has_cluster) {
4880 printk(KERN_NOTICE
4881 "megaraid: Cluster driver, initiator id:%d\n",
4882 adapter->this_id);
4883 }
4884 #endif
4885
4886 pci_set_drvdata(pdev, host);
4887
4888 mega_create_proc_entry(hba_count, mega_proc_dir_entry);
4889
4890 error = scsi_add_host(host, &pdev->dev);
4891 if (error)
4892 goto out_free_mbox;
4893
4894 scsi_scan_host(host);
4895 hba_count++;
4896 return 0;
4897
4898 out_free_mbox:
4899 pci_free_consistent(adapter->dev, sizeof(mbox64_t),
4900 adapter->una_mbox64, adapter->una_mbox64_dma);
4901 out_free_irq:
4902 free_irq(adapter->host->irq, adapter);
4903 out_free_scb_list:
4904 kfree(adapter->scb_list);
4905 out_free_cmd_buffer:
4906 pci_free_consistent(adapter->dev, MEGA_BUFFER_SIZE,
4907 adapter->mega_buffer, adapter->buf_dma_handle);
4908 out_host_put:
4909 scsi_host_put(host);
4910 out_iounmap:
4911 if (flag & BOARD_MEMMAP)
4912 iounmap((void *)mega_baseport);
4913 out_release_region:
4914 if (flag & BOARD_MEMMAP)
4915 release_mem_region(tbase, 128);
4916 else
4917 release_region(mega_baseport, 16);
4918 out_disable_device:
4919 pci_disable_device(pdev);
4920 out:
4921 return error;
4922 }
4923
4924 static void
4925 __megaraid_shutdown(adapter_t *adapter)
4926 {
4927 u_char raw_mbox[sizeof(struct mbox_out)];
4928 mbox_t *mbox = (mbox_t *)raw_mbox;
4929 int i;
4930
4931 /* Flush adapter cache */
4932 memset(&mbox->m_out, 0, sizeof(raw_mbox));
4933 raw_mbox[0] = FLUSH_ADAPTER;
4934
4935 free_irq(adapter->host->irq, adapter);
4936
4937 /* Issue a blocking (interrupts disabled) command to the card */
4938 issue_scb_block(adapter, raw_mbox);
4939
4940 /* Flush disks cache */
4941 memset(&mbox->m_out, 0, sizeof(raw_mbox));
4942 raw_mbox[0] = FLUSH_SYSTEM;
4943
4944 /* Issue a blocking (interrupts disabled) command to the card */
4945 issue_scb_block(adapter, raw_mbox);
4946
4947 if (atomic_read(&adapter->pend_cmds) > 0)
4948 printk(KERN_WARNING "megaraid: pending commands!!\n");
4949
4950 /*
4951 * Have a delibrate delay to make sure all the caches are
4952 * actually flushed.
4953 */
4954 for (i = 0; i <= 10; i++)
4955 mdelay(1000);
4956 }
4957
4958 static void
4959 megaraid_remove_one(struct pci_dev *pdev)
4960 {
4961 struct Scsi_Host *host = pci_get_drvdata(pdev);
4962 adapter_t *adapter = (adapter_t *)host->hostdata;
4963 char buf[12] = { 0 };
4964
4965 scsi_remove_host(host);
4966
4967 __megaraid_shutdown(adapter);
4968
4969 /* Free our resources */
4970 if (adapter->flag & BOARD_MEMMAP) {
4971 iounmap((void *)adapter->base);
4972 release_mem_region(adapter->host->base, 128);
4973 } else
4974 release_region(adapter->base, 16);
4975
4976 mega_free_sgl(adapter);
4977
4978 #ifdef CONFIG_PROC_FS
4979 if (adapter->controller_proc_dir_entry) {
4980 remove_proc_entry("stat", adapter->controller_proc_dir_entry);
4981 remove_proc_entry("config",
4982 adapter->controller_proc_dir_entry);
4983 remove_proc_entry("mailbox",
4984 adapter->controller_proc_dir_entry);
4985 #if MEGA_HAVE_ENH_PROC
4986 remove_proc_entry("rebuild-rate",
4987 adapter->controller_proc_dir_entry);
4988 remove_proc_entry("battery-status",
4989 adapter->controller_proc_dir_entry);
4990
4991 remove_proc_entry("diskdrives-ch0",
4992 adapter->controller_proc_dir_entry);
4993 remove_proc_entry("diskdrives-ch1",
4994 adapter->controller_proc_dir_entry);
4995 remove_proc_entry("diskdrives-ch2",
4996 adapter->controller_proc_dir_entry);
4997 remove_proc_entry("diskdrives-ch3",
4998 adapter->controller_proc_dir_entry);
4999
5000 remove_proc_entry("raiddrives-0-9",
5001 adapter->controller_proc_dir_entry);
5002 remove_proc_entry("raiddrives-10-19",
5003 adapter->controller_proc_dir_entry);
5004 remove_proc_entry("raiddrives-20-29",
5005 adapter->controller_proc_dir_entry);
5006 remove_proc_entry("raiddrives-30-39",
5007 adapter->controller_proc_dir_entry);
5008 #endif
5009 sprintf(buf, "hba%d", adapter->host->host_no);
5010 remove_proc_entry(buf, mega_proc_dir_entry);
5011 }
5012 #endif
5013
5014 pci_free_consistent(adapter->dev, MEGA_BUFFER_SIZE,
5015 adapter->mega_buffer, adapter->buf_dma_handle);
5016 kfree(adapter->scb_list);
5017 pci_free_consistent(adapter->dev, sizeof(mbox64_t),
5018 adapter->una_mbox64, adapter->una_mbox64_dma);
5019
5020 scsi_host_put(host);
5021 pci_disable_device(pdev);
5022
5023 hba_count--;
5024 }
5025
5026 static void
5027 megaraid_shutdown(struct device *dev)
5028 {
5029 struct Scsi_Host *host = pci_get_drvdata(to_pci_dev(dev));
5030 adapter_t *adapter = (adapter_t *)host->hostdata;
5031
5032 __megaraid_shutdown(adapter);
5033 }
5034
5035 static struct pci_device_id megaraid_pci_tbl[] = {
5036 {PCI_VENDOR_ID_DELL, PCI_DEVICE_ID_DISCOVERY,
5037 PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0},
5038 {PCI_VENDOR_ID_DELL, PCI_DEVICE_ID_PERC4_DI,
5039 PCI_ANY_ID, PCI_ANY_ID, 0, 0, BOARD_64BIT},
5040 {PCI_VENDOR_ID_LSI_LOGIC, PCI_DEVICE_ID_PERC4_QC_VERDE,
5041 PCI_ANY_ID, PCI_ANY_ID, 0, 0, BOARD_64BIT},
5042 {PCI_VENDOR_ID_AMI, PCI_DEVICE_ID_AMI_MEGARAID,
5043 PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0},
5044 {PCI_VENDOR_ID_AMI, PCI_DEVICE_ID_AMI_MEGARAID2,
5045 PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0},
5046 {PCI_VENDOR_ID_AMI, PCI_DEVICE_ID_AMI_MEGARAID3,
5047 PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0},
5048 {PCI_VENDOR_ID_INTEL, PCI_DEVICE_ID_AMI_MEGARAID3,
5049 PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0},
5050 {PCI_VENDOR_ID_LSI_LOGIC, PCI_DEVICE_ID_AMI_MEGARAID3,
5051 PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0},
5052 {0,}
5053 };
5054 MODULE_DEVICE_TABLE(pci, megaraid_pci_tbl);
5055
5056 static struct pci_driver megaraid_pci_driver = {
5057 .name = "megaraid",
5058 .id_table = megaraid_pci_tbl,
5059 .probe = megaraid_probe_one,
5060 .remove = __devexit_p(megaraid_remove_one),
5061 .driver = {
5062 .shutdown = megaraid_shutdown,
5063 },
5064 };
5065
5066 static int __init megaraid_init(void)
5067 {
5068 int error;
5069
5070 if ((max_cmd_per_lun <= 0) || (max_cmd_per_lun > MAX_CMD_PER_LUN))
5071 max_cmd_per_lun = MAX_CMD_PER_LUN;
5072 if (max_mbox_busy_wait > MBOX_BUSY_WAIT)
5073 max_mbox_busy_wait = MBOX_BUSY_WAIT;
5074
5075 #ifdef CONFIG_PROC_FS
5076 mega_proc_dir_entry = proc_mkdir("megaraid", &proc_root);
5077 if (!mega_proc_dir_entry) {
5078 printk(KERN_WARNING
5079 "megaraid: failed to create megaraid root\n");
5080 }
5081 #endif
5082 error = pci_module_init(&megaraid_pci_driver);
5083 if (error) {
5084 #ifdef CONFIG_PROC_FS
5085 remove_proc_entry("megaraid", &proc_root);
5086 #endif
5087 return error;
5088 }
5089
5090 /*
5091 * Register the driver as a character device, for applications
5092 * to access it for ioctls.
5093 * First argument (major) to register_chrdev implies a dynamic
5094 * major number allocation.
5095 */
5096 major = register_chrdev(0, "megadev", &megadev_fops);
5097 if (!major) {
5098 printk(KERN_WARNING
5099 "megaraid: failed to register char device\n");
5100 }
5101
5102 return 0;
5103 }
5104
5105 static void __exit megaraid_exit(void)
5106 {
5107 /*
5108 * Unregister the character device interface to the driver.
5109 */
5110 unregister_chrdev(major, "megadev");
5111
5112 pci_unregister_driver(&megaraid_pci_driver);
5113
5114 #ifdef CONFIG_PROC_FS
5115 remove_proc_entry("megaraid", &proc_root);
5116 #endif
5117 }
5118
5119 module_init(megaraid_init);
5120 module_exit(megaraid_exit);
5121
5122 /* vi: set ts=8 sw=8 tw=78: */