git.oblomov.eu Git - linux-2.6/blob - drivers/ide/ide-cd.c

   1 /*
   2  * ATAPI CD-ROM driver.
   3  *
   4  * Copyright (C) 1994-1996   Scott Snyder <snyder@fnald0.fnal.gov>
   5  * Copyright (C) 1996-1998   Erik Andersen <andersee@debian.org>
   6  * Copyright (C) 1998-2000   Jens Axboe <axboe@suse.de>
   7  * Copyright (C) 2005, 2007-2009  Bartlomiej Zolnierkiewicz
   8  *
   9  * May be copied or modified under the terms of the GNU General Public
  10  * License.  See linux/COPYING for more information.
  11  *
  12  * See Documentation/cdrom/ide-cd for usage information.
  13  *
  14  * Suggestions are welcome. Patches that work are more welcome though. ;-)
  15  *
  16  * Documentation:
  17  *      Mt. Fuji (SFF8090 version 4) and ATAPI (SFF-8020i rev 2.6) standards.
  18  *
  19  * For historical changelog please see:
  20  *      Documentation/ide/ChangeLog.ide-cd.1994-2004
  21  */
  22
  23 #define DRV_NAME "ide-cd"
  24 #define PFX DRV_NAME ": "
  25
  26 #define IDECD_VERSION "5.00"
  27
  28 #include <linux/module.h>
  29 #include <linux/types.h>
  30 #include <linux/kernel.h>
  31 #include <linux/delay.h>
  32 #include <linux/timer.h>
  33 #include <linux/slab.h>
  34 #include <linux/interrupt.h>
  35 #include <linux/errno.h>
  36 #include <linux/cdrom.h>
  37 #include <linux/ide.h>
  38 #include <linux/completion.h>
  39 #include <linux/mutex.h>
  40 #include <linux/bcd.h>
  41
  42 /* For SCSI -> ATAPI command conversion */
  43 #include <scsi/scsi.h>
  44
  45 #include <linux/irq.h>
  46 #include <linux/io.h>
  47 #include <asm/byteorder.h>
  48 #include <linux/uaccess.h>
  49 #include <asm/unaligned.h>
  50
  51 #include "ide-cd.h"
  52
  53 static DEFINE_MUTEX(idecd_ref_mutex);
  54
  55 static void ide_cd_release(struct device *);
  56
  57 static struct cdrom_info *ide_cd_get(struct gendisk *disk)
  58 {
  59         struct cdrom_info *cd = NULL;
  60
  61         mutex_lock(&idecd_ref_mutex);
  62         cd = ide_drv_g(disk, cdrom_info);
  63         if (cd) {
  64                 if (ide_device_get(cd->drive))
  65                         cd = NULL;
  66                 else
  67                         get_device(&cd->dev);
  68
  69         }
  70         mutex_unlock(&idecd_ref_mutex);
  71         return cd;
  72 }
  73
  74 static void ide_cd_put(struct cdrom_info *cd)
  75 {
  76         ide_drive_t *drive = cd->drive;
  77
  78         mutex_lock(&idecd_ref_mutex);
  79         put_device(&cd->dev);
  80         ide_device_put(drive);
  81         mutex_unlock(&idecd_ref_mutex);
  82 }
  83
  84 /*
  85  * Generic packet command support and error handling routines.
  86  */
  87
  88 /* Mark that we've seen a media change and invalidate our internal buffers. */
  89 static void cdrom_saw_media_change(ide_drive_t *drive)
  90 {
  91         drive->dev_flags |= IDE_DFLAG_MEDIA_CHANGED;
  92         drive->atapi_flags &= ~IDE_AFLAG_TOC_VALID;
  93 }
  94
  95 static int cdrom_log_sense(ide_drive_t *drive, struct request *rq,
  96                            struct request_sense *sense)
  97 {
  98         int log = 0;
  99
 100         ide_debug_log(IDE_DBG_SENSE, "sense_key: 0x%x", sense->sense_key);
 101
 102         if (!sense || !rq || (rq->cmd_flags & REQ_QUIET))
 103                 return 0;
 104
 105         switch (sense->sense_key) {
 106         case NO_SENSE:
 107         case RECOVERED_ERROR:
 108                 break;
 109         case NOT_READY:
 110                 /*
 111                  * don't care about tray state messages for e.g. capacity
 112                  * commands or in-progress or becoming ready
 113                  */
 114                 if (sense->asc == 0x3a || sense->asc == 0x04)
 115                         break;
 116                 log = 1;
 117                 break;
 118         case ILLEGAL_REQUEST:
 119                 /*
 120                  * don't log START_STOP unit with LoEj set, since we cannot
 121                  * reliably check if drive can auto-close
 122                  */
 123                 if (rq->cmd[0] == GPCMD_START_STOP_UNIT && sense->asc == 0x24)
 124                         break;
 125                 log = 1;
 126                 break;
 127         case UNIT_ATTENTION:
 128                 /*
 129                  * Make good and sure we've seen this potential media change.
 130                  * Some drives (i.e. Creative) fail to present the correct sense
 131                  * key in the error register.
 132                  */
 133                 cdrom_saw_media_change(drive);
 134                 break;
 135         default:
 136                 log = 1;
 137                 break;
 138         }
 139         return log;
 140 }
 141
 142 static void cdrom_analyze_sense_data(ide_drive_t *drive,
 143                               struct request *failed_command,
 144                               struct request_sense *sense)
 145 {
 146         unsigned long sector;
 147         unsigned long bio_sectors;
 148         struct cdrom_info *info = drive->driver_data;
 149
 150         ide_debug_log(IDE_DBG_SENSE, "error_code: 0x%x, sense_key: 0x%x",
 151                                      sense->error_code, sense->sense_key);
 152
 153         if (failed_command)
 154                 ide_debug_log(IDE_DBG_SENSE, "failed cmd: 0x%x",
 155                                              failed_command->cmd[0]);
 156
 157         if (!cdrom_log_sense(drive, failed_command, sense))
 158                 return;
 159
 160         /*
 161          * If a read toc is executed for a CD-R or CD-RW medium where the first
 162          * toc has not been recorded yet, it will fail with 05/24/00 (which is a
 163          * confusing error)
 164          */
 165         if (failed_command && failed_command->cmd[0] == GPCMD_READ_TOC_PMA_ATIP)
 166                 if (sense->sense_key == 0x05 && sense->asc == 0x24)
 167                         return;
 168
 169         /* current error */
 170         if (sense->error_code == 0x70) {
 171                 switch (sense->sense_key) {
 172                 case MEDIUM_ERROR:
 173                 case VOLUME_OVERFLOW:
 174                 case ILLEGAL_REQUEST:
 175                         if (!sense->valid)
 176                                 break;
 177                         if (failed_command == NULL ||
 178                                         !blk_fs_request(failed_command))
 179                                 break;
 180                         sector = (sense->information[0] << 24) |
 181                                  (sense->information[1] << 16) |
 182                                  (sense->information[2] <<  8) |
 183                                  (sense->information[3]);
 184
 185                         if (drive->queue->hardsect_size == 2048)
 186                                 /* device sector size is 2K */
 187                                 sector <<= 2;
 188
 189                         bio_sectors = max(bio_sectors(failed_command->bio), 4U);
 190                         sector &= ~(bio_sectors - 1);
 191
 192                         /*
 193                          * The SCSI specification allows for the value
 194                          * returned by READ CAPACITY to be up to 75 2K
 195                          * sectors past the last readable block.
 196                          * Therefore, if we hit a medium error within the
 197                          * last 75 2K sectors, we decrease the saved size
 198                          * value.
 199                          */
 200                         if (sector < get_capacity(info->disk) &&
 201                             drive->probed_capacity - sector < 4 * 75)
 202                                 set_capacity(info->disk, sector);
 203                 }
 204         }
 205
 206         ide_cd_log_error(drive->name, failed_command, sense);
 207 }
 208
 209 static void ide_cd_complete_failed_rq(ide_drive_t *drive, struct request *rq)
 210 {
 211         /*
 212          * For REQ_TYPE_SENSE, "rq->special" points to the original
 213          * failed request.  Also, the sense data should be read
 214          * directly from rq which might be different from the original
 215          * sense buffer if it got copied during mapping.
 216          */
 217         struct request *failed = (struct request *)rq->special;
 218         void *sense = bio_data(rq->bio);
 219
 220         if (failed) {
 221                 if (failed->sense) {
 222                         /*
 223                          * Sense is always read into drive->sense_data.
 224                          * Copy back if the failed request has its
 225                          * sense pointer set.
 226                          */
 227                         memcpy(failed->sense, sense, 18);
 228                         sense = failed->sense;
 229                         failed->sense_len = rq->sense_len;
 230                 }
 231                 cdrom_analyze_sense_data(drive, failed, sense);
 232
 233                 if (ide_end_rq(drive, failed, -EIO, blk_rq_bytes(failed)))
 234                         BUG();
 235         } else
 236                 cdrom_analyze_sense_data(drive, NULL, sense);
 237 }
 238
 239
 240 /*
 241  * Allow the drive 5 seconds to recover; some devices will return NOT_READY
 242  * while flushing data from cache.
 243  *
 244  * returns: 0 failed (write timeout expired)
 245  *          1 success
 246  */
 247 static int ide_cd_breathe(ide_drive_t *drive, struct request *rq)
 248 {
 249
 250         struct cdrom_info *info = drive->driver_data;
 251
 252         if (!rq->errors)
 253                 info->write_timeout = jiffies + ATAPI_WAIT_WRITE_BUSY;
 254
 255         rq->errors = 1;
 256
 257         if (time_after(jiffies, info->write_timeout))
 258                 return 0;
 259         else {
 260                 struct request_queue *q = drive->queue;
 261                 unsigned long flags;
 262
 263                 /*
 264                  * take a breather relying on the unplug timer to kick us again
 265                  */
 266
 267                 spin_lock_irqsave(q->queue_lock, flags);
 268                 blk_plug_device(q);
 269                 spin_unlock_irqrestore(q->queue_lock, flags);
 270
 271                 return 1;
 272         }
 273 }
 274
 275 /**
 276  * Returns:
 277  * 0: if the request should be continued.
 278  * 1: if the request will be going through error recovery.
 279  * 2: if the request should be ended.
 280  */
 281 static int cdrom_decode_status(ide_drive_t *drive, u8 stat)
 282 {
 283         ide_hwif_t *hwif = drive->hwif;
 284         struct request *rq = hwif->rq;
 285         int err, sense_key, do_end_request = 0;
 286
 287         /* get the IDE error register */
 288         err = ide_read_error(drive);
 289         sense_key = err >> 4;
 290
 291         ide_debug_log(IDE_DBG_RQ, "cmd: 0x%x, rq->cmd_type: 0x%x, err: 0x%x, "
 292                                   "stat 0x%x",
 293                                   rq->cmd[0], rq->cmd_type, err, stat);
 294
 295         if (blk_sense_request(rq)) {
 296                 /*
 297                  * We got an error trying to get sense info from the drive
 298                  * (probably while trying to recover from a former error).
 299                  * Just give up.
 300                  */
 301                 rq->cmd_flags |= REQ_FAILED;
 302                 return 2;
 303         }
 304
 305         /* if we have an error, pass CHECK_CONDITION as the SCSI status byte */
 306         if (blk_pc_request(rq) && !rq->errors)
 307                 rq->errors = SAM_STAT_CHECK_CONDITION;
 308
 309         if (blk_noretry_request(rq))
 310                 do_end_request = 1;
 311
 312         switch (sense_key) {
 313         case NOT_READY:
 314                 if (blk_fs_request(rq) && rq_data_dir(rq) == WRITE) {
 315                         if (ide_cd_breathe(drive, rq))
 316                                 return 1;
 317                 } else {
 318                         cdrom_saw_media_change(drive);
 319
 320                         if (blk_fs_request(rq) && !blk_rq_quiet(rq))
 321                                 printk(KERN_ERR PFX "%s: tray open\n",
 322                                         drive->name);
 323                 }
 324                 do_end_request = 1;
 325                 break;
 326         case UNIT_ATTENTION:
 327                 cdrom_saw_media_change(drive);
 328
 329                 if (blk_fs_request(rq) == 0)
 330                         return 0;
 331
 332                 /*
 333                  * Arrange to retry the request but be sure to give up if we've
 334                  * retried too many times.
 335                  */
 336                 if (++rq->errors > ERROR_MAX)
 337                         do_end_request = 1;
 338                 break;
 339         case ILLEGAL_REQUEST:
 340                 /*
 341                  * Don't print error message for this condition -- SFF8090i
 342                  * indicates that 5/24/00 is the correct response to a request
 343                  * to close the tray if the drive doesn't have that capability.
 344                  *
 345                  * cdrom_log_sense() knows this!
 346                  */
 347                 if (rq->cmd[0] == GPCMD_START_STOP_UNIT)
 348                         break;
 349                 /* fall-through */
 350         case DATA_PROTECT:
 351                 /*
 352                  * No point in retrying after an illegal request or data
 353                  * protect error.
 354                  */
 355                 if (!blk_rq_quiet(rq))
 356                         ide_dump_status(drive, "command error", stat);
 357                 do_end_request = 1;
 358                 break;
 359         case MEDIUM_ERROR:
 360                 /*
 361                  * No point in re-trying a zillion times on a bad sector.
 362                  * If we got here the error is not correctable.
 363                  */
 364                 if (!blk_rq_quiet(rq))
 365                         ide_dump_status(drive, "media error "
 366                                         "(bad sector)", stat);
 367                 do_end_request = 1;
 368                 break;
 369         case BLANK_CHECK:
 370                 /* disk appears blank? */
 371                 if (!blk_rq_quiet(rq))
 372                         ide_dump_status(drive, "media error (blank)",
 373                                         stat);
 374                 do_end_request = 1;
 375                 break;
 376         default:
 377                 if (blk_fs_request(rq) == 0)
 378                         break;
 379                 if (err & ~ATA_ABORTED) {
 380                         /* go to the default handler for other errors */
 381                         ide_error(drive, "cdrom_decode_status", stat);
 382                         return 1;
 383                 } else if (++rq->errors > ERROR_MAX)
 384                         /* we've racked up too many retries, abort */
 385                         do_end_request = 1;
 386         }
 387
 388         if (blk_fs_request(rq) == 0) {
 389                 rq->cmd_flags |= REQ_FAILED;
 390                 do_end_request = 1;
 391         }
 392
 393         /*
 394          * End a request through request sense analysis when we have sense data.
 395          * We need this in order to perform end of media processing.
 396          */
 397         if (do_end_request)
 398                 goto end_request;
 399
 400         /* if we got a CHECK_CONDITION status, queue a request sense command */
 401         if (stat & ATA_ERR)
 402                 return ide_queue_sense_rq(drive, NULL) ? 2 : 1;
 403         return 1;
 404
 405 end_request:
 406         if (stat & ATA_ERR) {
 407                 struct request_queue *q = drive->queue;
 408                 unsigned long flags;
 409
 410                 spin_lock_irqsave(q->queue_lock, flags);
 411                 blkdev_dequeue_request(rq);
 412                 spin_unlock_irqrestore(q->queue_lock, flags);
 413
 414                 hwif->rq = NULL;
 415
 416                 return ide_queue_sense_rq(drive, rq) ? 2 : 1;
 417         } else
 418                 return 2;
 419 }
 420
 421 /*
 422  * Check the contents of the interrupt reason register from the cdrom
 423  * and attempt to recover if there are problems.  Returns  0 if everything's
 424  * ok; nonzero if the request has been terminated.
 425  */
 426 static int ide_cd_check_ireason(ide_drive_t *drive, struct request *rq,
 427                                 int len, int ireason, int rw)
 428 {
 429         ide_hwif_t *hwif = drive->hwif;
 430
 431         ide_debug_log(IDE_DBG_FUNC, "ireason: 0x%x, rw: 0x%x", ireason, rw);
 432
 433         /*
 434          * ireason == 0: the drive wants to receive data from us
 435          * ireason == 2: the drive is expecting to transfer data to us
 436          */
 437         if (ireason == (!rw << 1))
 438                 return 0;
 439         else if (ireason == (rw << 1)) {
 440
 441                 /* whoops... */
 442                 printk(KERN_ERR PFX "%s: %s: wrong transfer direction!\n",
 443                                 drive->name, __func__);
 444
 445                 ide_pad_transfer(drive, rw, len);
 446         } else  if (rw == 0 && ireason == 1) {
 447                 /*
 448                  * Some drives (ASUS) seem to tell us that status info is
 449                  * available.  Just get it and ignore.
 450                  */
 451                 (void)hwif->tp_ops->read_status(hwif);
 452                 return 0;
 453         } else {
 454                 /* drive wants a command packet, or invalid ireason... */
 455                 printk(KERN_ERR PFX "%s: %s: bad interrupt reason 0x%02x\n",
 456                                 drive->name, __func__, ireason);
 457         }
 458
 459         if (rq->cmd_type == REQ_TYPE_ATA_PC)
 460                 rq->cmd_flags |= REQ_FAILED;
 461
 462         return -1;
 463 }
 464
 465 static void ide_cd_request_sense_fixup(ide_drive_t *drive, struct ide_cmd *cmd)
 466 {
 467         struct request *rq = cmd->rq;
 468
 469         ide_debug_log(IDE_DBG_FUNC, "rq->cmd[0]: 0x%x", rq->cmd[0]);
 470
 471         /*
 472          * Some of the trailing request sense fields are optional,
 473          * and some drives don't send them.  Sigh.
 474          */
 475         if (rq->cmd[0] == GPCMD_REQUEST_SENSE &&
 476             cmd->nleft > 0 && cmd->nleft <= 5)
 477                 cmd->nleft = 0;
 478 }
 479
 480 int ide_cd_queue_pc(ide_drive_t *drive, const unsigned char *cmd,
 481                     int write, void *buffer, unsigned *bufflen,
 482                     struct request_sense *sense, int timeout,
 483                     unsigned int cmd_flags)
 484 {
 485         struct cdrom_info *info = drive->driver_data;
 486         struct request_sense local_sense;
 487         int retries = 10;
 488         unsigned int flags = 0;
 489
 490         if (!sense)
 491                 sense = &local_sense;
 492
 493         ide_debug_log(IDE_DBG_PC, "cmd[0]: 0x%x, write: 0x%x, timeout: %d, "
 494                                   "cmd_flags: 0x%x",
 495                                   cmd[0], write, timeout, cmd_flags);
 496
 497         /* start of retry loop */
 498         do {
 499                 struct request *rq;
 500                 int error;
 501
 502                 rq = blk_get_request(drive->queue, write, __GFP_WAIT);
 503
 504                 memcpy(rq->cmd, cmd, BLK_MAX_CDB);
 505                 rq->cmd_type = REQ_TYPE_ATA_PC;
 506                 rq->sense = sense;
 507                 rq->cmd_flags |= cmd_flags;
 508                 rq->timeout = timeout;
 509                 if (buffer) {
 510                         error = blk_rq_map_kern(drive->queue, rq, buffer,
 511                                                 *bufflen, GFP_NOIO);
 512                         if (error) {
 513                                 blk_put_request(rq);
 514                                 return error;
 515                         }
 516                 }
 517
 518                 error = blk_execute_rq(drive->queue, info->disk, rq, 0);
 519
 520                 if (buffer)
 521                         *bufflen = rq->data_len;
 522
 523                 flags = rq->cmd_flags;
 524                 blk_put_request(rq);
 525
 526                 /*
 527                  * FIXME: we should probably abort/retry or something in case of
 528                  * failure.
 529                  */
 530                 if (flags & REQ_FAILED) {
 531                         /*
 532                          * The request failed.  Retry if it was due to a unit
 533                          * attention status (usually means media was changed).
 534                          */
 535                         struct request_sense *reqbuf = sense;
 536
 537                         if (reqbuf->sense_key == UNIT_ATTENTION)
 538                                 cdrom_saw_media_change(drive);
 539                         else if (reqbuf->sense_key == NOT_READY &&
 540                                  reqbuf->asc == 4 && reqbuf->ascq != 4) {
 541                                 /*
 542                                  * The drive is in the process of loading
 543                                  * a disk.  Retry, but wait a little to give
 544                                  * the drive time to complete the load.
 545                                  */
 546                                 ssleep(2);
 547                         } else {
 548                                 /* otherwise, don't retry */
 549                                 retries = 0;
 550                         }
 551                         --retries;
 552                 }
 553
 554                 /* end of retry loop */
 555         } while ((flags & REQ_FAILED) && retries >= 0);
 556
 557         /* return an error if the command failed */
 558         return (flags & REQ_FAILED) ? -EIO : 0;
 559 }
 560
 561 static void ide_cd_error_cmd(ide_drive_t *drive, struct ide_cmd *cmd)
 562 {
 563         unsigned int nr_bytes = cmd->nbytes - cmd->nleft;
 564
 565         if (cmd->tf_flags & IDE_TFLAG_WRITE)
 566                 nr_bytes -= cmd->last_xfer_len;
 567
 568         if (nr_bytes > 0)
 569                 ide_complete_rq(drive, 0, nr_bytes);
 570 }
 571
 572 static ide_startstop_t cdrom_newpc_intr(ide_drive_t *drive)
 573 {
 574         ide_hwif_t *hwif = drive->hwif;
 575         struct ide_cmd *cmd = &hwif->cmd;
 576         struct request *rq = hwif->rq;
 577         ide_expiry_t *expiry = NULL;
 578         int dma_error = 0, dma, thislen, uptodate = 0;
 579         int write = (rq_data_dir(rq) == WRITE) ? 1 : 0, rc = 0, nsectors;
 580         int sense = blk_sense_request(rq);
 581         unsigned int timeout;
 582         u16 len;
 583         u8 ireason, stat;
 584
 585         ide_debug_log(IDE_DBG_PC, "cmd: 0x%x, write: 0x%x", rq->cmd[0], write);
 586
 587         /* check for errors */
 588         dma = drive->dma;
 589         if (dma) {
 590                 drive->dma = 0;
 591                 drive->waiting_for_dma = 0;
 592                 dma_error = hwif->dma_ops->dma_end(drive);
 593                 ide_dma_unmap_sg(drive, cmd);
 594                 if (dma_error) {
 595                         printk(KERN_ERR PFX "%s: DMA %s error\n", drive->name,
 596                                         write ? "write" : "read");
 597                         ide_dma_off(drive);
 598                 }
 599         }
 600
 601         /* check status */
 602         stat = hwif->tp_ops->read_status(hwif);
 603
 604         if (!OK_STAT(stat, 0, BAD_R_STAT)) {
 605                 rc = cdrom_decode_status(drive, stat);
 606                 if (rc) {
 607                         if (rc == 2)
 608                                 goto out_end;
 609                         return ide_stopped;
 610                 }
 611         }
 612
 613         /* using dma, transfer is complete now */
 614         if (dma) {
 615                 if (dma_error)
 616                         return ide_error(drive, "dma error", stat);
 617                 uptodate = 1;
 618                 goto out_end;
 619         }
 620
 621         ide_read_bcount_and_ireason(drive, &len, &ireason);
 622
 623         thislen = blk_fs_request(rq) ? len : cmd->nleft;
 624         if (thislen > len)
 625                 thislen = len;
 626
 627         ide_debug_log(IDE_DBG_PC, "DRQ: stat: 0x%x, thislen: %d",
 628                                   stat, thislen);
 629
 630         /* If DRQ is clear, the command has completed. */
 631         if ((stat & ATA_DRQ) == 0) {
 632                 if (blk_fs_request(rq)) {
 633                         /*
 634                          * If we're not done reading/writing, complain.
 635                          * Otherwise, complete the command normally.
 636                          */
 637                         uptodate = 1;
 638                         if (cmd->nleft > 0) {
 639                                 printk(KERN_ERR PFX "%s: %s: data underrun "
 640                                         "(%u bytes)\n", drive->name, __func__,
 641                                         cmd->nleft);
 642                                 if (!write)
 643                                         rq->cmd_flags |= REQ_FAILED;
 644                                 uptodate = 0;
 645                         }
 646                 } else if (!blk_pc_request(rq)) {
 647                         ide_cd_request_sense_fixup(drive, cmd);
 648                         /* complain if we still have data left to transfer */
 649                         uptodate = cmd->nleft ? 0 : 1;
 650                         if (uptodate == 0)
 651                                 rq->cmd_flags |= REQ_FAILED;
 652                 }
 653                 goto out_end;
 654         }
 655
 656         /* check which way to transfer data */
 657         rc = ide_cd_check_ireason(drive, rq, len, ireason, write);
 658         if (rc)
 659                 goto out_end;
 660
 661         cmd->last_xfer_len = 0;
 662
 663         ide_debug_log(IDE_DBG_PC, "data transfer, rq->cmd_type: 0x%x, "
 664                                   "ireason: 0x%x",
 665                                   rq->cmd_type, ireason);
 666
 667         /* transfer data */
 668         while (thislen > 0) {
 669                 int blen = min_t(int, thislen, cmd->nleft);
 670
 671                 if (cmd->nleft == 0)
 672                         break;
 673
 674                 ide_pio_bytes(drive, cmd, write, blen);
 675                 cmd->last_xfer_len += blen;
 676
 677                 thislen -= blen;
 678                 len -= blen;
 679
 680                 if (sense && write == 0)
 681                         rq->sense_len += blen;
 682         }
 683
 684         /* pad, if necessary */
 685         if (len > 0) {
 686                 if (blk_fs_request(rq) == 0 || write == 0)
 687                         ide_pad_transfer(drive, write, len);
 688                 else {
 689                         printk(KERN_ERR PFX "%s: confused, missing data\n",
 690                                 drive->name);
 691                         blk_dump_rq_flags(rq, "cdrom_newpc_intr");
 692                 }
 693         }
 694
 695         if (blk_pc_request(rq)) {
 696                 timeout = rq->timeout;
 697         } else {
 698                 timeout = ATAPI_WAIT_PC;
 699                 if (!blk_fs_request(rq))
 700                         expiry = ide_cd_expiry;
 701         }
 702
 703         hwif->expiry = expiry;
 704         ide_set_handler(drive, cdrom_newpc_intr, timeout);
 705         return ide_started;
 706
 707 out_end:
 708         if (blk_pc_request(rq) && rc == 0) {
 709                 unsigned int dlen = rq->data_len;
 710
 711                 rq->data_len = 0;
 712
 713                 if (blk_end_request(rq, 0, dlen))
 714                         BUG();
 715
 716                 hwif->rq = NULL;
 717         } else {
 718                 if (sense && uptodate)
 719                         ide_cd_complete_failed_rq(drive, rq);
 720
 721                 if (blk_fs_request(rq)) {
 722                         if (cmd->nleft == 0)
 723                                 uptodate = 1;
 724                 } else {
 725                         if (uptodate <= 0 && rq->errors == 0)
 726                                 rq->errors = -EIO;
 727                 }
 728
 729                 if (uptodate == 0)
 730                         ide_cd_error_cmd(drive, cmd);
 731
 732                 /* make sure it's fully ended */
 733                 if (blk_pc_request(rq))
 734                         nsectors = (rq->data_len + 511) >> 9;
 735                 else
 736                         nsectors = rq->hard_nr_sectors;
 737
 738                 if (nsectors == 0)
 739                         nsectors = 1;
 740
 741                 if (blk_fs_request(rq) == 0) {
 742                         rq->data_len -= (cmd->nbytes - cmd->nleft);
 743                         if (uptodate == 0 && (cmd->tf_flags & IDE_TFLAG_WRITE))
 744                                 rq->data_len += cmd->last_xfer_len;
 745                 }
 746
 747                 ide_complete_rq(drive, uptodate ? 0 : -EIO, nsectors << 9);
 748
 749                 if (sense && rc == 2)
 750                         ide_error(drive, "request sense failure", stat);
 751         }
 752         return ide_stopped;
 753 }
 754
 755 static ide_startstop_t cdrom_start_rw(ide_drive_t *drive, struct request *rq)
 756 {
 757         struct cdrom_info *cd = drive->driver_data;
 758         struct request_queue *q = drive->queue;
 759         int write = rq_data_dir(rq) == WRITE;
 760         unsigned short sectors_per_frame =
 761                 queue_hardsect_size(q) >> SECTOR_BITS;
 762
 763         ide_debug_log(IDE_DBG_RQ, "rq->cmd[0]: 0x%x, rq->cmd_flags: 0x%x, "
 764                                   "secs_per_frame: %u",
 765                                   rq->cmd[0], rq->cmd_flags, sectors_per_frame);
 766
 767         if (write) {
 768                 /* disk has become write protected */
 769                 if (get_disk_ro(cd->disk))
 770                         return ide_stopped;
 771         } else {
 772                 /*
 773                  * We may be retrying this request after an error.  Fix up any
 774                  * weirdness which might be present in the request packet.
 775                  */
 776                 q->prep_rq_fn(q, rq);
 777         }
 778
 779         /* fs requests *must* be hardware frame aligned */
 780         if ((rq->nr_sectors & (sectors_per_frame - 1)) ||
 781             (rq->sector & (sectors_per_frame - 1)))
 782                 return ide_stopped;
 783
 784         /* use DMA, if possible */
 785         drive->dma = !!(drive->dev_flags & IDE_DFLAG_USING_DMA);
 786
 787         if (write)
 788                 cd->devinfo.media_written = 1;
 789
 790         rq->timeout = ATAPI_WAIT_PC;
 791
 792         return ide_started;
 793 }
 794
 795 static void cdrom_do_block_pc(ide_drive_t *drive, struct request *rq)
 796 {
 797
 798         ide_debug_log(IDE_DBG_PC, "rq->cmd[0]: 0x%x, rq->cmd_type: 0x%x",
 799                                   rq->cmd[0], rq->cmd_type);
 800
 801         if (blk_pc_request(rq))
 802                 rq->cmd_flags |= REQ_QUIET;
 803         else
 804                 rq->cmd_flags &= ~REQ_FAILED;
 805
 806         drive->dma = 0;
 807
 808         /* sg request */
 809         if (rq->bio) {
 810                 struct request_queue *q = drive->queue;
 811                 char *buf = bio_data(rq->bio);
 812                 unsigned int alignment;
 813
 814                 drive->dma = !!(drive->dev_flags & IDE_DFLAG_USING_DMA);
 815
 816                 /*
 817                  * check if dma is safe
 818                  *
 819                  * NOTE! The "len" and "addr" checks should possibly have
 820                  * separate masks.
 821                  */
 822                 alignment = queue_dma_alignment(q) | q->dma_pad_mask;
 823                 if ((unsigned long)buf & alignment
 824                     || rq->data_len & q->dma_pad_mask
 825                     || object_is_on_stack(buf))
 826                         drive->dma = 0;
 827         }
 828 }
 829
 830 static ide_startstop_t ide_cd_do_request(ide_drive_t *drive, struct request *rq,
 831                                         sector_t block)
 832 {
 833         struct ide_cmd cmd;
 834         int uptodate = 0, nsectors;
 835
 836         ide_debug_log(IDE_DBG_RQ, "cmd: 0x%x, block: %llu",
 837                                   rq->cmd[0], (unsigned long long)block);
 838
 839         if (drive->debug_mask & IDE_DBG_RQ)
 840                 blk_dump_rq_flags(rq, "ide_cd_do_request");
 841
 842         if (blk_fs_request(rq)) {
 843                 if (cdrom_start_rw(drive, rq) == ide_stopped)
 844                         goto out_end;
 845         } else if (blk_sense_request(rq) || blk_pc_request(rq) ||
 846                    rq->cmd_type == REQ_TYPE_ATA_PC) {
 847                 if (!rq->timeout)
 848                         rq->timeout = ATAPI_WAIT_PC;
 849
 850                 cdrom_do_block_pc(drive, rq);
 851         } else if (blk_special_request(rq)) {
 852                 /* right now this can only be a reset... */
 853                 uptodate = 1;
 854                 goto out_end;
 855         } else {
 856                 blk_dump_rq_flags(rq, DRV_NAME " bad flags");
 857                 if (rq->errors == 0)
 858                         rq->errors = -EIO;
 859                 goto out_end;
 860         }
 861
 862         /* prepare sense request for this command */
 863         ide_prep_sense(drive, rq);
 864
 865         memset(&cmd, 0, sizeof(cmd));
 866
 867         if (rq_data_dir(rq))
 868                 cmd.tf_flags |= IDE_TFLAG_WRITE;
 869
 870         cmd.rq = rq;
 871
 872         if (blk_fs_request(rq) || rq->data_len) {
 873                 ide_init_sg_cmd(&cmd, blk_fs_request(rq) ? (rq->nr_sectors << 9)
 874                                                          : rq->data_len);
 875                 ide_map_sg(drive, &cmd);
 876         }
 877
 878         return ide_issue_pc(drive, &cmd);
 879 out_end:
 880         nsectors = rq->hard_nr_sectors;
 881
 882         if (nsectors == 0)
 883                 nsectors = 1;
 884
 885         ide_complete_rq(drive, uptodate ? 0 : -EIO, nsectors << 9);
 886
 887         return ide_stopped;
 888 }
 889
 890 /*
 891  * Ioctl handling.
 892  *
 893  * Routines which queue packet commands take as a final argument a pointer to a
 894  * request_sense struct. If execution of the command results in an error with a
 895  * CHECK CONDITION status, this structure will be filled with the results of the
 896  * subsequent request sense command. The pointer can also be NULL, in which case
 897  * no sense information is returned.
 898  */
 899 static void msf_from_bcd(struct atapi_msf *msf)
 900 {
 901         msf->minute = bcd2bin(msf->minute);
 902         msf->second = bcd2bin(msf->second);
 903         msf->frame  = bcd2bin(msf->frame);
 904 }
 905
 906 int cdrom_check_status(ide_drive_t *drive, struct request_sense *sense)
 907 {
 908         struct cdrom_info *info = drive->driver_data;
 909         struct cdrom_device_info *cdi = &info->devinfo;
 910         unsigned char cmd[BLK_MAX_CDB];
 911
 912         ide_debug_log(IDE_DBG_FUNC, "enter");
 913
 914         memset(cmd, 0, BLK_MAX_CDB);
 915         cmd[0] = GPCMD_TEST_UNIT_READY;
 916
 917         /*
 918          * Sanyo 3 CD changer uses byte 7 of TEST_UNIT_READY to switch CDs
 919          * instead of supporting the LOAD_UNLOAD opcode.
 920          */
 921         cmd[7] = cdi->sanyo_slot % 3;
 922
 923         return ide_cd_queue_pc(drive, cmd, 0, NULL, NULL, sense, 0, REQ_QUIET);
 924 }
 925
 926 static int cdrom_read_capacity(ide_drive_t *drive, unsigned long *capacity,
 927                                unsigned long *sectors_per_frame,
 928                                struct request_sense *sense)
 929 {
 930         struct {
 931                 __be32 lba;
 932                 __be32 blocklen;
 933         } capbuf;
 934
 935         int stat;
 936         unsigned char cmd[BLK_MAX_CDB];
 937         unsigned len = sizeof(capbuf);
 938         u32 blocklen;
 939
 940         ide_debug_log(IDE_DBG_FUNC, "enter");
 941
 942         memset(cmd, 0, BLK_MAX_CDB);
 943         cmd[0] = GPCMD_READ_CDVD_CAPACITY;
 944
 945         stat = ide_cd_queue_pc(drive, cmd, 0, &capbuf, &len, sense, 0,
 946                                REQ_QUIET);
 947         if (stat)
 948                 return stat;
 949
 950         /*
 951          * Sanity check the given block size
 952          */
 953         blocklen = be32_to_cpu(capbuf.blocklen);
 954         switch (blocklen) {
 955         case 512:
 956         case 1024:
 957         case 2048:
 958         case 4096:
 959                 break;
 960         default:
 961                 printk(KERN_ERR PFX "%s: weird block size %u\n",
 962                                 drive->name, blocklen);
 963                 printk(KERN_ERR PFX "%s: default to 2kb block size\n",
 964                                 drive->name);
 965                 blocklen = 2048;
 966                 break;
 967         }
 968
 969         *capacity = 1 + be32_to_cpu(capbuf.lba);
 970         *sectors_per_frame = blocklen >> SECTOR_BITS;
 971
 972         ide_debug_log(IDE_DBG_PROBE, "cap: %lu, sectors_per_frame: %lu",
 973                                      *capacity, *sectors_per_frame);
 974
 975         return 0;
 976 }
 977
 978 static int cdrom_read_tocentry(ide_drive_t *drive, int trackno, int msf_flag,
 979                                 int format, char *buf, int buflen,
 980                                 struct request_sense *sense)
 981 {
 982         unsigned char cmd[BLK_MAX_CDB];
 983
 984         ide_debug_log(IDE_DBG_FUNC, "enter");
 985
 986         memset(cmd, 0, BLK_MAX_CDB);
 987
 988         cmd[0] = GPCMD_READ_TOC_PMA_ATIP;
 989         cmd[6] = trackno;
 990         cmd[7] = (buflen >> 8);
 991         cmd[8] = (buflen & 0xff);
 992         cmd[9] = (format << 6);
 993
 994         if (msf_flag)
 995                 cmd[1] = 2;
 996
 997         return ide_cd_queue_pc(drive, cmd, 0, buf, &buflen, sense, 0, REQ_QUIET);
 998 }
 999
1000 /* Try to read the entire TOC for the disk into our internal buffer. */
1001 int ide_cd_read_toc(ide_drive_t *drive, struct request_sense *sense)
1002 {
1003         int stat, ntracks, i;
1004         struct cdrom_info *info = drive->driver_data;
1005         struct cdrom_device_info *cdi = &info->devinfo;
1006         struct atapi_toc *toc = info->toc;
1007         struct {
1008                 struct atapi_toc_header hdr;
1009                 struct atapi_toc_entry  ent;
1010         } ms_tmp;
1011         long last_written;
1012         unsigned long sectors_per_frame = SECTORS_PER_FRAME;
1013
1014         ide_debug_log(IDE_DBG_FUNC, "enter");
1015
1016         if (toc == NULL) {
1017                 /* try to allocate space */
1018                 toc = kmalloc(sizeof(struct atapi_toc), GFP_KERNEL);
1019                 if (toc == NULL) {
1020                         printk(KERN_ERR PFX "%s: No cdrom TOC buffer!\n",
1021                                         drive->name);
1022                         return -ENOMEM;
1023                 }
1024                 info->toc = toc;
1025         }
1026
1027         /*
1028          * Check to see if the existing data is still valid. If it is,
1029          * just return.
1030          */
1031         (void) cdrom_check_status(drive, sense);
1032
1033         if (drive->atapi_flags & IDE_AFLAG_TOC_VALID)
1034                 return 0;
1035
1036         /* try to get the total cdrom capacity and sector size */
1037         stat = cdrom_read_capacity(drive, &toc->capacity, &sectors_per_frame,
1038                                    sense);
1039         if (stat)
1040                 toc->capacity = 0x1fffff;
1041
1042         set_capacity(info->disk, toc->capacity * sectors_per_frame);
1043         /* save a private copy of the TOC capacity for error handling */
1044         drive->probed_capacity = toc->capacity * sectors_per_frame;
1045
1046         blk_queue_hardsect_size(drive->queue,
1047                                 sectors_per_frame << SECTOR_BITS);
1048
1049         /* first read just the header, so we know how long the TOC is */
1050         stat = cdrom_read_tocentry(drive, 0, 1, 0, (char *) &toc->hdr,
1051                                     sizeof(struct atapi_toc_header), sense);
1052         if (stat)
1053                 return stat;
1054
1055         if (drive->atapi_flags & IDE_AFLAG_TOCTRACKS_AS_BCD) {
1056                 toc->hdr.first_track = bcd2bin(toc->hdr.first_track);
1057                 toc->hdr.last_track  = bcd2bin(toc->hdr.last_track);
1058         }
1059
1060         ntracks = toc->hdr.last_track - toc->hdr.first_track + 1;
1061         if (ntracks <= 0)
1062                 return -EIO;
1063         if (ntracks > MAX_TRACKS)
1064                 ntracks = MAX_TRACKS;
1065
1066         /* now read the whole schmeer */
1067         stat = cdrom_read_tocentry(drive, toc->hdr.first_track, 1, 0,
1068                                   (char *)&toc->hdr,
1069                                    sizeof(struct atapi_toc_header) +
1070                                    (ntracks + 1) *
1071                                    sizeof(struct atapi_toc_entry), sense);
1072
1073         if (stat && toc->hdr.first_track > 1) {
1074                 /*
1075                  * Cds with CDI tracks only don't have any TOC entries, despite
1076                  * of this the returned values are
1077                  * first_track == last_track = number of CDI tracks + 1,
1078                  * so that this case is indistinguishable from the same layout
1079                  * plus an additional audio track. If we get an error for the
1080                  * regular case, we assume a CDI without additional audio
1081                  * tracks. In this case the readable TOC is empty (CDI tracks
1082                  * are not included) and only holds the Leadout entry.
1083                  *
1084                  * Heiko Eißfeldt.
1085                  */
1086                 ntracks = 0;
1087                 stat = cdrom_read_tocentry(drive, CDROM_LEADOUT, 1, 0,
1088                                            (char *)&toc->hdr,
1089                                            sizeof(struct atapi_toc_header) +
1090                                            (ntracks + 1) *
1091                                            sizeof(struct atapi_toc_entry),
1092                                            sense);
1093                 if (stat)
1094                         return stat;
1095
1096                 if (drive->atapi_flags & IDE_AFLAG_TOCTRACKS_AS_BCD) {
1097                         toc->hdr.first_track = (u8)bin2bcd(CDROM_LEADOUT);
1098                         toc->hdr.last_track = (u8)bin2bcd(CDROM_LEADOUT);
1099                 } else {
1100                         toc->hdr.first_track = CDROM_LEADOUT;
1101                         toc->hdr.last_track = CDROM_LEADOUT;
1102                 }
1103         }
1104
1105         if (stat)
1106                 return stat;
1107
1108         toc->hdr.toc_length = be16_to_cpu(toc->hdr.toc_length);
1109
1110         if (drive->atapi_flags & IDE_AFLAG_TOCTRACKS_AS_BCD) {
1111                 toc->hdr.first_track = bcd2bin(toc->hdr.first_track);
1112                 toc->hdr.last_track  = bcd2bin(toc->hdr.last_track);
1113         }
1114
1115         for (i = 0; i <= ntracks; i++) {
1116                 if (drive->atapi_flags & IDE_AFLAG_TOCADDR_AS_BCD) {
1117                         if (drive->atapi_flags & IDE_AFLAG_TOCTRACKS_AS_BCD)
1118                                 toc->ent[i].track = bcd2bin(toc->ent[i].track);
1119                         msf_from_bcd(&toc->ent[i].addr.msf);
1120                 }
1121                 toc->ent[i].addr.lba = msf_to_lba(toc->ent[i].addr.msf.minute,
1122                                                   toc->ent[i].addr.msf.second,
1123                                                   toc->ent[i].addr.msf.frame);
1124         }
1125
1126         if (toc->hdr.first_track != CDROM_LEADOUT) {
1127                 /* read the multisession information */
1128                 stat = cdrom_read_tocentry(drive, 0, 0, 1, (char *)&ms_tmp,
1129                                            sizeof(ms_tmp), sense);
1130                 if (stat)
1131                         return stat;
1132
1133                 toc->last_session_lba = be32_to_cpu(ms_tmp.ent.addr.lba);
1134         } else {
1135                 ms_tmp.hdr.last_track = CDROM_LEADOUT;
1136                 ms_tmp.hdr.first_track = ms_tmp.hdr.last_track;
1137                 toc->last_session_lba = msf_to_lba(0, 2, 0); /* 0m 2s 0f */
1138         }
1139
1140         if (drive->atapi_flags & IDE_AFLAG_TOCADDR_AS_BCD) {
1141                 /* re-read multisession information using MSF format */
1142                 stat = cdrom_read_tocentry(drive, 0, 1, 1, (char *)&ms_tmp,
1143                                            sizeof(ms_tmp), sense);
1144                 if (stat)
1145                         return stat;
1146
1147                 msf_from_bcd(&ms_tmp.ent.addr.msf);
1148                 toc->last_session_lba = msf_to_lba(ms_tmp.ent.addr.msf.minute,
1149                                                    ms_tmp.ent.addr.msf.second,
1150                                                    ms_tmp.ent.addr.msf.frame);
1151         }
1152
1153         toc->xa_flag = (ms_tmp.hdr.first_track != ms_tmp.hdr.last_track);
1154
1155         /* now try to get the total cdrom capacity */
1156         stat = cdrom_get_last_written(cdi, &last_written);
1157         if (!stat && (last_written > toc->capacity)) {
1158                 toc->capacity = last_written;
1159                 set_capacity(info->disk, toc->capacity * sectors_per_frame);
1160                 drive->probed_capacity = toc->capacity * sectors_per_frame;
1161         }
1162
1163         /* Remember that we've read this stuff. */
1164         drive->atapi_flags |= IDE_AFLAG_TOC_VALID;
1165
1166         return 0;
1167 }
1168
1169 int ide_cdrom_get_capabilities(ide_drive_t *drive, u8 *buf)
1170 {
1171         struct cdrom_info *info = drive->driver_data;
1172         struct cdrom_device_info *cdi = &info->devinfo;
1173         struct packet_command cgc;
1174         int stat, attempts = 3, size = ATAPI_CAPABILITIES_PAGE_SIZE;
1175
1176         ide_debug_log(IDE_DBG_FUNC, "enter");
1177
1178         if ((drive->atapi_flags & IDE_AFLAG_FULL_CAPS_PAGE) == 0)
1179                 size -= ATAPI_CAPABILITIES_PAGE_PAD_SIZE;
1180
1181         init_cdrom_command(&cgc, buf, size, CGC_DATA_UNKNOWN);
1182         do {
1183                 /* we seem to get stat=0x01,err=0x00 the first time (??) */
1184                 stat = cdrom_mode_sense(cdi, &cgc, GPMODE_CAPABILITIES_PAGE, 0);
1185                 if (!stat)
1186                         break;
1187         } while (--attempts);
1188         return stat;
1189 }
1190
1191 void ide_cdrom_update_speed(ide_drive_t *drive, u8 *buf)
1192 {
1193         struct cdrom_info *cd = drive->driver_data;
1194         u16 curspeed, maxspeed;
1195
1196         ide_debug_log(IDE_DBG_FUNC, "enter");
1197
1198         if (drive->atapi_flags & IDE_AFLAG_LE_SPEED_FIELDS) {
1199                 curspeed = le16_to_cpup((__le16 *)&buf[8 + 14]);
1200                 maxspeed = le16_to_cpup((__le16 *)&buf[8 + 8]);
1201         } else {
1202                 curspeed = be16_to_cpup((__be16 *)&buf[8 + 14]);
1203                 maxspeed = be16_to_cpup((__be16 *)&buf[8 + 8]);
1204         }
1205
1206         ide_debug_log(IDE_DBG_PROBE, "curspeed: %u, maxspeed: %u",
1207                                      curspeed, maxspeed);
1208
1209         cd->current_speed = (curspeed + (176/2)) / 176;
1210         cd->max_speed = (maxspeed + (176/2)) / 176;
1211 }
1212
1213 #define IDE_CD_CAPABILITIES \
1214         (CDC_CLOSE_TRAY | CDC_OPEN_TRAY | CDC_LOCK | CDC_SELECT_SPEED | \
1215          CDC_SELECT_DISC | CDC_MULTI_SESSION | CDC_MCN | CDC_MEDIA_CHANGED | \
1216          CDC_PLAY_AUDIO | CDC_RESET | CDC_DRIVE_STATUS | CDC_CD_R | \
1217          CDC_CD_RW | CDC_DVD | CDC_DVD_R | CDC_DVD_RAM | CDC_GENERIC_PACKET | \
1218          CDC_MO_DRIVE | CDC_MRW | CDC_MRW_W | CDC_RAM)
1219
1220 static struct cdrom_device_ops ide_cdrom_dops = {
1221         .open                   = ide_cdrom_open_real,
1222         .release                = ide_cdrom_release_real,
1223         .drive_status           = ide_cdrom_drive_status,
1224         .media_changed          = ide_cdrom_check_media_change_real,
1225         .tray_move              = ide_cdrom_tray_move,
1226         .lock_door              = ide_cdrom_lock_door,
1227         .select_speed           = ide_cdrom_select_speed,
1228         .get_last_session       = ide_cdrom_get_last_session,
1229         .get_mcn                = ide_cdrom_get_mcn,
1230         .reset                  = ide_cdrom_reset,
1231         .audio_ioctl            = ide_cdrom_audio_ioctl,
1232         .capability             = IDE_CD_CAPABILITIES,
1233         .generic_packet         = ide_cdrom_packet,
1234 };
1235
1236 static int ide_cdrom_register(ide_drive_t *drive, int nslots)
1237 {
1238         struct cdrom_info *info = drive->driver_data;
1239         struct cdrom_device_info *devinfo = &info->devinfo;
1240
1241         ide_debug_log(IDE_DBG_PROBE, "nslots: %d", nslots);
1242
1243         devinfo->ops = &ide_cdrom_dops;
1244         devinfo->speed = info->current_speed;
1245         devinfo->capacity = nslots;
1246         devinfo->handle = drive;
1247         strcpy(devinfo->name, drive->name);
1248
1249         if (drive->atapi_flags & IDE_AFLAG_NO_SPEED_SELECT)
1250                 devinfo->mask |= CDC_SELECT_SPEED;
1251
1252         devinfo->disk = info->disk;
1253         return register_cdrom(devinfo);
1254 }
1255
1256 static int ide_cdrom_probe_capabilities(ide_drive_t *drive)
1257 {
1258         struct cdrom_info *cd = drive->driver_data;
1259         struct cdrom_device_info *cdi = &cd->devinfo;
1260         u8 buf[ATAPI_CAPABILITIES_PAGE_SIZE];
1261         mechtype_t mechtype;
1262         int nslots = 1;
1263
1264         ide_debug_log(IDE_DBG_PROBE, "media: 0x%x, atapi_flags: 0x%lx",
1265                                      drive->media, drive->atapi_flags);
1266
1267         cdi->mask = (CDC_CD_R | CDC_CD_RW | CDC_DVD | CDC_DVD_R |
1268                      CDC_DVD_RAM | CDC_SELECT_DISC | CDC_PLAY_AUDIO |
1269                      CDC_MO_DRIVE | CDC_RAM);
1270
1271         if (drive->media == ide_optical) {
1272                 cdi->mask &= ~(CDC_MO_DRIVE | CDC_RAM);
1273                 printk(KERN_ERR PFX "%s: ATAPI magneto-optical drive\n",
1274                                 drive->name);
1275                 return nslots;
1276         }
1277
1278         if (drive->atapi_flags & IDE_AFLAG_PRE_ATAPI12) {
1279                 drive->atapi_flags &= ~IDE_AFLAG_NO_EJECT;
1280                 cdi->mask &= ~CDC_PLAY_AUDIO;
1281                 return nslots;
1282         }
1283
1284         /*
1285          * We have to cheat a little here. the packet will eventually be queued
1286          * with ide_cdrom_packet(), which extracts the drive from cdi->handle.
1287          * Since this device hasn't been registered with the Uniform layer yet,
1288          * it can't do this. Same goes for cdi->ops.
1289          */
1290         cdi->handle = drive;
1291         cdi->ops = &ide_cdrom_dops;
1292
1293         if (ide_cdrom_get_capabilities(drive, buf))
1294                 return 0;
1295
1296         if ((buf[8 + 6] & 0x01) == 0)
1297                 drive->dev_flags &= ~IDE_DFLAG_DOORLOCKING;
1298         if (buf[8 + 6] & 0x08)
1299                 drive->atapi_flags &= ~IDE_AFLAG_NO_EJECT;
1300         if (buf[8 + 3] & 0x01)
1301                 cdi->mask &= ~CDC_CD_R;
1302         if (buf[8 + 3] & 0x02)
1303                 cdi->mask &= ~(CDC_CD_RW | CDC_RAM);
1304         if (buf[8 + 2] & 0x38)
1305                 cdi->mask &= ~CDC_DVD;
1306         if (buf[8 + 3] & 0x20)
1307                 cdi->mask &= ~(CDC_DVD_RAM | CDC_RAM);
1308         if (buf[8 + 3] & 0x10)
1309                 cdi->mask &= ~CDC_DVD_R;
1310         if ((buf[8 + 4] & 0x01) || (drive->atapi_flags & IDE_AFLAG_PLAY_AUDIO_OK))
1311                 cdi->mask &= ~CDC_PLAY_AUDIO;
1312
1313         mechtype = buf[8 + 6] >> 5;
1314         if (mechtype == mechtype_caddy ||
1315             mechtype == mechtype_popup ||
1316             (drive->atapi_flags & IDE_AFLAG_NO_AUTOCLOSE))
1317                 cdi->mask |= CDC_CLOSE_TRAY;
1318
1319         if (cdi->sanyo_slot > 0) {
1320                 cdi->mask &= ~CDC_SELECT_DISC;
1321                 nslots = 3;
1322         } else if (mechtype == mechtype_individual_changer ||
1323                    mechtype == mechtype_cartridge_changer) {
1324                 nslots = cdrom_number_of_slots(cdi);
1325                 if (nslots > 1)
1326                         cdi->mask &= ~CDC_SELECT_DISC;
1327         }
1328
1329         ide_cdrom_update_speed(drive, buf);
1330
1331         printk(KERN_INFO PFX "%s: ATAPI", drive->name);
1332
1333         /* don't print speed if the drive reported 0 */
1334         if (cd->max_speed)
1335                 printk(KERN_CONT " %dX", cd->max_speed);
1336
1337         printk(KERN_CONT " %s", (cdi->mask & CDC_DVD) ? "CD-ROM" : "DVD-ROM");
1338
1339         if ((cdi->mask & CDC_DVD_R) == 0 || (cdi->mask & CDC_DVD_RAM) == 0)
1340                 printk(KERN_CONT " DVD%s%s",
1341                                  (cdi->mask & CDC_DVD_R) ? "" : "-R",
1342                                  (cdi->mask & CDC_DVD_RAM) ? "" : "/RAM");
1343
1344         if ((cdi->mask & CDC_CD_R) == 0 || (cdi->mask & CDC_CD_RW) == 0)
1345                 printk(KERN_CONT " CD%s%s",
1346                                  (cdi->mask & CDC_CD_R) ? "" : "-R",
1347                                  (cdi->mask & CDC_CD_RW) ? "" : "/RW");
1348
1349         if ((cdi->mask & CDC_SELECT_DISC) == 0)
1350                 printk(KERN_CONT " changer w/%d slots", nslots);
1351         else
1352                 printk(KERN_CONT " drive");
1353
1354         printk(KERN_CONT ", %dkB Cache\n",
1355                          be16_to_cpup((__be16 *)&buf[8 + 12]));
1356
1357         return nslots;
1358 }
1359
1360 /* standard prep_rq_fn that builds 10 byte cmds */
1361 static int ide_cdrom_prep_fs(struct request_queue *q, struct request *rq)
1362 {
1363         int hard_sect = queue_hardsect_size(q);
1364         long block = (long)rq->hard_sector / (hard_sect >> 9);
1365         unsigned long blocks = rq->hard_nr_sectors / (hard_sect >> 9);
1366
1367         memset(rq->cmd, 0, BLK_MAX_CDB);
1368
1369         if (rq_data_dir(rq) == READ)
1370                 rq->cmd[0] = GPCMD_READ_10;
1371         else
1372                 rq->cmd[0] = GPCMD_WRITE_10;
1373
1374         /*
1375          * fill in lba
1376          */
1377         rq->cmd[2] = (block >> 24) & 0xff;
1378         rq->cmd[3] = (block >> 16) & 0xff;
1379         rq->cmd[4] = (block >>  8) & 0xff;
1380         rq->cmd[5] = block & 0xff;
1381
1382         /*
1383          * and transfer length
1384          */
1385         rq->cmd[7] = (blocks >> 8) & 0xff;
1386         rq->cmd[8] = blocks & 0xff;
1387         rq->cmd_len = 10;
1388         return BLKPREP_OK;
1389 }
1390
1391 /*
1392  * Most of the SCSI commands are supported directly by ATAPI devices.
1393  * This transform handles the few exceptions.
1394  */
1395 static int ide_cdrom_prep_pc(struct request *rq)
1396 {
1397         u8 *c = rq->cmd;
1398
1399         /* transform 6-byte read/write commands to the 10-byte version */
1400         if (c[0] == READ_6 || c[0] == WRITE_6) {
1401                 c[8] = c[4];
1402                 c[5] = c[3];
1403                 c[4] = c[2];
1404                 c[3] = c[1] & 0x1f;
1405                 c[2] = 0;
1406                 c[1] &= 0xe0;
1407                 c[0] += (READ_10 - READ_6);
1408                 rq->cmd_len = 10;
1409                 return BLKPREP_OK;
1410         }
1411
1412         /*
1413          * it's silly to pretend we understand 6-byte sense commands, just
1414          * reject with ILLEGAL_REQUEST and the caller should take the
1415          * appropriate action
1416          */
1417         if (c[0] == MODE_SENSE || c[0] == MODE_SELECT) {
1418                 rq->errors = ILLEGAL_REQUEST;
1419                 return BLKPREP_KILL;
1420         }
1421
1422         return BLKPREP_OK;
1423 }
1424
1425 static int ide_cdrom_prep_fn(struct request_queue *q, struct request *rq)
1426 {
1427         if (blk_fs_request(rq))
1428                 return ide_cdrom_prep_fs(q, rq);
1429         else if (blk_pc_request(rq))
1430                 return ide_cdrom_prep_pc(rq);
1431
1432         return 0;
1433 }
1434
1435 struct cd_list_entry {
1436         const char      *id_model;
1437         const char      *id_firmware;
1438         unsigned int    cd_flags;
1439 };
1440
1441 #ifdef CONFIG_IDE_PROC_FS
1442 static sector_t ide_cdrom_capacity(ide_drive_t *drive)
1443 {
1444         unsigned long capacity, sectors_per_frame;
1445
1446         if (cdrom_read_capacity(drive, &capacity, &sectors_per_frame, NULL))
1447                 return 0;
1448
1449         return capacity * sectors_per_frame;
1450 }
1451
1452 static int proc_idecd_read_capacity(char *page, char **start, off_t off,
1453                                         int count, int *eof, void *data)
1454 {
1455         ide_drive_t *drive = data;
1456         int len;
1457
1458         len = sprintf(page, "%llu\n", (long long)ide_cdrom_capacity(drive));
1459         PROC_IDE_READ_RETURN(page, start, off, count, eof, len);
1460 }
1461
1462 static ide_proc_entry_t idecd_proc[] = {
1463         { "capacity", S_IFREG|S_IRUGO, proc_idecd_read_capacity, NULL },
1464         { NULL, 0, NULL, NULL }
1465 };
1466
1467 static ide_proc_entry_t *ide_cd_proc_entries(ide_drive_t *drive)
1468 {
1469         return idecd_proc;
1470 }
1471
1472 static const struct ide_proc_devset *ide_cd_proc_devsets(ide_drive_t *drive)
1473 {
1474         return NULL;
1475 }
1476 #endif
1477
1478 static const struct cd_list_entry ide_cd_quirks_list[] = {
1479         /* SCR-3231 doesn't support the SET_CD_SPEED command. */
1480         { "SAMSUNG CD-ROM SCR-3231", NULL,   IDE_AFLAG_NO_SPEED_SELECT       },
1481         /* Old NEC260 (not R) was released before ATAPI 1.2 spec. */
1482         { "NEC CD-ROM DRIVE:260",    "1.01", IDE_AFLAG_TOCADDR_AS_BCD |
1483                                              IDE_AFLAG_PRE_ATAPI12,          },
1484         /* Vertos 300, some versions of this drive like to talk BCD. */
1485         { "V003S0DS",                NULL,   IDE_AFLAG_VERTOS_300_SSD,       },
1486         /* Vertos 600 ESD. */
1487         { "V006E0DS",                NULL,   IDE_AFLAG_VERTOS_600_ESD,       },
1488         /*
1489          * Sanyo 3 CD changer uses a non-standard command for CD changing
1490          * (by default standard ATAPI support for CD changers is used).
1491          */
1492         { "CD-ROM CDR-C3 G",         NULL,   IDE_AFLAG_SANYO_3CD             },
1493         { "CD-ROM CDR-C3G",          NULL,   IDE_AFLAG_SANYO_3CD             },
1494         { "CD-ROM CDR_C36",          NULL,   IDE_AFLAG_SANYO_3CD             },
1495         /* Stingray 8X CD-ROM. */
1496         { "STINGRAY 8422 IDE 8X CD-ROM 7-27-95", NULL, IDE_AFLAG_PRE_ATAPI12 },
1497         /*
1498          * ACER 50X CD-ROM and WPI 32X CD-ROM require the full spec length
1499          * mode sense page capabilities size, but older drives break.
1500          */
1501         { "ATAPI CD ROM DRIVE 50X MAX", NULL,   IDE_AFLAG_FULL_CAPS_PAGE     },
1502         { "WPI CDS-32X",                NULL,   IDE_AFLAG_FULL_CAPS_PAGE     },
1503         /* ACER/AOpen 24X CD-ROM has the speed fields byte-swapped. */
1504         { "",                        "241N", IDE_AFLAG_LE_SPEED_FIELDS       },
1505         /*
1506          * Some drives used by Apple don't advertise audio play
1507          * but they do support reading TOC & audio datas.
1508          */
1509         { "MATSHITADVD-ROM SR-8187", NULL,   IDE_AFLAG_PLAY_AUDIO_OK         },
1510         { "MATSHITADVD-ROM SR-8186", NULL,   IDE_AFLAG_PLAY_AUDIO_OK         },
1511         { "MATSHITADVD-ROM SR-8176", NULL,   IDE_AFLAG_PLAY_AUDIO_OK         },
1512         { "MATSHITADVD-ROM SR-8174", NULL,   IDE_AFLAG_PLAY_AUDIO_OK         },
1513         { "Optiarc DVD RW AD-5200A", NULL,   IDE_AFLAG_PLAY_AUDIO_OK         },
1514         { "Optiarc DVD RW AD-7200A", NULL,   IDE_AFLAG_PLAY_AUDIO_OK         },
1515         { "Optiarc DVD RW AD-7543A", NULL,   IDE_AFLAG_NO_AUTOCLOSE          },
1516         { "TEAC CD-ROM CD-224E",     NULL,   IDE_AFLAG_NO_AUTOCLOSE          },
1517         { NULL, NULL, 0 }
1518 };
1519
1520 static unsigned int ide_cd_flags(u16 *id)
1521 {
1522         const struct cd_list_entry *cle = ide_cd_quirks_list;
1523
1524         while (cle->id_model) {
1525                 if (strcmp(cle->id_model, (char *)&id[ATA_ID_PROD]) == 0 &&
1526                     (cle->id_firmware == NULL ||
1527                      strstr((char *)&id[ATA_ID_FW_REV], cle->id_firmware)))
1528                         return cle->cd_flags;
1529                 cle++;
1530         }
1531
1532         return 0;
1533 }
1534
1535 static int ide_cdrom_setup(ide_drive_t *drive)
1536 {
1537         struct cdrom_info *cd = drive->driver_data;
1538         struct cdrom_device_info *cdi = &cd->devinfo;
1539         struct request_queue *q = drive->queue;
1540         u16 *id = drive->id;
1541         char *fw_rev = (char *)&id[ATA_ID_FW_REV];
1542         int nslots;
1543
1544         ide_debug_log(IDE_DBG_PROBE, "enter");
1545
1546         blk_queue_prep_rq(q, ide_cdrom_prep_fn);
1547         blk_queue_dma_alignment(q, 31);
1548         blk_queue_update_dma_pad(q, 15);
1549
1550         q->unplug_delay = max((1 * HZ) / 1000, 1);
1551
1552         drive->dev_flags |= IDE_DFLAG_MEDIA_CHANGED;
1553         drive->atapi_flags = IDE_AFLAG_NO_EJECT | ide_cd_flags(id);
1554
1555         if ((drive->atapi_flags & IDE_AFLAG_VERTOS_300_SSD) &&
1556             fw_rev[4] == '1' && fw_rev[6] <= '2')
1557                 drive->atapi_flags |= (IDE_AFLAG_TOCTRACKS_AS_BCD |
1558                                      IDE_AFLAG_TOCADDR_AS_BCD);
1559         else if ((drive->atapi_flags & IDE_AFLAG_VERTOS_600_ESD) &&
1560                  fw_rev[4] == '1' && fw_rev[6] <= '2')
1561                 drive->atapi_flags |= IDE_AFLAG_TOCTRACKS_AS_BCD;
1562         else if (drive->atapi_flags & IDE_AFLAG_SANYO_3CD)
1563                 /* 3 => use CD in slot 0 */
1564                 cdi->sanyo_slot = 3;
1565
1566         nslots = ide_cdrom_probe_capabilities(drive);
1567
1568         blk_queue_hardsect_size(q, CD_FRAMESIZE);
1569
1570         if (ide_cdrom_register(drive, nslots)) {
1571                 printk(KERN_ERR PFX "%s: %s failed to register device with the"
1572                                 " cdrom driver.\n", drive->name, __func__);
1573                 cd->devinfo.handle = NULL;
1574                 return 1;
1575         }
1576
1577         ide_proc_register_driver(drive, cd->driver);
1578         return 0;
1579 }
1580
1581 static void ide_cd_remove(ide_drive_t *drive)
1582 {
1583         struct cdrom_info *info = drive->driver_data;
1584
1585         ide_debug_log(IDE_DBG_FUNC, "enter");
1586
1587         ide_proc_unregister_driver(drive, info->driver);
1588         device_del(&info->dev);
1589         del_gendisk(info->disk);
1590
1591         mutex_lock(&idecd_ref_mutex);
1592         put_device(&info->dev);
1593         mutex_unlock(&idecd_ref_mutex);
1594 }
1595
1596 static void ide_cd_release(struct device *dev)
1597 {
1598         struct cdrom_info *info = to_ide_drv(dev, cdrom_info);
1599         struct cdrom_device_info *devinfo = &info->devinfo;
1600         ide_drive_t *drive = info->drive;
1601         struct gendisk *g = info->disk;
1602
1603         ide_debug_log(IDE_DBG_FUNC, "enter");
1604
1605         kfree(info->toc);
1606         if (devinfo->handle == drive)
1607                 unregister_cdrom(devinfo);
1608         drive->driver_data = NULL;
1609         blk_queue_prep_rq(drive->queue, NULL);
1610         g->private_data = NULL;
1611         put_disk(g);
1612         kfree(info);
1613 }
1614
1615 static int ide_cd_probe(ide_drive_t *);
1616
1617 static struct ide_driver ide_cdrom_driver = {
1618         .gen_driver = {
1619                 .owner          = THIS_MODULE,
1620                 .name           = "ide-cdrom",
1621                 .bus            = &ide_bus_type,
1622         },
1623         .probe                  = ide_cd_probe,
1624         .remove                 = ide_cd_remove,
1625         .version                = IDECD_VERSION,
1626         .do_request             = ide_cd_do_request,
1627 #ifdef CONFIG_IDE_PROC_FS
1628         .proc_entries           = ide_cd_proc_entries,
1629         .proc_devsets           = ide_cd_proc_devsets,
1630 #endif
1631 };
1632
1633 static int idecd_open(struct block_device *bdev, fmode_t mode)
1634 {
1635         struct cdrom_info *info = ide_cd_get(bdev->bd_disk);
1636         int rc = -ENOMEM;
1637
1638         if (!info)
1639                 return -ENXIO;
1640
1641         rc = cdrom_open(&info->devinfo, bdev, mode);
1642
1643         if (rc < 0)
1644                 ide_cd_put(info);
1645
1646         return rc;
1647 }
1648
1649 static int idecd_release(struct gendisk *disk, fmode_t mode)
1650 {
1651         struct cdrom_info *info = ide_drv_g(disk, cdrom_info);
1652
1653         cdrom_release(&info->devinfo, mode);
1654
1655         ide_cd_put(info);
1656
1657         return 0;
1658 }
1659
1660 static int idecd_set_spindown(struct cdrom_device_info *cdi, unsigned long arg)
1661 {
1662         struct packet_command cgc;
1663         char buffer[16];
1664         int stat;
1665         char spindown;
1666
1667         if (copy_from_user(&spindown, (void __user *)arg, sizeof(char)))
1668                 return -EFAULT;
1669
1670         init_cdrom_command(&cgc, buffer, sizeof(buffer), CGC_DATA_UNKNOWN);
1671
1672         stat = cdrom_mode_sense(cdi, &cgc, GPMODE_CDROM_PAGE, 0);
1673         if (stat)
1674                 return stat;
1675
1676         buffer[11] = (buffer[11] & 0xf0) | (spindown & 0x0f);
1677         return cdrom_mode_select(cdi, &cgc);
1678 }
1679
1680 static int idecd_get_spindown(struct cdrom_device_info *cdi, unsigned long arg)
1681 {
1682         struct packet_command cgc;
1683         char buffer[16];
1684         int stat;
1685         char spindown;
1686
1687         init_cdrom_command(&cgc, buffer, sizeof(buffer), CGC_DATA_UNKNOWN);
1688
1689         stat = cdrom_mode_sense(cdi, &cgc, GPMODE_CDROM_PAGE, 0);
1690         if (stat)
1691                 return stat;
1692
1693         spindown = buffer[11] & 0x0f;
1694         if (copy_to_user((void __user *)arg, &spindown, sizeof(char)))
1695                 return -EFAULT;
1696         return 0;
1697 }
1698
1699 static int idecd_ioctl(struct block_device *bdev, fmode_t mode,
1700                         unsigned int cmd, unsigned long arg)
1701 {
1702         struct cdrom_info *info = ide_drv_g(bdev->bd_disk, cdrom_info);
1703         int err;
1704
1705         switch (cmd) {
1706         case CDROMSETSPINDOWN:
1707                 return idecd_set_spindown(&info->devinfo, arg);
1708         case CDROMGETSPINDOWN:
1709                 return idecd_get_spindown(&info->devinfo, arg);
1710         default:
1711                 break;
1712         }
1713
1714         err = generic_ide_ioctl(info->drive, bdev, cmd, arg);
1715         if (err == -EINVAL)
1716                 err = cdrom_ioctl(&info->devinfo, bdev, mode, cmd, arg);
1717
1718         return err;
1719 }
1720
1721 static int idecd_media_changed(struct gendisk *disk)
1722 {
1723         struct cdrom_info *info = ide_drv_g(disk, cdrom_info);
1724         return cdrom_media_changed(&info->devinfo);
1725 }
1726
1727 static int idecd_revalidate_disk(struct gendisk *disk)
1728 {
1729         struct cdrom_info *info = ide_drv_g(disk, cdrom_info);
1730         struct request_sense sense;
1731
1732         ide_cd_read_toc(info->drive, &sense);
1733
1734         return  0;
1735 }
1736
1737 static struct block_device_operations idecd_ops = {
1738         .owner                  = THIS_MODULE,
1739         .open                   = idecd_open,
1740         .release                = idecd_release,
1741         .locked_ioctl           = idecd_ioctl,
1742         .media_changed          = idecd_media_changed,
1743         .revalidate_disk        = idecd_revalidate_disk
1744 };
1745
1746 /* module options */
1747 static unsigned long debug_mask;
1748 module_param(debug_mask, ulong, 0644);
1749
1750 MODULE_DESCRIPTION("ATAPI CD-ROM Driver");
1751
1752 static int ide_cd_probe(ide_drive_t *drive)
1753 {
1754         struct cdrom_info *info;
1755         struct gendisk *g;
1756         struct request_sense sense;
1757
1758         ide_debug_log(IDE_DBG_PROBE, "driver_req: %s, media: 0x%x",
1759                                      drive->driver_req, drive->media);
1760
1761         if (!strstr("ide-cdrom", drive->driver_req))
1762                 goto failed;
1763
1764         if (drive->media != ide_cdrom && drive->media != ide_optical)
1765                 goto failed;
1766
1767         drive->debug_mask = debug_mask;
1768         drive->irq_handler = cdrom_newpc_intr;
1769
1770         info = kzalloc(sizeof(struct cdrom_info), GFP_KERNEL);
1771         if (info == NULL) {
1772                 printk(KERN_ERR PFX "%s: Can't allocate a cdrom structure\n",
1773                                 drive->name);
1774                 goto failed;
1775         }
1776
1777         g = alloc_disk(1 << PARTN_BITS);
1778         if (!g)
1779                 goto out_free_cd;
1780
1781         ide_init_disk(g, drive);
1782
1783         info->dev.parent = &drive->gendev;
1784         info->dev.release = ide_cd_release;
1785         dev_set_name(&info->dev, dev_name(&drive->gendev));
1786
1787         if (device_register(&info->dev))
1788                 goto out_free_disk;
1789
1790         info->drive = drive;
1791         info->driver = &ide_cdrom_driver;
1792         info->disk = g;
1793
1794         g->private_data = &info->driver;
1795
1796         drive->driver_data = info;
1797
1798         g->minors = 1;
1799         g->driverfs_dev = &drive->gendev;
1800         g->flags = GENHD_FL_CD | GENHD_FL_REMOVABLE;
1801         if (ide_cdrom_setup(drive)) {
1802                 put_device(&info->dev);
1803                 goto failed;
1804         }
1805
1806         ide_cd_read_toc(drive, &sense);
1807         g->fops = &idecd_ops;
1808         g->flags |= GENHD_FL_REMOVABLE;
1809         add_disk(g);
1810         return 0;
1811
1812 out_free_disk:
1813         put_disk(g);
1814 out_free_cd:
1815         kfree(info);
1816 failed:
1817         return -ENODEV;
1818 }
1819
1820 static void __exit ide_cdrom_exit(void)
1821 {
1822         driver_unregister(&ide_cdrom_driver.gen_driver);
1823 }
1824
1825 static int __init ide_cdrom_init(void)
1826 {
1827         printk(KERN_INFO DRV_NAME " driver " IDECD_VERSION "\n");
1828         return driver_register(&ide_cdrom_driver.gen_driver);
1829 }
1830
1831 MODULE_ALIAS("ide:*m-cdrom*");
1832 MODULE_ALIAS("ide-cd");
1833 module_init(ide_cdrom_init);
1834 module_exit(ide_cdrom_exit);
1835 MODULE_LICENSE("GPL");