1 /* 2 * libata-scsi.c - helper library for ATA 3 * 4 * Maintained by: Jeff Garzik <jgarzik@pobox.com> 5 * Please ALWAYS copy linux-ide@vger.kernel.org 6 * on emails. 7 * 8 * Copyright 2003-2004 Red Hat, Inc. All rights reserved. 9 * Copyright 2003-2004 Jeff Garzik 10 * 11 * 12 * This program is free software; you can redistribute it and/or modify 13 * it under the terms of the GNU General Public License as published by 14 * the Free Software Foundation; either version 2, or (at your option) 15 * any later version. 16 * 17 * This program is distributed in the hope that it will be useful, 18 * but WITHOUT ANY WARRANTY; without even the implied warranty of 19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 20 * GNU General Public License for more details. 21 * 22 * You should have received a copy of the GNU General Public License 23 * along with this program; see the file COPYING. If not, write to 24 * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. 25 * 26 * 27 * libata documentation is available via 'make {ps|pdf}docs', 28 * as Documentation/DocBook/libata.* 29 * 30 * Hardware documentation available from 31 * - http://www.t10.org/ 32 * - http://www.t13.org/ 33 * 34 */ 35 36 #include <linux/kernel.h> 37 #include <linux/blkdev.h> 38 #include <linux/spinlock.h> 39 #include <scsi/scsi.h> 40 #include <scsi/scsi_host.h> 41 #include <scsi/scsi_cmnd.h> 42 #include <scsi/scsi_eh.h> 43 #include <scsi/scsi_device.h> 44 #include <scsi/scsi_tcq.h> 45 #include <scsi/scsi_transport.h> 46 #include <linux/libata.h> 47 #include <linux/hdreg.h> 48 #include <asm/uaccess.h> 49 50 #include "libata.h" 51 52 #define SECTOR_SIZE 512 53 54 typedef unsigned int (*ata_xlat_func_t)(struct ata_queued_cmd *qc); 55 56 static struct ata_device * __ata_scsi_find_dev(struct ata_port *ap, 57 const struct scsi_device *scsidev); 58 static struct ata_device * ata_scsi_find_dev(struct ata_port *ap, 59 const struct scsi_device *scsidev); 60 static int ata_scsi_user_scan(struct Scsi_Host *shost, unsigned int channel, 61 unsigned int id, unsigned int lun); 62 63 64 #define RW_RECOVERY_MPAGE 0x1 65 #define RW_RECOVERY_MPAGE_LEN 12 66 #define CACHE_MPAGE 0x8 67 #define CACHE_MPAGE_LEN 20 68 #define CONTROL_MPAGE 0xa 69 #define CONTROL_MPAGE_LEN 12 70 #define ALL_MPAGES 0x3f 71 #define ALL_SUB_MPAGES 0xff 72 73 74 static const u8 def_rw_recovery_mpage[] = { 75 RW_RECOVERY_MPAGE, 76 RW_RECOVERY_MPAGE_LEN - 2, 77 (1 << 7) | /* AWRE, sat-r06 say it shall be 0 */ 78 (1 << 6), /* ARRE (auto read reallocation) */ 79 0, /* read retry count */ 80 0, 0, 0, 0, 81 0, /* write retry count */ 82 0, 0, 0 83 }; 84 85 static const u8 def_cache_mpage[CACHE_MPAGE_LEN] = { 86 CACHE_MPAGE, 87 CACHE_MPAGE_LEN - 2, 88 0, /* contains WCE, needs to be 0 for logic */ 89 0, 0, 0, 0, 0, 0, 0, 0, 0, 90 0, /* contains DRA, needs to be 0 for logic */ 91 0, 0, 0, 0, 0, 0, 0 92 }; 93 94 static const u8 def_control_mpage[CONTROL_MPAGE_LEN] = { 95 CONTROL_MPAGE, 96 CONTROL_MPAGE_LEN - 2, 97 2, /* DSENSE=0, GLTSD=1 */ 98 0, /* [QAM+QERR may be 1, see 05-359r1] */ 99 0, 0, 0, 0, 0xff, 0xff, 100 0, 30 /* extended self test time, see 05-359r1 */ 101 }; 102 103 /* 104 * libata transport template. libata doesn't do real transport stuff. 105 * It just needs the eh_timed_out hook. 106 */ 107 static struct scsi_transport_template ata_scsi_transport_template = { 108 .eh_strategy_handler = ata_scsi_error, 109 .eh_timed_out = ata_scsi_timed_out, 110 .user_scan = ata_scsi_user_scan, 111 }; 112 113 114 static void ata_scsi_invalid_field(struct scsi_cmnd *cmd, 115 void (*done)(struct scsi_cmnd *)) 116 { 117 ata_scsi_set_sense(cmd, ILLEGAL_REQUEST, 0x24, 0x0); 118 /* "Invalid field in cbd" */ 119 done(cmd); 120 } 121 122 /** 123 * ata_std_bios_param - generic bios head/sector/cylinder calculator used by sd. 124 * @sdev: SCSI device for which BIOS geometry is to be determined 125 * @bdev: block device associated with @sdev 126 * @capacity: capacity of SCSI device 127 * @geom: location to which geometry will be output 128 * 129 * Generic bios head/sector/cylinder calculator 130 * used by sd. Most BIOSes nowadays expect a XXX/255/16 (CHS) 131 * mapping. Some situations may arise where the disk is not 132 * bootable if this is not used. 133 * 134 * LOCKING: 135 * Defined by the SCSI layer. We don't really care. 136 * 137 * RETURNS: 138 * Zero. 139 */ 140 int ata_std_bios_param(struct scsi_device *sdev, struct block_device *bdev, 141 sector_t capacity, int geom[]) 142 { 143 geom[0] = 255; 144 geom[1] = 63; 145 sector_div(capacity, 255*63); 146 geom[2] = capacity; 147 148 return 0; 149 } 150 151 /** 152 * ata_get_identity - Handler for HDIO_GET_IDENTITY ioctl 153 * @sdev: SCSI device to get identify data for 154 * @arg: User buffer area for identify data 155 * 156 * LOCKING: 157 * Defined by the SCSI layer. We don't really care. 158 * 159 * RETURNS: 160 * Zero on success, negative errno on error. 161 */ 162 static int ata_get_identity(struct scsi_device *sdev, void __user *arg) 163 { 164 struct ata_port *ap = ata_shost_to_port(sdev->host); 165 struct ata_device *dev = ata_scsi_find_dev(ap, sdev); 166 u16 __user *dst = arg; 167 char buf[40]; 168 169 if (!dev) 170 return -ENOMSG; 171 172 if (copy_to_user(dst, dev->id, ATA_ID_WORDS * sizeof(u16))) 173 return -EFAULT; 174 175 ata_id_string(dev->id, buf, ATA_ID_PROD, ATA_ID_PROD_LEN); 176 if (copy_to_user(dst + ATA_ID_PROD, buf, ATA_ID_PROD_LEN)) 177 return -EFAULT; 178 179 ata_id_string(dev->id, buf, ATA_ID_FW_REV, ATA_ID_FW_REV_LEN); 180 if (copy_to_user(dst + ATA_ID_FW_REV, buf, ATA_ID_FW_REV_LEN)) 181 return -EFAULT; 182 183 ata_id_string(dev->id, buf, ATA_ID_SERNO, ATA_ID_SERNO_LEN); 184 if (copy_to_user(dst + ATA_ID_SERNO, buf, ATA_ID_SERNO_LEN)) 185 return -EFAULT; 186 187 return 0; 188 } 189 190 /** 191 * ata_cmd_ioctl - Handler for HDIO_DRIVE_CMD ioctl 192 * @scsidev: Device to which we are issuing command 193 * @arg: User provided data for issuing command 194 * 195 * LOCKING: 196 * Defined by the SCSI layer. We don't really care. 197 * 198 * RETURNS: 199 * Zero on success, negative errno on error. 200 */ 201 int ata_cmd_ioctl(struct scsi_device *scsidev, void __user *arg) 202 { 203 int rc = 0; 204 u8 scsi_cmd[MAX_COMMAND_SIZE]; 205 u8 args[4], *argbuf = NULL, *sensebuf = NULL; 206 int argsize = 0; 207 enum dma_data_direction data_dir; 208 int cmd_result; 209 210 if (arg == NULL) 211 return -EINVAL; 212 213 if (copy_from_user(args, arg, sizeof(args))) 214 return -EFAULT; 215 216 sensebuf = kzalloc(SCSI_SENSE_BUFFERSIZE, GFP_NOIO); 217 if (!sensebuf) 218 return -ENOMEM; 219 220 memset(scsi_cmd, 0, sizeof(scsi_cmd)); 221 222 if (args[3]) { 223 argsize = SECTOR_SIZE * args[3]; 224 argbuf = kmalloc(argsize, GFP_KERNEL); 225 if (argbuf == NULL) { 226 rc = -ENOMEM; 227 goto error; 228 } 229 230 scsi_cmd[1] = (4 << 1); /* PIO Data-in */ 231 scsi_cmd[2] = 0x0e; /* no off.line or cc, read from dev, 232 block count in sector count field */ 233 data_dir = DMA_FROM_DEVICE; 234 } else { 235 scsi_cmd[1] = (3 << 1); /* Non-data */ 236 scsi_cmd[2] = 0x20; /* cc but no off.line or data xfer */ 237 data_dir = DMA_NONE; 238 } 239 240 scsi_cmd[0] = ATA_16; 241 242 scsi_cmd[4] = args[2]; 243 if (args[0] == WIN_SMART) { /* hack -- ide driver does this too... */ 244 scsi_cmd[6] = args[3]; 245 scsi_cmd[8] = args[1]; 246 scsi_cmd[10] = 0x4f; 247 scsi_cmd[12] = 0xc2; 248 } else { 249 scsi_cmd[6] = args[1]; 250 } 251 scsi_cmd[14] = args[0]; 252 253 /* Good values for timeout and retries? Values below 254 from scsi_ioctl_send_command() for default case... */ 255 cmd_result = scsi_execute(scsidev, scsi_cmd, data_dir, argbuf, argsize, 256 sensebuf, (10*HZ), 5, 0); 257 258 if (driver_byte(cmd_result) == DRIVER_SENSE) {/* sense data available */ 259 u8 *desc = sensebuf + 8; 260 cmd_result &= ~(0xFF<<24); /* DRIVER_SENSE is not an error */ 261 262 /* If we set cc then ATA pass-through will cause a 263 * check condition even if no error. Filter that. */ 264 if (cmd_result & SAM_STAT_CHECK_CONDITION) { 265 struct scsi_sense_hdr sshdr; 266 scsi_normalize_sense(sensebuf, SCSI_SENSE_BUFFERSIZE, 267 &sshdr); 268 if (sshdr.sense_key==0 && 269 sshdr.asc==0 && sshdr.ascq==0) 270 cmd_result &= ~SAM_STAT_CHECK_CONDITION; 271 } 272 273 /* Send userspace a few ATA registers (same as drivers/ide) */ 274 if (sensebuf[0] == 0x72 && /* format is "descriptor" */ 275 desc[0] == 0x09 ) { /* code is "ATA Descriptor" */ 276 args[0] = desc[13]; /* status */ 277 args[1] = desc[3]; /* error */ 278 args[2] = desc[5]; /* sector count (0:7) */ 279 if (copy_to_user(arg, args, sizeof(args))) 280 rc = -EFAULT; 281 } 282 } 283 284 285 if (cmd_result) { 286 rc = -EIO; 287 goto error; 288 } 289 290 if ((argbuf) 291 && copy_to_user(arg + sizeof(args), argbuf, argsize)) 292 rc = -EFAULT; 293 error: 294 kfree(sensebuf); 295 kfree(argbuf); 296 return rc; 297 } 298 299 /** 300 * ata_task_ioctl - Handler for HDIO_DRIVE_TASK ioctl 301 * @scsidev: Device to which we are issuing command 302 * @arg: User provided data for issuing command 303 * 304 * LOCKING: 305 * Defined by the SCSI layer. We don't really care. 306 * 307 * RETURNS: 308 * Zero on success, negative errno on error. 309 */ 310 int ata_task_ioctl(struct scsi_device *scsidev, void __user *arg) 311 { 312 int rc = 0; 313 u8 scsi_cmd[MAX_COMMAND_SIZE]; 314 u8 args[7], *sensebuf = NULL; 315 int cmd_result; 316 317 if (arg == NULL) 318 return -EINVAL; 319 320 if (copy_from_user(args, arg, sizeof(args))) 321 return -EFAULT; 322 323 sensebuf = kzalloc(SCSI_SENSE_BUFFERSIZE, GFP_NOIO); 324 if (!sensebuf) 325 return -ENOMEM; 326 327 memset(scsi_cmd, 0, sizeof(scsi_cmd)); 328 scsi_cmd[0] = ATA_16; 329 scsi_cmd[1] = (3 << 1); /* Non-data */ 330 scsi_cmd[2] = 0x20; /* cc but no off.line or data xfer */ 331 scsi_cmd[4] = args[1]; 332 scsi_cmd[6] = args[2]; 333 scsi_cmd[8] = args[3]; 334 scsi_cmd[10] = args[4]; 335 scsi_cmd[12] = args[5]; 336 scsi_cmd[13] = args[6] & 0x4f; 337 scsi_cmd[14] = args[0]; 338 339 /* Good values for timeout and retries? Values below 340 from scsi_ioctl_send_command() for default case... */ 341 cmd_result = scsi_execute(scsidev, scsi_cmd, DMA_NONE, NULL, 0, 342 sensebuf, (10*HZ), 5, 0); 343 344 if (driver_byte(cmd_result) == DRIVER_SENSE) {/* sense data available */ 345 u8 *desc = sensebuf + 8; 346 cmd_result &= ~(0xFF<<24); /* DRIVER_SENSE is not an error */ 347 348 /* If we set cc then ATA pass-through will cause a 349 * check condition even if no error. Filter that. */ 350 if (cmd_result & SAM_STAT_CHECK_CONDITION) { 351 struct scsi_sense_hdr sshdr; 352 scsi_normalize_sense(sensebuf, SCSI_SENSE_BUFFERSIZE, 353 &sshdr); 354 if (sshdr.sense_key==0 && 355 sshdr.asc==0 && sshdr.ascq==0) 356 cmd_result &= ~SAM_STAT_CHECK_CONDITION; 357 } 358 359 /* Send userspace ATA registers */ 360 if (sensebuf[0] == 0x72 && /* format is "descriptor" */ 361 desc[0] == 0x09) {/* code is "ATA Descriptor" */ 362 args[0] = desc[13]; /* status */ 363 args[1] = desc[3]; /* error */ 364 args[2] = desc[5]; /* sector count (0:7) */ 365 args[3] = desc[7]; /* lbal */ 366 args[4] = desc[9]; /* lbam */ 367 args[5] = desc[11]; /* lbah */ 368 args[6] = desc[12]; /* select */ 369 if (copy_to_user(arg, args, sizeof(args))) 370 rc = -EFAULT; 371 } 372 } 373 374 if (cmd_result) { 375 rc = -EIO; 376 goto error; 377 } 378 379 error: 380 kfree(sensebuf); 381 return rc; 382 } 383 384 int ata_scsi_ioctl(struct scsi_device *scsidev, int cmd, void __user *arg) 385 { 386 int val = -EINVAL, rc = -EINVAL; 387 388 switch (cmd) { 389 case ATA_IOC_GET_IO32: 390 val = 0; 391 if (copy_to_user(arg, &val, 1)) 392 return -EFAULT; 393 return 0; 394 395 case ATA_IOC_SET_IO32: 396 val = (unsigned long) arg; 397 if (val != 0) 398 return -EINVAL; 399 return 0; 400 401 case HDIO_GET_IDENTITY: 402 return ata_get_identity(scsidev, arg); 403 404 case HDIO_DRIVE_CMD: 405 if (!capable(CAP_SYS_ADMIN) || !capable(CAP_SYS_RAWIO)) 406 return -EACCES; 407 return ata_cmd_ioctl(scsidev, arg); 408 409 case HDIO_DRIVE_TASK: 410 if (!capable(CAP_SYS_ADMIN) || !capable(CAP_SYS_RAWIO)) 411 return -EACCES; 412 return ata_task_ioctl(scsidev, arg); 413 414 default: 415 rc = -ENOTTY; 416 break; 417 } 418 419 return rc; 420 } 421 422 /** 423 * ata_scsi_qc_new - acquire new ata_queued_cmd reference 424 * @dev: ATA device to which the new command is attached 425 * @cmd: SCSI command that originated this ATA command 426 * @done: SCSI command completion function 427 * 428 * Obtain a reference to an unused ata_queued_cmd structure, 429 * which is the basic libata structure representing a single 430 * ATA command sent to the hardware. 431 * 432 * If a command was available, fill in the SCSI-specific 433 * portions of the structure with information on the 434 * current command. 435 * 436 * LOCKING: 437 * spin_lock_irqsave(host lock) 438 * 439 * RETURNS: 440 * Command allocated, or %NULL if none available. 441 */ 442 static struct ata_queued_cmd *ata_scsi_qc_new(struct ata_device *dev, 443 struct scsi_cmnd *cmd, 444 void (*done)(struct scsi_cmnd *)) 445 { 446 struct ata_queued_cmd *qc; 447 448 qc = ata_qc_new_init(dev); 449 if (qc) { 450 qc->scsicmd = cmd; 451 qc->scsidone = done; 452 453 if (cmd->use_sg) { 454 qc->__sg = (struct scatterlist *) cmd->request_buffer; 455 qc->n_elem = cmd->use_sg; 456 } else if (cmd->request_bufflen) { 457 qc->__sg = &qc->sgent; 458 qc->n_elem = 1; 459 } 460 } else { 461 cmd->result = (DID_OK << 16) | (QUEUE_FULL << 1); 462 done(cmd); 463 } 464 465 return qc; 466 } 467 468 /** 469 * ata_dump_status - user friendly display of error info 470 * @id: id of the port in question 471 * @tf: ptr to filled out taskfile 472 * 473 * Decode and dump the ATA error/status registers for the user so 474 * that they have some idea what really happened at the non 475 * make-believe layer. 476 * 477 * LOCKING: 478 * inherited from caller 479 */ 480 static void ata_dump_status(unsigned id, struct ata_taskfile *tf) 481 { 482 u8 stat = tf->command, err = tf->feature; 483 484 printk(KERN_WARNING "ata%u: status=0x%02x { ", id, stat); 485 if (stat & ATA_BUSY) { 486 printk("Busy }\n"); /* Data is not valid in this case */ 487 } else { 488 if (stat & 0x40) printk("DriveReady "); 489 if (stat & 0x20) printk("DeviceFault "); 490 if (stat & 0x10) printk("SeekComplete "); 491 if (stat & 0x08) printk("DataRequest "); 492 if (stat & 0x04) printk("CorrectedError "); 493 if (stat & 0x02) printk("Index "); 494 if (stat & 0x01) printk("Error "); 495 printk("}\n"); 496 497 if (err) { 498 printk(KERN_WARNING "ata%u: error=0x%02x { ", id, err); 499 if (err & 0x04) printk("DriveStatusError "); 500 if (err & 0x80) { 501 if (err & 0x04) printk("BadCRC "); 502 else printk("Sector "); 503 } 504 if (err & 0x40) printk("UncorrectableError "); 505 if (err & 0x10) printk("SectorIdNotFound "); 506 if (err & 0x02) printk("TrackZeroNotFound "); 507 if (err & 0x01) printk("AddrMarkNotFound "); 508 printk("}\n"); 509 } 510 } 511 } 512 513 /** 514 * ata_to_sense_error - convert ATA error to SCSI error 515 * @id: ATA device number 516 * @drv_stat: value contained in ATA status register 517 * @drv_err: value contained in ATA error register 518 * @sk: the sense key we'll fill out 519 * @asc: the additional sense code we'll fill out 520 * @ascq: the additional sense code qualifier we'll fill out 521 * @verbose: be verbose 522 * 523 * Converts an ATA error into a SCSI error. Fill out pointers to 524 * SK, ASC, and ASCQ bytes for later use in fixed or descriptor 525 * format sense blocks. 526 * 527 * LOCKING: 528 * spin_lock_irqsave(host lock) 529 */ 530 static void ata_to_sense_error(unsigned id, u8 drv_stat, u8 drv_err, u8 *sk, 531 u8 *asc, u8 *ascq, int verbose) 532 { 533 int i; 534 535 /* Based on the 3ware driver translation table */ 536 static const unsigned char sense_table[][4] = { 537 /* BBD|ECC|ID|MAR */ 538 {0xd1, ABORTED_COMMAND, 0x00, 0x00}, // Device busy Aborted command 539 /* BBD|ECC|ID */ 540 {0xd0, ABORTED_COMMAND, 0x00, 0x00}, // Device busy Aborted command 541 /* ECC|MC|MARK */ 542 {0x61, HARDWARE_ERROR, 0x00, 0x00}, // Device fault Hardware error 543 /* ICRC|ABRT */ /* NB: ICRC & !ABRT is BBD */ 544 {0x84, ABORTED_COMMAND, 0x47, 0x00}, // Data CRC error SCSI parity error 545 /* MC|ID|ABRT|TRK0|MARK */ 546 {0x37, NOT_READY, 0x04, 0x00}, // Unit offline Not ready 547 /* MCR|MARK */ 548 {0x09, NOT_READY, 0x04, 0x00}, // Unrecovered disk error Not ready 549 /* Bad address mark */ 550 {0x01, MEDIUM_ERROR, 0x13, 0x00}, // Address mark not found Address mark not found for data field 551 /* TRK0 */ 552 {0x02, HARDWARE_ERROR, 0x00, 0x00}, // Track 0 not found Hardware error 553 /* Abort & !ICRC */ 554 {0x04, ABORTED_COMMAND, 0x00, 0x00}, // Aborted command Aborted command 555 /* Media change request */ 556 {0x08, NOT_READY, 0x04, 0x00}, // Media change request FIXME: faking offline 557 /* SRV */ 558 {0x10, ABORTED_COMMAND, 0x14, 0x00}, // ID not found Recorded entity not found 559 /* Media change */ 560 {0x08, NOT_READY, 0x04, 0x00}, // Media change FIXME: faking offline 561 /* ECC */ 562 {0x40, MEDIUM_ERROR, 0x11, 0x04}, // Uncorrectable ECC error Unrecovered read error 563 /* BBD - block marked bad */ 564 {0x80, MEDIUM_ERROR, 0x11, 0x04}, // Block marked bad Medium error, unrecovered read error 565 {0xFF, 0xFF, 0xFF, 0xFF}, // END mark 566 }; 567 static const unsigned char stat_table[][4] = { 568 /* Must be first because BUSY means no other bits valid */ 569 {0x80, ABORTED_COMMAND, 0x47, 0x00}, // Busy, fake parity for now 570 {0x20, HARDWARE_ERROR, 0x00, 0x00}, // Device fault 571 {0x08, ABORTED_COMMAND, 0x47, 0x00}, // Timed out in xfer, fake parity for now 572 {0x04, RECOVERED_ERROR, 0x11, 0x00}, // Recovered ECC error Medium error, recovered 573 {0xFF, 0xFF, 0xFF, 0xFF}, // END mark 574 }; 575 576 /* 577 * Is this an error we can process/parse 578 */ 579 if (drv_stat & ATA_BUSY) { 580 drv_err = 0; /* Ignore the err bits, they're invalid */ 581 } 582 583 if (drv_err) { 584 /* Look for drv_err */ 585 for (i = 0; sense_table[i][0] != 0xFF; i++) { 586 /* Look for best matches first */ 587 if ((sense_table[i][0] & drv_err) == 588 sense_table[i][0]) { 589 *sk = sense_table[i][1]; 590 *asc = sense_table[i][2]; 591 *ascq = sense_table[i][3]; 592 goto translate_done; 593 } 594 } 595 /* No immediate match */ 596 if (verbose) 597 printk(KERN_WARNING "ata%u: no sense translation for " 598 "error 0x%02x\n", id, drv_err); 599 } 600 601 /* Fall back to interpreting status bits */ 602 for (i = 0; stat_table[i][0] != 0xFF; i++) { 603 if (stat_table[i][0] & drv_stat) { 604 *sk = stat_table[i][1]; 605 *asc = stat_table[i][2]; 606 *ascq = stat_table[i][3]; 607 goto translate_done; 608 } 609 } 610 /* No error? Undecoded? */ 611 if (verbose) 612 printk(KERN_WARNING "ata%u: no sense translation for " 613 "status: 0x%02x\n", id, drv_stat); 614 615 /* We need a sensible error return here, which is tricky, and one 616 that won't cause people to do things like return a disk wrongly */ 617 *sk = ABORTED_COMMAND; 618 *asc = 0x00; 619 *ascq = 0x00; 620 621 translate_done: 622 if (verbose) 623 printk(KERN_ERR "ata%u: translated ATA stat/err 0x%02x/%02x " 624 "to SCSI SK/ASC/ASCQ 0x%x/%02x/%02x\n", 625 id, drv_stat, drv_err, *sk, *asc, *ascq); 626 return; 627 } 628 629 /* 630 * ata_gen_passthru_sense - Generate check condition sense block. 631 * @qc: Command that completed. 632 * 633 * This function is specific to the ATA descriptor format sense 634 * block specified for the ATA pass through commands. Regardless 635 * of whether the command errored or not, return a sense 636 * block. Copy all controller registers into the sense 637 * block. Clear sense key, ASC & ASCQ if there is no error. 638 * 639 * LOCKING: 640 * None. 641 */ 642 static void ata_gen_passthru_sense(struct ata_queued_cmd *qc) 643 { 644 struct scsi_cmnd *cmd = qc->scsicmd; 645 struct ata_taskfile *tf = &qc->result_tf; 646 unsigned char *sb = cmd->sense_buffer; 647 unsigned char *desc = sb + 8; 648 int verbose = qc->ap->ops->error_handler == NULL; 649 650 memset(sb, 0, SCSI_SENSE_BUFFERSIZE); 651 652 cmd->result = (DRIVER_SENSE << 24) | SAM_STAT_CHECK_CONDITION; 653 654 /* 655 * Use ata_to_sense_error() to map status register bits 656 * onto sense key, asc & ascq. 657 */ 658 if (qc->err_mask || 659 tf->command & (ATA_BUSY | ATA_DF | ATA_ERR | ATA_DRQ)) { 660 ata_to_sense_error(qc->ap->print_id, tf->command, tf->feature, 661 &sb[1], &sb[2], &sb[3], verbose); 662 sb[1] &= 0x0f; 663 } 664 665 /* 666 * Sense data is current and format is descriptor. 667 */ 668 sb[0] = 0x72; 669 670 desc[0] = 0x09; 671 672 /* set length of additional sense data */ 673 sb[7] = 14; 674 desc[1] = 12; 675 676 /* 677 * Copy registers into sense buffer. 678 */ 679 desc[2] = 0x00; 680 desc[3] = tf->feature; /* == error reg */ 681 desc[5] = tf->nsect; 682 desc[7] = tf->lbal; 683 desc[9] = tf->lbam; 684 desc[11] = tf->lbah; 685 desc[12] = tf->device; 686 desc[13] = tf->command; /* == status reg */ 687 688 /* 689 * Fill in Extend bit, and the high order bytes 690 * if applicable. 691 */ 692 if (tf->flags & ATA_TFLAG_LBA48) { 693 desc[2] |= 0x01; 694 desc[4] = tf->hob_nsect; 695 desc[6] = tf->hob_lbal; 696 desc[8] = tf->hob_lbam; 697 desc[10] = tf->hob_lbah; 698 } 699 } 700 701 /** 702 * ata_gen_ata_sense - generate a SCSI fixed sense block 703 * @qc: Command that we are erroring out 704 * 705 * Generate sense block for a failed ATA command @qc. Descriptor 706 * format is used to accomodate LBA48 block address. 707 * 708 * LOCKING: 709 * None. 710 */ 711 static void ata_gen_ata_sense(struct ata_queued_cmd *qc) 712 { 713 struct ata_device *dev = qc->dev; 714 struct scsi_cmnd *cmd = qc->scsicmd; 715 struct ata_taskfile *tf = &qc->result_tf; 716 unsigned char *sb = cmd->sense_buffer; 717 unsigned char *desc = sb + 8; 718 int verbose = qc->ap->ops->error_handler == NULL; 719 u64 block; 720 721 memset(sb, 0, SCSI_SENSE_BUFFERSIZE); 722 723 cmd->result = (DRIVER_SENSE << 24) | SAM_STAT_CHECK_CONDITION; 724 725 /* sense data is current and format is descriptor */ 726 sb[0] = 0x72; 727 728 /* Use ata_to_sense_error() to map status register bits 729 * onto sense key, asc & ascq. 730 */ 731 if (qc->err_mask || 732 tf->command & (ATA_BUSY | ATA_DF | ATA_ERR | ATA_DRQ)) { 733 ata_to_sense_error(qc->ap->print_id, tf->command, tf->feature, 734 &sb[1], &sb[2], &sb[3], verbose); 735 sb[1] &= 0x0f; 736 } 737 738 block = ata_tf_read_block(&qc->result_tf, dev); 739 740 /* information sense data descriptor */ 741 sb[7] = 12; 742 desc[0] = 0x00; 743 desc[1] = 10; 744 745 desc[2] |= 0x80; /* valid */ 746 desc[6] = block >> 40; 747 desc[7] = block >> 32; 748 desc[8] = block >> 24; 749 desc[9] = block >> 16; 750 desc[10] = block >> 8; 751 desc[11] = block; 752 } 753 754 static void ata_scsi_sdev_config(struct scsi_device *sdev) 755 { 756 sdev->use_10_for_rw = 1; 757 sdev->use_10_for_ms = 1; 758 } 759 760 static void ata_scsi_dev_config(struct scsi_device *sdev, 761 struct ata_device *dev) 762 { 763 /* configure max sectors */ 764 blk_queue_max_sectors(sdev->request_queue, dev->max_sectors); 765 766 /* SATA DMA transfers must be multiples of 4 byte, so 767 * we need to pad ATAPI transfers using an extra sg. 768 * Decrement max hw segments accordingly. 769 */ 770 if (dev->class == ATA_DEV_ATAPI) { 771 request_queue_t *q = sdev->request_queue; 772 blk_queue_max_hw_segments(q, q->max_hw_segments - 1); 773 } 774 775 if (dev->flags & ATA_DFLAG_NCQ) { 776 int depth; 777 778 depth = min(sdev->host->can_queue, ata_id_queue_depth(dev->id)); 779 depth = min(ATA_MAX_QUEUE - 1, depth); 780 scsi_adjust_queue_depth(sdev, MSG_SIMPLE_TAG, depth); 781 } 782 } 783 784 /** 785 * ata_scsi_slave_config - Set SCSI device attributes 786 * @sdev: SCSI device to examine 787 * 788 * This is called before we actually start reading 789 * and writing to the device, to configure certain 790 * SCSI mid-layer behaviors. 791 * 792 * LOCKING: 793 * Defined by SCSI layer. We don't really care. 794 */ 795 796 int ata_scsi_slave_config(struct scsi_device *sdev) 797 { 798 struct ata_port *ap = ata_shost_to_port(sdev->host); 799 struct ata_device *dev = __ata_scsi_find_dev(ap, sdev); 800 801 ata_scsi_sdev_config(sdev); 802 803 blk_queue_max_phys_segments(sdev->request_queue, LIBATA_MAX_PRD); 804 805 sdev->manage_start_stop = 1; 806 807 if (dev) 808 ata_scsi_dev_config(sdev, dev); 809 810 return 0; /* scsi layer doesn't check return value, sigh */ 811 } 812 813 /** 814 * ata_scsi_slave_destroy - SCSI device is about to be destroyed 815 * @sdev: SCSI device to be destroyed 816 * 817 * @sdev is about to be destroyed for hot/warm unplugging. If 818 * this unplugging was initiated by libata as indicated by NULL 819 * dev->sdev, this function doesn't have to do anything. 820 * Otherwise, SCSI layer initiated warm-unplug is in progress. 821 * Clear dev->sdev, schedule the device for ATA detach and invoke 822 * EH. 823 * 824 * LOCKING: 825 * Defined by SCSI layer. We don't really care. 826 */ 827 void ata_scsi_slave_destroy(struct scsi_device *sdev) 828 { 829 struct ata_port *ap = ata_shost_to_port(sdev->host); 830 unsigned long flags; 831 struct ata_device *dev; 832 833 if (!ap->ops->error_handler) 834 return; 835 836 spin_lock_irqsave(ap->lock, flags); 837 dev = __ata_scsi_find_dev(ap, sdev); 838 if (dev && dev->sdev) { 839 /* SCSI device already in CANCEL state, no need to offline it */ 840 dev->sdev = NULL; 841 dev->flags |= ATA_DFLAG_DETACH; 842 ata_port_schedule_eh(ap); 843 } 844 spin_unlock_irqrestore(ap->lock, flags); 845 } 846 847 /** 848 * ata_scsi_change_queue_depth - SCSI callback for queue depth config 849 * @sdev: SCSI device to configure queue depth for 850 * @queue_depth: new queue depth 851 * 852 * This is libata standard hostt->change_queue_depth callback. 853 * SCSI will call into this callback when user tries to set queue 854 * depth via sysfs. 855 * 856 * LOCKING: 857 * SCSI layer (we don't care) 858 * 859 * RETURNS: 860 * Newly configured queue depth. 861 */ 862 int ata_scsi_change_queue_depth(struct scsi_device *sdev, int queue_depth) 863 { 864 struct ata_port *ap = ata_shost_to_port(sdev->host); 865 struct ata_device *dev; 866 unsigned long flags; 867 868 if (queue_depth < 1 || queue_depth == sdev->queue_depth) 869 return sdev->queue_depth; 870 871 dev = ata_scsi_find_dev(ap, sdev); 872 if (!dev || !ata_dev_enabled(dev)) 873 return sdev->queue_depth; 874 875 /* NCQ enabled? */ 876 spin_lock_irqsave(ap->lock, flags); 877 dev->flags &= ~ATA_DFLAG_NCQ_OFF; 878 if (queue_depth == 1 || !ata_ncq_enabled(dev)) { 879 dev->flags |= ATA_DFLAG_NCQ_OFF; 880 queue_depth = 1; 881 } 882 spin_unlock_irqrestore(ap->lock, flags); 883 884 /* limit and apply queue depth */ 885 queue_depth = min(queue_depth, sdev->host->can_queue); 886 queue_depth = min(queue_depth, ata_id_queue_depth(dev->id)); 887 queue_depth = min(queue_depth, ATA_MAX_QUEUE - 1); 888 889 if (sdev->queue_depth == queue_depth) 890 return -EINVAL; 891 892 scsi_adjust_queue_depth(sdev, MSG_SIMPLE_TAG, queue_depth); 893 return queue_depth; 894 } 895 896 /* XXX: for spindown warning */ 897 static void ata_delayed_done_timerfn(unsigned long arg) 898 { 899 struct scsi_cmnd *scmd = (void *)arg; 900 901 scmd->scsi_done(scmd); 902 } 903 904 /* XXX: for spindown warning */ 905 static void ata_delayed_done(struct scsi_cmnd *scmd) 906 { 907 static struct timer_list timer; 908 909 setup_timer(&timer, ata_delayed_done_timerfn, (unsigned long)scmd); 910 mod_timer(&timer, jiffies + 5 * HZ); 911 } 912 913 /** 914 * ata_scsi_start_stop_xlat - Translate SCSI START STOP UNIT command 915 * @qc: Storage for translated ATA taskfile 916 * 917 * Sets up an ATA taskfile to issue STANDBY (to stop) or READ VERIFY 918 * (to start). Perhaps these commands should be preceded by 919 * CHECK POWER MODE to see what power mode the device is already in. 920 * [See SAT revision 5 at www.t10.org] 921 * 922 * LOCKING: 923 * spin_lock_irqsave(host lock) 924 * 925 * RETURNS: 926 * Zero on success, non-zero on error. 927 */ 928 static unsigned int ata_scsi_start_stop_xlat(struct ata_queued_cmd *qc) 929 { 930 struct scsi_cmnd *scmd = qc->scsicmd; 931 struct ata_taskfile *tf = &qc->tf; 932 const u8 *cdb = scmd->cmnd; 933 934 if (scmd->cmd_len < 5) 935 goto invalid_fld; 936 937 tf->flags |= ATA_TFLAG_DEVICE | ATA_TFLAG_ISADDR; 938 tf->protocol = ATA_PROT_NODATA; 939 if (cdb[1] & 0x1) { 940 ; /* ignore IMMED bit, violates sat-r05 */ 941 } 942 if (cdb[4] & 0x2) 943 goto invalid_fld; /* LOEJ bit set not supported */ 944 if (((cdb[4] >> 4) & 0xf) != 0) 945 goto invalid_fld; /* power conditions not supported */ 946 if (cdb[4] & 0x1) { 947 tf->nsect = 1; /* 1 sector, lba=0 */ 948 949 if (qc->dev->flags & ATA_DFLAG_LBA) { 950 tf->flags |= ATA_TFLAG_LBA; 951 952 tf->lbah = 0x0; 953 tf->lbam = 0x0; 954 tf->lbal = 0x0; 955 tf->device |= ATA_LBA; 956 } else { 957 /* CHS */ 958 tf->lbal = 0x1; /* sect */ 959 tf->lbam = 0x0; /* cyl low */ 960 tf->lbah = 0x0; /* cyl high */ 961 } 962 963 tf->command = ATA_CMD_VERIFY; /* READ VERIFY */ 964 } else { 965 /* XXX: This is for backward compatibility, will be 966 * removed. Read Documentation/feature-removal-schedule.txt 967 * for more info. 968 */ 969 if ((qc->dev->flags & ATA_DFLAG_SPUNDOWN) && 970 (system_state == SYSTEM_HALT || 971 system_state == SYSTEM_POWER_OFF)) { 972 static unsigned long warned = 0; 973 974 if (!test_and_set_bit(0, &warned)) { 975 ata_dev_printk(qc->dev, KERN_WARNING, 976 "DISK MIGHT NOT BE SPUN DOWN PROPERLY. " 977 "UPDATE SHUTDOWN UTILITY\n"); 978 ata_dev_printk(qc->dev, KERN_WARNING, 979 "For more info, visit " 980 "http://linux-ata.org/shutdown.html\n"); 981 982 /* ->scsi_done is not used, use it for 983 * delayed completion. 984 */ 985 scmd->scsi_done = qc->scsidone; 986 qc->scsidone = ata_delayed_done; 987 } 988 scmd->result = SAM_STAT_GOOD; 989 return 1; 990 } 991 992 /* Issue ATA STANDBY IMMEDIATE command */ 993 tf->command = ATA_CMD_STANDBYNOW1; 994 } 995 996 /* 997 * Standby and Idle condition timers could be implemented but that 998 * would require libata to implement the Power condition mode page 999 * and allow the user to change it. Changing mode pages requires 1000 * MODE SELECT to be implemented. 1001 */ 1002 1003 return 0; 1004 1005 invalid_fld: 1006 ata_scsi_set_sense(scmd, ILLEGAL_REQUEST, 0x24, 0x0); 1007 /* "Invalid field in cbd" */ 1008 return 1; 1009 } 1010 1011 1012 /** 1013 * ata_scsi_flush_xlat - Translate SCSI SYNCHRONIZE CACHE command 1014 * @qc: Storage for translated ATA taskfile 1015 * 1016 * Sets up an ATA taskfile to issue FLUSH CACHE or 1017 * FLUSH CACHE EXT. 1018 * 1019 * LOCKING: 1020 * spin_lock_irqsave(host lock) 1021 * 1022 * RETURNS: 1023 * Zero on success, non-zero on error. 1024 */ 1025 static unsigned int ata_scsi_flush_xlat(struct ata_queued_cmd *qc) 1026 { 1027 struct ata_taskfile *tf = &qc->tf; 1028 1029 tf->flags |= ATA_TFLAG_DEVICE; 1030 tf->protocol = ATA_PROT_NODATA; 1031 1032 if (qc->dev->flags & ATA_DFLAG_FLUSH_EXT) 1033 tf->command = ATA_CMD_FLUSH_EXT; 1034 else 1035 tf->command = ATA_CMD_FLUSH; 1036 1037 return 0; 1038 } 1039 1040 /** 1041 * scsi_6_lba_len - Get LBA and transfer length 1042 * @cdb: SCSI command to translate 1043 * 1044 * Calculate LBA and transfer length for 6-byte commands. 1045 * 1046 * RETURNS: 1047 * @plba: the LBA 1048 * @plen: the transfer length 1049 */ 1050 static void scsi_6_lba_len(const u8 *cdb, u64 *plba, u32 *plen) 1051 { 1052 u64 lba = 0; 1053 u32 len; 1054 1055 VPRINTK("six-byte command\n"); 1056 1057 lba |= ((u64)(cdb[1] & 0x1f)) << 16; 1058 lba |= ((u64)cdb[2]) << 8; 1059 lba |= ((u64)cdb[3]); 1060 1061 len = cdb[4]; 1062 1063 *plba = lba; 1064 *plen = len; 1065 } 1066 1067 /** 1068 * scsi_10_lba_len - Get LBA and transfer length 1069 * @cdb: SCSI command to translate 1070 * 1071 * Calculate LBA and transfer length for 10-byte commands. 1072 * 1073 * RETURNS: 1074 * @plba: the LBA 1075 * @plen: the transfer length 1076 */ 1077 static void scsi_10_lba_len(const u8 *cdb, u64 *plba, u32 *plen) 1078 { 1079 u64 lba = 0; 1080 u32 len = 0; 1081 1082 VPRINTK("ten-byte command\n"); 1083 1084 lba |= ((u64)cdb[2]) << 24; 1085 lba |= ((u64)cdb[3]) << 16; 1086 lba |= ((u64)cdb[4]) << 8; 1087 lba |= ((u64)cdb[5]); 1088 1089 len |= ((u32)cdb[7]) << 8; 1090 len |= ((u32)cdb[8]); 1091 1092 *plba = lba; 1093 *plen = len; 1094 } 1095 1096 /** 1097 * scsi_16_lba_len - Get LBA and transfer length 1098 * @cdb: SCSI command to translate 1099 * 1100 * Calculate LBA and transfer length for 16-byte commands. 1101 * 1102 * RETURNS: 1103 * @plba: the LBA 1104 * @plen: the transfer length 1105 */ 1106 static void scsi_16_lba_len(const u8 *cdb, u64 *plba, u32 *plen) 1107 { 1108 u64 lba = 0; 1109 u32 len = 0; 1110 1111 VPRINTK("sixteen-byte command\n"); 1112 1113 lba |= ((u64)cdb[2]) << 56; 1114 lba |= ((u64)cdb[3]) << 48; 1115 lba |= ((u64)cdb[4]) << 40; 1116 lba |= ((u64)cdb[5]) << 32; 1117 lba |= ((u64)cdb[6]) << 24; 1118 lba |= ((u64)cdb[7]) << 16; 1119 lba |= ((u64)cdb[8]) << 8; 1120 lba |= ((u64)cdb[9]); 1121 1122 len |= ((u32)cdb[10]) << 24; 1123 len |= ((u32)cdb[11]) << 16; 1124 len |= ((u32)cdb[12]) << 8; 1125 len |= ((u32)cdb[13]); 1126 1127 *plba = lba; 1128 *plen = len; 1129 } 1130 1131 /** 1132 * ata_scsi_verify_xlat - Translate SCSI VERIFY command into an ATA one 1133 * @qc: Storage for translated ATA taskfile 1134 * 1135 * Converts SCSI VERIFY command to an ATA READ VERIFY command. 1136 * 1137 * LOCKING: 1138 * spin_lock_irqsave(host lock) 1139 * 1140 * RETURNS: 1141 * Zero on success, non-zero on error. 1142 */ 1143 static unsigned int ata_scsi_verify_xlat(struct ata_queued_cmd *qc) 1144 { 1145 struct scsi_cmnd *scmd = qc->scsicmd; 1146 struct ata_taskfile *tf = &qc->tf; 1147 struct ata_device *dev = qc->dev; 1148 u64 dev_sectors = qc->dev->n_sectors; 1149 const u8 *cdb = scmd->cmnd; 1150 u64 block; 1151 u32 n_block; 1152 1153 tf->flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE; 1154 tf->protocol = ATA_PROT_NODATA; 1155 1156 if (cdb[0] == VERIFY) { 1157 if (scmd->cmd_len < 10) 1158 goto invalid_fld; 1159 scsi_10_lba_len(cdb, &block, &n_block); 1160 } else if (cdb[0] == VERIFY_16) { 1161 if (scmd->cmd_len < 16) 1162 goto invalid_fld; 1163 scsi_16_lba_len(cdb, &block, &n_block); 1164 } else 1165 goto invalid_fld; 1166 1167 if (!n_block) 1168 goto nothing_to_do; 1169 if (block >= dev_sectors) 1170 goto out_of_range; 1171 if ((block + n_block) > dev_sectors) 1172 goto out_of_range; 1173 1174 if (dev->flags & ATA_DFLAG_LBA) { 1175 tf->flags |= ATA_TFLAG_LBA; 1176 1177 if (lba_28_ok(block, n_block)) { 1178 /* use LBA28 */ 1179 tf->command = ATA_CMD_VERIFY; 1180 tf->device |= (block >> 24) & 0xf; 1181 } else if (lba_48_ok(block, n_block)) { 1182 if (!(dev->flags & ATA_DFLAG_LBA48)) 1183 goto out_of_range; 1184 1185 /* use LBA48 */ 1186 tf->flags |= ATA_TFLAG_LBA48; 1187 tf->command = ATA_CMD_VERIFY_EXT; 1188 1189 tf->hob_nsect = (n_block >> 8) & 0xff; 1190 1191 tf->hob_lbah = (block >> 40) & 0xff; 1192 tf->hob_lbam = (block >> 32) & 0xff; 1193 tf->hob_lbal = (block >> 24) & 0xff; 1194 } else 1195 /* request too large even for LBA48 */ 1196 goto out_of_range; 1197 1198 tf->nsect = n_block & 0xff; 1199 1200 tf->lbah = (block >> 16) & 0xff; 1201 tf->lbam = (block >> 8) & 0xff; 1202 tf->lbal = block & 0xff; 1203 1204 tf->device |= ATA_LBA; 1205 } else { 1206 /* CHS */ 1207 u32 sect, head, cyl, track; 1208 1209 if (!lba_28_ok(block, n_block)) 1210 goto out_of_range; 1211 1212 /* Convert LBA to CHS */ 1213 track = (u32)block / dev->sectors; 1214 cyl = track / dev->heads; 1215 head = track % dev->heads; 1216 sect = (u32)block % dev->sectors + 1; 1217 1218 DPRINTK("block %u track %u cyl %u head %u sect %u\n", 1219 (u32)block, track, cyl, head, sect); 1220 1221 /* Check whether the converted CHS can fit. 1222 Cylinder: 0-65535 1223 Head: 0-15 1224 Sector: 1-255*/ 1225 if ((cyl >> 16) || (head >> 4) || (sect >> 8) || (!sect)) 1226 goto out_of_range; 1227 1228 tf->command = ATA_CMD_VERIFY; 1229 tf->nsect = n_block & 0xff; /* Sector count 0 means 256 sectors */ 1230 tf->lbal = sect; 1231 tf->lbam = cyl; 1232 tf->lbah = cyl >> 8; 1233 tf->device |= head; 1234 } 1235 1236 return 0; 1237 1238 invalid_fld: 1239 ata_scsi_set_sense(scmd, ILLEGAL_REQUEST, 0x24, 0x0); 1240 /* "Invalid field in cbd" */ 1241 return 1; 1242 1243 out_of_range: 1244 ata_scsi_set_sense(scmd, ILLEGAL_REQUEST, 0x21, 0x0); 1245 /* "Logical Block Address out of range" */ 1246 return 1; 1247 1248 nothing_to_do: 1249 scmd->result = SAM_STAT_GOOD; 1250 return 1; 1251 } 1252 1253 /** 1254 * ata_scsi_rw_xlat - Translate SCSI r/w command into an ATA one 1255 * @qc: Storage for translated ATA taskfile 1256 * 1257 * Converts any of six SCSI read/write commands into the 1258 * ATA counterpart, including starting sector (LBA), 1259 * sector count, and taking into account the device's LBA48 1260 * support. 1261 * 1262 * Commands %READ_6, %READ_10, %READ_16, %WRITE_6, %WRITE_10, and 1263 * %WRITE_16 are currently supported. 1264 * 1265 * LOCKING: 1266 * spin_lock_irqsave(host lock) 1267 * 1268 * RETURNS: 1269 * Zero on success, non-zero on error. 1270 */ 1271 static unsigned int ata_scsi_rw_xlat(struct ata_queued_cmd *qc) 1272 { 1273 struct scsi_cmnd *scmd = qc->scsicmd; 1274 const u8 *cdb = scmd->cmnd; 1275 unsigned int tf_flags = 0; 1276 u64 block; 1277 u32 n_block; 1278 int rc; 1279 1280 if (cdb[0] == WRITE_10 || cdb[0] == WRITE_6 || cdb[0] == WRITE_16) 1281 tf_flags |= ATA_TFLAG_WRITE; 1282 1283 /* Calculate the SCSI LBA, transfer length and FUA. */ 1284 switch (cdb[0]) { 1285 case READ_10: 1286 case WRITE_10: 1287 if (unlikely(scmd->cmd_len < 10)) 1288 goto invalid_fld; 1289 scsi_10_lba_len(cdb, &block, &n_block); 1290 if (unlikely(cdb[1] & (1 << 3))) 1291 tf_flags |= ATA_TFLAG_FUA; 1292 break; 1293 case READ_6: 1294 case WRITE_6: 1295 if (unlikely(scmd->cmd_len < 6)) 1296 goto invalid_fld; 1297 scsi_6_lba_len(cdb, &block, &n_block); 1298 1299 /* for 6-byte r/w commands, transfer length 0 1300 * means 256 blocks of data, not 0 block. 1301 */ 1302 if (!n_block) 1303 n_block = 256; 1304 break; 1305 case READ_16: 1306 case WRITE_16: 1307 if (unlikely(scmd->cmd_len < 16)) 1308 goto invalid_fld; 1309 scsi_16_lba_len(cdb, &block, &n_block); 1310 if (unlikely(cdb[1] & (1 << 3))) 1311 tf_flags |= ATA_TFLAG_FUA; 1312 break; 1313 default: 1314 DPRINTK("no-byte command\n"); 1315 goto invalid_fld; 1316 } 1317 1318 /* Check and compose ATA command */ 1319 if (!n_block) 1320 /* For 10-byte and 16-byte SCSI R/W commands, transfer 1321 * length 0 means transfer 0 block of data. 1322 * However, for ATA R/W commands, sector count 0 means 1323 * 256 or 65536 sectors, not 0 sectors as in SCSI. 1324 * 1325 * WARNING: one or two older ATA drives treat 0 as 0... 1326 */ 1327 goto nothing_to_do; 1328 1329 qc->flags |= ATA_QCFLAG_IO; 1330 qc->nbytes = n_block * ATA_SECT_SIZE; 1331 1332 rc = ata_build_rw_tf(&qc->tf, qc->dev, block, n_block, tf_flags, 1333 qc->tag); 1334 if (likely(rc == 0)) 1335 return 0; 1336 1337 if (rc == -ERANGE) 1338 goto out_of_range; 1339 /* treat all other errors as -EINVAL, fall through */ 1340 invalid_fld: 1341 ata_scsi_set_sense(scmd, ILLEGAL_REQUEST, 0x24, 0x0); 1342 /* "Invalid field in cbd" */ 1343 return 1; 1344 1345 out_of_range: 1346 ata_scsi_set_sense(scmd, ILLEGAL_REQUEST, 0x21, 0x0); 1347 /* "Logical Block Address out of range" */ 1348 return 1; 1349 1350 nothing_to_do: 1351 scmd->result = SAM_STAT_GOOD; 1352 return 1; 1353 } 1354 1355 static void ata_scsi_qc_complete(struct ata_queued_cmd *qc) 1356 { 1357 struct ata_port *ap = qc->ap; 1358 struct scsi_cmnd *cmd = qc->scsicmd; 1359 u8 *cdb = cmd->cmnd; 1360 int need_sense = (qc->err_mask != 0); 1361 1362 /* We snoop the SET_FEATURES - Write Cache ON/OFF command, and 1363 * schedule EH_REVALIDATE operation to update the IDENTIFY DEVICE 1364 * cache 1365 */ 1366 if (ap->ops->error_handler && 1367 !need_sense && (qc->tf.command == ATA_CMD_SET_FEATURES) && 1368 ((qc->tf.feature == SETFEATURES_WC_ON) || 1369 (qc->tf.feature == SETFEATURES_WC_OFF))) { 1370 ap->eh_info.action |= ATA_EH_REVALIDATE; 1371 ata_port_schedule_eh(ap); 1372 } 1373 1374 /* For ATA pass thru (SAT) commands, generate a sense block if 1375 * user mandated it or if there's an error. Note that if we 1376 * generate because the user forced us to, a check condition 1377 * is generated and the ATA register values are returned 1378 * whether the command completed successfully or not. If there 1379 * was no error, SK, ASC and ASCQ will all be zero. 1380 */ 1381 if (((cdb[0] == ATA_16) || (cdb[0] == ATA_12)) && 1382 ((cdb[2] & 0x20) || need_sense)) { 1383 ata_gen_passthru_sense(qc); 1384 } else { 1385 if (!need_sense) { 1386 cmd->result = SAM_STAT_GOOD; 1387 } else { 1388 /* TODO: decide which descriptor format to use 1389 * for 48b LBA devices and call that here 1390 * instead of the fixed desc, which is only 1391 * good for smaller LBA (and maybe CHS?) 1392 * devices. 1393 */ 1394 ata_gen_ata_sense(qc); 1395 } 1396 } 1397 1398 /* XXX: track spindown state for spindown skipping and warning */ 1399 if (unlikely(qc->tf.command == ATA_CMD_STANDBY || 1400 qc->tf.command == ATA_CMD_STANDBYNOW1)) 1401 qc->dev->flags |= ATA_DFLAG_SPUNDOWN; 1402 else if (likely(system_state != SYSTEM_HALT && 1403 system_state != SYSTEM_POWER_OFF)) 1404 qc->dev->flags &= ~ATA_DFLAG_SPUNDOWN; 1405 1406 if (need_sense && !ap->ops->error_handler) 1407 ata_dump_status(ap->print_id, &qc->result_tf); 1408 1409 qc->scsidone(cmd); 1410 1411 ata_qc_free(qc); 1412 } 1413 1414 /** 1415 * ata_scmd_need_defer - Check whether we need to defer scmd 1416 * @dev: ATA device to which the command is addressed 1417 * @is_io: Is the command IO (and thus possibly NCQ)? 1418 * 1419 * NCQ and non-NCQ commands cannot run together. As upper layer 1420 * only knows the queue depth, we are responsible for maintaining 1421 * exclusion. This function checks whether a new command can be 1422 * issued to @dev. 1423 * 1424 * LOCKING: 1425 * spin_lock_irqsave(host lock) 1426 * 1427 * RETURNS: 1428 * 1 if deferring is needed, 0 otherwise. 1429 */ 1430 static int ata_scmd_need_defer(struct ata_device *dev, int is_io) 1431 { 1432 struct ata_port *ap = dev->ap; 1433 int is_ncq = is_io && ata_ncq_enabled(dev); 1434 1435 if (is_ncq) { 1436 if (!ata_tag_valid(ap->active_tag)) 1437 return 0; 1438 } else { 1439 if (!ata_tag_valid(ap->active_tag) && !ap->sactive) 1440 return 0; 1441 } 1442 return 1; 1443 } 1444 1445 /** 1446 * ata_scsi_translate - Translate then issue SCSI command to ATA device 1447 * @dev: ATA device to which the command is addressed 1448 * @cmd: SCSI command to execute 1449 * @done: SCSI command completion function 1450 * @xlat_func: Actor which translates @cmd to an ATA taskfile 1451 * 1452 * Our ->queuecommand() function has decided that the SCSI 1453 * command issued can be directly translated into an ATA 1454 * command, rather than handled internally. 1455 * 1456 * This function sets up an ata_queued_cmd structure for the 1457 * SCSI command, and sends that ata_queued_cmd to the hardware. 1458 * 1459 * The xlat_func argument (actor) returns 0 if ready to execute 1460 * ATA command, else 1 to finish translation. If 1 is returned 1461 * then cmd->result (and possibly cmd->sense_buffer) are assumed 1462 * to be set reflecting an error condition or clean (early) 1463 * termination. 1464 * 1465 * LOCKING: 1466 * spin_lock_irqsave(host lock) 1467 * 1468 * RETURNS: 1469 * 0 on success, SCSI_ML_QUEUE_DEVICE_BUSY if the command 1470 * needs to be deferred. 1471 */ 1472 static int ata_scsi_translate(struct ata_device *dev, struct scsi_cmnd *cmd, 1473 void (*done)(struct scsi_cmnd *), 1474 ata_xlat_func_t xlat_func) 1475 { 1476 struct ata_queued_cmd *qc; 1477 int is_io = xlat_func == ata_scsi_rw_xlat; 1478 1479 VPRINTK("ENTER\n"); 1480 1481 if (unlikely(ata_scmd_need_defer(dev, is_io))) 1482 goto defer; 1483 1484 qc = ata_scsi_qc_new(dev, cmd, done); 1485 if (!qc) 1486 goto err_mem; 1487 1488 /* data is present; dma-map it */ 1489 if (cmd->sc_data_direction == DMA_FROM_DEVICE || 1490 cmd->sc_data_direction == DMA_TO_DEVICE) { 1491 if (unlikely(cmd->request_bufflen < 1)) { 1492 ata_dev_printk(dev, KERN_WARNING, 1493 "WARNING: zero len r/w req\n"); 1494 goto err_did; 1495 } 1496 1497 if (cmd->use_sg) 1498 ata_sg_init(qc, cmd->request_buffer, cmd->use_sg); 1499 else 1500 ata_sg_init_one(qc, cmd->request_buffer, 1501 cmd->request_bufflen); 1502 1503 qc->dma_dir = cmd->sc_data_direction; 1504 } 1505 1506 qc->complete_fn = ata_scsi_qc_complete; 1507 1508 if (xlat_func(qc)) 1509 goto early_finish; 1510 1511 /* select device, send command to hardware */ 1512 ata_qc_issue(qc); 1513 1514 VPRINTK("EXIT\n"); 1515 return 0; 1516 1517 early_finish: 1518 ata_qc_free(qc); 1519 qc->scsidone(cmd); 1520 DPRINTK("EXIT - early finish (good or error)\n"); 1521 return 0; 1522 1523 err_did: 1524 ata_qc_free(qc); 1525 cmd->result = (DID_ERROR << 16); 1526 qc->scsidone(cmd); 1527 err_mem: 1528 DPRINTK("EXIT - internal\n"); 1529 return 0; 1530 1531 defer: 1532 DPRINTK("EXIT - defer\n"); 1533 return SCSI_MLQUEUE_DEVICE_BUSY; 1534 } 1535 1536 /** 1537 * ata_scsi_rbuf_get - Map response buffer. 1538 * @cmd: SCSI command containing buffer to be mapped. 1539 * @buf_out: Pointer to mapped area. 1540 * 1541 * Maps buffer contained within SCSI command @cmd. 1542 * 1543 * LOCKING: 1544 * spin_lock_irqsave(host lock) 1545 * 1546 * RETURNS: 1547 * Length of response buffer. 1548 */ 1549 1550 static unsigned int ata_scsi_rbuf_get(struct scsi_cmnd *cmd, u8 **buf_out) 1551 { 1552 u8 *buf; 1553 unsigned int buflen; 1554 1555 if (cmd->use_sg) { 1556 struct scatterlist *sg; 1557 1558 sg = (struct scatterlist *) cmd->request_buffer; 1559 buf = kmap_atomic(sg->page, KM_IRQ0) + sg->offset; 1560 buflen = sg->length; 1561 } else { 1562 buf = cmd->request_buffer; 1563 buflen = cmd->request_bufflen; 1564 } 1565 1566 *buf_out = buf; 1567 return buflen; 1568 } 1569 1570 /** 1571 * ata_scsi_rbuf_put - Unmap response buffer. 1572 * @cmd: SCSI command containing buffer to be unmapped. 1573 * @buf: buffer to unmap 1574 * 1575 * Unmaps response buffer contained within @cmd. 1576 * 1577 * LOCKING: 1578 * spin_lock_irqsave(host lock) 1579 */ 1580 1581 static inline void ata_scsi_rbuf_put(struct scsi_cmnd *cmd, u8 *buf) 1582 { 1583 if (cmd->use_sg) { 1584 struct scatterlist *sg; 1585 1586 sg = (struct scatterlist *) cmd->request_buffer; 1587 kunmap_atomic(buf - sg->offset, KM_IRQ0); 1588 } 1589 } 1590 1591 /** 1592 * ata_scsi_rbuf_fill - wrapper for SCSI command simulators 1593 * @args: device IDENTIFY data / SCSI command of interest. 1594 * @actor: Callback hook for desired SCSI command simulator 1595 * 1596 * Takes care of the hard work of simulating a SCSI command... 1597 * Mapping the response buffer, calling the command's handler, 1598 * and handling the handler's return value. This return value 1599 * indicates whether the handler wishes the SCSI command to be 1600 * completed successfully (0), or not (in which case cmd->result 1601 * and sense buffer are assumed to be set). 1602 * 1603 * LOCKING: 1604 * spin_lock_irqsave(host lock) 1605 */ 1606 1607 void ata_scsi_rbuf_fill(struct ata_scsi_args *args, 1608 unsigned int (*actor) (struct ata_scsi_args *args, 1609 u8 *rbuf, unsigned int buflen)) 1610 { 1611 u8 *rbuf; 1612 unsigned int buflen, rc; 1613 struct scsi_cmnd *cmd = args->cmd; 1614 1615 buflen = ata_scsi_rbuf_get(cmd, &rbuf); 1616 memset(rbuf, 0, buflen); 1617 rc = actor(args, rbuf, buflen); 1618 ata_scsi_rbuf_put(cmd, rbuf); 1619 1620 if (rc == 0) 1621 cmd->result = SAM_STAT_GOOD; 1622 args->done(cmd); 1623 } 1624 1625 /** 1626 * ATA_SCSI_RBUF_SET - helper to set values in SCSI response buffer 1627 * @idx: byte index into SCSI response buffer 1628 * @val: value to set 1629 * 1630 * To be used by SCSI command simulator functions. This macros 1631 * expects two local variables, u8 *rbuf and unsigned int buflen, 1632 * are in scope. 1633 * 1634 * LOCKING: 1635 * None. 1636 */ 1637 #define ATA_SCSI_RBUF_SET(idx, val) do { \ 1638 if ((idx) < buflen) rbuf[(idx)] = (u8)(val); \ 1639 } while (0) 1640 1641 /** 1642 * ata_scsiop_inq_std - Simulate INQUIRY command 1643 * @args: device IDENTIFY data / SCSI command of interest. 1644 * @rbuf: Response buffer, to which simulated SCSI cmd output is sent. 1645 * @buflen: Response buffer length. 1646 * 1647 * Returns standard device identification data associated 1648 * with non-VPD INQUIRY command output. 1649 * 1650 * LOCKING: 1651 * spin_lock_irqsave(host lock) 1652 */ 1653 1654 unsigned int ata_scsiop_inq_std(struct ata_scsi_args *args, u8 *rbuf, 1655 unsigned int buflen) 1656 { 1657 u8 hdr[] = { 1658 TYPE_DISK, 1659 0, 1660 0x5, /* claim SPC-3 version compatibility */ 1661 2, 1662 95 - 4 1663 }; 1664 1665 /* set scsi removeable (RMB) bit per ata bit */ 1666 if (ata_id_removeable(args->id)) 1667 hdr[1] |= (1 << 7); 1668 1669 VPRINTK("ENTER\n"); 1670 1671 memcpy(rbuf, hdr, sizeof(hdr)); 1672 1673 if (buflen > 35) { 1674 memcpy(&rbuf[8], "ATA ", 8); 1675 ata_id_string(args->id, &rbuf[16], ATA_ID_PROD, 16); 1676 ata_id_string(args->id, &rbuf[32], ATA_ID_FW_REV, 4); 1677 if (rbuf[32] == 0 || rbuf[32] == ' ') 1678 memcpy(&rbuf[32], "n/a ", 4); 1679 } 1680 1681 if (buflen > 63) { 1682 const u8 versions[] = { 1683 0x60, /* SAM-3 (no version claimed) */ 1684 1685 0x03, 1686 0x20, /* SBC-2 (no version claimed) */ 1687 1688 0x02, 1689 0x60 /* SPC-3 (no version claimed) */ 1690 }; 1691 1692 memcpy(rbuf + 59, versions, sizeof(versions)); 1693 } 1694 1695 return 0; 1696 } 1697 1698 /** 1699 * ata_scsiop_inq_00 - Simulate INQUIRY VPD page 0, list of pages 1700 * @args: device IDENTIFY data / SCSI command of interest. 1701 * @rbuf: Response buffer, to which simulated SCSI cmd output is sent. 1702 * @buflen: Response buffer length. 1703 * 1704 * Returns list of inquiry VPD pages available. 1705 * 1706 * LOCKING: 1707 * spin_lock_irqsave(host lock) 1708 */ 1709 1710 unsigned int ata_scsiop_inq_00(struct ata_scsi_args *args, u8 *rbuf, 1711 unsigned int buflen) 1712 { 1713 const u8 pages[] = { 1714 0x00, /* page 0x00, this page */ 1715 0x80, /* page 0x80, unit serial no page */ 1716 0x83 /* page 0x83, device ident page */ 1717 }; 1718 rbuf[3] = sizeof(pages); /* number of supported VPD pages */ 1719 1720 if (buflen > 6) 1721 memcpy(rbuf + 4, pages, sizeof(pages)); 1722 1723 return 0; 1724 } 1725 1726 /** 1727 * ata_scsiop_inq_80 - Simulate INQUIRY VPD page 80, device serial number 1728 * @args: device IDENTIFY data / SCSI command of interest. 1729 * @rbuf: Response buffer, to which simulated SCSI cmd output is sent. 1730 * @buflen: Response buffer length. 1731 * 1732 * Returns ATA device serial number. 1733 * 1734 * LOCKING: 1735 * spin_lock_irqsave(host lock) 1736 */ 1737 1738 unsigned int ata_scsiop_inq_80(struct ata_scsi_args *args, u8 *rbuf, 1739 unsigned int buflen) 1740 { 1741 const u8 hdr[] = { 1742 0, 1743 0x80, /* this page code */ 1744 0, 1745 ATA_ID_SERNO_LEN, /* page len */ 1746 }; 1747 memcpy(rbuf, hdr, sizeof(hdr)); 1748 1749 if (buflen > (ATA_ID_SERNO_LEN + 4 - 1)) 1750 ata_id_string(args->id, (unsigned char *) &rbuf[4], 1751 ATA_ID_SERNO, ATA_ID_SERNO_LEN); 1752 1753 return 0; 1754 } 1755 1756 /** 1757 * ata_scsiop_inq_83 - Simulate INQUIRY VPD page 83, device identity 1758 * @args: device IDENTIFY data / SCSI command of interest. 1759 * @rbuf: Response buffer, to which simulated SCSI cmd output is sent. 1760 * @buflen: Response buffer length. 1761 * 1762 * Yields two logical unit device identification designators: 1763 * - vendor specific ASCII containing the ATA serial number 1764 * - SAT defined "t10 vendor id based" containing ASCII vendor 1765 * name ("ATA "), model and serial numbers. 1766 * 1767 * LOCKING: 1768 * spin_lock_irqsave(host lock) 1769 */ 1770 1771 unsigned int ata_scsiop_inq_83(struct ata_scsi_args *args, u8 *rbuf, 1772 unsigned int buflen) 1773 { 1774 int num; 1775 const int sat_model_serial_desc_len = 68; 1776 1777 rbuf[1] = 0x83; /* this page code */ 1778 num = 4; 1779 1780 if (buflen > (ATA_ID_SERNO_LEN + num + 3)) { 1781 /* piv=0, assoc=lu, code_set=ACSII, designator=vendor */ 1782 rbuf[num + 0] = 2; 1783 rbuf[num + 3] = ATA_ID_SERNO_LEN; 1784 num += 4; 1785 ata_id_string(args->id, (unsigned char *) rbuf + num, 1786 ATA_ID_SERNO, ATA_ID_SERNO_LEN); 1787 num += ATA_ID_SERNO_LEN; 1788 } 1789 if (buflen > (sat_model_serial_desc_len + num + 3)) { 1790 /* SAT defined lu model and serial numbers descriptor */ 1791 /* piv=0, assoc=lu, code_set=ACSII, designator=t10 vendor id */ 1792 rbuf[num + 0] = 2; 1793 rbuf[num + 1] = 1; 1794 rbuf[num + 3] = sat_model_serial_desc_len; 1795 num += 4; 1796 memcpy(rbuf + num, "ATA ", 8); 1797 num += 8; 1798 ata_id_string(args->id, (unsigned char *) rbuf + num, 1799 ATA_ID_PROD, ATA_ID_PROD_LEN); 1800 num += ATA_ID_PROD_LEN; 1801 ata_id_string(args->id, (unsigned char *) rbuf + num, 1802 ATA_ID_SERNO, ATA_ID_SERNO_LEN); 1803 num += ATA_ID_SERNO_LEN; 1804 } 1805 rbuf[3] = num - 4; /* page len (assume less than 256 bytes) */ 1806 return 0; 1807 } 1808 1809 /** 1810 * ata_scsiop_noop - Command handler that simply returns success. 1811 * @args: device IDENTIFY data / SCSI command of interest. 1812 * @rbuf: Response buffer, to which simulated SCSI cmd output is sent. 1813 * @buflen: Response buffer length. 1814 * 1815 * No operation. Simply returns success to caller, to indicate 1816 * that the caller should successfully complete this SCSI command. 1817 * 1818 * LOCKING: 1819 * spin_lock_irqsave(host lock) 1820 */ 1821 1822 unsigned int ata_scsiop_noop(struct ata_scsi_args *args, u8 *rbuf, 1823 unsigned int buflen) 1824 { 1825 VPRINTK("ENTER\n"); 1826 return 0; 1827 } 1828 1829 /** 1830 * ata_msense_push - Push data onto MODE SENSE data output buffer 1831 * @ptr_io: (input/output) Location to store more output data 1832 * @last: End of output data buffer 1833 * @buf: Pointer to BLOB being added to output buffer 1834 * @buflen: Length of BLOB 1835 * 1836 * Store MODE SENSE data on an output buffer. 1837 * 1838 * LOCKING: 1839 * None. 1840 */ 1841 1842 static void ata_msense_push(u8 **ptr_io, const u8 *last, 1843 const u8 *buf, unsigned int buflen) 1844 { 1845 u8 *ptr = *ptr_io; 1846 1847 if ((ptr + buflen - 1) > last) 1848 return; 1849 1850 memcpy(ptr, buf, buflen); 1851 1852 ptr += buflen; 1853 1854 *ptr_io = ptr; 1855 } 1856 1857 /** 1858 * ata_msense_caching - Simulate MODE SENSE caching info page 1859 * @id: device IDENTIFY data 1860 * @ptr_io: (input/output) Location to store more output data 1861 * @last: End of output data buffer 1862 * 1863 * Generate a caching info page, which conditionally indicates 1864 * write caching to the SCSI layer, depending on device 1865 * capabilities. 1866 * 1867 * LOCKING: 1868 * None. 1869 */ 1870 1871 static unsigned int ata_msense_caching(u16 *id, u8 **ptr_io, 1872 const u8 *last) 1873 { 1874 u8 page[CACHE_MPAGE_LEN]; 1875 1876 memcpy(page, def_cache_mpage, sizeof(page)); 1877 if (ata_id_wcache_enabled(id)) 1878 page[2] |= (1 << 2); /* write cache enable */ 1879 if (!ata_id_rahead_enabled(id)) 1880 page[12] |= (1 << 5); /* disable read ahead */ 1881 1882 ata_msense_push(ptr_io, last, page, sizeof(page)); 1883 return sizeof(page); 1884 } 1885 1886 /** 1887 * ata_msense_ctl_mode - Simulate MODE SENSE control mode page 1888 * @dev: Device associated with this MODE SENSE command 1889 * @ptr_io: (input/output) Location to store more output data 1890 * @last: End of output data buffer 1891 * 1892 * Generate a generic MODE SENSE control mode page. 1893 * 1894 * LOCKING: 1895 * None. 1896 */ 1897 1898 static unsigned int ata_msense_ctl_mode(u8 **ptr_io, const u8 *last) 1899 { 1900 ata_msense_push(ptr_io, last, def_control_mpage, 1901 sizeof(def_control_mpage)); 1902 return sizeof(def_control_mpage); 1903 } 1904 1905 /** 1906 * ata_msense_rw_recovery - Simulate MODE SENSE r/w error recovery page 1907 * @dev: Device associated with this MODE SENSE command 1908 * @ptr_io: (input/output) Location to store more output data 1909 * @last: End of output data buffer 1910 * 1911 * Generate a generic MODE SENSE r/w error recovery page. 1912 * 1913 * LOCKING: 1914 * None. 1915 */ 1916 1917 static unsigned int ata_msense_rw_recovery(u8 **ptr_io, const u8 *last) 1918 { 1919 1920 ata_msense_push(ptr_io, last, def_rw_recovery_mpage, 1921 sizeof(def_rw_recovery_mpage)); 1922 return sizeof(def_rw_recovery_mpage); 1923 } 1924 1925 /* 1926 * We can turn this into a real blacklist if it's needed, for now just 1927 * blacklist any Maxtor BANC1G10 revision firmware 1928 */ 1929 static int ata_dev_supports_fua(u16 *id) 1930 { 1931 unsigned char model[ATA_ID_PROD_LEN + 1], fw[ATA_ID_FW_REV_LEN + 1]; 1932 1933 if (!libata_fua) 1934 return 0; 1935 if (!ata_id_has_fua(id)) 1936 return 0; 1937 1938 ata_id_c_string(id, model, ATA_ID_PROD, sizeof(model)); 1939 ata_id_c_string(id, fw, ATA_ID_FW_REV, sizeof(fw)); 1940 1941 if (strcmp(model, "Maxtor")) 1942 return 1; 1943 if (strcmp(fw, "BANC1G10")) 1944 return 1; 1945 1946 return 0; /* blacklisted */ 1947 } 1948 1949 /** 1950 * ata_scsiop_mode_sense - Simulate MODE SENSE 6, 10 commands 1951 * @args: device IDENTIFY data / SCSI command of interest. 1952 * @rbuf: Response buffer, to which simulated SCSI cmd output is sent. 1953 * @buflen: Response buffer length. 1954 * 1955 * Simulate MODE SENSE commands. Assume this is invoked for direct 1956 * access devices (e.g. disks) only. There should be no block 1957 * descriptor for other device types. 1958 * 1959 * LOCKING: 1960 * spin_lock_irqsave(host lock) 1961 */ 1962 1963 unsigned int ata_scsiop_mode_sense(struct ata_scsi_args *args, u8 *rbuf, 1964 unsigned int buflen) 1965 { 1966 struct ata_device *dev = args->dev; 1967 u8 *scsicmd = args->cmd->cmnd, *p, *last; 1968 const u8 sat_blk_desc[] = { 1969 0, 0, 0, 0, /* number of blocks: sat unspecified */ 1970 0, 1971 0, 0x2, 0x0 /* block length: 512 bytes */ 1972 }; 1973 u8 pg, spg; 1974 unsigned int ebd, page_control, six_byte, output_len, alloc_len, minlen; 1975 u8 dpofua; 1976 1977 VPRINTK("ENTER\n"); 1978 1979 six_byte = (scsicmd[0] == MODE_SENSE); 1980 ebd = !(scsicmd[1] & 0x8); /* dbd bit inverted == edb */ 1981 /* 1982 * LLBA bit in msense(10) ignored (compliant) 1983 */ 1984 1985 page_control = scsicmd[2] >> 6; 1986 switch (page_control) { 1987 case 0: /* current */ 1988 break; /* supported */ 1989 case 3: /* saved */ 1990 goto saving_not_supp; 1991 case 1: /* changeable */ 1992 case 2: /* defaults */ 1993 default: 1994 goto invalid_fld; 1995 } 1996 1997 if (six_byte) { 1998 output_len = 4 + (ebd ? 8 : 0); 1999 alloc_len = scsicmd[4]; 2000 } else { 2001 output_len = 8 + (ebd ? 8 : 0); 2002 alloc_len = (scsicmd[7] << 8) + scsicmd[8]; 2003 } 2004 minlen = (alloc_len < buflen) ? alloc_len : buflen; 2005 2006 p = rbuf + output_len; 2007 last = rbuf + minlen - 1; 2008 2009 pg = scsicmd[2] & 0x3f; 2010 spg = scsicmd[3]; 2011 /* 2012 * No mode subpages supported (yet) but asking for _all_ 2013 * subpages may be valid 2014 */ 2015 if (spg && (spg != ALL_SUB_MPAGES)) 2016 goto invalid_fld; 2017 2018 switch(pg) { 2019 case RW_RECOVERY_MPAGE: 2020 output_len += ata_msense_rw_recovery(&p, last); 2021 break; 2022 2023 case CACHE_MPAGE: 2024 output_len += ata_msense_caching(args->id, &p, last); 2025 break; 2026 2027 case CONTROL_MPAGE: { 2028 output_len += ata_msense_ctl_mode(&p, last); 2029 break; 2030 } 2031 2032 case ALL_MPAGES: 2033 output_len += ata_msense_rw_recovery(&p, last); 2034 output_len += ata_msense_caching(args->id, &p, last); 2035 output_len += ata_msense_ctl_mode(&p, last); 2036 break; 2037 2038 default: /* invalid page code */ 2039 goto invalid_fld; 2040 } 2041 2042 if (minlen < 1) 2043 return 0; 2044 2045 dpofua = 0; 2046 if (ata_dev_supports_fua(args->id) && (dev->flags & ATA_DFLAG_LBA48) && 2047 (!(dev->flags & ATA_DFLAG_PIO) || dev->multi_count)) 2048 dpofua = 1 << 4; 2049 2050 if (six_byte) { 2051 output_len--; 2052 rbuf[0] = output_len; 2053 if (minlen > 2) 2054 rbuf[2] |= dpofua; 2055 if (ebd) { 2056 if (minlen > 3) 2057 rbuf[3] = sizeof(sat_blk_desc); 2058 if (minlen > 11) 2059 memcpy(rbuf + 4, sat_blk_desc, 2060 sizeof(sat_blk_desc)); 2061 } 2062 } else { 2063 output_len -= 2; 2064 rbuf[0] = output_len >> 8; 2065 if (minlen > 1) 2066 rbuf[1] = output_len; 2067 if (minlen > 3) 2068 rbuf[3] |= dpofua; 2069 if (ebd) { 2070 if (minlen > 7) 2071 rbuf[7] = sizeof(sat_blk_desc); 2072 if (minlen > 15) 2073 memcpy(rbuf + 8, sat_blk_desc, 2074 sizeof(sat_blk_desc)); 2075 } 2076 } 2077 return 0; 2078 2079 invalid_fld: 2080 ata_scsi_set_sense(args->cmd, ILLEGAL_REQUEST, 0x24, 0x0); 2081 /* "Invalid field in cbd" */ 2082 return 1; 2083 2084 saving_not_supp: 2085 ata_scsi_set_sense(args->cmd, ILLEGAL_REQUEST, 0x39, 0x0); 2086 /* "Saving parameters not supported" */ 2087 return 1; 2088 } 2089 2090 /** 2091 * ata_scsiop_read_cap - Simulate READ CAPACITY[ 16] commands 2092 * @args: device IDENTIFY data / SCSI command of interest. 2093 * @rbuf: Response buffer, to which simulated SCSI cmd output is sent. 2094 * @buflen: Response buffer length. 2095 * 2096 * Simulate READ CAPACITY commands. 2097 * 2098 * LOCKING: 2099 * None. 2100 */ 2101 unsigned int ata_scsiop_read_cap(struct ata_scsi_args *args, u8 *rbuf, 2102 unsigned int buflen) 2103 { 2104 u64 last_lba = args->dev->n_sectors - 1; /* LBA of the last block */ 2105 2106 VPRINTK("ENTER\n"); 2107 2108 if (args->cmd->cmnd[0] == READ_CAPACITY) { 2109 if (last_lba >= 0xffffffffULL) 2110 last_lba = 0xffffffff; 2111 2112 /* sector count, 32-bit */ 2113 ATA_SCSI_RBUF_SET(0, last_lba >> (8 * 3)); 2114 ATA_SCSI_RBUF_SET(1, last_lba >> (8 * 2)); 2115 ATA_SCSI_RBUF_SET(2, last_lba >> (8 * 1)); 2116 ATA_SCSI_RBUF_SET(3, last_lba); 2117 2118 /* sector size */ 2119 ATA_SCSI_RBUF_SET(6, ATA_SECT_SIZE >> 8); 2120 ATA_SCSI_RBUF_SET(7, ATA_SECT_SIZE); 2121 } else { 2122 /* sector count, 64-bit */ 2123 ATA_SCSI_RBUF_SET(0, last_lba >> (8 * 7)); 2124 ATA_SCSI_RBUF_SET(1, last_lba >> (8 * 6)); 2125 ATA_SCSI_RBUF_SET(2, last_lba >> (8 * 5)); 2126 ATA_SCSI_RBUF_SET(3, last_lba >> (8 * 4)); 2127 ATA_SCSI_RBUF_SET(4, last_lba >> (8 * 3)); 2128 ATA_SCSI_RBUF_SET(5, last_lba >> (8 * 2)); 2129 ATA_SCSI_RBUF_SET(6, last_lba >> (8 * 1)); 2130 ATA_SCSI_RBUF_SET(7, last_lba); 2131 2132 /* sector size */ 2133 ATA_SCSI_RBUF_SET(10, ATA_SECT_SIZE >> 8); 2134 ATA_SCSI_RBUF_SET(11, ATA_SECT_SIZE); 2135 } 2136 2137 return 0; 2138 } 2139 2140 /** 2141 * ata_scsiop_report_luns - Simulate REPORT LUNS command 2142 * @args: device IDENTIFY data / SCSI command of interest. 2143 * @rbuf: Response buffer, to which simulated SCSI cmd output is sent. 2144 * @buflen: Response buffer length. 2145 * 2146 * Simulate REPORT LUNS command. 2147 * 2148 * LOCKING: 2149 * spin_lock_irqsave(host lock) 2150 */ 2151 2152 unsigned int ata_scsiop_report_luns(struct ata_scsi_args *args, u8 *rbuf, 2153 unsigned int buflen) 2154 { 2155 VPRINTK("ENTER\n"); 2156 rbuf[3] = 8; /* just one lun, LUN 0, size 8 bytes */ 2157 2158 return 0; 2159 } 2160 2161 /** 2162 * ata_scsi_set_sense - Set SCSI sense data and status 2163 * @cmd: SCSI request to be handled 2164 * @sk: SCSI-defined sense key 2165 * @asc: SCSI-defined additional sense code 2166 * @ascq: SCSI-defined additional sense code qualifier 2167 * 2168 * Helper function that builds a valid fixed format, current 2169 * response code and the given sense key (sk), additional sense 2170 * code (asc) and additional sense code qualifier (ascq) with 2171 * a SCSI command status of %SAM_STAT_CHECK_CONDITION and 2172 * DRIVER_SENSE set in the upper bits of scsi_cmnd::result . 2173 * 2174 * LOCKING: 2175 * Not required 2176 */ 2177 2178 void ata_scsi_set_sense(struct scsi_cmnd *cmd, u8 sk, u8 asc, u8 ascq) 2179 { 2180 cmd->result = (DRIVER_SENSE << 24) | SAM_STAT_CHECK_CONDITION; 2181 2182 cmd->sense_buffer[0] = 0x70; /* fixed format, current */ 2183 cmd->sense_buffer[2] = sk; 2184 cmd->sense_buffer[7] = 18 - 8; /* additional sense length */ 2185 cmd->sense_buffer[12] = asc; 2186 cmd->sense_buffer[13] = ascq; 2187 } 2188 2189 /** 2190 * ata_scsi_badcmd - End a SCSI request with an error 2191 * @cmd: SCSI request to be handled 2192 * @done: SCSI command completion function 2193 * @asc: SCSI-defined additional sense code 2194 * @ascq: SCSI-defined additional sense code qualifier 2195 * 2196 * Helper function that completes a SCSI command with 2197 * %SAM_STAT_CHECK_CONDITION, with a sense key %ILLEGAL_REQUEST 2198 * and the specified additional sense codes. 2199 * 2200 * LOCKING: 2201 * spin_lock_irqsave(host lock) 2202 */ 2203 2204 void ata_scsi_badcmd(struct scsi_cmnd *cmd, void (*done)(struct scsi_cmnd *), u8 asc, u8 ascq) 2205 { 2206 DPRINTK("ENTER\n"); 2207 ata_scsi_set_sense(cmd, ILLEGAL_REQUEST, asc, ascq); 2208 2209 done(cmd); 2210 } 2211 2212 static void atapi_sense_complete(struct ata_queued_cmd *qc) 2213 { 2214 if (qc->err_mask && ((qc->err_mask & AC_ERR_DEV) == 0)) { 2215 /* FIXME: not quite right; we don't want the 2216 * translation of taskfile registers into 2217 * a sense descriptors, since that's only 2218 * correct for ATA, not ATAPI 2219 */ 2220 ata_gen_passthru_sense(qc); 2221 } 2222 2223 qc->scsidone(qc->scsicmd); 2224 ata_qc_free(qc); 2225 } 2226 2227 /* is it pointless to prefer PIO for "safety reasons"? */ 2228 static inline int ata_pio_use_silly(struct ata_port *ap) 2229 { 2230 return (ap->flags & ATA_FLAG_PIO_DMA); 2231 } 2232 2233 static void atapi_request_sense(struct ata_queued_cmd *qc) 2234 { 2235 struct ata_port *ap = qc->ap; 2236 struct scsi_cmnd *cmd = qc->scsicmd; 2237 2238 DPRINTK("ATAPI request sense\n"); 2239 2240 /* FIXME: is this needed? */ 2241 memset(cmd->sense_buffer, 0, sizeof(cmd->sense_buffer)); 2242 2243 ap->ops->tf_read(ap, &qc->tf); 2244 2245 /* fill these in, for the case where they are -not- overwritten */ 2246 cmd->sense_buffer[0] = 0x70; 2247 cmd->sense_buffer[2] = qc->tf.feature >> 4; 2248 2249 ata_qc_reinit(qc); 2250 2251 ata_sg_init_one(qc, cmd->sense_buffer, sizeof(cmd->sense_buffer)); 2252 qc->dma_dir = DMA_FROM_DEVICE; 2253 2254 memset(&qc->cdb, 0, qc->dev->cdb_len); 2255 qc->cdb[0] = REQUEST_SENSE; 2256 qc->cdb[4] = SCSI_SENSE_BUFFERSIZE; 2257 2258 qc->tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE; 2259 qc->tf.command = ATA_CMD_PACKET; 2260 2261 if (ata_pio_use_silly(ap)) { 2262 qc->tf.protocol = ATA_PROT_ATAPI_DMA; 2263 qc->tf.feature |= ATAPI_PKT_DMA; 2264 } else { 2265 qc->tf.protocol = ATA_PROT_ATAPI; 2266 qc->tf.lbam = (8 * 1024) & 0xff; 2267 qc->tf.lbah = (8 * 1024) >> 8; 2268 } 2269 qc->nbytes = SCSI_SENSE_BUFFERSIZE; 2270 2271 qc->complete_fn = atapi_sense_complete; 2272 2273 ata_qc_issue(qc); 2274 2275 DPRINTK("EXIT\n"); 2276 } 2277 2278 static void atapi_qc_complete(struct ata_queued_cmd *qc) 2279 { 2280 struct scsi_cmnd *cmd = qc->scsicmd; 2281 unsigned int err_mask = qc->err_mask; 2282 2283 VPRINTK("ENTER, err_mask 0x%X\n", err_mask); 2284 2285 /* handle completion from new EH */ 2286 if (unlikely(qc->ap->ops->error_handler && 2287 (err_mask || qc->flags & ATA_QCFLAG_SENSE_VALID))) { 2288 2289 if (!(qc->flags & ATA_QCFLAG_SENSE_VALID)) { 2290 /* FIXME: not quite right; we don't want the 2291 * translation of taskfile registers into a 2292 * sense descriptors, since that's only 2293 * correct for ATA, not ATAPI 2294 */ 2295 ata_gen_passthru_sense(qc); 2296 } 2297 2298 /* SCSI EH automatically locks door if sdev->locked is 2299 * set. Sometimes door lock request continues to 2300 * fail, for example, when no media is present. This 2301 * creates a loop - SCSI EH issues door lock which 2302 * fails and gets invoked again to acquire sense data 2303 * for the failed command. 2304 * 2305 * If door lock fails, always clear sdev->locked to 2306 * avoid this infinite loop. 2307 */ 2308 if (qc->cdb[0] == ALLOW_MEDIUM_REMOVAL) 2309 qc->dev->sdev->locked = 0; 2310 2311 qc->scsicmd->result = SAM_STAT_CHECK_CONDITION; 2312 qc->scsidone(cmd); 2313 ata_qc_free(qc); 2314 return; 2315 } 2316 2317 /* successful completion or old EH failure path */ 2318 if (unlikely(err_mask & AC_ERR_DEV)) { 2319 cmd->result = SAM_STAT_CHECK_CONDITION; 2320 atapi_request_sense(qc); 2321 return; 2322 } else if (unlikely(err_mask)) { 2323 /* FIXME: not quite right; we don't want the 2324 * translation of taskfile registers into 2325 * a sense descriptors, since that's only 2326 * correct for ATA, not ATAPI 2327 */ 2328 ata_gen_passthru_sense(qc); 2329 } else { 2330 u8 *scsicmd = cmd->cmnd; 2331 2332 if ((scsicmd[0] == INQUIRY) && ((scsicmd[1] & 0x03) == 0)) { 2333 u8 *buf = NULL; 2334 unsigned int buflen; 2335 2336 buflen = ata_scsi_rbuf_get(cmd, &buf); 2337 2338 /* ATAPI devices typically report zero for their SCSI version, 2339 * and sometimes deviate from the spec WRT response data 2340 * format. If SCSI version is reported as zero like normal, 2341 * then we make the following fixups: 1) Fake MMC-5 version, 2342 * to indicate to the Linux scsi midlayer this is a modern 2343 * device. 2) Ensure response data format / ATAPI information 2344 * are always correct. 2345 */ 2346 if (buf[2] == 0) { 2347 buf[2] = 0x5; 2348 buf[3] = 0x32; 2349 } 2350 2351 ata_scsi_rbuf_put(cmd, buf); 2352 } 2353 2354 cmd->result = SAM_STAT_GOOD; 2355 } 2356 2357 qc->scsidone(cmd); 2358 ata_qc_free(qc); 2359 } 2360 /** 2361 * atapi_xlat - Initialize PACKET taskfile 2362 * @qc: command structure to be initialized 2363 * 2364 * LOCKING: 2365 * spin_lock_irqsave(host lock) 2366 * 2367 * RETURNS: 2368 * Zero on success, non-zero on failure. 2369 */ 2370 static unsigned int atapi_xlat(struct ata_queued_cmd *qc) 2371 { 2372 struct scsi_cmnd *scmd = qc->scsicmd; 2373 struct ata_device *dev = qc->dev; 2374 int using_pio = (dev->flags & ATA_DFLAG_PIO); 2375 int nodata = (scmd->sc_data_direction == DMA_NONE); 2376 2377 if (!using_pio) 2378 /* Check whether ATAPI DMA is safe */ 2379 if (ata_check_atapi_dma(qc)) 2380 using_pio = 1; 2381 2382 memset(qc->cdb, 0, dev->cdb_len); 2383 memcpy(qc->cdb, scmd->cmnd, scmd->cmd_len); 2384 2385 qc->complete_fn = atapi_qc_complete; 2386 2387 qc->tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE; 2388 if (scmd->sc_data_direction == DMA_TO_DEVICE) { 2389 qc->tf.flags |= ATA_TFLAG_WRITE; 2390 DPRINTK("direction: write\n"); 2391 } 2392 2393 qc->tf.command = ATA_CMD_PACKET; 2394 2395 /* no data, or PIO data xfer */ 2396 if (using_pio || nodata) { 2397 if (nodata) 2398 qc->tf.protocol = ATA_PROT_ATAPI_NODATA; 2399 else 2400 qc->tf.protocol = ATA_PROT_ATAPI; 2401 qc->tf.lbam = (8 * 1024) & 0xff; 2402 qc->tf.lbah = (8 * 1024) >> 8; 2403 } 2404 2405 /* DMA data xfer */ 2406 else { 2407 qc->tf.protocol = ATA_PROT_ATAPI_DMA; 2408 qc->tf.feature |= ATAPI_PKT_DMA; 2409 2410 if (atapi_dmadir && (scmd->sc_data_direction != DMA_TO_DEVICE)) 2411 /* some SATA bridges need us to indicate data xfer direction */ 2412 qc->tf.feature |= ATAPI_DMADIR; 2413 } 2414 2415 qc->nbytes = scmd->request_bufflen; 2416 2417 return 0; 2418 } 2419 2420 static struct ata_device * ata_find_dev(struct ata_port *ap, int id) 2421 { 2422 if (likely(id < ATA_MAX_DEVICES)) 2423 return &ap->device[id]; 2424 return NULL; 2425 } 2426 2427 static struct ata_device * __ata_scsi_find_dev(struct ata_port *ap, 2428 const struct scsi_device *scsidev) 2429 { 2430 /* skip commands not addressed to targets we simulate */ 2431 if (unlikely(scsidev->channel || scsidev->lun)) 2432 return NULL; 2433 2434 return ata_find_dev(ap, scsidev->id); 2435 } 2436 2437 /** 2438 * ata_scsi_dev_enabled - determine if device is enabled 2439 * @dev: ATA device 2440 * 2441 * Determine if commands should be sent to the specified device. 2442 * 2443 * LOCKING: 2444 * spin_lock_irqsave(host lock) 2445 * 2446 * RETURNS: 2447 * 0 if commands are not allowed / 1 if commands are allowed 2448 */ 2449 2450 static int ata_scsi_dev_enabled(struct ata_device *dev) 2451 { 2452 if (unlikely(!ata_dev_enabled(dev))) 2453 return 0; 2454 2455 if (!atapi_enabled || (dev->ap->flags & ATA_FLAG_NO_ATAPI)) { 2456 if (unlikely(dev->class == ATA_DEV_ATAPI)) { 2457 ata_dev_printk(dev, KERN_WARNING, 2458 "WARNING: ATAPI is %s, device ignored.\n", 2459 atapi_enabled ? "not supported with this driver" : "disabled"); 2460 return 0; 2461 } 2462 } 2463 2464 return 1; 2465 } 2466 2467 /** 2468 * ata_scsi_find_dev - lookup ata_device from scsi_cmnd 2469 * @ap: ATA port to which the device is attached 2470 * @scsidev: SCSI device from which we derive the ATA device 2471 * 2472 * Given various information provided in struct scsi_cmnd, 2473 * map that onto an ATA bus, and using that mapping 2474 * determine which ata_device is associated with the 2475 * SCSI command to be sent. 2476 * 2477 * LOCKING: 2478 * spin_lock_irqsave(host lock) 2479 * 2480 * RETURNS: 2481 * Associated ATA device, or %NULL if not found. 2482 */ 2483 static struct ata_device * 2484 ata_scsi_find_dev(struct ata_port *ap, const struct scsi_device *scsidev) 2485 { 2486 struct ata_device *dev = __ata_scsi_find_dev(ap, scsidev); 2487 2488 if (unlikely(!dev || !ata_scsi_dev_enabled(dev))) 2489 return NULL; 2490 2491 return dev; 2492 } 2493 2494 /* 2495 * ata_scsi_map_proto - Map pass-thru protocol value to taskfile value. 2496 * @byte1: Byte 1 from pass-thru CDB. 2497 * 2498 * RETURNS: 2499 * ATA_PROT_UNKNOWN if mapping failed/unimplemented, protocol otherwise. 2500 */ 2501 static u8 2502 ata_scsi_map_proto(u8 byte1) 2503 { 2504 switch((byte1 & 0x1e) >> 1) { 2505 case 3: /* Non-data */ 2506 return ATA_PROT_NODATA; 2507 2508 case 6: /* DMA */ 2509 return ATA_PROT_DMA; 2510 2511 case 4: /* PIO Data-in */ 2512 case 5: /* PIO Data-out */ 2513 return ATA_PROT_PIO; 2514 2515 case 10: /* Device Reset */ 2516 case 0: /* Hard Reset */ 2517 case 1: /* SRST */ 2518 case 2: /* Bus Idle */ 2519 case 7: /* Packet */ 2520 case 8: /* DMA Queued */ 2521 case 9: /* Device Diagnostic */ 2522 case 11: /* UDMA Data-in */ 2523 case 12: /* UDMA Data-Out */ 2524 case 13: /* FPDMA */ 2525 default: /* Reserved */ 2526 break; 2527 } 2528 2529 return ATA_PROT_UNKNOWN; 2530 } 2531 2532 /** 2533 * ata_scsi_pass_thru - convert ATA pass-thru CDB to taskfile 2534 * @qc: command structure to be initialized 2535 * 2536 * Handles either 12 or 16-byte versions of the CDB. 2537 * 2538 * RETURNS: 2539 * Zero on success, non-zero on failure. 2540 */ 2541 static unsigned int ata_scsi_pass_thru(struct ata_queued_cmd *qc) 2542 { 2543 struct ata_taskfile *tf = &(qc->tf); 2544 struct scsi_cmnd *scmd = qc->scsicmd; 2545 struct ata_device *dev = qc->dev; 2546 const u8 *cdb = scmd->cmnd; 2547 2548 if ((tf->protocol = ata_scsi_map_proto(cdb[1])) == ATA_PROT_UNKNOWN) 2549 goto invalid_fld; 2550 2551 /* We may not issue DMA commands if no DMA mode is set */ 2552 if (tf->protocol == ATA_PROT_DMA && dev->dma_mode == 0) 2553 goto invalid_fld; 2554 2555 if (cdb[1] & 0xe0) 2556 /* PIO multi not supported yet */ 2557 goto invalid_fld; 2558 2559 /* 2560 * 12 and 16 byte CDBs use different offsets to 2561 * provide the various register values. 2562 */ 2563 if (cdb[0] == ATA_16) { 2564 /* 2565 * 16-byte CDB - may contain extended commands. 2566 * 2567 * If that is the case, copy the upper byte register values. 2568 */ 2569 if (cdb[1] & 0x01) { 2570 tf->hob_feature = cdb[3]; 2571 tf->hob_nsect = cdb[5]; 2572 tf->hob_lbal = cdb[7]; 2573 tf->hob_lbam = cdb[9]; 2574 tf->hob_lbah = cdb[11]; 2575 tf->flags |= ATA_TFLAG_LBA48; 2576 } else 2577 tf->flags &= ~ATA_TFLAG_LBA48; 2578 2579 /* 2580 * Always copy low byte, device and command registers. 2581 */ 2582 tf->feature = cdb[4]; 2583 tf->nsect = cdb[6]; 2584 tf->lbal = cdb[8]; 2585 tf->lbam = cdb[10]; 2586 tf->lbah = cdb[12]; 2587 tf->device = cdb[13]; 2588 tf->command = cdb[14]; 2589 } else { 2590 /* 2591 * 12-byte CDB - incapable of extended commands. 2592 */ 2593 tf->flags &= ~ATA_TFLAG_LBA48; 2594 2595 tf->feature = cdb[3]; 2596 tf->nsect = cdb[4]; 2597 tf->lbal = cdb[5]; 2598 tf->lbam = cdb[6]; 2599 tf->lbah = cdb[7]; 2600 tf->device = cdb[8]; 2601 tf->command = cdb[9]; 2602 } 2603 /* 2604 * If slave is possible, enforce correct master/slave bit 2605 */ 2606 if (qc->ap->flags & ATA_FLAG_SLAVE_POSS) 2607 tf->device = qc->dev->devno ? 2608 tf->device | ATA_DEV1 : tf->device & ~ATA_DEV1; 2609 2610 /* READ/WRITE LONG use a non-standard sect_size */ 2611 qc->sect_size = ATA_SECT_SIZE; 2612 switch (tf->command) { 2613 case ATA_CMD_READ_LONG: 2614 case ATA_CMD_READ_LONG_ONCE: 2615 case ATA_CMD_WRITE_LONG: 2616 case ATA_CMD_WRITE_LONG_ONCE: 2617 if (tf->protocol != ATA_PROT_PIO || tf->nsect != 1) 2618 goto invalid_fld; 2619 qc->sect_size = scmd->request_bufflen; 2620 } 2621 2622 /* 2623 * Filter SET_FEATURES - XFER MODE command -- otherwise, 2624 * SET_FEATURES - XFER MODE must be preceded/succeeded 2625 * by an update to hardware-specific registers for each 2626 * controller (i.e. the reason for ->set_piomode(), 2627 * ->set_dmamode(), and ->post_set_mode() hooks). 2628 */ 2629 if ((tf->command == ATA_CMD_SET_FEATURES) 2630 && (tf->feature == SETFEATURES_XFER)) 2631 goto invalid_fld; 2632 2633 /* 2634 * Set flags so that all registers will be written, 2635 * and pass on write indication (used for PIO/DMA 2636 * setup.) 2637 */ 2638 tf->flags |= (ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE); 2639 2640 if (scmd->sc_data_direction == DMA_TO_DEVICE) 2641 tf->flags |= ATA_TFLAG_WRITE; 2642 2643 /* 2644 * Set transfer length. 2645 * 2646 * TODO: find out if we need to do more here to 2647 * cover scatter/gather case. 2648 */ 2649 qc->nbytes = scmd->request_bufflen; 2650 2651 /* request result TF */ 2652 qc->flags |= ATA_QCFLAG_RESULT_TF; 2653 2654 return 0; 2655 2656 invalid_fld: 2657 ata_scsi_set_sense(scmd, ILLEGAL_REQUEST, 0x24, 0x00); 2658 /* "Invalid field in cdb" */ 2659 return 1; 2660 } 2661 2662 /** 2663 * ata_get_xlat_func - check if SCSI to ATA translation is possible 2664 * @dev: ATA device 2665 * @cmd: SCSI command opcode to consider 2666 * 2667 * Look up the SCSI command given, and determine whether the 2668 * SCSI command is to be translated or simulated. 2669 * 2670 * RETURNS: 2671 * Pointer to translation function if possible, %NULL if not. 2672 */ 2673 2674 static inline ata_xlat_func_t ata_get_xlat_func(struct ata_device *dev, u8 cmd) 2675 { 2676 switch (cmd) { 2677 case READ_6: 2678 case READ_10: 2679 case READ_16: 2680 2681 case WRITE_6: 2682 case WRITE_10: 2683 case WRITE_16: 2684 return ata_scsi_rw_xlat; 2685 2686 case SYNCHRONIZE_CACHE: 2687 if (ata_try_flush_cache(dev)) 2688 return ata_scsi_flush_xlat; 2689 break; 2690 2691 case VERIFY: 2692 case VERIFY_16: 2693 return ata_scsi_verify_xlat; 2694 2695 case ATA_12: 2696 case ATA_16: 2697 return ata_scsi_pass_thru; 2698 2699 case START_STOP: 2700 return ata_scsi_start_stop_xlat; 2701 } 2702 2703 return NULL; 2704 } 2705 2706 /** 2707 * ata_scsi_dump_cdb - dump SCSI command contents to dmesg 2708 * @ap: ATA port to which the command was being sent 2709 * @cmd: SCSI command to dump 2710 * 2711 * Prints the contents of a SCSI command via printk(). 2712 */ 2713 2714 static inline void ata_scsi_dump_cdb(struct ata_port *ap, 2715 struct scsi_cmnd *cmd) 2716 { 2717 #ifdef ATA_DEBUG 2718 struct scsi_device *scsidev = cmd->device; 2719 u8 *scsicmd = cmd->cmnd; 2720 2721 DPRINTK("CDB (%u:%d,%d,%d) %02x %02x %02x %02x %02x %02x %02x %02x %02x\n", 2722 ap->print_id, 2723 scsidev->channel, scsidev->id, scsidev->lun, 2724 scsicmd[0], scsicmd[1], scsicmd[2], scsicmd[3], 2725 scsicmd[4], scsicmd[5], scsicmd[6], scsicmd[7], 2726 scsicmd[8]); 2727 #endif 2728 } 2729 2730 static inline int __ata_scsi_queuecmd(struct scsi_cmnd *scmd, 2731 void (*done)(struct scsi_cmnd *), 2732 struct ata_device *dev) 2733 { 2734 int rc = 0; 2735 2736 if (unlikely(!scmd->cmd_len || scmd->cmd_len > dev->cdb_len)) { 2737 DPRINTK("bad CDB len=%u, max=%u\n", 2738 scmd->cmd_len, dev->cdb_len); 2739 scmd->result = DID_ERROR << 16; 2740 done(scmd); 2741 return 0; 2742 } 2743 2744 if (dev->class == ATA_DEV_ATA) { 2745 ata_xlat_func_t xlat_func = ata_get_xlat_func(dev, 2746 scmd->cmnd[0]); 2747 2748 if (xlat_func) 2749 rc = ata_scsi_translate(dev, scmd, done, xlat_func); 2750 else 2751 ata_scsi_simulate(dev, scmd, done); 2752 } else 2753 rc = ata_scsi_translate(dev, scmd, done, atapi_xlat); 2754 2755 return rc; 2756 } 2757 2758 /** 2759 * ata_scsi_queuecmd - Issue SCSI cdb to libata-managed device 2760 * @cmd: SCSI command to be sent 2761 * @done: Completion function, called when command is complete 2762 * 2763 * In some cases, this function translates SCSI commands into 2764 * ATA taskfiles, and queues the taskfiles to be sent to 2765 * hardware. In other cases, this function simulates a 2766 * SCSI device by evaluating and responding to certain 2767 * SCSI commands. This creates the overall effect of 2768 * ATA and ATAPI devices appearing as SCSI devices. 2769 * 2770 * LOCKING: 2771 * Releases scsi-layer-held lock, and obtains host lock. 2772 * 2773 * RETURNS: 2774 * Return value from __ata_scsi_queuecmd() if @cmd can be queued, 2775 * 0 otherwise. 2776 */ 2777 int ata_scsi_queuecmd(struct scsi_cmnd *cmd, void (*done)(struct scsi_cmnd *)) 2778 { 2779 struct ata_port *ap; 2780 struct ata_device *dev; 2781 struct scsi_device *scsidev = cmd->device; 2782 struct Scsi_Host *shost = scsidev->host; 2783 int rc = 0; 2784 2785 ap = ata_shost_to_port(shost); 2786 2787 spin_unlock(shost->host_lock); 2788 spin_lock(ap->lock); 2789 2790 ata_scsi_dump_cdb(ap, cmd); 2791 2792 dev = ata_scsi_find_dev(ap, scsidev); 2793 if (likely(dev)) 2794 rc = __ata_scsi_queuecmd(cmd, done, dev); 2795 else { 2796 cmd->result = (DID_BAD_TARGET << 16); 2797 done(cmd); 2798 } 2799 2800 spin_unlock(ap->lock); 2801 spin_lock(shost->host_lock); 2802 return rc; 2803 } 2804 2805 /** 2806 * ata_scsi_simulate - simulate SCSI command on ATA device 2807 * @dev: the target device 2808 * @cmd: SCSI command being sent to device. 2809 * @done: SCSI command completion function. 2810 * 2811 * Interprets and directly executes a select list of SCSI commands 2812 * that can be handled internally. 2813 * 2814 * LOCKING: 2815 * spin_lock_irqsave(host lock) 2816 */ 2817 2818 void ata_scsi_simulate(struct ata_device *dev, struct scsi_cmnd *cmd, 2819 void (*done)(struct scsi_cmnd *)) 2820 { 2821 struct ata_scsi_args args; 2822 const u8 *scsicmd = cmd->cmnd; 2823 2824 args.dev = dev; 2825 args.id = dev->id; 2826 args.cmd = cmd; 2827 args.done = done; 2828 2829 switch(scsicmd[0]) { 2830 /* no-op's, complete with success */ 2831 case SYNCHRONIZE_CACHE: 2832 case REZERO_UNIT: 2833 case SEEK_6: 2834 case SEEK_10: 2835 case TEST_UNIT_READY: 2836 case FORMAT_UNIT: /* FIXME: correct? */ 2837 case SEND_DIAGNOSTIC: /* FIXME: correct? */ 2838 ata_scsi_rbuf_fill(&args, ata_scsiop_noop); 2839 break; 2840 2841 case INQUIRY: 2842 if (scsicmd[1] & 2) /* is CmdDt set? */ 2843 ata_scsi_invalid_field(cmd, done); 2844 else if ((scsicmd[1] & 1) == 0) /* is EVPD clear? */ 2845 ata_scsi_rbuf_fill(&args, ata_scsiop_inq_std); 2846 else if (scsicmd[2] == 0x00) 2847 ata_scsi_rbuf_fill(&args, ata_scsiop_inq_00); 2848 else if (scsicmd[2] == 0x80) 2849 ata_scsi_rbuf_fill(&args, ata_scsiop_inq_80); 2850 else if (scsicmd[2] == 0x83) 2851 ata_scsi_rbuf_fill(&args, ata_scsiop_inq_83); 2852 else 2853 ata_scsi_invalid_field(cmd, done); 2854 break; 2855 2856 case MODE_SENSE: 2857 case MODE_SENSE_10: 2858 ata_scsi_rbuf_fill(&args, ata_scsiop_mode_sense); 2859 break; 2860 2861 case MODE_SELECT: /* unconditionally return */ 2862 case MODE_SELECT_10: /* bad-field-in-cdb */ 2863 ata_scsi_invalid_field(cmd, done); 2864 break; 2865 2866 case READ_CAPACITY: 2867 ata_scsi_rbuf_fill(&args, ata_scsiop_read_cap); 2868 break; 2869 2870 case SERVICE_ACTION_IN: 2871 if ((scsicmd[1] & 0x1f) == SAI_READ_CAPACITY_16) 2872 ata_scsi_rbuf_fill(&args, ata_scsiop_read_cap); 2873 else 2874 ata_scsi_invalid_field(cmd, done); 2875 break; 2876 2877 case REPORT_LUNS: 2878 ata_scsi_rbuf_fill(&args, ata_scsiop_report_luns); 2879 break; 2880 2881 /* mandatory commands we haven't implemented yet */ 2882 case REQUEST_SENSE: 2883 2884 /* all other commands */ 2885 default: 2886 ata_scsi_set_sense(cmd, ILLEGAL_REQUEST, 0x20, 0x0); 2887 /* "Invalid command operation code" */ 2888 done(cmd); 2889 break; 2890 } 2891 } 2892 2893 int ata_scsi_add_hosts(struct ata_host *host, struct scsi_host_template *sht) 2894 { 2895 int i, rc; 2896 2897 for (i = 0; i < host->n_ports; i++) { 2898 struct ata_port *ap = host->ports[i]; 2899 struct Scsi_Host *shost; 2900 2901 rc = -ENOMEM; 2902 shost = scsi_host_alloc(sht, sizeof(struct ata_port *)); 2903 if (!shost) 2904 goto err_alloc; 2905 2906 *(struct ata_port **)&shost->hostdata[0] = ap; 2907 ap->scsi_host = shost; 2908 2909 shost->transportt = &ata_scsi_transport_template; 2910 shost->unique_id = ap->print_id; 2911 shost->max_id = 16; 2912 shost->max_lun = 1; 2913 shost->max_channel = 1; 2914 shost->max_cmd_len = 16; 2915 2916 rc = scsi_add_host(ap->scsi_host, ap->host->dev); 2917 if (rc) 2918 goto err_add; 2919 } 2920 2921 return 0; 2922 2923 err_add: 2924 scsi_host_put(host->ports[i]->scsi_host); 2925 err_alloc: 2926 while (--i >= 0) { 2927 struct Scsi_Host *shost = host->ports[i]->scsi_host; 2928 2929 scsi_remove_host(shost); 2930 scsi_host_put(shost); 2931 } 2932 return rc; 2933 } 2934 2935 void ata_scsi_scan_host(struct ata_port *ap) 2936 { 2937 unsigned int i; 2938 2939 if (ap->flags & ATA_FLAG_DISABLED) 2940 return; 2941 2942 for (i = 0; i < ATA_MAX_DEVICES; i++) { 2943 struct ata_device *dev = &ap->device[i]; 2944 struct scsi_device *sdev; 2945 2946 if (!ata_dev_enabled(dev) || dev->sdev) 2947 continue; 2948 2949 sdev = __scsi_add_device(ap->scsi_host, 0, i, 0, NULL); 2950 if (!IS_ERR(sdev)) { 2951 dev->sdev = sdev; 2952 scsi_device_put(sdev); 2953 } 2954 } 2955 } 2956 2957 /** 2958 * ata_scsi_offline_dev - offline attached SCSI device 2959 * @dev: ATA device to offline attached SCSI device for 2960 * 2961 * This function is called from ata_eh_hotplug() and responsible 2962 * for taking the SCSI device attached to @dev offline. This 2963 * function is called with host lock which protects dev->sdev 2964 * against clearing. 2965 * 2966 * LOCKING: 2967 * spin_lock_irqsave(host lock) 2968 * 2969 * RETURNS: 2970 * 1 if attached SCSI device exists, 0 otherwise. 2971 */ 2972 int ata_scsi_offline_dev(struct ata_device *dev) 2973 { 2974 if (dev->sdev) { 2975 scsi_device_set_state(dev->sdev, SDEV_OFFLINE); 2976 return 1; 2977 } 2978 return 0; 2979 } 2980 2981 /** 2982 * ata_scsi_remove_dev - remove attached SCSI device 2983 * @dev: ATA device to remove attached SCSI device for 2984 * 2985 * This function is called from ata_eh_scsi_hotplug() and 2986 * responsible for removing the SCSI device attached to @dev. 2987 * 2988 * LOCKING: 2989 * Kernel thread context (may sleep). 2990 */ 2991 static void ata_scsi_remove_dev(struct ata_device *dev) 2992 { 2993 struct ata_port *ap = dev->ap; 2994 struct scsi_device *sdev; 2995 unsigned long flags; 2996 2997 /* Alas, we need to grab scan_mutex to ensure SCSI device 2998 * state doesn't change underneath us and thus 2999 * scsi_device_get() always succeeds. The mutex locking can 3000 * be removed if there is __scsi_device_get() interface which 3001 * increments reference counts regardless of device state. 3002 */ 3003 mutex_lock(&ap->scsi_host->scan_mutex); 3004 spin_lock_irqsave(ap->lock, flags); 3005 3006 /* clearing dev->sdev is protected by host lock */ 3007 sdev = dev->sdev; 3008 dev->sdev = NULL; 3009 3010 if (sdev) { 3011 /* If user initiated unplug races with us, sdev can go 3012 * away underneath us after the host lock and 3013 * scan_mutex are released. Hold onto it. 3014 */ 3015 if (scsi_device_get(sdev) == 0) { 3016 /* The following ensures the attached sdev is 3017 * offline on return from ata_scsi_offline_dev() 3018 * regardless it wins or loses the race 3019 * against this function. 3020 */ 3021 scsi_device_set_state(sdev, SDEV_OFFLINE); 3022 } else { 3023 WARN_ON(1); 3024 sdev = NULL; 3025 } 3026 } 3027 3028 spin_unlock_irqrestore(ap->lock, flags); 3029 mutex_unlock(&ap->scsi_host->scan_mutex); 3030 3031 if (sdev) { 3032 ata_dev_printk(dev, KERN_INFO, "detaching (SCSI %s)\n", 3033 sdev->sdev_gendev.bus_id); 3034 3035 scsi_remove_device(sdev); 3036 scsi_device_put(sdev); 3037 } 3038 } 3039 3040 /** 3041 * ata_scsi_hotplug - SCSI part of hotplug 3042 * @work: Pointer to ATA port to perform SCSI hotplug on 3043 * 3044 * Perform SCSI part of hotplug. It's executed from a separate 3045 * workqueue after EH completes. This is necessary because SCSI 3046 * hot plugging requires working EH and hot unplugging is 3047 * synchronized with hot plugging with a mutex. 3048 * 3049 * LOCKING: 3050 * Kernel thread context (may sleep). 3051 */ 3052 void ata_scsi_hotplug(struct work_struct *work) 3053 { 3054 struct ata_port *ap = 3055 container_of(work, struct ata_port, hotplug_task.work); 3056 int i; 3057 3058 if (ap->pflags & ATA_PFLAG_UNLOADING) { 3059 DPRINTK("ENTER/EXIT - unloading\n"); 3060 return; 3061 } 3062 3063 DPRINTK("ENTER\n"); 3064 3065 /* unplug detached devices */ 3066 for (i = 0; i < ATA_MAX_DEVICES; i++) { 3067 struct ata_device *dev = &ap->device[i]; 3068 unsigned long flags; 3069 3070 if (!(dev->flags & ATA_DFLAG_DETACHED)) 3071 continue; 3072 3073 spin_lock_irqsave(ap->lock, flags); 3074 dev->flags &= ~ATA_DFLAG_DETACHED; 3075 spin_unlock_irqrestore(ap->lock, flags); 3076 3077 ata_scsi_remove_dev(dev); 3078 } 3079 3080 /* scan for new ones */ 3081 ata_scsi_scan_host(ap); 3082 3083 /* If we scanned while EH was in progress, scan would have 3084 * failed silently. Requeue if there are enabled but 3085 * unattached devices. 3086 */ 3087 for (i = 0; i < ATA_MAX_DEVICES; i++) { 3088 struct ata_device *dev = &ap->device[i]; 3089 if (ata_dev_enabled(dev) && !dev->sdev) { 3090 queue_delayed_work(ata_aux_wq, &ap->hotplug_task, 3091 round_jiffies_relative(HZ)); 3092 break; 3093 } 3094 } 3095 3096 DPRINTK("EXIT\n"); 3097 } 3098 3099 /** 3100 * ata_scsi_user_scan - indication for user-initiated bus scan 3101 * @shost: SCSI host to scan 3102 * @channel: Channel to scan 3103 * @id: ID to scan 3104 * @lun: LUN to scan 3105 * 3106 * This function is called when user explicitly requests bus 3107 * scan. Set probe pending flag and invoke EH. 3108 * 3109 * LOCKING: 3110 * SCSI layer (we don't care) 3111 * 3112 * RETURNS: 3113 * Zero. 3114 */ 3115 static int ata_scsi_user_scan(struct Scsi_Host *shost, unsigned int channel, 3116 unsigned int id, unsigned int lun) 3117 { 3118 struct ata_port *ap = ata_shost_to_port(shost); 3119 unsigned long flags; 3120 int rc = 0; 3121 3122 if (!ap->ops->error_handler) 3123 return -EOPNOTSUPP; 3124 3125 if ((channel != SCAN_WILD_CARD && channel != 0) || 3126 (lun != SCAN_WILD_CARD && lun != 0)) 3127 return -EINVAL; 3128 3129 spin_lock_irqsave(ap->lock, flags); 3130 3131 if (id == SCAN_WILD_CARD) { 3132 ap->eh_info.probe_mask |= (1 << ATA_MAX_DEVICES) - 1; 3133 ap->eh_info.action |= ATA_EH_SOFTRESET; 3134 } else { 3135 struct ata_device *dev = ata_find_dev(ap, id); 3136 3137 if (dev) { 3138 ap->eh_info.probe_mask |= 1 << dev->devno; 3139 ap->eh_info.action |= ATA_EH_SOFTRESET; 3140 ap->eh_info.flags |= ATA_EHI_RESUME_LINK; 3141 } else 3142 rc = -EINVAL; 3143 } 3144 3145 if (rc == 0) { 3146 ata_port_schedule_eh(ap); 3147 spin_unlock_irqrestore(ap->lock, flags); 3148 ata_port_wait_eh(ap); 3149 } else 3150 spin_unlock_irqrestore(ap->lock, flags); 3151 3152 return rc; 3153 } 3154 3155 /** 3156 * ata_scsi_dev_rescan - initiate scsi_rescan_device() 3157 * @work: Pointer to ATA port to perform scsi_rescan_device() 3158 * 3159 * After ATA pass thru (SAT) commands are executed successfully, 3160 * libata need to propagate the changes to SCSI layer. This 3161 * function must be executed from ata_aux_wq such that sdev 3162 * attach/detach don't race with rescan. 3163 * 3164 * LOCKING: 3165 * Kernel thread context (may sleep). 3166 */ 3167 void ata_scsi_dev_rescan(struct work_struct *work) 3168 { 3169 struct ata_port *ap = 3170 container_of(work, struct ata_port, scsi_rescan_task); 3171 unsigned long flags; 3172 unsigned int i; 3173 3174 spin_lock_irqsave(ap->lock, flags); 3175 3176 for (i = 0; i < ATA_MAX_DEVICES; i++) { 3177 struct ata_device *dev = &ap->device[i]; 3178 struct scsi_device *sdev = dev->sdev; 3179 3180 if (!ata_dev_enabled(dev) || !sdev) 3181 continue; 3182 if (scsi_device_get(sdev)) 3183 continue; 3184 3185 spin_unlock_irqrestore(ap->lock, flags); 3186 scsi_rescan_device(&(sdev->sdev_gendev)); 3187 scsi_device_put(sdev); 3188 spin_lock_irqsave(ap->lock, flags); 3189 } 3190 3191 spin_unlock_irqrestore(ap->lock, flags); 3192 } 3193 3194 /** 3195 * ata_sas_port_alloc - Allocate port for a SAS attached SATA device 3196 * @host: ATA host container for all SAS ports 3197 * @port_info: Information from low-level host driver 3198 * @shost: SCSI host that the scsi device is attached to 3199 * 3200 * LOCKING: 3201 * PCI/etc. bus probe sem. 3202 * 3203 * RETURNS: 3204 * ata_port pointer on success / NULL on failure. 3205 */ 3206 3207 struct ata_port *ata_sas_port_alloc(struct ata_host *host, 3208 struct ata_port_info *port_info, 3209 struct Scsi_Host *shost) 3210 { 3211 struct ata_port *ap; 3212 3213 ap = ata_port_alloc(host); 3214 if (!ap) 3215 return NULL; 3216 3217 ap->port_no = 0; 3218 ap->lock = shost->host_lock; 3219 ap->pio_mask = port_info->pio_mask; 3220 ap->mwdma_mask = port_info->mwdma_mask; 3221 ap->udma_mask = port_info->udma_mask; 3222 ap->flags |= port_info->flags; 3223 ap->ops = port_info->port_ops; 3224 ap->cbl = ATA_CBL_SATA; 3225 3226 return ap; 3227 } 3228 EXPORT_SYMBOL_GPL(ata_sas_port_alloc); 3229 3230 /** 3231 * ata_sas_port_start - Set port up for dma. 3232 * @ap: Port to initialize 3233 * 3234 * Called just after data structures for each port are 3235 * initialized. Allocates DMA pad. 3236 * 3237 * May be used as the port_start() entry in ata_port_operations. 3238 * 3239 * LOCKING: 3240 * Inherited from caller. 3241 */ 3242 int ata_sas_port_start(struct ata_port *ap) 3243 { 3244 return ata_pad_alloc(ap, ap->dev); 3245 } 3246 EXPORT_SYMBOL_GPL(ata_sas_port_start); 3247 3248 /** 3249 * ata_port_stop - Undo ata_sas_port_start() 3250 * @ap: Port to shut down 3251 * 3252 * Frees the DMA pad. 3253 * 3254 * May be used as the port_stop() entry in ata_port_operations. 3255 * 3256 * LOCKING: 3257 * Inherited from caller. 3258 */ 3259 3260 void ata_sas_port_stop(struct ata_port *ap) 3261 { 3262 ata_pad_free(ap, ap->dev); 3263 } 3264 EXPORT_SYMBOL_GPL(ata_sas_port_stop); 3265 3266 /** 3267 * ata_sas_port_init - Initialize a SATA device 3268 * @ap: SATA port to initialize 3269 * 3270 * LOCKING: 3271 * PCI/etc. bus probe sem. 3272 * 3273 * RETURNS: 3274 * Zero on success, non-zero on error. 3275 */ 3276 3277 int ata_sas_port_init(struct ata_port *ap) 3278 { 3279 int rc = ap->ops->port_start(ap); 3280 3281 if (!rc) { 3282 ap->print_id = ata_print_id++; 3283 rc = ata_bus_probe(ap); 3284 } 3285 3286 return rc; 3287 } 3288 EXPORT_SYMBOL_GPL(ata_sas_port_init); 3289 3290 /** 3291 * ata_sas_port_destroy - Destroy a SATA port allocated by ata_sas_port_alloc 3292 * @ap: SATA port to destroy 3293 * 3294 */ 3295 3296 void ata_sas_port_destroy(struct ata_port *ap) 3297 { 3298 if (ap->ops->port_stop) 3299 ap->ops->port_stop(ap); 3300 kfree(ap); 3301 } 3302 EXPORT_SYMBOL_GPL(ata_sas_port_destroy); 3303 3304 /** 3305 * ata_sas_slave_configure - Default slave_config routine for libata devices 3306 * @sdev: SCSI device to configure 3307 * @ap: ATA port to which SCSI device is attached 3308 * 3309 * RETURNS: 3310 * Zero. 3311 */ 3312 3313 int ata_sas_slave_configure(struct scsi_device *sdev, struct ata_port *ap) 3314 { 3315 ata_scsi_sdev_config(sdev); 3316 ata_scsi_dev_config(sdev, ap->device); 3317 return 0; 3318 } 3319 EXPORT_SYMBOL_GPL(ata_sas_slave_configure); 3320 3321 /** 3322 * ata_sas_queuecmd - Issue SCSI cdb to libata-managed device 3323 * @cmd: SCSI command to be sent 3324 * @done: Completion function, called when command is complete 3325 * @ap: ATA port to which the command is being sent 3326 * 3327 * RETURNS: 3328 * Return value from __ata_scsi_queuecmd() if @cmd can be queued, 3329 * 0 otherwise. 3330 */ 3331 3332 int ata_sas_queuecmd(struct scsi_cmnd *cmd, void (*done)(struct scsi_cmnd *), 3333 struct ata_port *ap) 3334 { 3335 int rc = 0; 3336 3337 ata_scsi_dump_cdb(ap, cmd); 3338 3339 if (likely(ata_scsi_dev_enabled(ap->device))) 3340 rc = __ata_scsi_queuecmd(cmd, done, ap->device); 3341 else { 3342 cmd->result = (DID_BAD_TARGET << 16); 3343 done(cmd); 3344 } 3345 return rc; 3346 } 3347 EXPORT_SYMBOL_GPL(ata_sas_queuecmd); 3348