root/drivers/block/ide.h

/* [previous][next][first][last][top][bottom][index][help] */

INCLUDED FROM


   1 /*
   2  *  linux/drivers/block/ide.h
   3  *
   4  *  Copyright (C) 1994, 1995  Linus Torvalds & authors
   5  */
   6 
   7 #include <linux/config.h>
   8 
   9 /*
  10  * This is the multiple IDE interface driver, as evolved from hd.c.  
  11  * It supports up to four IDE interfaces, on one or more IRQs (usually 14 & 15).
  12  * There can be up to two drives per interface, as per the ATA-2 spec.
  13  *
  14  * Primary i/f:    ide0: major=3;  (hda)         minor=0; (hdb)         minor=64
  15  * Secondary i/f:  ide1: major=22; (hdc or hd1a) minor=0; (hdd or hd1b) minor=64
  16  * Tertiary i/f:   ide2: major=33; (hde)         minor=0; (hdf)         minor=64
  17  * Quaternary i/f: ide3: major=34; (hdg)         minor=0; (hdh)         minor=64
  18  */
  19 
  20 /******************************************************************************
  21  * IDE driver configuration options (play with these as desired):
  22  * 
  23  * REALLY_SLOW_IO can be defined in ide.c and ide-cd.c, if necessary
  24  */
  25 #undef REALLY_FAST_IO                   /* define if ide ports are perfect */
  26 #define INITIAL_MULT_COUNT      0       /* off=0; on=2,4,8,16,32, etc.. */
  27 
  28 #ifndef SUPPORT_VLB_SYNC                /* 1 to support weird 32-bit chips */
  29 #define SUPPORT_VLB_SYNC        1       /* 0 to reduce kernel size */
  30 #endif
  31 #ifndef DISK_RECOVERY_TIME              /* off=0; on=access_delay_time */
  32 #define DISK_RECOVERY_TIME      0       /*  for hardware that needs it */
  33 #endif
  34 #ifndef OK_TO_RESET_CONTROLLER          /* 1 needed for good error recovery */
  35 #define OK_TO_RESET_CONTROLLER  1       /* 0 for use with AH2372A/B interface */
  36 #endif
  37 #ifndef FAKE_FDISK_FOR_EZDRIVE          /* 1 to help linux fdisk with EZDRIVE */
  38 #define FAKE_FDISK_FOR_EZDRIVE  1       /* 0 to reduce kernel size */
  39 #endif
  40 #ifndef FANCY_STATUS_DUMPS              /* 1 for human-readable drive errors */
  41 #define FANCY_STATUS_DUMPS      1       /* 0 to reduce kernel size */
  42 #endif
  43 
  44 #if defined(CONFIG_BLK_DEV_IDECD) || defined(CONFIG_BLK_DEV_IDETAPE)
  45 #define CONFIG_BLK_DEV_IDEATAPI 1
  46 #endif
  47 
  48 /*
  49  * IDE_DRIVE_CMD is used to implement many features of the hdparm utility
  50  */
  51 #define IDE_DRIVE_CMD           99      /* (magic) undef to reduce kernel size*/
  52 
  53 /*
  54  *  "No user-serviceable parts" beyond this point  :)
  55  *****************************************************************************/
  56 
  57 typedef unsigned char   byte;   /* used everywhere */
  58 
  59 /*
  60  * Probably not wise to fiddle with these
  61  */
  62 #define ERROR_MAX       8       /* Max read/write errors per sector */
  63 #define ERROR_RESET     3       /* Reset controller every 4th retry */
  64 #define ERROR_RECAL     1       /* Recalibrate every 2nd retry */
  65 
  66 /*
  67  * Ensure that various configuration flags have compatible settings
  68  */
  69 #ifdef REALLY_SLOW_IO
  70 #undef REALLY_FAST_IO
  71 #endif
  72 
  73 /*
  74  * Definitions for accessing IDE controller registers
  75  */
  76 
  77 #define HWIF(drive)             ((ide_hwif_t *)((drive)->hwif))
  78 #define HWGROUP(drive)          ((ide_hwgroup_t *)(HWIF(drive)->hwgroup))
  79 
  80 #define IDE_DATA_OFFSET         (0)
  81 #define IDE_ERROR_OFFSET        (1)
  82 #define IDE_NSECTOR_OFFSET      (2)
  83 #define IDE_SECTOR_OFFSET       (3)
  84 #define IDE_LCYL_OFFSET         (4)
  85 #define IDE_HCYL_OFFSET         (5)
  86 #define IDE_SELECT_OFFSET       (6)
  87 #define IDE_STATUS_OFFSET       (7)
  88 #define IDE_FEATURE_OFFSET      IDE_ERROR_OFFSET
  89 #define IDE_COMMAND_OFFSET      IDE_STATUS_OFFSET
  90 
  91 #define IDE_DATA_REG            (HWIF(drive)->io_base+IDE_DATA_OFFSET)
  92 #define IDE_ERROR_REG           (HWIF(drive)->io_base+IDE_ERROR_OFFSET)
  93 #define IDE_NSECTOR_REG         (HWIF(drive)->io_base+IDE_NSECTOR_OFFSET)
  94 #define IDE_SECTOR_REG          (HWIF(drive)->io_base+IDE_SECTOR_OFFSET)
  95 #define IDE_LCYL_REG            (HWIF(drive)->io_base+IDE_LCYL_OFFSET)
  96 #define IDE_HCYL_REG            (HWIF(drive)->io_base+IDE_HCYL_OFFSET)
  97 #define IDE_SELECT_REG          (HWIF(drive)->io_base+IDE_SELECT_OFFSET)
  98 #define IDE_STATUS_REG          (HWIF(drive)->io_base+IDE_STATUS_OFFSET)
  99 #define IDE_CONTROL_REG         (HWIF(drive)->ctl_port)
 100 #define IDE_FEATURE_REG         IDE_ERROR_REG
 101 #define IDE_COMMAND_REG         IDE_STATUS_REG
 102 #define IDE_ALTSTATUS_REG       IDE_CONTROL_REG
 103 
 104 #ifdef REALLY_FAST_IO
 105 #define OUT_BYTE(b,p)           outb((b),(p))
 106 #define IN_BYTE(p)              (byte)inb(p)
 107 #else
 108 #define OUT_BYTE(b,p)           outb_p((b),(p))
 109 #define IN_BYTE(p)              (byte)inb_p(p)
 110 #endif /* REALLY_FAST_IO */
 111 
 112 #define GET_ERR()               IN_BYTE(IDE_ERROR_REG)
 113 #define GET_STAT()              IN_BYTE(IDE_STATUS_REG)
 114 #define OK_STAT(stat,good,bad)  (((stat)&((good)|(bad)))==(good))
 115 #define BAD_R_STAT              (BUSY_STAT   | ERR_STAT)
 116 #define BAD_W_STAT              (BAD_R_STAT  | WRERR_STAT)
 117 #define BAD_STAT                (BAD_R_STAT  | DRQ_STAT)
 118 #define DRIVE_READY             (READY_STAT  | SEEK_STAT)
 119 #define DATA_READY              (DRIVE_READY | DRQ_STAT)
 120 
 121 /*
 122  * Some more useful definitions
 123  */
 124 #define IDE_MAJOR_NAME  "ide"   /* the same for all i/f; see also genhd.c */
 125 #define MAJOR_NAME      IDE_MAJOR_NAME
 126 #define PARTN_BITS      6       /* number of minor dev bits for partitions */
 127 #define PARTN_MASK      ((1<<PARTN_BITS)-1)     /* a useful bit mask */
 128 #define MAX_DRIVES      2       /* per interface; 2 assumed by lots of code */
 129 #ifndef MAX_HWIFS
 130 #define MAX_HWIFS       4       /* an arbitrary, but realistic limit */
 131 #endif
 132 #define SECTOR_WORDS    (512 / 4)       /* number of 32bit words per sector */
 133 
 134 /*
 135  * Timeouts for various operations:
 136  */
 137 #define WAIT_DRQ        (5*HZ/100)      /* 50msec - spec allows up to 20ms */
 138 #define WAIT_READY      (3*HZ/100)      /* 30msec - should be instantaneous */
 139 #define WAIT_PIDENTIFY  (1*HZ)  /* 1sec   - should be less than 3ms (?) */
 140 #define WAIT_WORSTCASE  (30*HZ) /* 30sec  - worst case when spinning up */
 141 #define WAIT_CMD        (10*HZ) /* 10sec  - maximum wait for an IRQ to happen */
 142 
 143 #if defined(CONFIG_BLK_DEV_HT6560B) || defined(CONFIG_BLK_DEV_PROMISE)
 144 #define SELECT_DRIVE(hwif,drive)                                \
 145 {                                                               \
 146         if (hwif->selectproc)                                   \
 147                 hwif->selectproc(drive);                        \
 148         else                                                    \
 149                 OUT_BYTE((drive)->select.all, hwif->io_base+IDE_SELECT_OFFSET); \
 150 }
 151 #else
 152 #define SELECT_DRIVE(hwif,drive)  OUT_BYTE((drive)->select.all, hwif->io_base+IDE_SELECT_OFFSET);
 153 #endif  /* CONFIG_BLK_DEV_HT6560B || CONFIG_BLK_DEV_PROMISE */
 154                 
 155 #ifdef CONFIG_BLK_DEV_IDETAPE
 156 #include "ide-tape.h"
 157 #endif /* CONFIG_BLK_DEV_IDETAPE */
 158 
 159 #ifdef CONFIG_BLK_DEV_IDECD
 160 
 161 struct atapi_request_sense {
 162   unsigned char error_code : 7;
 163   unsigned char valid      : 1;
 164   byte reserved1;
 165   unsigned char sense_key  : 4;
 166   unsigned char reserved2  : 1;
 167   unsigned char ili        : 1;
 168   unsigned char reserved3  : 2;
 169   byte info[4];
 170   byte sense_len;
 171   byte command_info[4];
 172   byte asc;
 173   byte ascq;
 174   byte fru;
 175   byte sense_key_specific[3];
 176 };
 177 
 178 struct packet_command {
 179   char *buffer;
 180   int buflen;
 181   int stat;
 182   struct atapi_request_sense *sense_data;
 183   unsigned char c[12];
 184 };
 185 
 186 /* Space to hold the disk TOC. */
 187 
 188 #define MAX_TRACKS 99
 189 struct atapi_toc_header {
 190   unsigned short toc_length;
 191   byte first_track;
 192   byte last_track;
 193 };
 194 
 195 struct atapi_toc_entry {
 196   byte reserved1;
 197   unsigned control : 4;
 198   unsigned adr     : 4;
 199   byte track;
 200   byte reserved2;
 201   union {
 202     unsigned lba;
 203     struct {
 204       byte reserved3;
 205       byte m;
 206       byte s;
 207       byte f;
 208     } msf;
 209   } addr;
 210 };
 211 
 212 struct atapi_toc {
 213   int    last_session_lba;
 214   int    xa_flag;
 215   unsigned capacity;
 216   struct atapi_toc_header hdr;
 217   struct atapi_toc_entry  ent[MAX_TRACKS+1];  /* One extra for the leadout. */
 218 };
 219 
 220 
 221 /* This structure is annoyingly close to, but not identical with,
 222    the cdrom_subchnl structure from cdrom.h. */
 223 struct atapi_cdrom_subchnl 
 224 {
 225   u_char  acdsc_reserved;
 226   u_char  acdsc_audiostatus;
 227   u_short acdsc_length;
 228   u_char  acdsc_format;
 229 
 230   u_char  acdsc_adr:    4;
 231   u_char  acdsc_ctrl:   4;
 232   u_char  acdsc_trk;
 233   u_char  acdsc_ind;
 234   union
 235   {
 236     struct                      
 237     {
 238       u_char    reserved;
 239       u_char    minute;
 240       u_char    second;
 241       u_char    frame;
 242     } msf;
 243     int lba;
 244   } acdsc_absaddr;
 245   union 
 246   {
 247     struct 
 248     {
 249       u_char    reserved;
 250       u_char    minute;
 251       u_char    second;
 252       u_char    frame;
 253     } msf;
 254     int lba;
 255   } acdsc_reladdr;
 256 };
 257 
 258 
 259 /* Extra per-device info for cdrom drives. */
 260 struct cdrom_info {
 261 
 262   /* Buffer for table of contents.  NULL if we haven't allocated
 263      a TOC buffer for this device yet. */
 264 
 265   struct atapi_toc *toc;
 266 
 267   /* Sector buffer.  If a read request wants only the first part of a cdrom
 268      block, we cache the rest of the block here, in the expectation that that
 269      data is going to be wanted soon.  SECTOR_BUFFERED is the number of the
 270      first buffered sector, and NSECTORS_BUFFERED is the number of sectors
 271      in the buffer.  Before the buffer is allocated, we should have
 272      SECTOR_BUFFER == NULL and NSECTORS_BUFFERED == 0. */
 273 
 274   unsigned long sector_buffered;
 275   unsigned long nsectors_buffered;
 276   char *sector_buffer;
 277 
 278   /* The result of the last successful request sense command
 279      on this device. */
 280   struct atapi_request_sense sense_data;
 281 };
 282 
 283 #endif /* CONFIG_BLK_DEV_IDECD */
 284 
 285 /*
 286  * Now for the data we need to maintain per-drive:  ide_drive_t
 287  */
 288 
 289 typedef enum {ide_disk, ide_cdrom, ide_tape} ide_media_t;
 290 
 291 typedef union {
 292         unsigned all                    : 8;    /* all of the bits together */
 293         struct {
 294                 unsigned set_geometry   : 1;    /* respecify drive geometry */
 295                 unsigned recalibrate    : 1;    /* seek to cyl 0      */
 296                 unsigned set_multmode   : 1;    /* set multmode count */
 297                 unsigned set_pio        : 1;    /* set pio mode */
 298                 unsigned reserved       : 4;    /* unused */
 299                 } b;
 300         } special_t;
 301 
 302 typedef union {
 303         unsigned all                    : 8;    /* all of the bits together */
 304         struct {
 305                 unsigned head           : 4;    /* always zeros here */
 306                 unsigned unit           : 1;    /* drive select number, 0 or 1 */
 307                 unsigned bit5           : 1;    /* always 1 */
 308                 unsigned lba            : 1;    /* using LBA instead of CHS */
 309                 unsigned bit7           : 1;    /* always 1 */
 310         } b;
 311         } select_t;
 312 
 313 typedef struct ide_drive_s {
 314         special_t       special;        /* special action flags */
 315         unsigned present        : 1;    /* drive is physically present */
 316         unsigned noprobe        : 1;    /* from:  hdx=noprobe */
 317         unsigned keep_settings  : 1;    /* restore settings after drive reset */
 318         unsigned busy           : 1;    /* currently doing revalidate_disk() */
 319         unsigned removeable     : 1;    /* 1 if need to do check_media_change */
 320         unsigned using_dma      : 1;    /* disk is using dma for read/write */
 321         unsigned forced_geom    : 1;    /* 1 if hdx=c,h,s was given at boot */
 322         unsigned unmask         : 1;    /* flag: okay to unmask other irqs */
 323         unsigned autotune       : 2;    /* 1=autotune, 2=noautotune, 0=default */
 324 #if FAKE_FDISK_FOR_EZDRIVE
 325         unsigned remap_0_to_1   : 1;    /* flag: partitioned with ezdrive */
 326 #endif /* FAKE_FDISK_FOR_EZDRIVE */
 327         ide_media_t     media;          /* disk, cdrom, tape */
 328         select_t        select;         /* basic drive/head select reg value */
 329         byte            ctl;            /* "normal" value for IDE_CONTROL_REG */
 330         byte            ready_stat;     /* min status value for drive ready */
 331         byte            mult_count;     /* current multiple sector setting */
 332         byte            mult_req;       /* requested multiple sector setting */
 333         byte            pio_req;        /* requested multiple sector setting */
 334         byte            io_32bit;       /* 0=16-bit, 1=32-bit, 2/3=32bit+sync */
 335         byte            bad_wstat;      /* used for ignoring WRERR_STAT */
 336         byte            sect0;          /* offset of first sector for DM6:DDO */
 337         byte            usage;          /* current "open()" count for drive */
 338         byte            head;           /* "real" number of heads */
 339         byte            sect;           /* "real" sectors per track */
 340         byte            bios_head;      /* BIOS/fdisk/LILO number of heads */
 341         byte            bios_sect;      /* BIOS/fdisk/LILO sectors per track */
 342         unsigned short  bios_cyl;       /* BIOS/fdisk/LILO number of cyls */
 343         unsigned short  cyl;            /* "real" number of cyls */
 344         void              *hwif;        /* actually (ide_hwif_t *) */
 345         struct wait_queue *wqueue;      /* used to wait for drive in open() */
 346         struct hd_driveid *id;          /* drive model identification info */
 347         struct hd_struct  *part;        /* drive partition table */
 348         char            name[4];        /* drive name, such as "hda" */
 349 #ifdef CONFIG_BLK_DEV_IDECD
 350         struct cdrom_info cdrom_info;   /* for ide-cd.c */
 351 #endif /* CONFIG_BLK_DEV_IDECD */
 352 #ifdef CONFIG_BLK_DEV_IDETAPE
 353         idetape_tape_t  tape;           /* for ide-tape.c */
 354 #endif /* CONFIG_BLK_DEV_IDETAPE */
 355         } ide_drive_t;
 356 
 357 /*
 358  * An ide_dmaproc_t() initiates/aborts DMA read/write operations on a drive.
 359  *
 360  * The caller is assumed to have selected the drive and programmed the drive's
 361  * sector address using CHS or LBA.  All that remains is to prepare for DMA
 362  * and then issue the actual read/write DMA/PIO command to the drive.
 363  *
 364  * Returns 0 if all went well.
 365  * Returns 1 if DMA read/write could not be started, in which case the caller
 366  * should either try again later, or revert to PIO for the current request.
 367  */
 368 typedef enum {  ide_dma_read = 0,       ide_dma_write = 1,
 369                 ide_dma_abort = 2,      ide_dma_check = 3,
 370                 ide_dma_status_bad = 4, ide_dma_transferred = 5,
 371                 ide_dma_begin = 6 }
 372         ide_dma_action_t;
 373 
 374 typedef int (ide_dmaproc_t)(ide_dma_action_t, ide_drive_t *);
 375 
 376 
 377 /*
 378  * An ide_tuneproc_t() is used to set the speed of an IDE interface
 379  * to a particular PIO mode.  The "byte" parameter is used
 380  * to select the PIO mode by number (0,1,2,3,4,5), and a value of 255
 381  * indicates that the interface driver should "auto-tune" the PIO mode
 382  * according to the drive capabilities in drive->id;
 383  *
 384  * Not all interface types support tuning, and not all of those
 385  * support all possible PIO settings.  They may silently ignore
 386  * or round values as they see fit.
 387  */
 388 typedef void (ide_tuneproc_t)(ide_drive_t *, byte);
 389 
 390 /*
 391  * This is used to provide HT6560B & PROMISE interface support.
 392  */
 393 typedef void (ide_selectproc_t) (ide_drive_t *);
 394 
 395 /*
 396  * hwif_chipset_t is used to keep track of the specific hardware
 397  * chipset used by each IDE interface, if known.
 398  */
 399 typedef enum {  ide_unknown,    ide_generic,    ide_triton,
 400                 ide_cmd640,     ide_dtc2278,    ide_ali14xx,
 401                 ide_qd6580,     ide_umc8672,    ide_ht6560b,
 402                 ide_promise }
 403         hwif_chipset_t;
 404 
 405 typedef struct hwif_s {
 406         struct hwif_s   *next;          /* for linked-list in ide_hwgroup_t */
 407         void            *hwgroup;       /* actually (ide_hwgroup_t *) */
 408         unsigned short  io_base;        /* base io port addr */
 409         unsigned short  ctl_port;       /* usually io_base+0x206 */
 410         ide_drive_t     drives[MAX_DRIVES];     /* drive info */
 411         struct gendisk  *gd;            /* gendisk structure */
 412         ide_tuneproc_t  *tuneproc;      /* routine to tune PIO mode for drives */
 413 #if defined(CONFIG_BLK_DEV_HT6560B) || defined(CONFIG_BLK_DEV_PROMISE)
 414         ide_selectproc_t *selectproc;   /* tweaks hardware to select drive */
 415 #endif
 416         ide_dmaproc_t   *dmaproc;       /* dma read/write/abort routine */
 417         unsigned long   *dmatable;      /* dma physical region descriptor table */
 418         unsigned short  dma_base;       /* base addr for dma ports (triton) */
 419         byte            irq;            /* our irq number */
 420         byte            major;          /* our major number */
 421         char            name[5];        /* name of interface, eg. "ide0" */
 422         byte            index;          /* 0 for ide0; 1 for ide1; ... */
 423         hwif_chipset_t  chipset;        /* sub-module for tuning.. */
 424         unsigned        noprobe    : 1; /* don't probe for this interface */
 425         unsigned        present    : 1; /* this interface exists */
 426         unsigned        serialized : 1; /* serialized operation with mate hwif */
 427         unsigned        no_unmask  : 1; /* disallow setting unmask bits */
 428         unsigned        got_irq    : 1; /* 1 = already alloc'd our irq */
 429 #ifdef CONFIG_BLK_DEV_PROMISE
 430         unsigned        is_promise2: 1; /* 2nd i/f on promose DC4030 */
 431 #endif /* CONFIG_BLK_DEV_PROMISE */
 432 #if (DISK_RECOVERY_TIME > 0)
 433         unsigned long   last_time;      /* time when previous rq was done */
 434 #endif
 435 #ifdef CONFIG_BLK_DEV_IDECD
 436         struct request request_sense_request;   /* from ide-cd.c */
 437         struct packet_command request_sense_pc; /* from ide-cd.c */
 438 #endif /* CONFIG_BLK_DEV_IDECD */
 439 #ifdef CONFIG_BLK_DEV_IDETAPE
 440         ide_drive_t     *tape_drive;    /* Pointer to the tape on this interface */
 441 #endif /* CONFIG_BLK_DEV_IDETAPE */
 442         } ide_hwif_t;
 443 
 444 /*
 445  *  internal ide interrupt handler type
 446  */
 447 typedef void (ide_handler_t)(ide_drive_t *);
 448 
 449 typedef struct hwgroup_s {
 450         ide_handler_t           *handler;/* irq handler, if active */
 451         ide_drive_t             *drive; /* current drive */
 452         ide_hwif_t              *hwif;  /* ptr to current hwif in linked-list */
 453         ide_hwif_t              *next_hwif; /* next selected hwif (for tape) */
 454         struct request          *rq;    /* current request */
 455         struct timer_list       timer;  /* failsafe timer */
 456         struct request          wrq;    /* local copy of current write rq */
 457         unsigned long           poll_timeout;   /* timeout value during long polls */
 458         } ide_hwgroup_t;
 459 
 460 /*
 461  * ide_hwifs[] is the master data structure used to keep track
 462  * of just about everything in ide.c.  Whenever possible, routines
 463  * should be using pointers to a drive (ide_drive_t *) or 
 464  * pointers to a hwif (ide_hwif_t *), rather than indexing this
 465  * structure directly (the allocation/layout may change!).
 466  */
 467 #ifdef _IDE_C
 468         ide_hwif_t      ide_hwifs[MAX_HWIFS];   /* master data repository */
 469 #else
 470 extern  ide_hwif_t      ide_hwifs[];
 471 #endif
 472 
 473 /*
 474  * One final include file, which references some of the data/defns from above
 475  */
 476 #define IDE_DRIVER      /* "parameter" for blk.h */
 477 #include <linux/blk.h>
 478 
 479 #if (DISK_RECOVERY_TIME > 0)
 480 void ide_set_recovery_timer (ide_hwif_t *);
 481 #define SET_RECOVERY_TIMER(drive) ide_set_recovery_timer (drive)
 482 #else
 483 #define SET_RECOVERY_TIMER(drive)
 484 #endif
 485 
 486 /*
 487  * This is used for (nearly) all data transfers from the IDE interface
 488  */
 489 void ide_input_data (ide_drive_t *drive, void *buffer, unsigned int wcount);
 490 
 491 /*
 492  * This is used for (nearly) all data transfers to the IDE interface
 493  */
 494 void ide_output_data (ide_drive_t *drive, void *buffer, unsigned int wcount);
 495 
 496 /*
 497  * This is used on exit from the driver, to designate the next irq handler
 498  * and also to start the safety timer.
 499  */
 500 void ide_set_handler (ide_drive_t *drive, ide_handler_t *handler, unsigned int timeout);
 501 
 502 /*
 503  * Error reporting, in human readable form (luxurious, but a memory hog).
 504  */
 505 byte ide_dump_status (ide_drive_t *drive, const char *msg, byte stat);
 506 
 507 /*
 508  * ide_error() takes action based on the error returned by the controller.
 509  * The calling function must return afterwards, to restart the request.
 510  */
 511 void ide_error (ide_drive_t *drive, const char *msg, byte stat);
 512 
 513 /*
 514  * ide_fixstring() cleans up and (optionally) byte-swaps a text string,
 515  * removing leading/trailing blanks and compressing internal blanks.
 516  * It is primarily used to tidy up the model name/number fields as
 517  * returned by the WIN_[P]IDENTIFY commands.
 518  */
 519 void ide_fixstring (byte *s, const int bytecount, const int byteswap);
 520 
 521 /*
 522  * This routine busy-waits for the drive status to be not "busy".
 523  * It then checks the status for all of the "good" bits and none
 524  * of the "bad" bits, and if all is okay it returns 0.  All other
 525  * cases return 1 after invoking ide_error() -- caller should return.
 526  *
 527  */
 528 int ide_wait_stat (ide_drive_t *drive, byte good, byte bad, unsigned long timeout);
 529 
 530 /*
 531  * This routine is called from the partition-table code in genhd.c
 532  * to "convert" a drive to a logical geometry with fewer than 1024 cyls.
 533  *
 534  * The second parameter, "xparm", determines exactly how the translation
 535  * will be handled:
 536  *               0 = convert to CHS with fewer than 1024 cyls
 537  *                      using the same method as Ontrack DiskManager.
 538  *               1 = same as "0", plus offset everything by 63 sectors.
 539  *              -1 = similar to "0", plus redirect sector 0 to sector 1.
 540  *              >1 = convert to a CHS geometry with "xparm" heads.
 541  *
 542  * Returns 0 if the translation was not possible, if the device was not
 543  * an IDE disk drive, or if a geometry was "forced" on the commandline.
 544  * Returns 1 if the geometry translation was successful.
 545  */
 546 int ide_xlate_1024 (kdev_t, int, const char *);
 547 
 548 /*
 549  * Start a reset operation for an IDE interface.
 550  * The caller should return immediately after invoking this.
 551  */
 552 void ide_do_reset (ide_drive_t *);
 553 
 554 /*
 555  * This function is intended to be used prior to invoking ide_do_drive_cmd().
 556  */
 557 void ide_init_drive_cmd (struct request *rq);
 558 
 559 /*
 560  * "action" parameter type for ide_do_drive_cmd() below.
 561  */
 562 typedef enum
 563         {ide_wait,      /* insert rq at end of list, and wait for it */
 564          ide_next,      /* insert rq immediately after current request */
 565          ide_preempt,   /* insert rq in front of current request */
 566          ide_end}       /* insert rq at end of list, but don't wait for it */
 567  ide_action_t;
 568 
 569 /*
 570  * This function issues a special IDE device request
 571  * onto the request queue.
 572  *
 573  * If action is ide_wait, then then rq is queued at the end of
 574  * the request queue, and the function sleeps until it has been
 575  * processed.  This is for use when invoked from an ioctl handler.
 576  *
 577  * If action is ide_preempt, then the rq is queued at the head of
 578  * the request queue, displacing the currently-being-processed
 579  * request and this function returns immediately without waiting
 580  * for the new rq to be completed.  This is VERY DANGEROUS, and is
 581  * intended for careful use by the ATAPI tape/cdrom driver code.
 582  *
 583  * If action is ide_next, then the rq is queued immediately after
 584  * the currently-being-processed-request (if any), and the function
 585  * returns without waiting for the new rq to be completed.  As above,
 586  * This is VERY DANGEROUS, and is intended for careful use by the 
 587  * ATAPI tape/cdrom driver code.
 588  *
 589  * If action is ide_end, then the rq is queued at the end of the
 590  * request queue, and the function returns immediately without waiting
 591  * for the new rq to be completed. This is again intended for careful
 592  * use by the ATAPI tape/cdrom driver code. (Currently used by ide-tape.c,
 593  * when operating in the pipelined operation mode).
 594  */
 595 int ide_do_drive_cmd (ide_drive_t *drive, struct request *rq, ide_action_t action);
 596  
 597 /*
 598  * Clean up after success/failure of an explicit drive cmd.
 599  * stat/err are used only when (HWGROUP(drive)->rq->cmd == IDE_DRIVE_CMD).
 600  */
 601 void ide_end_drive_cmd (ide_drive_t *drive, byte stat, byte err);
 602 
 603 /*
 604  * ide_multwrite() transfers a block of up to mcount sectors of data
 605  * to a drive as part of a disk multwrite operation.
 606  */
 607 void ide_multwrite (ide_drive_t *drive, unsigned int mcount);
 608 
 609 #ifdef CONFIG_BLK_DEV_IDECD
 610 /*
 611  * These are routines in ide-cd.c invoked from ide.c
 612  */
 613 void ide_do_rw_cdrom (ide_drive_t *, unsigned long);
 614 int ide_cdrom_ioctl (ide_drive_t *, struct inode *, struct file *, unsigned int, unsigned long);
 615 int ide_cdrom_check_media_change (ide_drive_t *);
 616 int ide_cdrom_open (struct inode *, struct file *, ide_drive_t *);
 617 void ide_cdrom_release (struct inode *, struct file *, ide_drive_t *);
 618 void ide_cdrom_setup (ide_drive_t *);
 619 #endif /* CONFIG_BLK_DEV_IDECD */
 620 
 621 #ifdef CONFIG_BLK_DEV_IDETAPE
 622 
 623 /*
 624  *      Functions in ide-tape.c which are invoked from ide.c:
 625  */
 626 
 627 /*
 628  *      idetape_identify_device is called during device probing stage to
 629  *      probe for an ide atapi tape drive and to initialize global variables
 630  *      in ide-tape.c which provide the link between the character device
 631  *      and the correspoding block device.
 632  *
 633  *      Returns 1 if an ide tape was detected and is supported.
 634  *      Returns 0 otherwise.
 635  */
 636  
 637 int idetape_identify_device (ide_drive_t *drive,struct hd_driveid *id);
 638 
 639 /*
 640  *      idetape_setup is called a bit later than idetape_identify_device,
 641  *      during the search for disk partitions, to initialize various tape
 642  *      state variables in ide_drive_t *drive.
 643  */
 644  
 645 void idetape_setup (ide_drive_t *drive);
 646 
 647 /*
 648  *      idetape_do_request is our request function. It is called by ide.c
 649  *      to process a new request.
 650  */
 651 
 652 void idetape_do_request (ide_drive_t *drive, struct request *rq, unsigned long block);
 653 
 654 /*
 655  *      idetape_end_request is used to finish servicing a request, and to
 656  *      insert a pending pipeline request into the main device queue.
 657  */
 658  
 659 void idetape_end_request (byte uptodate, ide_hwgroup_t *hwgroup);
 660 
 661 /*
 662  *      Block device interface functions.
 663  */
 664   
 665 int idetape_blkdev_ioctl (ide_drive_t *drive, struct inode *inode, struct file *file,
 666                         unsigned int cmd, unsigned long arg);
 667 int idetape_blkdev_open (struct inode *inode, struct file *filp, ide_drive_t *drive);
 668 void idetape_blkdev_release (struct inode *inode, struct file *filp, ide_drive_t *drive);
 669 
 670 /*
 671  *      idetape_register_chrdev initializes the character device interface to
 672  *      the ide tape drive.
 673  */
 674  
 675 void idetape_register_chrdev (void);
 676 
 677 #endif /* CONFIG_BLK_DEV_IDETAPE */
 678 
 679 #ifdef CONFIG_BLK_DEV_TRITON
 680 void ide_init_triton (byte, byte);
 681 #endif /* CONFIG_BLK_DEV_TRITON */

/* [previous][next][first][last][top][bottom][index][help] */