![[bottom]](../icons/bottom.png){kind=icon}
![[previous]](../icons/n_left.png){kind=icon}
![[next]](../icons/n_right.png){kind=icon}
![[first]](../icons/n_first.png){kind=icon}
![[last]](../icons/n_last.png){kind=icon}
![[top]](../icons/n_top.png){kind=icon}
![[index]](../icons/index.png){kind=icon}
![[help]](../icons/help.png){kind=icon}
*/
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 */
![[top]](../icons/top.png){kind=icon}
![[bottom]](../icons/n_bottom.png){kind=icon}
*/