2 * Copyright (C) 1994-1998 Linus Torvalds & authors (see below)
3 * Copyright (C) 2005, 2007 Bartlomiej Zolnierkiewicz
7 * Mostly written by Mark Lord <mlord@pobox.com>
8 * and Gadi Oxman <gadio@netvision.net.il>
9 * and Andre Hedrick <andre@linux-ide.org>
11 * See linux/MAINTAINERS for address of current maintainer.
13 * This is the IDE probe module, as evolved from hd.c and ide.c.
15 * -- increase WAIT_PIDENTIFY to avoid CD-ROM locking at boot
19 #include <linux/module.h>
20 #include <linux/types.h>
21 #include <linux/string.h>
22 #include <linux/kernel.h>
23 #include <linux/timer.h>
25 #include <linux/interrupt.h>
26 #include <linux/major.h>
27 #include <linux/errno.h>
28 #include <linux/genhd.h>
29 #include <linux/slab.h>
30 #include <linux/delay.h>
31 #include <linux/ide.h>
32 #include <linux/spinlock.h>
33 #include <linux/kmod.h>
34 #include <linux/pci.h>
35 #include <linux/scatterlist.h>
37 #include <asm/byteorder.h>
39 #include <asm/uaccess.h>
43 * generic_id - add a generic drive id
44 * @drive: drive to make an ID block for
46 * Add a fake id field to the drive we are passed. This allows
47 * use to skip a ton of NULL checks (which people always miss)
48 * and make drive properties unconditional outside of this file
51 static void generic_id(ide_drive_t
*drive
)
55 id
[ATA_ID_CUR_CYLS
] = id
[ATA_ID_CYLS
] = drive
->cyl
;
56 id
[ATA_ID_CUR_HEADS
] = id
[ATA_ID_HEADS
] = drive
->head
;
57 id
[ATA_ID_CUR_SECTORS
] = id
[ATA_ID_SECTORS
] = drive
->sect
;
60 static void ide_disk_init_chs(ide_drive_t
*drive
)
64 /* Extract geometry if we did not already have one for the drive */
65 if (!drive
->cyl
|| !drive
->head
|| !drive
->sect
) {
66 drive
->cyl
= drive
->bios_cyl
= id
[ATA_ID_CYLS
];
67 drive
->head
= drive
->bios_head
= id
[ATA_ID_HEADS
];
68 drive
->sect
= drive
->bios_sect
= id
[ATA_ID_SECTORS
];
71 /* Handle logical geometry translation by the drive */
72 if (ata_id_current_chs_valid(id
)) {
73 drive
->cyl
= id
[ATA_ID_CUR_CYLS
];
74 drive
->head
= id
[ATA_ID_CUR_HEADS
];
75 drive
->sect
= id
[ATA_ID_CUR_SECTORS
];
78 /* Use physical geometry if what we have still makes no sense */
79 if (drive
->head
> 16 && id
[ATA_ID_HEADS
] && id
[ATA_ID_HEADS
] <= 16) {
80 drive
->cyl
= id
[ATA_ID_CYLS
];
81 drive
->head
= id
[ATA_ID_HEADS
];
82 drive
->sect
= id
[ATA_ID_SECTORS
];
86 static void ide_disk_init_mult_count(ide_drive_t
*drive
)
89 u8 max_multsect
= id
[ATA_ID_MAX_MULTSECT
] & 0xff;
92 if ((max_multsect
/ 2) > 1)
93 id
[ATA_ID_MULTSECT
] = max_multsect
| 0x100;
95 id
[ATA_ID_MULTSECT
] &= ~0x1ff;
97 drive
->mult_req
= id
[ATA_ID_MULTSECT
] & 0xff;
100 drive
->special_flags
|= IDE_SFLAG_SET_MULTMODE
;
104 static void ide_classify_ata_dev(ide_drive_t
*drive
)
107 char *m
= (char *)&id
[ATA_ID_PROD
];
108 int is_cfa
= ata_id_is_cfa(id
);
110 /* CF devices are *not* removable in Linux definition of the term */
111 if (is_cfa
== 0 && (id
[ATA_ID_CONFIG
] & (1 << 7)))
112 drive
->dev_flags
|= IDE_DFLAG_REMOVABLE
;
114 drive
->media
= ide_disk
;
116 if (!ata_id_has_unload(drive
->id
))
117 drive
->dev_flags
|= IDE_DFLAG_NO_UNLOAD
;
119 printk(KERN_INFO
"%s: %s, %s DISK drive\n", drive
->name
, m
,
120 is_cfa
? "CFA" : "ATA");
123 static void ide_classify_atapi_dev(ide_drive_t
*drive
)
126 char *m
= (char *)&id
[ATA_ID_PROD
];
127 u8 type
= (id
[ATA_ID_CONFIG
] >> 8) & 0x1f;
129 printk(KERN_INFO
"%s: %s, ATAPI ", drive
->name
, m
);
132 if (!strstr(m
, "CD-ROM")) {
133 if (!strstr(m
, "oppy") &&
134 !strstr(m
, "poyp") &&
136 printk(KERN_CONT
"cdrom or floppy?, assuming ");
137 if (drive
->media
!= ide_cdrom
) {
138 printk(KERN_CONT
"FLOPPY");
139 drive
->dev_flags
|= IDE_DFLAG_REMOVABLE
;
143 /* Early cdrom models used zero */
146 drive
->dev_flags
|= IDE_DFLAG_REMOVABLE
;
148 /* kludge for Apple PowerBook internal zip */
149 if (!strstr(m
, "CD-ROM") && strstr(m
, "ZIP")) {
150 printk(KERN_CONT
"FLOPPY");
155 printk(KERN_CONT
"CD/DVD-ROM");
158 printk(KERN_CONT
"TAPE");
161 printk(KERN_CONT
"OPTICAL");
162 drive
->dev_flags
|= IDE_DFLAG_REMOVABLE
;
165 printk(KERN_CONT
"UNKNOWN (type %d)", type
);
169 printk(KERN_CONT
" drive\n");
171 /* an ATAPI device ignores DRDY */
172 drive
->ready_stat
= 0;
173 if (ata_id_cdb_intr(id
))
174 drive
->atapi_flags
|= IDE_AFLAG_DRQ_INTERRUPT
;
175 drive
->dev_flags
|= IDE_DFLAG_DOORLOCKING
;
176 /* we don't do head unloading on ATAPI devices */
177 drive
->dev_flags
|= IDE_DFLAG_NO_UNLOAD
;
181 * do_identify - identify a drive
182 * @drive: drive to identify
184 * @id: buffer for IDENTIFY data
186 * Called when we have issued a drive identify command to
187 * read and parse the results. This function is run with
188 * interrupts disabled.
191 static void do_identify(ide_drive_t
*drive
, u8 cmd
, u16
*id
)
193 ide_hwif_t
*hwif
= drive
->hwif
;
194 char *m
= (char *)&id
[ATA_ID_PROD
];
198 /* local CPU only; some systems need this */
199 local_irq_save(flags
);
200 /* read 512 bytes of id info */
201 hwif
->tp_ops
->input_data(drive
, NULL
, id
, SECTOR_SIZE
);
202 local_irq_restore(flags
);
204 drive
->dev_flags
|= IDE_DFLAG_ID_READ
;
206 printk(KERN_INFO
"%s: dumping identify data\n", drive
->name
);
207 ide_dump_identify((u8
*)id
);
212 * ATA_CMD_ID_ATA returns little-endian info,
213 * ATA_CMD_ID_ATAPI *usually* returns little-endian info.
215 if (cmd
== ATA_CMD_ID_ATAPI
) {
216 if ((m
[0] == 'N' && m
[1] == 'E') || /* NEC */
217 (m
[0] == 'F' && m
[1] == 'X') || /* Mitsumi */
218 (m
[0] == 'P' && m
[1] == 'i')) /* Pioneer */
219 /* Vertos drives may still be weird */
223 ide_fixstring(m
, ATA_ID_PROD_LEN
, bswap
);
224 ide_fixstring((char *)&id
[ATA_ID_FW_REV
], ATA_ID_FW_REV_LEN
, bswap
);
225 ide_fixstring((char *)&id
[ATA_ID_SERNO
], ATA_ID_SERNO_LEN
, bswap
);
227 /* we depend on this a lot! */
228 m
[ATA_ID_PROD_LEN
- 1] = '\0';
230 if (strstr(m
, "E X A B Y T E N E S T"))
231 drive
->dev_flags
&= ~IDE_DFLAG_PRESENT
;
233 drive
->dev_flags
|= IDE_DFLAG_PRESENT
;
237 * ide_dev_read_id - send ATA/ATAPI IDENTIFY command
238 * @drive: drive to identify
239 * @cmd: command to use
240 * @id: buffer for IDENTIFY data
241 * @irq_ctx: flag set when called from the IRQ context
243 * Sends an ATA(PI) IDENTIFY request to a drive and waits for a response.
245 * Returns: 0 device was identified
246 * 1 device timed-out (no response to identify request)
247 * 2 device aborted the command (refused to identify itself)
250 int ide_dev_read_id(ide_drive_t
*drive
, u8 cmd
, u16
*id
, int irq_ctx
)
252 ide_hwif_t
*hwif
= drive
->hwif
;
253 struct ide_io_ports
*io_ports
= &hwif
->io_ports
;
254 const struct ide_tp_ops
*tp_ops
= hwif
->tp_ops
;
255 int use_altstatus
= 0, rc
;
256 unsigned long timeout
;
260 * Disable device IRQ. Otherwise we'll get spurious interrupts
261 * during the identify phase that the IRQ handler isn't expecting.
263 if (io_ports
->ctl_addr
)
264 tp_ops
->write_devctl(hwif
, ATA_NIEN
| ATA_DEVCTL_OBS
);
266 /* take a deep breath */
272 if (io_ports
->ctl_addr
&&
273 (hwif
->host_flags
& IDE_HFLAG_BROKEN_ALTSTATUS
) == 0) {
274 a
= tp_ops
->read_altstatus(hwif
);
275 s
= tp_ops
->read_status(hwif
);
276 if ((a
^ s
) & ~ATA_IDX
)
277 /* ancient Seagate drives, broken interfaces */
278 printk(KERN_INFO
"%s: probing with STATUS(0x%02x) "
279 "instead of ALTSTATUS(0x%02x)\n",
282 /* use non-intrusive polling */
286 /* set features register for atapi
287 * identify command to be sure of reply
289 if (cmd
== ATA_CMD_ID_ATAPI
) {
290 struct ide_taskfile tf
;
292 memset(&tf
, 0, sizeof(tf
));
293 /* disable DMA & overlap */
294 tp_ops
->tf_load(drive
, &tf
, IDE_VALID_FEATURE
);
297 /* ask drive for ID */
298 tp_ops
->exec_command(hwif
, cmd
);
300 timeout
= ((cmd
== ATA_CMD_ID_ATA
) ? WAIT_WORSTCASE
: WAIT_PIDENTIFY
) / 2;
302 /* wait for IRQ and ATA_DRQ */
304 rc
= __ide_wait_stat(drive
, ATA_DRQ
, BAD_R_STAT
, timeout
, &s
);
308 rc
= ide_busy_sleep(drive
, timeout
, use_altstatus
);
313 s
= tp_ops
->read_status(hwif
);
316 if (OK_STAT(s
, ATA_DRQ
, BAD_R_STAT
)) {
317 /* drive returned ID */
318 do_identify(drive
, cmd
, id
);
319 /* drive responded with ID */
321 /* clear drive IRQ */
322 (void)tp_ops
->read_status(hwif
);
324 /* drive refused ID */
330 int ide_busy_sleep(ide_drive_t
*drive
, unsigned long timeout
, int altstatus
)
332 ide_hwif_t
*hwif
= drive
->hwif
;
338 msleep(50); /* give drive a breather */
339 stat
= altstatus
? hwif
->tp_ops
->read_altstatus(hwif
)
340 : hwif
->tp_ops
->read_status(hwif
);
341 if ((stat
& ATA_BUSY
) == 0)
343 } while (time_before(jiffies
, timeout
));
345 printk(KERN_ERR
"%s: timeout in %s\n", drive
->name
, __func__
);
347 return 1; /* drive timed-out */
350 static u8
ide_read_device(ide_drive_t
*drive
)
352 struct ide_taskfile tf
;
354 drive
->hwif
->tp_ops
->tf_read(drive
, &tf
, IDE_VALID_DEVICE
);
360 * do_probe - probe an IDE device
361 * @drive: drive to probe
362 * @cmd: command to use
364 * do_probe() has the difficult job of finding a drive if it exists,
365 * without getting hung up if it doesn't exist, without trampling on
366 * ethernet cards, and without leaving any IRQs dangling to haunt us later.
368 * If a drive is "known" to exist (from CMOS or kernel parameters),
369 * but does not respond right away, the probe will "hang in there"
370 * for the maximum wait time (about 30 seconds), otherwise it will
371 * exit much more quickly.
373 * Returns: 0 device was identified
374 * 1 device timed-out (no response to identify request)
375 * 2 device aborted the command (refused to identify itself)
376 * 3 bad status from device (possible for ATAPI drives)
377 * 4 probe was not attempted because failure was obvious
380 static int do_probe (ide_drive_t
*drive
, u8 cmd
)
382 ide_hwif_t
*hwif
= drive
->hwif
;
383 const struct ide_tp_ops
*tp_ops
= hwif
->tp_ops
;
386 u8 present
= !!(drive
->dev_flags
& IDE_DFLAG_PRESENT
), stat
;
388 /* avoid waiting for inappropriate probes */
389 if (present
&& drive
->media
!= ide_disk
&& cmd
== ATA_CMD_ID_ATA
)
393 printk(KERN_INFO
"probing for %s: present=%d, media=%d, probetype=%s\n",
394 drive
->name
, present
, drive
->media
,
395 (cmd
== ATA_CMD_ID_ATA
) ? "ATA" : "ATAPI");
398 /* needed for some systems
399 * (e.g. crw9624 as drive0 with disk as slave)
402 tp_ops
->dev_select(drive
);
405 if (ide_read_device(drive
) != drive
->select
&& present
== 0) {
407 /* exit with drive0 selected */
408 tp_ops
->dev_select(hwif
->devices
[0]);
409 /* allow ATA_BUSY to assert & clear */
412 /* no i/f present: mmm.. this should be a 4 -ml */
416 stat
= tp_ops
->read_status(hwif
);
418 if (OK_STAT(stat
, ATA_DRDY
, ATA_BUSY
) ||
419 present
|| cmd
== ATA_CMD_ID_ATAPI
) {
420 rc
= ide_dev_read_id(drive
, cmd
, id
, 0);
422 /* failed: try again */
423 rc
= ide_dev_read_id(drive
, cmd
, id
, 0);
425 stat
= tp_ops
->read_status(hwif
);
427 if (stat
== (ATA_BUSY
| ATA_DRDY
))
430 if (rc
== 1 && cmd
== ATA_CMD_ID_ATAPI
) {
431 printk(KERN_ERR
"%s: no response (status = 0x%02x), "
432 "resetting drive\n", drive
->name
, stat
);
434 tp_ops
->dev_select(drive
);
436 tp_ops
->exec_command(hwif
, ATA_CMD_DEV_RESET
);
437 (void)ide_busy_sleep(drive
, WAIT_WORSTCASE
, 0);
438 rc
= ide_dev_read_id(drive
, cmd
, id
, 0);
441 /* ensure drive IRQ is clear */
442 stat
= tp_ops
->read_status(hwif
);
445 printk(KERN_ERR
"%s: no response (status = 0x%02x)\n",
448 /* not present or maybe ATAPI */
452 /* exit with drive0 selected */
453 tp_ops
->dev_select(hwif
->devices
[0]);
455 /* ensure drive irq is clear */
456 (void)tp_ops
->read_status(hwif
);
462 * probe_for_drives - upper level drive probe
463 * @drive: drive to probe for
465 * probe_for_drive() tests for existence of a given drive using do_probe()
466 * and presents things to the user as needed.
468 * Returns: 0 no device was found
470 * (note: IDE_DFLAG_PRESENT might still be not set)
473 static u8
probe_for_drive(ide_drive_t
*drive
)
479 drive
->dev_flags
&= ~IDE_DFLAG_ID_READ
;
481 m
= (char *)&drive
->id
[ATA_ID_PROD
];
482 strcpy(m
, "UNKNOWN");
485 if ((drive
->dev_flags
& IDE_DFLAG_NOPROBE
) == 0) {
486 /* if !(success||timed-out) */
487 cmd
= ATA_CMD_ID_ATA
;
488 rc
= do_probe(drive
, cmd
);
490 /* look for ATAPI device */
491 cmd
= ATA_CMD_ID_ATAPI
;
492 rc
= do_probe(drive
, cmd
);
495 if ((drive
->dev_flags
& IDE_DFLAG_PRESENT
) == 0)
498 /* identification failed? */
499 if ((drive
->dev_flags
& IDE_DFLAG_ID_READ
) == 0) {
500 if (drive
->media
== ide_disk
) {
501 printk(KERN_INFO
"%s: non-IDE drive, CHS=%d/%d/%d\n",
502 drive
->name
, drive
->cyl
,
503 drive
->head
, drive
->sect
);
504 } else if (drive
->media
== ide_cdrom
) {
505 printk(KERN_INFO
"%s: ATAPI cdrom (?)\n", drive
->name
);
508 printk(KERN_WARNING
"%s: Unknown device on bus refused identification. Ignoring.\n", drive
->name
);
509 drive
->dev_flags
&= ~IDE_DFLAG_PRESENT
;
512 if (cmd
== ATA_CMD_ID_ATAPI
)
513 ide_classify_atapi_dev(drive
);
515 ide_classify_ata_dev(drive
);
519 if ((drive
->dev_flags
& IDE_DFLAG_PRESENT
) == 0)
522 /* The drive wasn't being helpful. Add generic info only */
523 if ((drive
->dev_flags
& IDE_DFLAG_ID_READ
) == 0) {
528 if (drive
->media
== ide_disk
) {
529 ide_disk_init_chs(drive
);
530 ide_disk_init_mult_count(drive
);
536 static void hwif_release_dev(struct device
*dev
)
538 ide_hwif_t
*hwif
= container_of(dev
, ide_hwif_t
, gendev
);
540 complete(&hwif
->gendev_rel_comp
);
543 static int ide_register_port(ide_hwif_t
*hwif
)
547 /* register with global device tree */
548 dev_set_name(&hwif
->gendev
, hwif
->name
);
549 dev_set_drvdata(&hwif
->gendev
, hwif
);
550 if (hwif
->gendev
.parent
== NULL
)
551 hwif
->gendev
.parent
= hwif
->dev
;
552 hwif
->gendev
.release
= hwif_release_dev
;
554 ret
= device_register(&hwif
->gendev
);
556 printk(KERN_WARNING
"IDE: %s: device_register error: %d\n",
561 hwif
->portdev
= device_create(ide_port_class
, &hwif
->gendev
,
562 MKDEV(0, 0), hwif
, hwif
->name
);
563 if (IS_ERR(hwif
->portdev
)) {
564 ret
= PTR_ERR(hwif
->portdev
);
565 device_unregister(&hwif
->gendev
);
572 * ide_port_wait_ready - wait for port to become ready
575 * This is needed on some PPCs and a bunch of BIOS-less embedded
576 * platforms. Typical cases are:
578 * - The firmware hard reset the disk before booting the kernel,
579 * the drive is still doing it's poweron-reset sequence, that
580 * can take up to 30 seconds.
582 * - The firmware does nothing (or no firmware), the device is
583 * still in POST state (same as above actually).
585 * - Some CD/DVD/Writer combo drives tend to drive the bus during
586 * their reset sequence even when they are non-selected slave
587 * devices, thus preventing discovery of the main HD.
589 * Doing this wait-for-non-busy should not harm any existing
590 * configuration and fix some issues like the above.
594 * Returns 0 on success, error code (< 0) otherwise.
597 static int ide_port_wait_ready(ide_hwif_t
*hwif
)
599 const struct ide_tp_ops
*tp_ops
= hwif
->tp_ops
;
603 printk(KERN_DEBUG
"Probing IDE interface %s...\n", hwif
->name
);
605 /* Let HW settle down a bit from whatever init state we
609 /* Wait for BSY bit to go away, spec timeout is 30 seconds,
610 * I know of at least one disk who takes 31 seconds, I use 35
613 rc
= ide_wait_not_busy(hwif
, 35000);
617 /* Now make sure both master & slave are ready */
618 ide_port_for_each_dev(i
, drive
, hwif
) {
619 /* Ignore disks that we will not probe for later. */
620 if ((drive
->dev_flags
& IDE_DFLAG_NOPROBE
) == 0 ||
621 (drive
->dev_flags
& IDE_DFLAG_PRESENT
)) {
622 tp_ops
->dev_select(drive
);
623 tp_ops
->write_devctl(hwif
, ATA_DEVCTL_OBS
);
625 rc
= ide_wait_not_busy(hwif
, 35000);
629 printk(KERN_DEBUG
"%s: ide_wait_not_busy() skipped\n",
633 /* Exit function with master reselected (let's be sane) */
635 tp_ops
->dev_select(hwif
->devices
[0]);
641 * ide_undecoded_slave - look for bad CF adapters
642 * @dev1: slave device
644 * Analyse the drives on the interface and attempt to decide if we
645 * have the same drive viewed twice. This occurs with crap CF adapters
646 * and PCMCIA sometimes.
649 void ide_undecoded_slave(ide_drive_t
*dev1
)
651 ide_drive_t
*dev0
= dev1
->hwif
->devices
[0];
653 if ((dev1
->dn
& 1) == 0 || (dev0
->dev_flags
& IDE_DFLAG_PRESENT
) == 0)
656 /* If the models don't match they are not the same product */
657 if (strcmp((char *)&dev0
->id
[ATA_ID_PROD
],
658 (char *)&dev1
->id
[ATA_ID_PROD
]))
661 /* Serial numbers do not match */
662 if (strncmp((char *)&dev0
->id
[ATA_ID_SERNO
],
663 (char *)&dev1
->id
[ATA_ID_SERNO
], ATA_ID_SERNO_LEN
))
666 /* No serial number, thankfully very rare for CF */
667 if (*(char *)&dev0
->id
[ATA_ID_SERNO
] == 0)
670 /* Appears to be an IDE flash adapter with decode bugs */
671 printk(KERN_WARNING
"ide-probe: ignoring undecoded slave\n");
673 dev1
->dev_flags
&= ~IDE_DFLAG_PRESENT
;
676 EXPORT_SYMBOL_GPL(ide_undecoded_slave
);
678 static int ide_probe_port(ide_hwif_t
*hwif
)
684 BUG_ON(hwif
->present
);
686 if ((hwif
->devices
[0]->dev_flags
& IDE_DFLAG_NOPROBE
) &&
687 (hwif
->devices
[1]->dev_flags
& IDE_DFLAG_NOPROBE
))
691 * We must always disable IRQ, as probe_for_drive will assert IRQ, but
692 * we'll install our IRQ driver much later...
696 disable_irq(hwif
->irq
);
698 rc
= ide_port_wait_ready(hwif
);
700 printk(KERN_INFO
"%s: no devices on the port\n", hwif
->name
);
702 } else if (rc
== -EBUSY
)
703 printk(KERN_ERR
"%s: not ready before the probe\n", hwif
->name
);
708 * Second drive should only exist if first drive was found,
709 * but a lot of cdrom drives are configured as single slaves.
711 ide_port_for_each_dev(i
, drive
, hwif
) {
712 (void) probe_for_drive(drive
);
713 if (drive
->dev_flags
& IDE_DFLAG_PRESENT
)
718 * Use cached IRQ number. It might be (and is...) changed by probe
727 static void ide_port_tune_devices(ide_hwif_t
*hwif
)
729 const struct ide_port_ops
*port_ops
= hwif
->port_ops
;
733 ide_port_for_each_present_dev(i
, drive
, hwif
) {
734 ide_check_nien_quirk_list(drive
);
736 if (port_ops
&& port_ops
->quirkproc
)
737 port_ops
->quirkproc(drive
);
740 ide_port_for_each_present_dev(i
, drive
, hwif
) {
741 ide_set_max_pio(drive
);
743 drive
->dev_flags
|= IDE_DFLAG_NICE1
;
753 static int ide_init_queue(ide_drive_t
*drive
)
755 struct request_queue
*q
;
756 ide_hwif_t
*hwif
= drive
->hwif
;
757 int max_sectors
= 256;
758 int max_sg_entries
= PRD_ENTRIES
;
761 * Our default set up assumes the normal IDE case,
762 * that is 64K segmenting, standard PRD setup
763 * and LBA28. Some drivers then impose their own
764 * limits and LBA48 we could raise it but as yet
768 q
= blk_init_queue_node(do_ide_request
, NULL
, hwif_to_node(hwif
));
772 q
->queuedata
= drive
;
773 blk_queue_segment_boundary(q
, 0xffff);
775 if (hwif
->rqsize
< max_sectors
)
776 max_sectors
= hwif
->rqsize
;
777 blk_queue_max_sectors(q
, max_sectors
);
780 /* When we have an IOMMU, we may have a problem where pci_map_sg()
781 * creates segments that don't completely match our boundary
782 * requirements and thus need to be broken up again. Because it
783 * doesn't align properly either, we may actually have to break up
784 * to more segments than what was we got in the first place, a max
785 * worst case is twice as many.
786 * This will be fixed once we teach pci_map_sg() about our boundary
787 * requirements, hopefully soon. *FIXME*
789 if (!PCI_DMA_BUS_IS_PHYS
)
790 max_sg_entries
>>= 1;
791 #endif /* CONFIG_PCI */
793 blk_queue_max_hw_segments(q
, max_sg_entries
);
794 blk_queue_max_phys_segments(q
, max_sg_entries
);
796 /* assign drive queue */
799 /* needs drive->queue to be set */
800 ide_toggle_bounce(drive
, 1);
805 static DEFINE_MUTEX(ide_cfg_mtx
);
808 * For any present drive:
809 * - allocate the block device queue
811 static int ide_port_setup_devices(ide_hwif_t
*hwif
)
816 mutex_lock(&ide_cfg_mtx
);
817 ide_port_for_each_present_dev(i
, drive
, hwif
) {
818 if (ide_init_queue(drive
)) {
819 printk(KERN_ERR
"ide: failed to init %s\n",
821 drive
->dev_flags
&= ~IDE_DFLAG_PRESENT
;
827 mutex_unlock(&ide_cfg_mtx
);
832 static void ide_host_enable_irqs(struct ide_host
*host
)
837 ide_host_for_each_port(i
, hwif
, host
) {
841 /* clear any pending IRQs */
842 hwif
->tp_ops
->read_status(hwif
);
845 if (hwif
->io_ports
.ctl_addr
)
846 hwif
->tp_ops
->write_devctl(hwif
, ATA_DEVCTL_OBS
);
851 * This routine sets up the IRQ for an IDE interface.
853 static int init_irq (ide_hwif_t
*hwif
)
855 struct ide_io_ports
*io_ports
= &hwif
->io_ports
;
856 struct ide_host
*host
= hwif
->host
;
857 irq_handler_t irq_handler
= host
->irq_handler
;
858 int sa
= host
->irq_flags
;
860 if (irq_handler
== NULL
)
861 irq_handler
= ide_intr
;
863 if (request_irq(hwif
->irq
, irq_handler
, sa
, hwif
->name
, hwif
))
866 #if !defined(__mc68000__)
867 printk(KERN_INFO
"%s at 0x%03lx-0x%03lx,0x%03lx on irq %d", hwif
->name
,
868 io_ports
->data_addr
, io_ports
->status_addr
,
869 io_ports
->ctl_addr
, hwif
->irq
);
871 printk(KERN_INFO
"%s at 0x%08lx on irq %d", hwif
->name
,
872 io_ports
->data_addr
, hwif
->irq
);
873 #endif /* __mc68000__ */
874 if (hwif
->host
->host_flags
& IDE_HFLAG_SERIALIZE
)
875 printk(KERN_CONT
" (serialized)");
876 printk(KERN_CONT
"\n");
883 static int ata_lock(dev_t dev
, void *data
)
885 /* FIXME: we want to pin hwif down */
889 static struct kobject
*ata_probe(dev_t dev
, int *part
, void *data
)
891 ide_hwif_t
*hwif
= data
;
892 int unit
= *part
>> PARTN_BITS
;
893 ide_drive_t
*drive
= hwif
->devices
[unit
];
895 if ((drive
->dev_flags
& IDE_DFLAG_PRESENT
) == 0)
898 if (drive
->media
== ide_disk
)
899 request_module("ide-disk");
900 if (drive
->media
== ide_cdrom
|| drive
->media
== ide_optical
)
901 request_module("ide-cd");
902 if (drive
->media
== ide_tape
)
903 request_module("ide-tape");
904 if (drive
->media
== ide_floppy
)
905 request_module("ide-floppy");
910 static struct kobject
*exact_match(dev_t dev
, int *part
, void *data
)
912 struct gendisk
*p
= data
;
913 *part
&= (1 << PARTN_BITS
) - 1;
914 return &disk_to_dev(p
)->kobj
;
917 static int exact_lock(dev_t dev
, void *data
)
919 struct gendisk
*p
= data
;
926 void ide_register_region(struct gendisk
*disk
)
928 blk_register_region(MKDEV(disk
->major
, disk
->first_minor
),
929 disk
->minors
, NULL
, exact_match
, exact_lock
, disk
);
932 EXPORT_SYMBOL_GPL(ide_register_region
);
934 void ide_unregister_region(struct gendisk
*disk
)
936 blk_unregister_region(MKDEV(disk
->major
, disk
->first_minor
),
940 EXPORT_SYMBOL_GPL(ide_unregister_region
);
942 void ide_init_disk(struct gendisk
*disk
, ide_drive_t
*drive
)
944 ide_hwif_t
*hwif
= drive
->hwif
;
945 unsigned int unit
= drive
->dn
& 1;
947 disk
->major
= hwif
->major
;
948 disk
->first_minor
= unit
<< PARTN_BITS
;
949 sprintf(disk
->disk_name
, "hd%c", 'a' + hwif
->index
* MAX_DRIVES
+ unit
);
950 disk
->queue
= drive
->queue
;
953 EXPORT_SYMBOL_GPL(ide_init_disk
);
955 static void drive_release_dev (struct device
*dev
)
957 ide_drive_t
*drive
= container_of(dev
, ide_drive_t
, gendev
);
959 ide_proc_unregister_device(drive
);
961 blk_cleanup_queue(drive
->queue
);
964 drive
->dev_flags
&= ~IDE_DFLAG_PRESENT
;
966 complete(&drive
->gendev_rel_comp
);
969 static int hwif_init(ide_hwif_t
*hwif
)
972 printk(KERN_ERR
"%s: disabled, no IRQ\n", hwif
->name
);
976 if (register_blkdev(hwif
->major
, hwif
->name
))
979 if (!hwif
->sg_max_nents
)
980 hwif
->sg_max_nents
= PRD_ENTRIES
;
982 hwif
->sg_table
= kmalloc(sizeof(struct scatterlist
)*hwif
->sg_max_nents
,
984 if (!hwif
->sg_table
) {
985 printk(KERN_ERR
"%s: unable to allocate SG table.\n", hwif
->name
);
989 sg_init_table(hwif
->sg_table
, hwif
->sg_max_nents
);
991 if (init_irq(hwif
)) {
992 printk(KERN_ERR
"%s: disabled, unable to get IRQ %d\n",
993 hwif
->name
, hwif
->irq
);
997 blk_register_region(MKDEV(hwif
->major
, 0), MAX_DRIVES
<< PARTN_BITS
,
998 THIS_MODULE
, ata_probe
, ata_lock
, hwif
);
1002 unregister_blkdev(hwif
->major
, hwif
->name
);
1006 static void hwif_register_devices(ide_hwif_t
*hwif
)
1011 ide_port_for_each_present_dev(i
, drive
, hwif
) {
1012 struct device
*dev
= &drive
->gendev
;
1015 dev_set_name(dev
, "%u.%u", hwif
->index
, i
);
1016 dev_set_drvdata(dev
, drive
);
1017 dev
->parent
= &hwif
->gendev
;
1018 dev
->bus
= &ide_bus_type
;
1019 dev
->release
= drive_release_dev
;
1021 ret
= device_register(dev
);
1023 printk(KERN_WARNING
"IDE: %s: device_register error: "
1024 "%d\n", __func__
, ret
);
1028 static void ide_port_init_devices(ide_hwif_t
*hwif
)
1030 const struct ide_port_ops
*port_ops
= hwif
->port_ops
;
1034 ide_port_for_each_dev(i
, drive
, hwif
) {
1035 drive
->dn
= i
+ hwif
->channel
* 2;
1037 if (hwif
->host_flags
& IDE_HFLAG_IO_32BIT
)
1038 drive
->io_32bit
= 1;
1039 if (hwif
->host_flags
& IDE_HFLAG_NO_IO_32BIT
)
1040 drive
->dev_flags
|= IDE_DFLAG_NO_IO_32BIT
;
1041 if (hwif
->host_flags
& IDE_HFLAG_UNMASK_IRQS
)
1042 drive
->dev_flags
|= IDE_DFLAG_UNMASK
;
1043 if (hwif
->host_flags
& IDE_HFLAG_NO_UNMASK_IRQS
)
1044 drive
->dev_flags
|= IDE_DFLAG_NO_UNMASK
;
1046 if (port_ops
&& port_ops
->init_dev
)
1047 port_ops
->init_dev(drive
);
1050 ide_port_for_each_dev(i
, drive
, hwif
) {
1052 * default to PIO Mode 0 before we figure out
1053 * the most suited mode for the attached device
1055 if (port_ops
&& port_ops
->set_pio_mode
)
1056 port_ops
->set_pio_mode(drive
, 0);
1060 static void ide_init_port(ide_hwif_t
*hwif
, unsigned int port
,
1061 const struct ide_port_info
*d
)
1063 hwif
->channel
= port
;
1065 hwif
->chipset
= d
->chipset
? d
->chipset
: ide_pci
;
1070 /* ->host_flags may be set by ->init_iops (or even earlier...) */
1071 hwif
->host_flags
|= d
->host_flags
;
1072 hwif
->pio_mask
= d
->pio_mask
;
1075 hwif
->tp_ops
= d
->tp_ops
;
1077 /* ->set_pio_mode for DTC2278 is currently limited to port 0 */
1078 if ((hwif
->host_flags
& IDE_HFLAG_DTC2278
) == 0 || hwif
->channel
== 0)
1079 hwif
->port_ops
= d
->port_ops
;
1081 hwif
->swdma_mask
= d
->swdma_mask
;
1082 hwif
->mwdma_mask
= d
->mwdma_mask
;
1083 hwif
->ultra_mask
= d
->udma_mask
;
1085 if ((d
->host_flags
& IDE_HFLAG_NO_DMA
) == 0) {
1088 hwif
->dma_ops
= d
->dma_ops
;
1091 rc
= d
->init_dma(hwif
, d
);
1093 rc
= ide_hwif_setup_dma(hwif
, d
);
1096 printk(KERN_INFO
"%s: DMA disabled\n", hwif
->name
);
1098 hwif
->dma_ops
= NULL
;
1100 hwif
->swdma_mask
= 0;
1101 hwif
->mwdma_mask
= 0;
1102 hwif
->ultra_mask
= 0;
1106 if ((d
->host_flags
& IDE_HFLAG_SERIALIZE
) ||
1107 ((d
->host_flags
& IDE_HFLAG_SERIALIZE_DMA
) && hwif
->dma_base
))
1108 hwif
->host
->host_flags
|= IDE_HFLAG_SERIALIZE
;
1111 hwif
->rqsize
= d
->max_sectors
;
1113 if ((hwif
->host_flags
& IDE_HFLAG_NO_LBA48
) ||
1114 (hwif
->host_flags
& IDE_HFLAG_NO_LBA48_DMA
))
1117 hwif
->rqsize
= 65536;
1120 /* call chipset specific routine for each enabled port */
1125 static void ide_port_cable_detect(ide_hwif_t
*hwif
)
1127 const struct ide_port_ops
*port_ops
= hwif
->port_ops
;
1129 if (port_ops
&& port_ops
->cable_detect
&& (hwif
->ultra_mask
& 0x78)) {
1130 if (hwif
->cbl
!= ATA_CBL_PATA40_SHORT
)
1131 hwif
->cbl
= port_ops
->cable_detect(hwif
);
1135 static const u8 ide_hwif_to_major
[] =
1136 { IDE0_MAJOR
, IDE1_MAJOR
, IDE2_MAJOR
, IDE3_MAJOR
, IDE4_MAJOR
,
1137 IDE5_MAJOR
, IDE6_MAJOR
, IDE7_MAJOR
, IDE8_MAJOR
, IDE9_MAJOR
};
1139 static void ide_port_init_devices_data(ide_hwif_t
*hwif
)
1144 ide_port_for_each_dev(i
, drive
, hwif
) {
1145 u8 j
= (hwif
->index
* MAX_DRIVES
) + i
;
1146 u16
*saved_id
= drive
->id
;
1148 memset(drive
, 0, sizeof(*drive
));
1149 memset(saved_id
, 0, SECTOR_SIZE
);
1150 drive
->id
= saved_id
;
1152 drive
->media
= ide_disk
;
1153 drive
->select
= (i
<< 4) | ATA_DEVICE_OBS
;
1155 drive
->ready_stat
= ATA_DRDY
;
1156 drive
->bad_wstat
= BAD_W_STAT
;
1157 drive
->special_flags
= IDE_SFLAG_RECALIBRATE
|
1158 IDE_SFLAG_SET_GEOMETRY
;
1159 drive
->name
[0] = 'h';
1160 drive
->name
[1] = 'd';
1161 drive
->name
[2] = 'a' + j
;
1162 drive
->max_failures
= IDE_DEFAULT_MAX_FAILURES
;
1164 INIT_LIST_HEAD(&drive
->list
);
1165 init_completion(&drive
->gendev_rel_comp
);
1169 static void ide_init_port_data(ide_hwif_t
*hwif
, unsigned int index
)
1171 /* fill in any non-zero initial values */
1172 hwif
->index
= index
;
1173 hwif
->major
= ide_hwif_to_major
[index
];
1175 hwif
->name
[0] = 'i';
1176 hwif
->name
[1] = 'd';
1177 hwif
->name
[2] = 'e';
1178 hwif
->name
[3] = '0' + index
;
1180 spin_lock_init(&hwif
->lock
);
1182 init_timer(&hwif
->timer
);
1183 hwif
->timer
.function
= &ide_timer_expiry
;
1184 hwif
->timer
.data
= (unsigned long)hwif
;
1186 init_completion(&hwif
->gendev_rel_comp
);
1188 hwif
->tp_ops
= &default_tp_ops
;
1190 ide_port_init_devices_data(hwif
);
1193 static void ide_init_port_hw(ide_hwif_t
*hwif
, struct ide_hw
*hw
)
1195 memcpy(&hwif
->io_ports
, &hw
->io_ports
, sizeof(hwif
->io_ports
));
1196 hwif
->irq
= hw
->irq
;
1197 hwif
->dev
= hw
->dev
;
1198 hwif
->gendev
.parent
= hw
->parent
? hw
->parent
: hw
->dev
;
1199 hwif
->config_data
= hw
->config
;
1202 static unsigned int ide_indexes
;
1205 * ide_find_port_slot - find free port slot
1208 * Return the new port slot index or -ENOENT if we are out of free slots.
1211 static int ide_find_port_slot(const struct ide_port_info
*d
)
1214 u8 bootable
= (d
&& (d
->host_flags
& IDE_HFLAG_NON_BOOTABLE
)) ? 0 : 1;
1215 u8 i
= (d
&& (d
->host_flags
& IDE_HFLAG_QD_2ND_PORT
)) ? 1 : 0;
1218 * Claim an unassigned slot.
1220 * Give preference to claiming other slots before claiming ide0/ide1,
1221 * just in case there's another interface yet-to-be-scanned
1222 * which uses ports 0x1f0/0x170 (the ide0/ide1 defaults).
1224 * Unless there is a bootable card that does not use the standard
1225 * ports 0x1f0/0x170 (the ide0/ide1 defaults).
1227 mutex_lock(&ide_cfg_mtx
);
1229 if ((ide_indexes
| i
) != (1 << MAX_HWIFS
) - 1)
1230 idx
= ffz(ide_indexes
| i
);
1232 if ((ide_indexes
| 3) != (1 << MAX_HWIFS
) - 1)
1233 idx
= ffz(ide_indexes
| 3);
1234 else if ((ide_indexes
& 3) != 3)
1235 idx
= ffz(ide_indexes
);
1238 ide_indexes
|= (1 << idx
);
1239 mutex_unlock(&ide_cfg_mtx
);
1244 static void ide_free_port_slot(int idx
)
1246 mutex_lock(&ide_cfg_mtx
);
1247 ide_indexes
&= ~(1 << idx
);
1248 mutex_unlock(&ide_cfg_mtx
);
1251 static void ide_port_free_devices(ide_hwif_t
*hwif
)
1256 ide_port_for_each_dev(i
, drive
, hwif
) {
1262 static int ide_port_alloc_devices(ide_hwif_t
*hwif
, int node
)
1266 for (i
= 0; i
< MAX_DRIVES
; i
++) {
1269 drive
= kzalloc_node(sizeof(*drive
), GFP_KERNEL
, node
);
1274 * In order to keep things simple we have an id
1275 * block for all drives at all times. If the device
1276 * is pre ATA or refuses ATA/ATAPI identify we
1277 * will add faked data to this.
1279 * Also note that 0 everywhere means "can't do X"
1281 drive
->id
= kzalloc_node(SECTOR_SIZE
, GFP_KERNEL
, node
);
1282 if (drive
->id
== NULL
)
1285 hwif
->devices
[i
] = drive
;
1290 ide_port_free_devices(hwif
);
1294 struct ide_host
*ide_host_alloc(const struct ide_port_info
*d
,
1295 struct ide_hw
**hws
, unsigned int n_ports
)
1297 struct ide_host
*host
;
1298 struct device
*dev
= hws
[0] ? hws
[0]->dev
: NULL
;
1299 int node
= dev
? dev_to_node(dev
) : -1;
1302 host
= kzalloc_node(sizeof(*host
), GFP_KERNEL
, node
);
1306 for (i
= 0; i
< n_ports
; i
++) {
1313 hwif
= kzalloc_node(sizeof(*hwif
), GFP_KERNEL
, node
);
1317 if (ide_port_alloc_devices(hwif
, node
) < 0) {
1322 idx
= ide_find_port_slot(d
);
1324 printk(KERN_ERR
"%s: no free slot for interface\n",
1325 d
? d
->name
: "ide");
1326 ide_port_free_devices(hwif
);
1331 ide_init_port_data(hwif
, idx
);
1335 host
->ports
[i
] = hwif
;
1339 if (host
->n_ports
== 0) {
1347 host
->init_chipset
= d
->init_chipset
;
1348 host
->get_lock
= d
->get_lock
;
1349 host
->release_lock
= d
->release_lock
;
1350 host
->host_flags
= d
->host_flags
;
1351 host
->irq_flags
= d
->irq_flags
;
1356 EXPORT_SYMBOL_GPL(ide_host_alloc
);
1358 static void ide_port_free(ide_hwif_t
*hwif
)
1360 ide_port_free_devices(hwif
);
1361 ide_free_port_slot(hwif
->index
);
1365 static void ide_disable_port(ide_hwif_t
*hwif
)
1367 struct ide_host
*host
= hwif
->host
;
1370 printk(KERN_INFO
"%s: disabling port\n", hwif
->name
);
1372 for (i
= 0; i
< MAX_HOST_PORTS
; i
++) {
1373 if (host
->ports
[i
] == hwif
) {
1374 host
->ports
[i
] = NULL
;
1379 ide_port_free(hwif
);
1382 int ide_host_register(struct ide_host
*host
, const struct ide_port_info
*d
,
1383 struct ide_hw
**hws
)
1385 ide_hwif_t
*hwif
, *mate
= NULL
;
1388 ide_host_for_each_port(i
, hwif
, host
) {
1394 ide_init_port_hw(hwif
, hws
[i
]);
1395 ide_port_apply_params(hwif
);
1397 if ((i
& 1) && mate
) {
1402 mate
= (i
& 1) ? NULL
: hwif
;
1404 ide_init_port(hwif
, i
& 1, d
);
1405 ide_port_cable_detect(hwif
);
1407 hwif
->port_flags
|= IDE_PFLAG_PROBING
;
1409 ide_port_init_devices(hwif
);
1412 ide_host_for_each_port(i
, hwif
, host
) {
1416 if (ide_probe_port(hwif
) == 0)
1419 hwif
->port_flags
&= ~IDE_PFLAG_PROBING
;
1421 if ((hwif
->host_flags
& IDE_HFLAG_4DRIVES
) == 0 ||
1422 hwif
->mate
== NULL
|| hwif
->mate
->present
== 0) {
1423 if (ide_register_port(hwif
)) {
1424 ide_disable_port(hwif
);
1430 ide_port_tune_devices(hwif
);
1433 ide_host_enable_irqs(host
);
1435 ide_host_for_each_port(i
, hwif
, host
) {
1439 if (hwif_init(hwif
) == 0) {
1440 printk(KERN_INFO
"%s: failed to initialize IDE "
1441 "interface\n", hwif
->name
);
1442 device_unregister(&hwif
->gendev
);
1443 ide_disable_port(hwif
);
1448 if (ide_port_setup_devices(hwif
) == 0) {
1455 ide_acpi_init_port(hwif
);
1458 ide_acpi_port_init_devices(hwif
);
1461 ide_host_for_each_port(i
, hwif
, host
) {
1466 hwif_register_devices(hwif
);
1469 ide_host_for_each_port(i
, hwif
, host
) {
1473 ide_sysfs_register_port(hwif
);
1474 ide_proc_register_port(hwif
);
1477 ide_proc_port_register_devices(hwif
);
1482 EXPORT_SYMBOL_GPL(ide_host_register
);
1484 int ide_host_add(const struct ide_port_info
*d
, struct ide_hw
**hws
,
1485 unsigned int n_ports
, struct ide_host
**hostp
)
1487 struct ide_host
*host
;
1490 host
= ide_host_alloc(d
, hws
, n_ports
);
1494 rc
= ide_host_register(host
, d
, hws
);
1496 ide_host_free(host
);
1505 EXPORT_SYMBOL_GPL(ide_host_add
);
1507 static void __ide_port_unregister_devices(ide_hwif_t
*hwif
)
1512 ide_port_for_each_present_dev(i
, drive
, hwif
) {
1513 device_unregister(&drive
->gendev
);
1514 wait_for_completion(&drive
->gendev_rel_comp
);
1518 void ide_port_unregister_devices(ide_hwif_t
*hwif
)
1520 mutex_lock(&ide_cfg_mtx
);
1521 __ide_port_unregister_devices(hwif
);
1523 ide_port_init_devices_data(hwif
);
1524 mutex_unlock(&ide_cfg_mtx
);
1526 EXPORT_SYMBOL_GPL(ide_port_unregister_devices
);
1529 * ide_unregister - free an IDE interface
1530 * @hwif: IDE interface
1532 * Perform the final unregister of an IDE interface.
1535 * The caller must not hold the IDE locks.
1537 * It is up to the caller to be sure there is no pending I/O here,
1538 * and that the interface will not be reopened (present/vanishing
1539 * locking isn't yet done BTW).
1542 static void ide_unregister(ide_hwif_t
*hwif
)
1544 BUG_ON(in_interrupt());
1545 BUG_ON(irqs_disabled());
1547 mutex_lock(&ide_cfg_mtx
);
1549 if (hwif
->present
) {
1550 __ide_port_unregister_devices(hwif
);
1554 ide_proc_unregister_port(hwif
);
1556 free_irq(hwif
->irq
, hwif
);
1558 device_unregister(hwif
->portdev
);
1559 device_unregister(&hwif
->gendev
);
1560 wait_for_completion(&hwif
->gendev_rel_comp
);
1563 * Remove us from the kernel's knowledge
1565 blk_unregister_region(MKDEV(hwif
->major
, 0), MAX_DRIVES
<<PARTN_BITS
);
1566 kfree(hwif
->sg_table
);
1567 unregister_blkdev(hwif
->major
, hwif
->name
);
1569 ide_release_dma_engine(hwif
);
1571 mutex_unlock(&ide_cfg_mtx
);
1574 void ide_host_free(struct ide_host
*host
)
1579 ide_host_for_each_port(i
, hwif
, host
) {
1581 ide_port_free(hwif
);
1586 EXPORT_SYMBOL_GPL(ide_host_free
);
1588 void ide_host_remove(struct ide_host
*host
)
1593 ide_host_for_each_port(i
, hwif
, host
) {
1595 ide_unregister(hwif
);
1598 ide_host_free(host
);
1600 EXPORT_SYMBOL_GPL(ide_host_remove
);
1602 void ide_port_scan(ide_hwif_t
*hwif
)
1606 ide_port_apply_params(hwif
);
1607 ide_port_cable_detect(hwif
);
1609 hwif
->port_flags
|= IDE_PFLAG_PROBING
;
1611 ide_port_init_devices(hwif
);
1613 rc
= ide_probe_port(hwif
);
1615 hwif
->port_flags
&= ~IDE_PFLAG_PROBING
;
1622 ide_port_tune_devices(hwif
);
1623 ide_port_setup_devices(hwif
);
1624 ide_acpi_port_init_devices(hwif
);
1625 hwif_register_devices(hwif
);
1626 ide_proc_port_register_devices(hwif
);
1628 EXPORT_SYMBOL_GPL(ide_port_scan
);