2 * libata-eh.c - libata error handling
4 * Maintained by: Tejun Heo <tj@kernel.org>
5 * Please ALWAYS copy linux-ide@vger.kernel.org
8 * Copyright 2006 Tejun Heo <htejun@gmail.com>
11 * This program is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU General Public License as
13 * published by the Free Software Foundation; either version 2, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 * General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; see the file COPYING. If not, write to
23 * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139,
27 * libata documentation is available via 'make {ps|pdf}docs',
28 * as Documentation/DocBook/libata.*
30 * Hardware documentation available from http://www.t13.org/ and
31 * http://www.sata-io.org/
35 #include <linux/kernel.h>
36 #include <linux/blkdev.h>
37 #include <linux/export.h>
38 #include <linux/pci.h>
39 #include <scsi/scsi.h>
40 #include <scsi/scsi_host.h>
41 #include <scsi/scsi_eh.h>
42 #include <scsi/scsi_device.h>
43 #include <scsi/scsi_cmnd.h>
44 #include <scsi/scsi_dbg.h>
45 #include "../scsi/scsi_transport_api.h"
47 #include <linux/libata.h>
52 /* speed down verdicts */
53 ATA_EH_SPDN_NCQ_OFF
= (1 << 0),
54 ATA_EH_SPDN_SPEED_DOWN
= (1 << 1),
55 ATA_EH_SPDN_FALLBACK_TO_PIO
= (1 << 2),
56 ATA_EH_SPDN_KEEP_ERRORS
= (1 << 3),
59 ATA_EFLAG_IS_IO
= (1 << 0),
60 ATA_EFLAG_DUBIOUS_XFER
= (1 << 1),
61 ATA_EFLAG_OLD_ER
= (1 << 31),
63 /* error categories */
66 ATA_ECAT_TOUT_HSM
= 2,
68 ATA_ECAT_DUBIOUS_NONE
= 4,
69 ATA_ECAT_DUBIOUS_ATA_BUS
= 5,
70 ATA_ECAT_DUBIOUS_TOUT_HSM
= 6,
71 ATA_ECAT_DUBIOUS_UNK_DEV
= 7,
74 ATA_EH_CMD_DFL_TIMEOUT
= 5000,
76 /* always put at least this amount of time between resets */
77 ATA_EH_RESET_COOL_DOWN
= 5000,
79 /* Waiting in ->prereset can never be reliable. It's
80 * sometimes nice to wait there but it can't be depended upon;
81 * otherwise, we wouldn't be resetting. Just give it enough
82 * time for most drives to spin up.
84 ATA_EH_PRERESET_TIMEOUT
= 10000,
85 ATA_EH_FASTDRAIN_INTERVAL
= 3000,
89 /* probe speed down parameters, see ata_eh_schedule_probe() */
90 ATA_EH_PROBE_TRIAL_INTERVAL
= 60000, /* 1 min */
91 ATA_EH_PROBE_TRIALS
= 2,
94 /* The following table determines how we sequence resets. Each entry
95 * represents timeout for that try. The first try can be soft or
96 * hardreset. All others are hardreset if available. In most cases
97 * the first reset w/ 10sec timeout should succeed. Following entries
98 * are mostly for error handling, hotplug and those outlier devices that
99 * take an exceptionally long time to recover from reset.
101 static const unsigned long ata_eh_reset_timeouts
[] = {
102 10000, /* most drives spin up by 10sec */
103 10000, /* > 99% working drives spin up before 20sec */
104 35000, /* give > 30 secs of idleness for outlier devices */
105 5000, /* and sweet one last chance */
106 ULONG_MAX
, /* > 1 min has elapsed, give up */
109 static const unsigned long ata_eh_identify_timeouts
[] = {
110 5000, /* covers > 99% of successes and not too boring on failures */
111 10000, /* combined time till here is enough even for media access */
112 30000, /* for true idiots */
116 static const unsigned long ata_eh_flush_timeouts
[] = {
117 15000, /* be generous with flush */
119 30000, /* and even more generous */
123 static const unsigned long ata_eh_other_timeouts
[] = {
124 5000, /* same rationale as identify timeout */
126 /* but no merciful 30sec for other commands, it just isn't worth it */
130 struct ata_eh_cmd_timeout_ent
{
132 const unsigned long *timeouts
;
135 /* The following table determines timeouts to use for EH internal
136 * commands. Each table entry is a command class and matches the
137 * commands the entry applies to and the timeout table to use.
139 * On the retry after a command timed out, the next timeout value from
140 * the table is used. If the table doesn't contain further entries,
141 * the last value is used.
143 * ehc->cmd_timeout_idx keeps track of which timeout to use per
144 * command class, so if SET_FEATURES times out on the first try, the
145 * next try will use the second timeout value only for that class.
147 #define CMDS(cmds...) (const u8 []){ cmds, 0 }
148 static const struct ata_eh_cmd_timeout_ent
149 ata_eh_cmd_timeout_table
[ATA_EH_CMD_TIMEOUT_TABLE_SIZE
] = {
150 { .commands
= CMDS(ATA_CMD_ID_ATA
, ATA_CMD_ID_ATAPI
),
151 .timeouts
= ata_eh_identify_timeouts
, },
152 { .commands
= CMDS(ATA_CMD_READ_NATIVE_MAX
, ATA_CMD_READ_NATIVE_MAX_EXT
),
153 .timeouts
= ata_eh_other_timeouts
, },
154 { .commands
= CMDS(ATA_CMD_SET_MAX
, ATA_CMD_SET_MAX_EXT
),
155 .timeouts
= ata_eh_other_timeouts
, },
156 { .commands
= CMDS(ATA_CMD_SET_FEATURES
),
157 .timeouts
= ata_eh_other_timeouts
, },
158 { .commands
= CMDS(ATA_CMD_INIT_DEV_PARAMS
),
159 .timeouts
= ata_eh_other_timeouts
, },
160 { .commands
= CMDS(ATA_CMD_FLUSH
, ATA_CMD_FLUSH_EXT
),
161 .timeouts
= ata_eh_flush_timeouts
},
165 static void __ata_port_freeze(struct ata_port
*ap
);
167 static void ata_eh_handle_port_suspend(struct ata_port
*ap
);
168 static void ata_eh_handle_port_resume(struct ata_port
*ap
);
169 #else /* CONFIG_PM */
170 static void ata_eh_handle_port_suspend(struct ata_port
*ap
)
173 static void ata_eh_handle_port_resume(struct ata_port
*ap
)
175 #endif /* CONFIG_PM */
177 static void __ata_ehi_pushv_desc(struct ata_eh_info
*ehi
, const char *fmt
,
180 ehi
->desc_len
+= vscnprintf(ehi
->desc
+ ehi
->desc_len
,
181 ATA_EH_DESC_LEN
- ehi
->desc_len
,
186 * __ata_ehi_push_desc - push error description without adding separator
188 * @fmt: printf format string
190 * Format string according to @fmt and append it to @ehi->desc.
193 * spin_lock_irqsave(host lock)
195 void __ata_ehi_push_desc(struct ata_eh_info
*ehi
, const char *fmt
, ...)
200 __ata_ehi_pushv_desc(ehi
, fmt
, args
);
205 * ata_ehi_push_desc - push error description with separator
207 * @fmt: printf format string
209 * Format string according to @fmt and append it to @ehi->desc.
210 * If @ehi->desc is not empty, ", " is added in-between.
213 * spin_lock_irqsave(host lock)
215 void ata_ehi_push_desc(struct ata_eh_info
*ehi
, const char *fmt
, ...)
220 __ata_ehi_push_desc(ehi
, ", ");
223 __ata_ehi_pushv_desc(ehi
, fmt
, args
);
228 * ata_ehi_clear_desc - clean error description
234 * spin_lock_irqsave(host lock)
236 void ata_ehi_clear_desc(struct ata_eh_info
*ehi
)
243 * ata_port_desc - append port description
244 * @ap: target ATA port
245 * @fmt: printf format string
247 * Format string according to @fmt and append it to port
248 * description. If port description is not empty, " " is added
249 * in-between. This function is to be used while initializing
250 * ata_host. The description is printed on host registration.
255 void ata_port_desc(struct ata_port
*ap
, const char *fmt
, ...)
259 WARN_ON(!(ap
->pflags
& ATA_PFLAG_INITIALIZING
));
261 if (ap
->link
.eh_info
.desc_len
)
262 __ata_ehi_push_desc(&ap
->link
.eh_info
, " ");
265 __ata_ehi_pushv_desc(&ap
->link
.eh_info
, fmt
, args
);
272 * ata_port_pbar_desc - append PCI BAR description
273 * @ap: target ATA port
274 * @bar: target PCI BAR
275 * @offset: offset into PCI BAR
276 * @name: name of the area
278 * If @offset is negative, this function formats a string which
279 * contains the name, address, size and type of the BAR and
280 * appends it to the port description. If @offset is zero or
281 * positive, only name and offsetted address is appended.
286 void ata_port_pbar_desc(struct ata_port
*ap
, int bar
, ssize_t offset
,
289 struct pci_dev
*pdev
= to_pci_dev(ap
->host
->dev
);
291 unsigned long long start
, len
;
293 if (pci_resource_flags(pdev
, bar
) & IORESOURCE_MEM
)
295 else if (pci_resource_flags(pdev
, bar
) & IORESOURCE_IO
)
298 start
= (unsigned long long)pci_resource_start(pdev
, bar
);
299 len
= (unsigned long long)pci_resource_len(pdev
, bar
);
302 ata_port_desc(ap
, "%s %s%llu@0x%llx", name
, type
, len
, start
);
304 ata_port_desc(ap
, "%s 0x%llx", name
,
305 start
+ (unsigned long long)offset
);
308 #endif /* CONFIG_PCI */
310 static int ata_lookup_timeout_table(u8 cmd
)
314 for (i
= 0; i
< ATA_EH_CMD_TIMEOUT_TABLE_SIZE
; i
++) {
317 for (cur
= ata_eh_cmd_timeout_table
[i
].commands
; *cur
; cur
++)
326 * ata_internal_cmd_timeout - determine timeout for an internal command
327 * @dev: target device
328 * @cmd: internal command to be issued
330 * Determine timeout for internal command @cmd for @dev.
336 * Determined timeout.
338 unsigned long ata_internal_cmd_timeout(struct ata_device
*dev
, u8 cmd
)
340 struct ata_eh_context
*ehc
= &dev
->link
->eh_context
;
341 int ent
= ata_lookup_timeout_table(cmd
);
345 return ATA_EH_CMD_DFL_TIMEOUT
;
347 idx
= ehc
->cmd_timeout_idx
[dev
->devno
][ent
];
348 return ata_eh_cmd_timeout_table
[ent
].timeouts
[idx
];
352 * ata_internal_cmd_timed_out - notification for internal command timeout
353 * @dev: target device
354 * @cmd: internal command which timed out
356 * Notify EH that internal command @cmd for @dev timed out. This
357 * function should be called only for commands whose timeouts are
358 * determined using ata_internal_cmd_timeout().
363 void ata_internal_cmd_timed_out(struct ata_device
*dev
, u8 cmd
)
365 struct ata_eh_context
*ehc
= &dev
->link
->eh_context
;
366 int ent
= ata_lookup_timeout_table(cmd
);
372 idx
= ehc
->cmd_timeout_idx
[dev
->devno
][ent
];
373 if (ata_eh_cmd_timeout_table
[ent
].timeouts
[idx
+ 1] != ULONG_MAX
)
374 ehc
->cmd_timeout_idx
[dev
->devno
][ent
]++;
377 static void ata_ering_record(struct ata_ering
*ering
, unsigned int eflags
,
378 unsigned int err_mask
)
380 struct ata_ering_entry
*ent
;
385 ering
->cursor
%= ATA_ERING_SIZE
;
387 ent
= &ering
->ring
[ering
->cursor
];
388 ent
->eflags
= eflags
;
389 ent
->err_mask
= err_mask
;
390 ent
->timestamp
= get_jiffies_64();
393 static struct ata_ering_entry
*ata_ering_top(struct ata_ering
*ering
)
395 struct ata_ering_entry
*ent
= &ering
->ring
[ering
->cursor
];
402 int ata_ering_map(struct ata_ering
*ering
,
403 int (*map_fn
)(struct ata_ering_entry
*, void *),
407 struct ata_ering_entry
*ent
;
411 ent
= &ering
->ring
[idx
];
414 rc
= map_fn(ent
, arg
);
417 idx
= (idx
- 1 + ATA_ERING_SIZE
) % ATA_ERING_SIZE
;
418 } while (idx
!= ering
->cursor
);
423 static int ata_ering_clear_cb(struct ata_ering_entry
*ent
, void *void_arg
)
425 ent
->eflags
|= ATA_EFLAG_OLD_ER
;
429 static void ata_ering_clear(struct ata_ering
*ering
)
431 ata_ering_map(ering
, ata_ering_clear_cb
, NULL
);
434 static unsigned int ata_eh_dev_action(struct ata_device
*dev
)
436 struct ata_eh_context
*ehc
= &dev
->link
->eh_context
;
438 return ehc
->i
.action
| ehc
->i
.dev_action
[dev
->devno
];
441 static void ata_eh_clear_action(struct ata_link
*link
, struct ata_device
*dev
,
442 struct ata_eh_info
*ehi
, unsigned int action
)
444 struct ata_device
*tdev
;
447 ehi
->action
&= ~action
;
448 ata_for_each_dev(tdev
, link
, ALL
)
449 ehi
->dev_action
[tdev
->devno
] &= ~action
;
451 /* doesn't make sense for port-wide EH actions */
452 WARN_ON(!(action
& ATA_EH_PERDEV_MASK
));
454 /* break ehi->action into ehi->dev_action */
455 if (ehi
->action
& action
) {
456 ata_for_each_dev(tdev
, link
, ALL
)
457 ehi
->dev_action
[tdev
->devno
] |=
458 ehi
->action
& action
;
459 ehi
->action
&= ~action
;
462 /* turn off the specified per-dev action */
463 ehi
->dev_action
[dev
->devno
] &= ~action
;
468 * ata_eh_acquire - acquire EH ownership
469 * @ap: ATA port to acquire EH ownership for
471 * Acquire EH ownership for @ap. This is the basic exclusion
472 * mechanism for ports sharing a host. Only one port hanging off
473 * the same host can claim the ownership of EH.
478 void ata_eh_acquire(struct ata_port
*ap
)
480 mutex_lock(&ap
->host
->eh_mutex
);
481 WARN_ON_ONCE(ap
->host
->eh_owner
);
482 ap
->host
->eh_owner
= current
;
486 * ata_eh_release - release EH ownership
487 * @ap: ATA port to release EH ownership for
489 * Release EH ownership for @ap if the caller. The caller must
490 * have acquired EH ownership using ata_eh_acquire() previously.
495 void ata_eh_release(struct ata_port
*ap
)
497 WARN_ON_ONCE(ap
->host
->eh_owner
!= current
);
498 ap
->host
->eh_owner
= NULL
;
499 mutex_unlock(&ap
->host
->eh_mutex
);
503 * ata_scsi_timed_out - SCSI layer time out callback
504 * @cmd: timed out SCSI command
506 * Handles SCSI layer timeout. We race with normal completion of
507 * the qc for @cmd. If the qc is already gone, we lose and let
508 * the scsi command finish (EH_HANDLED). Otherwise, the qc has
509 * timed out and EH should be invoked. Prevent ata_qc_complete()
510 * from finishing it by setting EH_SCHEDULED and return
513 * TODO: kill this function once old EH is gone.
516 * Called from timer context
519 * EH_HANDLED or EH_NOT_HANDLED
521 enum blk_eh_timer_return
ata_scsi_timed_out(struct scsi_cmnd
*cmd
)
523 struct Scsi_Host
*host
= cmd
->device
->host
;
524 struct ata_port
*ap
= ata_shost_to_port(host
);
526 struct ata_queued_cmd
*qc
;
527 enum blk_eh_timer_return ret
;
531 if (ap
->ops
->error_handler
) {
532 ret
= BLK_EH_NOT_HANDLED
;
536 ret
= BLK_EH_HANDLED
;
537 spin_lock_irqsave(ap
->lock
, flags
);
538 qc
= ata_qc_from_tag(ap
, ap
->link
.active_tag
);
540 WARN_ON(qc
->scsicmd
!= cmd
);
541 qc
->flags
|= ATA_QCFLAG_EH_SCHEDULED
;
542 qc
->err_mask
|= AC_ERR_TIMEOUT
;
543 ret
= BLK_EH_NOT_HANDLED
;
545 spin_unlock_irqrestore(ap
->lock
, flags
);
548 DPRINTK("EXIT, ret=%d\n", ret
);
552 static void ata_eh_unload(struct ata_port
*ap
)
554 struct ata_link
*link
;
555 struct ata_device
*dev
;
558 /* Restore SControl IPM and SPD for the next driver and
559 * disable attached devices.
561 ata_for_each_link(link
, ap
, PMP_FIRST
) {
562 sata_scr_write(link
, SCR_CONTROL
, link
->saved_scontrol
& 0xff0);
563 ata_for_each_dev(dev
, link
, ALL
)
564 ata_dev_disable(dev
);
567 /* freeze and set UNLOADED */
568 spin_lock_irqsave(ap
->lock
, flags
);
570 ata_port_freeze(ap
); /* won't be thawed */
571 ap
->pflags
&= ~ATA_PFLAG_EH_PENDING
; /* clear pending from freeze */
572 ap
->pflags
|= ATA_PFLAG_UNLOADED
;
574 spin_unlock_irqrestore(ap
->lock
, flags
);
578 * ata_scsi_error - SCSI layer error handler callback
579 * @host: SCSI host on which error occurred
581 * Handles SCSI-layer-thrown error events.
584 * Inherited from SCSI layer (none, can sleep)
589 void ata_scsi_error(struct Scsi_Host
*host
)
591 struct ata_port
*ap
= ata_shost_to_port(host
);
593 LIST_HEAD(eh_work_q
);
597 spin_lock_irqsave(host
->host_lock
, flags
);
598 list_splice_init(&host
->eh_cmd_q
, &eh_work_q
);
599 spin_unlock_irqrestore(host
->host_lock
, flags
);
601 ata_scsi_cmd_error_handler(host
, ap
, &eh_work_q
);
603 /* If we timed raced normal completion and there is nothing to
604 recover nr_timedout == 0 why exactly are we doing error recovery ? */
605 ata_scsi_port_error_handler(host
, ap
);
607 /* finish or retry handled scmd's and clean up */
608 WARN_ON(host
->host_failed
|| !list_empty(&eh_work_q
));
614 * ata_scsi_cmd_error_handler - error callback for a list of commands
615 * @host: scsi host containing the port
616 * @ap: ATA port within the host
617 * @eh_work_q: list of commands to process
619 * process the given list of commands and return those finished to the
620 * ap->eh_done_q. This function is the first part of the libata error
621 * handler which processes a given list of failed commands.
623 void ata_scsi_cmd_error_handler(struct Scsi_Host
*host
, struct ata_port
*ap
,
624 struct list_head
*eh_work_q
)
629 /* make sure sff pio task is not running */
630 ata_sff_flush_pio_task(ap
);
632 /* synchronize with host lock and sort out timeouts */
634 /* For new EH, all qcs are finished in one of three ways -
635 * normal completion, error completion, and SCSI timeout.
636 * Both completions can race against SCSI timeout. When normal
637 * completion wins, the qc never reaches EH. When error
638 * completion wins, the qc has ATA_QCFLAG_FAILED set.
640 * When SCSI timeout wins, things are a bit more complex.
641 * Normal or error completion can occur after the timeout but
642 * before this point. In such cases, both types of
643 * completions are honored. A scmd is determined to have
644 * timed out iff its associated qc is active and not failed.
646 if (ap
->ops
->error_handler
) {
647 struct scsi_cmnd
*scmd
, *tmp
;
650 spin_lock_irqsave(ap
->lock
, flags
);
652 /* This must occur under the ap->lock as we don't want
653 a polled recovery to race the real interrupt handler
655 The lost_interrupt handler checks for any completed but
656 non-notified command and completes much like an IRQ handler.
658 We then fall into the error recovery code which will treat
659 this as if normal completion won the race */
661 if (ap
->ops
->lost_interrupt
)
662 ap
->ops
->lost_interrupt(ap
);
664 list_for_each_entry_safe(scmd
, tmp
, eh_work_q
, eh_entry
) {
665 struct ata_queued_cmd
*qc
;
667 for (i
= 0; i
< ATA_MAX_QUEUE
; i
++) {
668 qc
= __ata_qc_from_tag(ap
, i
);
669 if (qc
->flags
& ATA_QCFLAG_ACTIVE
&&
674 if (i
< ATA_MAX_QUEUE
) {
675 /* the scmd has an associated qc */
676 if (!(qc
->flags
& ATA_QCFLAG_FAILED
)) {
677 /* which hasn't failed yet, timeout */
678 qc
->err_mask
|= AC_ERR_TIMEOUT
;
679 qc
->flags
|= ATA_QCFLAG_FAILED
;
683 /* Normal completion occurred after
684 * SCSI timeout but before this point.
685 * Successfully complete it.
687 scmd
->retries
= scmd
->allowed
;
688 scsi_eh_finish_cmd(scmd
, &ap
->eh_done_q
);
692 /* If we have timed out qcs. They belong to EH from
693 * this point but the state of the controller is
694 * unknown. Freeze the port to make sure the IRQ
695 * handler doesn't diddle with those qcs. This must
696 * be done atomically w.r.t. setting QCFLAG_FAILED.
699 __ata_port_freeze(ap
);
701 spin_unlock_irqrestore(ap
->lock
, flags
);
703 /* initialize eh_tries */
704 ap
->eh_tries
= ATA_EH_MAX_TRIES
;
706 spin_unlock_wait(ap
->lock
);
709 EXPORT_SYMBOL(ata_scsi_cmd_error_handler
);
712 * ata_scsi_port_error_handler - recover the port after the commands
713 * @host: SCSI host containing the port
716 * Handle the recovery of the port @ap after all the commands
717 * have been recovered.
719 void ata_scsi_port_error_handler(struct Scsi_Host
*host
, struct ata_port
*ap
)
723 /* invoke error handler */
724 if (ap
->ops
->error_handler
) {
725 struct ata_link
*link
;
727 /* acquire EH ownership */
730 /* kill fast drain timer */
731 del_timer_sync(&ap
->fastdrain_timer
);
733 /* process port resume request */
734 ata_eh_handle_port_resume(ap
);
736 /* fetch & clear EH info */
737 spin_lock_irqsave(ap
->lock
, flags
);
739 ata_for_each_link(link
, ap
, HOST_FIRST
) {
740 struct ata_eh_context
*ehc
= &link
->eh_context
;
741 struct ata_device
*dev
;
743 memset(&link
->eh_context
, 0, sizeof(link
->eh_context
));
744 link
->eh_context
.i
= link
->eh_info
;
745 memset(&link
->eh_info
, 0, sizeof(link
->eh_info
));
747 ata_for_each_dev(dev
, link
, ENABLED
) {
748 int devno
= dev
->devno
;
750 ehc
->saved_xfer_mode
[devno
] = dev
->xfer_mode
;
751 if (ata_ncq_enabled(dev
))
752 ehc
->saved_ncq_enabled
|= 1 << devno
;
756 ap
->pflags
|= ATA_PFLAG_EH_IN_PROGRESS
;
757 ap
->pflags
&= ~ATA_PFLAG_EH_PENDING
;
758 ap
->excl_link
= NULL
; /* don't maintain exclusion over EH */
760 spin_unlock_irqrestore(ap
->lock
, flags
);
762 /* invoke EH, skip if unloading or suspended */
763 if (!(ap
->pflags
& (ATA_PFLAG_UNLOADING
| ATA_PFLAG_SUSPENDED
)))
764 ap
->ops
->error_handler(ap
);
766 /* if unloading, commence suicide */
767 if ((ap
->pflags
& ATA_PFLAG_UNLOADING
) &&
768 !(ap
->pflags
& ATA_PFLAG_UNLOADED
))
773 /* process port suspend request */
774 ata_eh_handle_port_suspend(ap
);
776 /* Exception might have happened after ->error_handler
777 * recovered the port but before this point. Repeat
780 spin_lock_irqsave(ap
->lock
, flags
);
782 if (ap
->pflags
& ATA_PFLAG_EH_PENDING
) {
783 if (--ap
->eh_tries
) {
784 spin_unlock_irqrestore(ap
->lock
, flags
);
788 "EH pending after %d tries, giving up\n",
790 ap
->pflags
&= ~ATA_PFLAG_EH_PENDING
;
793 /* this run is complete, make sure EH info is clear */
794 ata_for_each_link(link
, ap
, HOST_FIRST
)
795 memset(&link
->eh_info
, 0, sizeof(link
->eh_info
));
797 /* end eh (clear host_eh_scheduled) while holding
798 * ap->lock such that if exception occurs after this
799 * point but before EH completion, SCSI midlayer will
804 spin_unlock_irqrestore(ap
->lock
, flags
);
807 WARN_ON(ata_qc_from_tag(ap
, ap
->link
.active_tag
) == NULL
);
808 ap
->ops
->eng_timeout(ap
);
811 scsi_eh_flush_done_q(&ap
->eh_done_q
);
814 spin_lock_irqsave(ap
->lock
, flags
);
816 if (ap
->pflags
& ATA_PFLAG_LOADING
)
817 ap
->pflags
&= ~ATA_PFLAG_LOADING
;
818 else if (ap
->pflags
& ATA_PFLAG_SCSI_HOTPLUG
)
819 schedule_delayed_work(&ap
->hotplug_task
, 0);
821 if (ap
->pflags
& ATA_PFLAG_RECOVERED
)
822 ata_port_info(ap
, "EH complete\n");
824 ap
->pflags
&= ~(ATA_PFLAG_SCSI_HOTPLUG
| ATA_PFLAG_RECOVERED
);
826 /* tell wait_eh that we're done */
827 ap
->pflags
&= ~ATA_PFLAG_EH_IN_PROGRESS
;
828 wake_up_all(&ap
->eh_wait_q
);
830 spin_unlock_irqrestore(ap
->lock
, flags
);
832 EXPORT_SYMBOL_GPL(ata_scsi_port_error_handler
);
835 * ata_port_wait_eh - Wait for the currently pending EH to complete
836 * @ap: Port to wait EH for
838 * Wait until the currently pending EH is complete.
841 * Kernel thread context (may sleep).
843 void ata_port_wait_eh(struct ata_port
*ap
)
849 spin_lock_irqsave(ap
->lock
, flags
);
851 while (ap
->pflags
& (ATA_PFLAG_EH_PENDING
| ATA_PFLAG_EH_IN_PROGRESS
)) {
852 prepare_to_wait(&ap
->eh_wait_q
, &wait
, TASK_UNINTERRUPTIBLE
);
853 spin_unlock_irqrestore(ap
->lock
, flags
);
855 spin_lock_irqsave(ap
->lock
, flags
);
857 finish_wait(&ap
->eh_wait_q
, &wait
);
859 spin_unlock_irqrestore(ap
->lock
, flags
);
861 /* make sure SCSI EH is complete */
862 if (scsi_host_in_recovery(ap
->scsi_host
)) {
867 EXPORT_SYMBOL_GPL(ata_port_wait_eh
);
869 static int ata_eh_nr_in_flight(struct ata_port
*ap
)
874 /* count only non-internal commands */
875 for (tag
= 0; tag
< ATA_MAX_QUEUE
- 1; tag
++)
876 if (ata_qc_from_tag(ap
, tag
))
882 void ata_eh_fastdrain_timerfn(unsigned long arg
)
884 struct ata_port
*ap
= (void *)arg
;
888 spin_lock_irqsave(ap
->lock
, flags
);
890 cnt
= ata_eh_nr_in_flight(ap
);
896 if (cnt
== ap
->fastdrain_cnt
) {
899 /* No progress during the last interval, tag all
900 * in-flight qcs as timed out and freeze the port.
902 for (tag
= 0; tag
< ATA_MAX_QUEUE
- 1; tag
++) {
903 struct ata_queued_cmd
*qc
= ata_qc_from_tag(ap
, tag
);
905 qc
->err_mask
|= AC_ERR_TIMEOUT
;
910 /* some qcs have finished, give it another chance */
911 ap
->fastdrain_cnt
= cnt
;
912 ap
->fastdrain_timer
.expires
=
913 ata_deadline(jiffies
, ATA_EH_FASTDRAIN_INTERVAL
);
914 add_timer(&ap
->fastdrain_timer
);
918 spin_unlock_irqrestore(ap
->lock
, flags
);
922 * ata_eh_set_pending - set ATA_PFLAG_EH_PENDING and activate fast drain
923 * @ap: target ATA port
924 * @fastdrain: activate fast drain
926 * Set ATA_PFLAG_EH_PENDING and activate fast drain if @fastdrain
927 * is non-zero and EH wasn't pending before. Fast drain ensures
928 * that EH kicks in in timely manner.
931 * spin_lock_irqsave(host lock)
933 static void ata_eh_set_pending(struct ata_port
*ap
, int fastdrain
)
937 /* already scheduled? */
938 if (ap
->pflags
& ATA_PFLAG_EH_PENDING
)
941 ap
->pflags
|= ATA_PFLAG_EH_PENDING
;
946 /* do we have in-flight qcs? */
947 cnt
= ata_eh_nr_in_flight(ap
);
951 /* activate fast drain */
952 ap
->fastdrain_cnt
= cnt
;
953 ap
->fastdrain_timer
.expires
=
954 ata_deadline(jiffies
, ATA_EH_FASTDRAIN_INTERVAL
);
955 add_timer(&ap
->fastdrain_timer
);
959 * ata_qc_schedule_eh - schedule qc for error handling
960 * @qc: command to schedule error handling for
962 * Schedule error handling for @qc. EH will kick in as soon as
963 * other commands are drained.
966 * spin_lock_irqsave(host lock)
968 void ata_qc_schedule_eh(struct ata_queued_cmd
*qc
)
970 struct ata_port
*ap
= qc
->ap
;
971 struct request_queue
*q
= qc
->scsicmd
->device
->request_queue
;
974 WARN_ON(!ap
->ops
->error_handler
);
976 qc
->flags
|= ATA_QCFLAG_FAILED
;
977 ata_eh_set_pending(ap
, 1);
979 /* The following will fail if timeout has already expired.
980 * ata_scsi_error() takes care of such scmds on EH entry.
981 * Note that ATA_QCFLAG_FAILED is unconditionally set after
982 * this function completes.
984 spin_lock_irqsave(q
->queue_lock
, flags
);
985 blk_abort_request(qc
->scsicmd
->request
);
986 spin_unlock_irqrestore(q
->queue_lock
, flags
);
990 * ata_std_sched_eh - non-libsas ata_ports issue eh with this common routine
991 * @ap: ATA port to schedule EH for
993 * LOCKING: inherited from ata_port_schedule_eh
994 * spin_lock_irqsave(host lock)
996 void ata_std_sched_eh(struct ata_port
*ap
)
998 WARN_ON(!ap
->ops
->error_handler
);
1000 if (ap
->pflags
& ATA_PFLAG_INITIALIZING
)
1003 ata_eh_set_pending(ap
, 1);
1004 scsi_schedule_eh(ap
->scsi_host
);
1006 DPRINTK("port EH scheduled\n");
1008 EXPORT_SYMBOL_GPL(ata_std_sched_eh
);
1011 * ata_std_end_eh - non-libsas ata_ports complete eh with this common routine
1012 * @ap: ATA port to end EH for
1014 * In the libata object model there is a 1:1 mapping of ata_port to
1015 * shost, so host fields can be directly manipulated under ap->lock, in
1016 * the libsas case we need to hold a lock at the ha->level to coordinate
1020 * spin_lock_irqsave(host lock)
1022 void ata_std_end_eh(struct ata_port
*ap
)
1024 struct Scsi_Host
*host
= ap
->scsi_host
;
1026 host
->host_eh_scheduled
= 0;
1028 EXPORT_SYMBOL(ata_std_end_eh
);
1032 * ata_port_schedule_eh - schedule error handling without a qc
1033 * @ap: ATA port to schedule EH for
1035 * Schedule error handling for @ap. EH will kick in as soon as
1036 * all commands are drained.
1039 * spin_lock_irqsave(host lock)
1041 void ata_port_schedule_eh(struct ata_port
*ap
)
1043 /* see: ata_std_sched_eh, unless you know better */
1044 ap
->ops
->sched_eh(ap
);
1047 static int ata_do_link_abort(struct ata_port
*ap
, struct ata_link
*link
)
1049 int tag
, nr_aborted
= 0;
1051 WARN_ON(!ap
->ops
->error_handler
);
1053 /* we're gonna abort all commands, no need for fast drain */
1054 ata_eh_set_pending(ap
, 0);
1056 for (tag
= 0; tag
< ATA_MAX_QUEUE
; tag
++) {
1057 struct ata_queued_cmd
*qc
= ata_qc_from_tag(ap
, tag
);
1059 if (qc
&& (!link
|| qc
->dev
->link
== link
)) {
1060 qc
->flags
|= ATA_QCFLAG_FAILED
;
1061 ata_qc_complete(qc
);
1067 ata_port_schedule_eh(ap
);
1073 * ata_link_abort - abort all qc's on the link
1074 * @link: ATA link to abort qc's for
1076 * Abort all active qc's active on @link and schedule EH.
1079 * spin_lock_irqsave(host lock)
1082 * Number of aborted qc's.
1084 int ata_link_abort(struct ata_link
*link
)
1086 return ata_do_link_abort(link
->ap
, link
);
1090 * ata_port_abort - abort all qc's on the port
1091 * @ap: ATA port to abort qc's for
1093 * Abort all active qc's of @ap and schedule EH.
1096 * spin_lock_irqsave(host_set lock)
1099 * Number of aborted qc's.
1101 int ata_port_abort(struct ata_port
*ap
)
1103 return ata_do_link_abort(ap
, NULL
);
1107 * __ata_port_freeze - freeze port
1108 * @ap: ATA port to freeze
1110 * This function is called when HSM violation or some other
1111 * condition disrupts normal operation of the port. Frozen port
1112 * is not allowed to perform any operation until the port is
1113 * thawed, which usually follows a successful reset.
1115 * ap->ops->freeze() callback can be used for freezing the port
1116 * hardware-wise (e.g. mask interrupt and stop DMA engine). If a
1117 * port cannot be frozen hardware-wise, the interrupt handler
1118 * must ack and clear interrupts unconditionally while the port
1122 * spin_lock_irqsave(host lock)
1124 static void __ata_port_freeze(struct ata_port
*ap
)
1126 WARN_ON(!ap
->ops
->error_handler
);
1128 if (ap
->ops
->freeze
)
1129 ap
->ops
->freeze(ap
);
1131 ap
->pflags
|= ATA_PFLAG_FROZEN
;
1133 DPRINTK("ata%u port frozen\n", ap
->print_id
);
1137 * ata_port_freeze - abort & freeze port
1138 * @ap: ATA port to freeze
1140 * Abort and freeze @ap. The freeze operation must be called
1141 * first, because some hardware requires special operations
1142 * before the taskfile registers are accessible.
1145 * spin_lock_irqsave(host lock)
1148 * Number of aborted commands.
1150 int ata_port_freeze(struct ata_port
*ap
)
1154 WARN_ON(!ap
->ops
->error_handler
);
1156 __ata_port_freeze(ap
);
1157 nr_aborted
= ata_port_abort(ap
);
1163 * sata_async_notification - SATA async notification handler
1164 * @ap: ATA port where async notification is received
1166 * Handler to be called when async notification via SDB FIS is
1167 * received. This function schedules EH if necessary.
1170 * spin_lock_irqsave(host lock)
1173 * 1 if EH is scheduled, 0 otherwise.
1175 int sata_async_notification(struct ata_port
*ap
)
1180 if (!(ap
->flags
& ATA_FLAG_AN
))
1183 rc
= sata_scr_read(&ap
->link
, SCR_NOTIFICATION
, &sntf
);
1185 sata_scr_write(&ap
->link
, SCR_NOTIFICATION
, sntf
);
1187 if (!sata_pmp_attached(ap
) || rc
) {
1188 /* PMP is not attached or SNTF is not available */
1189 if (!sata_pmp_attached(ap
)) {
1190 /* PMP is not attached. Check whether ATAPI
1191 * AN is configured. If so, notify media
1194 struct ata_device
*dev
= ap
->link
.device
;
1196 if ((dev
->class == ATA_DEV_ATAPI
) &&
1197 (dev
->flags
& ATA_DFLAG_AN
))
1198 ata_scsi_media_change_notify(dev
);
1201 /* PMP is attached but SNTF is not available.
1202 * ATAPI async media change notification is
1203 * not used. The PMP must be reporting PHY
1204 * status change, schedule EH.
1206 ata_port_schedule_eh(ap
);
1210 /* PMP is attached and SNTF is available */
1211 struct ata_link
*link
;
1213 /* check and notify ATAPI AN */
1214 ata_for_each_link(link
, ap
, EDGE
) {
1215 if (!(sntf
& (1 << link
->pmp
)))
1218 if ((link
->device
->class == ATA_DEV_ATAPI
) &&
1219 (link
->device
->flags
& ATA_DFLAG_AN
))
1220 ata_scsi_media_change_notify(link
->device
);
1223 /* If PMP is reporting that PHY status of some
1224 * downstream ports has changed, schedule EH.
1226 if (sntf
& (1 << SATA_PMP_CTRL_PORT
)) {
1227 ata_port_schedule_eh(ap
);
1236 * ata_eh_freeze_port - EH helper to freeze port
1237 * @ap: ATA port to freeze
1244 void ata_eh_freeze_port(struct ata_port
*ap
)
1246 unsigned long flags
;
1248 if (!ap
->ops
->error_handler
)
1251 spin_lock_irqsave(ap
->lock
, flags
);
1252 __ata_port_freeze(ap
);
1253 spin_unlock_irqrestore(ap
->lock
, flags
);
1257 * ata_port_thaw_port - EH helper to thaw port
1258 * @ap: ATA port to thaw
1260 * Thaw frozen port @ap.
1265 void ata_eh_thaw_port(struct ata_port
*ap
)
1267 unsigned long flags
;
1269 if (!ap
->ops
->error_handler
)
1272 spin_lock_irqsave(ap
->lock
, flags
);
1274 ap
->pflags
&= ~ATA_PFLAG_FROZEN
;
1279 spin_unlock_irqrestore(ap
->lock
, flags
);
1281 DPRINTK("ata%u port thawed\n", ap
->print_id
);
1284 static void ata_eh_scsidone(struct scsi_cmnd
*scmd
)
1289 static void __ata_eh_qc_complete(struct ata_queued_cmd
*qc
)
1291 struct ata_port
*ap
= qc
->ap
;
1292 struct scsi_cmnd
*scmd
= qc
->scsicmd
;
1293 unsigned long flags
;
1295 spin_lock_irqsave(ap
->lock
, flags
);
1296 qc
->scsidone
= ata_eh_scsidone
;
1297 __ata_qc_complete(qc
);
1298 WARN_ON(ata_tag_valid(qc
->tag
));
1299 spin_unlock_irqrestore(ap
->lock
, flags
);
1301 scsi_eh_finish_cmd(scmd
, &ap
->eh_done_q
);
1305 * ata_eh_qc_complete - Complete an active ATA command from EH
1306 * @qc: Command to complete
1308 * Indicate to the mid and upper layers that an ATA command has
1309 * completed. To be used from EH.
1311 void ata_eh_qc_complete(struct ata_queued_cmd
*qc
)
1313 struct scsi_cmnd
*scmd
= qc
->scsicmd
;
1314 scmd
->retries
= scmd
->allowed
;
1315 __ata_eh_qc_complete(qc
);
1319 * ata_eh_qc_retry - Tell midlayer to retry an ATA command after EH
1320 * @qc: Command to retry
1322 * Indicate to the mid and upper layers that an ATA command
1323 * should be retried. To be used from EH.
1325 * SCSI midlayer limits the number of retries to scmd->allowed.
1326 * scmd->allowed is incremented for commands which get retried
1327 * due to unrelated failures (qc->err_mask is zero).
1329 void ata_eh_qc_retry(struct ata_queued_cmd
*qc
)
1331 struct scsi_cmnd
*scmd
= qc
->scsicmd
;
1334 __ata_eh_qc_complete(qc
);
1338 * ata_dev_disable - disable ATA device
1339 * @dev: ATA device to disable
1346 void ata_dev_disable(struct ata_device
*dev
)
1348 if (!ata_dev_enabled(dev
))
1351 if (ata_msg_drv(dev
->link
->ap
))
1352 ata_dev_warn(dev
, "disabled\n");
1353 ata_acpi_on_disable(dev
);
1354 ata_down_xfermask_limit(dev
, ATA_DNXFER_FORCE_PIO0
| ATA_DNXFER_QUIET
);
1357 /* From now till the next successful probe, ering is used to
1358 * track probe failures. Clear accumulated device error info.
1360 ata_ering_clear(&dev
->ering
);
1364 * ata_eh_detach_dev - detach ATA device
1365 * @dev: ATA device to detach
1372 void ata_eh_detach_dev(struct ata_device
*dev
)
1374 struct ata_link
*link
= dev
->link
;
1375 struct ata_port
*ap
= link
->ap
;
1376 struct ata_eh_context
*ehc
= &link
->eh_context
;
1377 unsigned long flags
;
1379 ata_dev_disable(dev
);
1381 spin_lock_irqsave(ap
->lock
, flags
);
1383 dev
->flags
&= ~ATA_DFLAG_DETACH
;
1385 if (ata_scsi_offline_dev(dev
)) {
1386 dev
->flags
|= ATA_DFLAG_DETACHED
;
1387 ap
->pflags
|= ATA_PFLAG_SCSI_HOTPLUG
;
1390 /* clear per-dev EH info */
1391 ata_eh_clear_action(link
, dev
, &link
->eh_info
, ATA_EH_PERDEV_MASK
);
1392 ata_eh_clear_action(link
, dev
, &link
->eh_context
.i
, ATA_EH_PERDEV_MASK
);
1393 ehc
->saved_xfer_mode
[dev
->devno
] = 0;
1394 ehc
->saved_ncq_enabled
&= ~(1 << dev
->devno
);
1396 spin_unlock_irqrestore(ap
->lock
, flags
);
1400 * ata_eh_about_to_do - about to perform eh_action
1401 * @link: target ATA link
1402 * @dev: target ATA dev for per-dev action (can be NULL)
1403 * @action: action about to be performed
1405 * Called just before performing EH actions to clear related bits
1406 * in @link->eh_info such that eh actions are not unnecessarily
1412 void ata_eh_about_to_do(struct ata_link
*link
, struct ata_device
*dev
,
1413 unsigned int action
)
1415 struct ata_port
*ap
= link
->ap
;
1416 struct ata_eh_info
*ehi
= &link
->eh_info
;
1417 struct ata_eh_context
*ehc
= &link
->eh_context
;
1418 unsigned long flags
;
1420 spin_lock_irqsave(ap
->lock
, flags
);
1422 ata_eh_clear_action(link
, dev
, ehi
, action
);
1424 /* About to take EH action, set RECOVERED. Ignore actions on
1425 * slave links as master will do them again.
1427 if (!(ehc
->i
.flags
& ATA_EHI_QUIET
) && link
!= ap
->slave_link
)
1428 ap
->pflags
|= ATA_PFLAG_RECOVERED
;
1430 spin_unlock_irqrestore(ap
->lock
, flags
);
1434 * ata_eh_done - EH action complete
1435 * @ap: target ATA port
1436 * @dev: target ATA dev for per-dev action (can be NULL)
1437 * @action: action just completed
1439 * Called right after performing EH actions to clear related bits
1440 * in @link->eh_context.
1445 void ata_eh_done(struct ata_link
*link
, struct ata_device
*dev
,
1446 unsigned int action
)
1448 struct ata_eh_context
*ehc
= &link
->eh_context
;
1450 ata_eh_clear_action(link
, dev
, &ehc
->i
, action
);
1454 * ata_err_string - convert err_mask to descriptive string
1455 * @err_mask: error mask to convert to string
1457 * Convert @err_mask to descriptive string. Errors are
1458 * prioritized according to severity and only the most severe
1459 * error is reported.
1465 * Descriptive string for @err_mask
1467 static const char *ata_err_string(unsigned int err_mask
)
1469 if (err_mask
& AC_ERR_HOST_BUS
)
1470 return "host bus error";
1471 if (err_mask
& AC_ERR_ATA_BUS
)
1472 return "ATA bus error";
1473 if (err_mask
& AC_ERR_TIMEOUT
)
1475 if (err_mask
& AC_ERR_HSM
)
1476 return "HSM violation";
1477 if (err_mask
& AC_ERR_SYSTEM
)
1478 return "internal error";
1479 if (err_mask
& AC_ERR_MEDIA
)
1480 return "media error";
1481 if (err_mask
& AC_ERR_INVALID
)
1482 return "invalid argument";
1483 if (err_mask
& AC_ERR_DEV
)
1484 return "device error";
1485 return "unknown error";
1489 * ata_read_log_page - read a specific log page
1490 * @dev: target device
1492 * @page: page to read
1493 * @buf: buffer to store read page
1494 * @sectors: number of sectors to read
1496 * Read log page using READ_LOG_EXT command.
1499 * Kernel thread context (may sleep).
1502 * 0 on success, AC_ERR_* mask otherwise.
1504 unsigned int ata_read_log_page(struct ata_device
*dev
, u8 log
,
1505 u8 page
, void *buf
, unsigned int sectors
)
1507 struct ata_taskfile tf
;
1508 unsigned int err_mask
;
1510 DPRINTK("read log page - log 0x%x, page 0x%x\n", log
, page
);
1512 ata_tf_init(dev
, &tf
);
1513 if (dev
->dma_mode
&& ata_id_has_read_log_dma_ext(dev
->id
)) {
1514 tf
.command
= ATA_CMD_READ_LOG_DMA_EXT
;
1515 tf
.protocol
= ATA_PROT_DMA
;
1517 tf
.command
= ATA_CMD_READ_LOG_EXT
;
1518 tf
.protocol
= ATA_PROT_PIO
;
1523 tf
.hob_nsect
= sectors
>> 8;
1524 tf
.flags
|= ATA_TFLAG_ISADDR
| ATA_TFLAG_LBA48
| ATA_TFLAG_DEVICE
;
1526 err_mask
= ata_exec_internal(dev
, &tf
, NULL
, DMA_FROM_DEVICE
,
1527 buf
, sectors
* ATA_SECT_SIZE
, 0);
1529 DPRINTK("EXIT, err_mask=%x\n", err_mask
);
1534 * ata_eh_read_log_10h - Read log page 10h for NCQ error details
1535 * @dev: Device to read log page 10h from
1536 * @tag: Resulting tag of the failed command
1537 * @tf: Resulting taskfile registers of the failed command
1539 * Read log page 10h to obtain NCQ error details and clear error
1543 * Kernel thread context (may sleep).
1546 * 0 on success, -errno otherwise.
1548 static int ata_eh_read_log_10h(struct ata_device
*dev
,
1549 int *tag
, struct ata_taskfile
*tf
)
1551 u8
*buf
= dev
->link
->ap
->sector_buf
;
1552 unsigned int err_mask
;
1556 err_mask
= ata_read_log_page(dev
, ATA_LOG_SATA_NCQ
, 0, buf
, 1);
1561 for (i
= 0; i
< ATA_SECT_SIZE
; i
++)
1564 ata_dev_warn(dev
, "invalid checksum 0x%x on log page 10h\n",
1570 *tag
= buf
[0] & 0x1f;
1572 tf
->command
= buf
[2];
1573 tf
->feature
= buf
[3];
1577 tf
->device
= buf
[7];
1578 tf
->hob_lbal
= buf
[8];
1579 tf
->hob_lbam
= buf
[9];
1580 tf
->hob_lbah
= buf
[10];
1581 tf
->nsect
= buf
[12];
1582 tf
->hob_nsect
= buf
[13];
1583 if (ata_id_has_ncq_autosense(dev
->id
))
1584 tf
->auxiliary
= buf
[14] << 16 | buf
[15] << 8 | buf
[16];
1590 * atapi_eh_tur - perform ATAPI TEST_UNIT_READY
1591 * @dev: target ATAPI device
1592 * @r_sense_key: out parameter for sense_key
1594 * Perform ATAPI TEST_UNIT_READY.
1597 * EH context (may sleep).
1600 * 0 on success, AC_ERR_* mask on failure.
1602 unsigned int atapi_eh_tur(struct ata_device
*dev
, u8
*r_sense_key
)
1604 u8 cdb
[ATAPI_CDB_LEN
] = { TEST_UNIT_READY
, 0, 0, 0, 0, 0 };
1605 struct ata_taskfile tf
;
1606 unsigned int err_mask
;
1608 ata_tf_init(dev
, &tf
);
1610 tf
.flags
|= ATA_TFLAG_ISADDR
| ATA_TFLAG_DEVICE
;
1611 tf
.command
= ATA_CMD_PACKET
;
1612 tf
.protocol
= ATAPI_PROT_NODATA
;
1614 err_mask
= ata_exec_internal(dev
, &tf
, cdb
, DMA_NONE
, NULL
, 0, 0);
1615 if (err_mask
== AC_ERR_DEV
)
1616 *r_sense_key
= tf
.feature
>> 4;
1621 * ata_eh_request_sense - perform REQUEST_SENSE_DATA_EXT
1622 * @dev: device to perform REQUEST_SENSE_SENSE_DATA_EXT to
1623 * @sense_buf: result sense data buffer (SCSI_SENSE_BUFFERSIZE bytes long)
1624 * @dfl_sense_key: default sense key to use
1626 * Perform REQUEST_SENSE_DATA_EXT after the device reported CHECK
1627 * SENSE. This function is EH helper.
1630 * Kernel thread context (may sleep).
1633 * encoded sense data on success, 0 on failure or if sense data
1636 static u32
ata_eh_request_sense(struct ata_queued_cmd
*qc
,
1637 struct scsi_cmnd
*cmd
)
1639 struct ata_device
*dev
= qc
->dev
;
1640 struct ata_taskfile tf
;
1641 unsigned int err_mask
;
1646 DPRINTK("ATA request sense\n");
1647 ata_dev_warn(dev
, "request sense\n");
1648 if (!ata_id_sense_reporting_enabled(dev
->id
)) {
1649 ata_dev_warn(qc
->dev
, "sense data reporting disabled\n");
1652 ata_tf_init(dev
, &tf
);
1654 tf
.flags
|= ATA_TFLAG_ISADDR
| ATA_TFLAG_DEVICE
;
1655 tf
.flags
|= ATA_TFLAG_LBA
| ATA_TFLAG_LBA48
;
1656 tf
.command
= ATA_CMD_REQ_SENSE_DATA
;
1657 tf
.protocol
= ATA_PROT_NODATA
;
1659 err_mask
= ata_exec_internal(dev
, &tf
, NULL
, DMA_NONE
, NULL
, 0, 0);
1662 * The device may set the SENSE DATA AVAILABLE bit to one in the
1663 * STATUS field and clear the ERROR bit to zero in the STATUS field
1664 * to indicate that the command returned completion without an error
1665 * and the sense data described in table 306 is available.
1667 * IOW the 'ATA_SENSE' bit might not be set even though valid
1668 * sense data is available.
1669 * So check for both.
1671 if ((tf
.command
& ATA_SENSE
) ||
1672 tf
.lbah
!= 0 || tf
.lbam
!= 0 || tf
.lbal
!= 0) {
1673 ata_scsi_set_sense(cmd
, tf
.lbah
, tf
.lbam
, tf
.lbal
);
1674 qc
->flags
|= ATA_QCFLAG_SENSE_VALID
;
1675 ata_dev_warn(dev
, "sense data %02x/%02x/%02x\n",
1676 tf
.lbah
, tf
.lbam
, tf
.lbal
);
1678 ata_dev_warn(dev
, "request sense failed stat %02x emask %x\n",
1679 tf
.command
, err_mask
);
1685 * atapi_eh_request_sense - perform ATAPI REQUEST_SENSE
1686 * @dev: device to perform REQUEST_SENSE to
1687 * @sense_buf: result sense data buffer (SCSI_SENSE_BUFFERSIZE bytes long)
1688 * @dfl_sense_key: default sense key to use
1690 * Perform ATAPI REQUEST_SENSE after the device reported CHECK
1691 * SENSE. This function is EH helper.
1694 * Kernel thread context (may sleep).
1697 * 0 on success, AC_ERR_* mask on failure
1699 unsigned int atapi_eh_request_sense(struct ata_device
*dev
,
1700 u8
*sense_buf
, u8 dfl_sense_key
)
1702 u8 cdb
[ATAPI_CDB_LEN
] =
1703 { REQUEST_SENSE
, 0, 0, 0, SCSI_SENSE_BUFFERSIZE
, 0 };
1704 struct ata_port
*ap
= dev
->link
->ap
;
1705 struct ata_taskfile tf
;
1707 DPRINTK("ATAPI request sense\n");
1709 memset(sense_buf
, 0, SCSI_SENSE_BUFFERSIZE
);
1711 /* initialize sense_buf with the error register,
1712 * for the case where they are -not- overwritten
1714 sense_buf
[0] = 0x70;
1715 sense_buf
[2] = dfl_sense_key
;
1717 /* some devices time out if garbage left in tf */
1718 ata_tf_init(dev
, &tf
);
1720 tf
.flags
|= ATA_TFLAG_ISADDR
| ATA_TFLAG_DEVICE
;
1721 tf
.command
= ATA_CMD_PACKET
;
1723 /* is it pointless to prefer PIO for "safety reasons"? */
1724 if (ap
->flags
& ATA_FLAG_PIO_DMA
) {
1725 tf
.protocol
= ATAPI_PROT_DMA
;
1726 tf
.feature
|= ATAPI_PKT_DMA
;
1728 tf
.protocol
= ATAPI_PROT_PIO
;
1729 tf
.lbam
= SCSI_SENSE_BUFFERSIZE
;
1733 return ata_exec_internal(dev
, &tf
, cdb
, DMA_FROM_DEVICE
,
1734 sense_buf
, SCSI_SENSE_BUFFERSIZE
, 0);
1738 * ata_eh_analyze_serror - analyze SError for a failed port
1739 * @link: ATA link to analyze SError for
1741 * Analyze SError if available and further determine cause of
1747 static void ata_eh_analyze_serror(struct ata_link
*link
)
1749 struct ata_eh_context
*ehc
= &link
->eh_context
;
1750 u32 serror
= ehc
->i
.serror
;
1751 unsigned int err_mask
= 0, action
= 0;
1754 if (serror
& (SERR_PERSISTENT
| SERR_DATA
)) {
1755 err_mask
|= AC_ERR_ATA_BUS
;
1756 action
|= ATA_EH_RESET
;
1758 if (serror
& SERR_PROTOCOL
) {
1759 err_mask
|= AC_ERR_HSM
;
1760 action
|= ATA_EH_RESET
;
1762 if (serror
& SERR_INTERNAL
) {
1763 err_mask
|= AC_ERR_SYSTEM
;
1764 action
|= ATA_EH_RESET
;
1767 /* Determine whether a hotplug event has occurred. Both
1768 * SError.N/X are considered hotplug events for enabled or
1769 * host links. For disabled PMP links, only N bit is
1770 * considered as X bit is left at 1 for link plugging.
1772 if (link
->lpm_policy
> ATA_LPM_MAX_POWER
)
1773 hotplug_mask
= 0; /* hotplug doesn't work w/ LPM */
1774 else if (!(link
->flags
& ATA_LFLAG_DISABLED
) || ata_is_host_link(link
))
1775 hotplug_mask
= SERR_PHYRDY_CHG
| SERR_DEV_XCHG
;
1777 hotplug_mask
= SERR_PHYRDY_CHG
;
1779 if (serror
& hotplug_mask
)
1780 ata_ehi_hotplugged(&ehc
->i
);
1782 ehc
->i
.err_mask
|= err_mask
;
1783 ehc
->i
.action
|= action
;
1787 * ata_eh_analyze_ncq_error - analyze NCQ error
1788 * @link: ATA link to analyze NCQ error for
1790 * Read log page 10h, determine the offending qc and acquire
1791 * error status TF. For NCQ device errors, all LLDDs have to do
1792 * is setting AC_ERR_DEV in ehi->err_mask. This function takes
1796 * Kernel thread context (may sleep).
1798 void ata_eh_analyze_ncq_error(struct ata_link
*link
)
1800 struct ata_port
*ap
= link
->ap
;
1801 struct ata_eh_context
*ehc
= &link
->eh_context
;
1802 struct ata_device
*dev
= link
->device
;
1803 struct ata_queued_cmd
*qc
;
1804 struct ata_taskfile tf
;
1807 /* if frozen, we can't do much */
1808 if (ap
->pflags
& ATA_PFLAG_FROZEN
)
1811 /* is it NCQ device error? */
1812 if (!link
->sactive
|| !(ehc
->i
.err_mask
& AC_ERR_DEV
))
1815 /* has LLDD analyzed already? */
1816 for (tag
= 0; tag
< ATA_MAX_QUEUE
; tag
++) {
1817 qc
= __ata_qc_from_tag(ap
, tag
);
1819 if (!(qc
->flags
& ATA_QCFLAG_FAILED
))
1826 /* okay, this error is ours */
1827 memset(&tf
, 0, sizeof(tf
));
1828 rc
= ata_eh_read_log_10h(dev
, &tag
, &tf
);
1830 ata_link_err(link
, "failed to read log page 10h (errno=%d)\n",
1835 if (!(link
->sactive
& (1 << tag
))) {
1836 ata_link_err(link
, "log page 10h reported inactive tag %d\n",
1841 /* we've got the perpetrator, condemn it */
1842 qc
= __ata_qc_from_tag(ap
, tag
);
1843 memcpy(&qc
->result_tf
, &tf
, sizeof(tf
));
1844 qc
->result_tf
.flags
= ATA_TFLAG_ISADDR
| ATA_TFLAG_LBA
| ATA_TFLAG_LBA48
;
1845 qc
->err_mask
|= AC_ERR_DEV
| AC_ERR_NCQ
;
1846 if (qc
->result_tf
.auxiliary
) {
1847 char sense_key
, asc
, ascq
;
1849 sense_key
= (qc
->result_tf
.auxiliary
>> 16) & 0xff;
1850 asc
= (qc
->result_tf
.auxiliary
>> 8) & 0xff;
1851 ascq
= qc
->result_tf
.auxiliary
& 0xff;
1852 ata_dev_dbg(dev
, "NCQ Autosense %02x/%02x/%02x\n",
1853 sense_key
, asc
, ascq
);
1854 ata_scsi_set_sense(qc
->scsicmd
, sense_key
, asc
, ascq
);
1855 qc
->flags
|= ATA_QCFLAG_SENSE_VALID
;
1858 ehc
->i
.err_mask
&= ~AC_ERR_DEV
;
1862 * ata_eh_analyze_tf - analyze taskfile of a failed qc
1863 * @qc: qc to analyze
1864 * @tf: Taskfile registers to analyze
1866 * Analyze taskfile of @qc and further determine cause of
1867 * failure. This function also requests ATAPI sense data if
1871 * Kernel thread context (may sleep).
1874 * Determined recovery action
1876 static unsigned int ata_eh_analyze_tf(struct ata_queued_cmd
*qc
,
1877 const struct ata_taskfile
*tf
)
1879 unsigned int tmp
, action
= 0;
1880 u8 stat
= tf
->command
, err
= tf
->feature
;
1882 if ((stat
& (ATA_BUSY
| ATA_DRQ
| ATA_DRDY
)) != ATA_DRDY
) {
1883 qc
->err_mask
|= AC_ERR_HSM
;
1884 return ATA_EH_RESET
;
1888 * Sense data reporting does not work if the
1889 * device fault bit is set.
1891 if ((stat
& ATA_SENSE
) && !(stat
& ATA_DF
) &&
1892 !(qc
->flags
& ATA_QCFLAG_SENSE_VALID
)) {
1893 if (!(qc
->ap
->pflags
& ATA_PFLAG_FROZEN
)) {
1894 tmp
= ata_eh_request_sense(qc
, qc
->scsicmd
);
1896 qc
->err_mask
|= tmp
;
1898 ata_dev_warn(qc
->dev
, "sense data available but port frozen\n");
1902 /* Set by NCQ autosense or request sense above */
1903 if (qc
->flags
& ATA_QCFLAG_SENSE_VALID
)
1906 if (stat
& (ATA_ERR
| ATA_DF
))
1907 qc
->err_mask
|= AC_ERR_DEV
;
1911 switch (qc
->dev
->class) {
1915 qc
->err_mask
|= AC_ERR_ATA_BUS
;
1916 if (err
& (ATA_UNC
| ATA_AMNF
))
1917 qc
->err_mask
|= AC_ERR_MEDIA
;
1919 qc
->err_mask
|= AC_ERR_INVALID
;
1923 if (!(qc
->ap
->pflags
& ATA_PFLAG_FROZEN
)) {
1924 tmp
= atapi_eh_request_sense(qc
->dev
,
1925 qc
->scsicmd
->sense_buffer
,
1926 qc
->result_tf
.feature
>> 4);
1928 /* ATA_QCFLAG_SENSE_VALID is used to
1929 * tell atapi_qc_complete() that sense
1930 * data is already valid.
1932 * TODO: interpret sense data and set
1933 * appropriate err_mask.
1935 qc
->flags
|= ATA_QCFLAG_SENSE_VALID
;
1937 qc
->err_mask
|= tmp
;
1941 if (qc
->err_mask
& (AC_ERR_HSM
| AC_ERR_TIMEOUT
| AC_ERR_ATA_BUS
))
1942 action
|= ATA_EH_RESET
;
1947 static int ata_eh_categorize_error(unsigned int eflags
, unsigned int err_mask
,
1952 if (!(eflags
& ATA_EFLAG_DUBIOUS_XFER
))
1956 base
= ATA_ECAT_DUBIOUS_NONE
;
1958 if (err_mask
& AC_ERR_ATA_BUS
)
1959 return base
+ ATA_ECAT_ATA_BUS
;
1961 if (err_mask
& AC_ERR_TIMEOUT
)
1962 return base
+ ATA_ECAT_TOUT_HSM
;
1964 if (eflags
& ATA_EFLAG_IS_IO
) {
1965 if (err_mask
& AC_ERR_HSM
)
1966 return base
+ ATA_ECAT_TOUT_HSM
;
1968 (AC_ERR_DEV
|AC_ERR_MEDIA
|AC_ERR_INVALID
)) == AC_ERR_DEV
)
1969 return base
+ ATA_ECAT_UNK_DEV
;
1975 struct speed_down_verdict_arg
{
1978 int nr_errors
[ATA_ECAT_NR
];
1981 static int speed_down_verdict_cb(struct ata_ering_entry
*ent
, void *void_arg
)
1983 struct speed_down_verdict_arg
*arg
= void_arg
;
1986 if ((ent
->eflags
& ATA_EFLAG_OLD_ER
) || (ent
->timestamp
< arg
->since
))
1989 cat
= ata_eh_categorize_error(ent
->eflags
, ent
->err_mask
,
1991 arg
->nr_errors
[cat
]++;
1997 * ata_eh_speed_down_verdict - Determine speed down verdict
1998 * @dev: Device of interest
2000 * This function examines error ring of @dev and determines
2001 * whether NCQ needs to be turned off, transfer speed should be
2002 * stepped down, or falling back to PIO is necessary.
2004 * ECAT_ATA_BUS : ATA_BUS error for any command
2006 * ECAT_TOUT_HSM : TIMEOUT for any command or HSM violation for
2009 * ECAT_UNK_DEV : Unknown DEV error for IO commands
2011 * ECAT_DUBIOUS_* : Identical to above three but occurred while
2012 * data transfer hasn't been verified.
2016 * NCQ_OFF : Turn off NCQ.
2018 * SPEED_DOWN : Speed down transfer speed but don't fall back
2021 * FALLBACK_TO_PIO : Fall back to PIO.
2023 * Even if multiple verdicts are returned, only one action is
2024 * taken per error. An action triggered by non-DUBIOUS errors
2025 * clears ering, while one triggered by DUBIOUS_* errors doesn't.
2026 * This is to expedite speed down decisions right after device is
2027 * initially configured.
2029 * The followings are speed down rules. #1 and #2 deal with
2032 * 1. If more than one DUBIOUS_ATA_BUS or DUBIOUS_TOUT_HSM errors
2033 * occurred during last 5 mins, SPEED_DOWN and FALLBACK_TO_PIO.
2035 * 2. If more than one DUBIOUS_TOUT_HSM or DUBIOUS_UNK_DEV errors
2036 * occurred during last 5 mins, NCQ_OFF.
2038 * 3. If more than 8 ATA_BUS, TOUT_HSM or UNK_DEV errors
2039 * occurred during last 5 mins, FALLBACK_TO_PIO
2041 * 4. If more than 3 TOUT_HSM or UNK_DEV errors occurred
2042 * during last 10 mins, NCQ_OFF.
2044 * 5. If more than 3 ATA_BUS or TOUT_HSM errors, or more than 6
2045 * UNK_DEV errors occurred during last 10 mins, SPEED_DOWN.
2048 * Inherited from caller.
2051 * OR of ATA_EH_SPDN_* flags.
2053 static unsigned int ata_eh_speed_down_verdict(struct ata_device
*dev
)
2055 const u64 j5mins
= 5LLU * 60 * HZ
, j10mins
= 10LLU * 60 * HZ
;
2056 u64 j64
= get_jiffies_64();
2057 struct speed_down_verdict_arg arg
;
2058 unsigned int verdict
= 0;
2060 /* scan past 5 mins of error history */
2061 memset(&arg
, 0, sizeof(arg
));
2062 arg
.since
= j64
- min(j64
, j5mins
);
2063 ata_ering_map(&dev
->ering
, speed_down_verdict_cb
, &arg
);
2065 if (arg
.nr_errors
[ATA_ECAT_DUBIOUS_ATA_BUS
] +
2066 arg
.nr_errors
[ATA_ECAT_DUBIOUS_TOUT_HSM
] > 1)
2067 verdict
|= ATA_EH_SPDN_SPEED_DOWN
|
2068 ATA_EH_SPDN_FALLBACK_TO_PIO
| ATA_EH_SPDN_KEEP_ERRORS
;
2070 if (arg
.nr_errors
[ATA_ECAT_DUBIOUS_TOUT_HSM
] +
2071 arg
.nr_errors
[ATA_ECAT_DUBIOUS_UNK_DEV
] > 1)
2072 verdict
|= ATA_EH_SPDN_NCQ_OFF
| ATA_EH_SPDN_KEEP_ERRORS
;
2074 if (arg
.nr_errors
[ATA_ECAT_ATA_BUS
] +
2075 arg
.nr_errors
[ATA_ECAT_TOUT_HSM
] +
2076 arg
.nr_errors
[ATA_ECAT_UNK_DEV
] > 6)
2077 verdict
|= ATA_EH_SPDN_FALLBACK_TO_PIO
;
2079 /* scan past 10 mins of error history */
2080 memset(&arg
, 0, sizeof(arg
));
2081 arg
.since
= j64
- min(j64
, j10mins
);
2082 ata_ering_map(&dev
->ering
, speed_down_verdict_cb
, &arg
);
2084 if (arg
.nr_errors
[ATA_ECAT_TOUT_HSM
] +
2085 arg
.nr_errors
[ATA_ECAT_UNK_DEV
] > 3)
2086 verdict
|= ATA_EH_SPDN_NCQ_OFF
;
2088 if (arg
.nr_errors
[ATA_ECAT_ATA_BUS
] +
2089 arg
.nr_errors
[ATA_ECAT_TOUT_HSM
] > 3 ||
2090 arg
.nr_errors
[ATA_ECAT_UNK_DEV
] > 6)
2091 verdict
|= ATA_EH_SPDN_SPEED_DOWN
;
2097 * ata_eh_speed_down - record error and speed down if necessary
2098 * @dev: Failed device
2099 * @eflags: mask of ATA_EFLAG_* flags
2100 * @err_mask: err_mask of the error
2102 * Record error and examine error history to determine whether
2103 * adjusting transmission speed is necessary. It also sets
2104 * transmission limits appropriately if such adjustment is
2108 * Kernel thread context (may sleep).
2111 * Determined recovery action.
2113 static unsigned int ata_eh_speed_down(struct ata_device
*dev
,
2114 unsigned int eflags
, unsigned int err_mask
)
2116 struct ata_link
*link
= ata_dev_phys_link(dev
);
2118 unsigned int verdict
;
2119 unsigned int action
= 0;
2121 /* don't bother if Cat-0 error */
2122 if (ata_eh_categorize_error(eflags
, err_mask
, &xfer_ok
) == 0)
2125 /* record error and determine whether speed down is necessary */
2126 ata_ering_record(&dev
->ering
, eflags
, err_mask
);
2127 verdict
= ata_eh_speed_down_verdict(dev
);
2130 if ((verdict
& ATA_EH_SPDN_NCQ_OFF
) &&
2131 (dev
->flags
& (ATA_DFLAG_PIO
| ATA_DFLAG_NCQ
|
2132 ATA_DFLAG_NCQ_OFF
)) == ATA_DFLAG_NCQ
) {
2133 dev
->flags
|= ATA_DFLAG_NCQ_OFF
;
2134 ata_dev_warn(dev
, "NCQ disabled due to excessive errors\n");
2139 if (verdict
& ATA_EH_SPDN_SPEED_DOWN
) {
2140 /* speed down SATA link speed if possible */
2141 if (sata_down_spd_limit(link
, 0) == 0) {
2142 action
|= ATA_EH_RESET
;
2146 /* lower transfer mode */
2147 if (dev
->spdn_cnt
< 2) {
2148 static const int dma_dnxfer_sel
[] =
2149 { ATA_DNXFER_DMA
, ATA_DNXFER_40C
};
2150 static const int pio_dnxfer_sel
[] =
2151 { ATA_DNXFER_PIO
, ATA_DNXFER_FORCE_PIO0
};
2154 if (dev
->xfer_shift
!= ATA_SHIFT_PIO
)
2155 sel
= dma_dnxfer_sel
[dev
->spdn_cnt
];
2157 sel
= pio_dnxfer_sel
[dev
->spdn_cnt
];
2161 if (ata_down_xfermask_limit(dev
, sel
) == 0) {
2162 action
|= ATA_EH_RESET
;
2168 /* Fall back to PIO? Slowing down to PIO is meaningless for
2169 * SATA ATA devices. Consider it only for PATA and SATAPI.
2171 if ((verdict
& ATA_EH_SPDN_FALLBACK_TO_PIO
) && (dev
->spdn_cnt
>= 2) &&
2172 (link
->ap
->cbl
!= ATA_CBL_SATA
|| dev
->class == ATA_DEV_ATAPI
) &&
2173 (dev
->xfer_shift
!= ATA_SHIFT_PIO
)) {
2174 if (ata_down_xfermask_limit(dev
, ATA_DNXFER_FORCE_PIO
) == 0) {
2176 action
|= ATA_EH_RESET
;
2183 /* device has been slowed down, blow error history */
2184 if (!(verdict
& ATA_EH_SPDN_KEEP_ERRORS
))
2185 ata_ering_clear(&dev
->ering
);
2190 * ata_eh_worth_retry - analyze error and decide whether to retry
2191 * @qc: qc to possibly retry
2193 * Look at the cause of the error and decide if a retry
2194 * might be useful or not. We don't want to retry media errors
2195 * because the drive itself has probably already taken 10-30 seconds
2196 * doing its own internal retries before reporting the failure.
2198 static inline int ata_eh_worth_retry(struct ata_queued_cmd
*qc
)
2200 if (qc
->err_mask
& AC_ERR_MEDIA
)
2201 return 0; /* don't retry media errors */
2202 if (qc
->flags
& ATA_QCFLAG_IO
)
2203 return 1; /* otherwise retry anything from fs stack */
2204 if (qc
->err_mask
& AC_ERR_INVALID
)
2205 return 0; /* don't retry these */
2206 return qc
->err_mask
!= AC_ERR_DEV
; /* retry if not dev error */
2210 * ata_eh_link_autopsy - analyze error and determine recovery action
2211 * @link: host link to perform autopsy on
2213 * Analyze why @link failed and determine which recovery actions
2214 * are needed. This function also sets more detailed AC_ERR_*
2215 * values and fills sense data for ATAPI CHECK SENSE.
2218 * Kernel thread context (may sleep).
2220 static void ata_eh_link_autopsy(struct ata_link
*link
)
2222 struct ata_port
*ap
= link
->ap
;
2223 struct ata_eh_context
*ehc
= &link
->eh_context
;
2224 struct ata_device
*dev
;
2225 unsigned int all_err_mask
= 0, eflags
= 0;
2232 if (ehc
->i
.flags
& ATA_EHI_NO_AUTOPSY
)
2235 /* obtain and analyze SError */
2236 rc
= sata_scr_read(link
, SCR_ERROR
, &serror
);
2238 ehc
->i
.serror
|= serror
;
2239 ata_eh_analyze_serror(link
);
2240 } else if (rc
!= -EOPNOTSUPP
) {
2241 /* SError read failed, force reset and probing */
2242 ehc
->i
.probe_mask
|= ATA_ALL_DEVICES
;
2243 ehc
->i
.action
|= ATA_EH_RESET
;
2244 ehc
->i
.err_mask
|= AC_ERR_OTHER
;
2247 /* analyze NCQ failure */
2248 ata_eh_analyze_ncq_error(link
);
2250 /* any real error trumps AC_ERR_OTHER */
2251 if (ehc
->i
.err_mask
& ~AC_ERR_OTHER
)
2252 ehc
->i
.err_mask
&= ~AC_ERR_OTHER
;
2254 all_err_mask
|= ehc
->i
.err_mask
;
2256 for (tag
= 0; tag
< ATA_MAX_QUEUE
; tag
++) {
2257 struct ata_queued_cmd
*qc
= __ata_qc_from_tag(ap
, tag
);
2259 if (!(qc
->flags
& ATA_QCFLAG_FAILED
) ||
2260 ata_dev_phys_link(qc
->dev
) != link
)
2263 /* inherit upper level err_mask */
2264 qc
->err_mask
|= ehc
->i
.err_mask
;
2267 ehc
->i
.action
|= ata_eh_analyze_tf(qc
, &qc
->result_tf
);
2269 /* DEV errors are probably spurious in case of ATA_BUS error */
2270 if (qc
->err_mask
& AC_ERR_ATA_BUS
)
2271 qc
->err_mask
&= ~(AC_ERR_DEV
| AC_ERR_MEDIA
|
2274 /* any real error trumps unknown error */
2275 if (qc
->err_mask
& ~AC_ERR_OTHER
)
2276 qc
->err_mask
&= ~AC_ERR_OTHER
;
2278 /* SENSE_VALID trumps dev/unknown error and revalidation */
2279 if (qc
->flags
& ATA_QCFLAG_SENSE_VALID
)
2280 qc
->err_mask
&= ~(AC_ERR_DEV
| AC_ERR_OTHER
);
2282 /* determine whether the command is worth retrying */
2283 if (ata_eh_worth_retry(qc
))
2284 qc
->flags
|= ATA_QCFLAG_RETRY
;
2286 /* accumulate error info */
2287 ehc
->i
.dev
= qc
->dev
;
2288 all_err_mask
|= qc
->err_mask
;
2289 if (qc
->flags
& ATA_QCFLAG_IO
)
2290 eflags
|= ATA_EFLAG_IS_IO
;
2293 /* enforce default EH actions */
2294 if (ap
->pflags
& ATA_PFLAG_FROZEN
||
2295 all_err_mask
& (AC_ERR_HSM
| AC_ERR_TIMEOUT
))
2296 ehc
->i
.action
|= ATA_EH_RESET
;
2297 else if (((eflags
& ATA_EFLAG_IS_IO
) && all_err_mask
) ||
2298 (!(eflags
& ATA_EFLAG_IS_IO
) && (all_err_mask
& ~AC_ERR_DEV
)))
2299 ehc
->i
.action
|= ATA_EH_REVALIDATE
;
2301 /* If we have offending qcs and the associated failed device,
2302 * perform per-dev EH action only on the offending device.
2305 ehc
->i
.dev_action
[ehc
->i
.dev
->devno
] |=
2306 ehc
->i
.action
& ATA_EH_PERDEV_MASK
;
2307 ehc
->i
.action
&= ~ATA_EH_PERDEV_MASK
;
2310 /* propagate timeout to host link */
2311 if ((all_err_mask
& AC_ERR_TIMEOUT
) && !ata_is_host_link(link
))
2312 ap
->link
.eh_context
.i
.err_mask
|= AC_ERR_TIMEOUT
;
2314 /* record error and consider speeding down */
2316 if (!dev
&& ((ata_link_max_devices(link
) == 1 &&
2317 ata_dev_enabled(link
->device
))))
2321 if (dev
->flags
& ATA_DFLAG_DUBIOUS_XFER
)
2322 eflags
|= ATA_EFLAG_DUBIOUS_XFER
;
2323 ehc
->i
.action
|= ata_eh_speed_down(dev
, eflags
, all_err_mask
);
2330 * ata_eh_autopsy - analyze error and determine recovery action
2331 * @ap: host port to perform autopsy on
2333 * Analyze all links of @ap and determine why they failed and
2334 * which recovery actions are needed.
2337 * Kernel thread context (may sleep).
2339 void ata_eh_autopsy(struct ata_port
*ap
)
2341 struct ata_link
*link
;
2343 ata_for_each_link(link
, ap
, EDGE
)
2344 ata_eh_link_autopsy(link
);
2346 /* Handle the frigging slave link. Autopsy is done similarly
2347 * but actions and flags are transferred over to the master
2348 * link and handled from there.
2350 if (ap
->slave_link
) {
2351 struct ata_eh_context
*mehc
= &ap
->link
.eh_context
;
2352 struct ata_eh_context
*sehc
= &ap
->slave_link
->eh_context
;
2354 /* transfer control flags from master to slave */
2355 sehc
->i
.flags
|= mehc
->i
.flags
& ATA_EHI_TO_SLAVE_MASK
;
2357 /* perform autopsy on the slave link */
2358 ata_eh_link_autopsy(ap
->slave_link
);
2360 /* transfer actions from slave to master and clear slave */
2361 ata_eh_about_to_do(ap
->slave_link
, NULL
, ATA_EH_ALL_ACTIONS
);
2362 mehc
->i
.action
|= sehc
->i
.action
;
2363 mehc
->i
.dev_action
[1] |= sehc
->i
.dev_action
[1];
2364 mehc
->i
.flags
|= sehc
->i
.flags
;
2365 ata_eh_done(ap
->slave_link
, NULL
, ATA_EH_ALL_ACTIONS
);
2368 /* Autopsy of fanout ports can affect host link autopsy.
2369 * Perform host link autopsy last.
2371 if (sata_pmp_attached(ap
))
2372 ata_eh_link_autopsy(&ap
->link
);
2376 * ata_get_cmd_descript - get description for ATA command
2377 * @command: ATA command code to get description for
2379 * Return a textual description of the given command, or NULL if the
2380 * command is not known.
2385 const char *ata_get_cmd_descript(u8 command
)
2387 #ifdef CONFIG_ATA_VERBOSE_ERROR
2393 { ATA_CMD_DEV_RESET
, "DEVICE RESET" },
2394 { ATA_CMD_CHK_POWER
, "CHECK POWER MODE" },
2395 { ATA_CMD_STANDBY
, "STANDBY" },
2396 { ATA_CMD_IDLE
, "IDLE" },
2397 { ATA_CMD_EDD
, "EXECUTE DEVICE DIAGNOSTIC" },
2398 { ATA_CMD_DOWNLOAD_MICRO
, "DOWNLOAD MICROCODE" },
2399 { ATA_CMD_DOWNLOAD_MICRO_DMA
, "DOWNLOAD MICROCODE DMA" },
2400 { ATA_CMD_NOP
, "NOP" },
2401 { ATA_CMD_FLUSH
, "FLUSH CACHE" },
2402 { ATA_CMD_FLUSH_EXT
, "FLUSH CACHE EXT" },
2403 { ATA_CMD_ID_ATA
, "IDENTIFY DEVICE" },
2404 { ATA_CMD_ID_ATAPI
, "IDENTIFY PACKET DEVICE" },
2405 { ATA_CMD_SERVICE
, "SERVICE" },
2406 { ATA_CMD_READ
, "READ DMA" },
2407 { ATA_CMD_READ_EXT
, "READ DMA EXT" },
2408 { ATA_CMD_READ_QUEUED
, "READ DMA QUEUED" },
2409 { ATA_CMD_READ_STREAM_EXT
, "READ STREAM EXT" },
2410 { ATA_CMD_READ_STREAM_DMA_EXT
, "READ STREAM DMA EXT" },
2411 { ATA_CMD_WRITE
, "WRITE DMA" },
2412 { ATA_CMD_WRITE_EXT
, "WRITE DMA EXT" },
2413 { ATA_CMD_WRITE_QUEUED
, "WRITE DMA QUEUED EXT" },
2414 { ATA_CMD_WRITE_STREAM_EXT
, "WRITE STREAM EXT" },
2415 { ATA_CMD_WRITE_STREAM_DMA_EXT
, "WRITE STREAM DMA EXT" },
2416 { ATA_CMD_WRITE_FUA_EXT
, "WRITE DMA FUA EXT" },
2417 { ATA_CMD_WRITE_QUEUED_FUA_EXT
, "WRITE DMA QUEUED FUA EXT" },
2418 { ATA_CMD_FPDMA_READ
, "READ FPDMA QUEUED" },
2419 { ATA_CMD_FPDMA_WRITE
, "WRITE FPDMA QUEUED" },
2420 { ATA_CMD_FPDMA_SEND
, "SEND FPDMA QUEUED" },
2421 { ATA_CMD_FPDMA_RECV
, "RECEIVE FPDMA QUEUED" },
2422 { ATA_CMD_PIO_READ
, "READ SECTOR(S)" },
2423 { ATA_CMD_PIO_READ_EXT
, "READ SECTOR(S) EXT" },
2424 { ATA_CMD_PIO_WRITE
, "WRITE SECTOR(S)" },
2425 { ATA_CMD_PIO_WRITE_EXT
, "WRITE SECTOR(S) EXT" },
2426 { ATA_CMD_READ_MULTI
, "READ MULTIPLE" },
2427 { ATA_CMD_READ_MULTI_EXT
, "READ MULTIPLE EXT" },
2428 { ATA_CMD_WRITE_MULTI
, "WRITE MULTIPLE" },
2429 { ATA_CMD_WRITE_MULTI_EXT
, "WRITE MULTIPLE EXT" },
2430 { ATA_CMD_WRITE_MULTI_FUA_EXT
, "WRITE MULTIPLE FUA EXT" },
2431 { ATA_CMD_SET_FEATURES
, "SET FEATURES" },
2432 { ATA_CMD_SET_MULTI
, "SET MULTIPLE MODE" },
2433 { ATA_CMD_VERIFY
, "READ VERIFY SECTOR(S)" },
2434 { ATA_CMD_VERIFY_EXT
, "READ VERIFY SECTOR(S) EXT" },
2435 { ATA_CMD_WRITE_UNCORR_EXT
, "WRITE UNCORRECTABLE EXT" },
2436 { ATA_CMD_STANDBYNOW1
, "STANDBY IMMEDIATE" },
2437 { ATA_CMD_IDLEIMMEDIATE
, "IDLE IMMEDIATE" },
2438 { ATA_CMD_SLEEP
, "SLEEP" },
2439 { ATA_CMD_INIT_DEV_PARAMS
, "INITIALIZE DEVICE PARAMETERS" },
2440 { ATA_CMD_READ_NATIVE_MAX
, "READ NATIVE MAX ADDRESS" },
2441 { ATA_CMD_READ_NATIVE_MAX_EXT
, "READ NATIVE MAX ADDRESS EXT" },
2442 { ATA_CMD_SET_MAX
, "SET MAX ADDRESS" },
2443 { ATA_CMD_SET_MAX_EXT
, "SET MAX ADDRESS EXT" },
2444 { ATA_CMD_READ_LOG_EXT
, "READ LOG EXT" },
2445 { ATA_CMD_WRITE_LOG_EXT
, "WRITE LOG EXT" },
2446 { ATA_CMD_READ_LOG_DMA_EXT
, "READ LOG DMA EXT" },
2447 { ATA_CMD_WRITE_LOG_DMA_EXT
, "WRITE LOG DMA EXT" },
2448 { ATA_CMD_TRUSTED_NONDATA
, "TRUSTED NON-DATA" },
2449 { ATA_CMD_TRUSTED_RCV
, "TRUSTED RECEIVE" },
2450 { ATA_CMD_TRUSTED_RCV_DMA
, "TRUSTED RECEIVE DMA" },
2451 { ATA_CMD_TRUSTED_SND
, "TRUSTED SEND" },
2452 { ATA_CMD_TRUSTED_SND_DMA
, "TRUSTED SEND DMA" },
2453 { ATA_CMD_PMP_READ
, "READ BUFFER" },
2454 { ATA_CMD_PMP_READ_DMA
, "READ BUFFER DMA" },
2455 { ATA_CMD_PMP_WRITE
, "WRITE BUFFER" },
2456 { ATA_CMD_PMP_WRITE_DMA
, "WRITE BUFFER DMA" },
2457 { ATA_CMD_CONF_OVERLAY
, "DEVICE CONFIGURATION OVERLAY" },
2458 { ATA_CMD_SEC_SET_PASS
, "SECURITY SET PASSWORD" },
2459 { ATA_CMD_SEC_UNLOCK
, "SECURITY UNLOCK" },
2460 { ATA_CMD_SEC_ERASE_PREP
, "SECURITY ERASE PREPARE" },
2461 { ATA_CMD_SEC_ERASE_UNIT
, "SECURITY ERASE UNIT" },
2462 { ATA_CMD_SEC_FREEZE_LOCK
, "SECURITY FREEZE LOCK" },
2463 { ATA_CMD_SEC_DISABLE_PASS
, "SECURITY DISABLE PASSWORD" },
2464 { ATA_CMD_CONFIG_STREAM
, "CONFIGURE STREAM" },
2465 { ATA_CMD_SMART
, "SMART" },
2466 { ATA_CMD_MEDIA_LOCK
, "DOOR LOCK" },
2467 { ATA_CMD_MEDIA_UNLOCK
, "DOOR UNLOCK" },
2468 { ATA_CMD_DSM
, "DATA SET MANAGEMENT" },
2469 { ATA_CMD_CHK_MED_CRD_TYP
, "CHECK MEDIA CARD TYPE" },
2470 { ATA_CMD_CFA_REQ_EXT_ERR
, "CFA REQUEST EXTENDED ERROR" },
2471 { ATA_CMD_CFA_WRITE_NE
, "CFA WRITE SECTORS WITHOUT ERASE" },
2472 { ATA_CMD_CFA_TRANS_SECT
, "CFA TRANSLATE SECTOR" },
2473 { ATA_CMD_CFA_ERASE
, "CFA ERASE SECTORS" },
2474 { ATA_CMD_CFA_WRITE_MULT_NE
, "CFA WRITE MULTIPLE WITHOUT ERASE" },
2475 { ATA_CMD_REQ_SENSE_DATA
, "REQUEST SENSE DATA EXT" },
2476 { ATA_CMD_SANITIZE_DEVICE
, "SANITIZE DEVICE" },
2477 { ATA_CMD_READ_LONG
, "READ LONG (with retries)" },
2478 { ATA_CMD_READ_LONG_ONCE
, "READ LONG (without retries)" },
2479 { ATA_CMD_WRITE_LONG
, "WRITE LONG (with retries)" },
2480 { ATA_CMD_WRITE_LONG_ONCE
, "WRITE LONG (without retries)" },
2481 { ATA_CMD_RESTORE
, "RECALIBRATE" },
2482 { 0, NULL
} /* terminate list */
2486 for (i
= 0; cmd_descr
[i
].text
; i
++)
2487 if (cmd_descr
[i
].command
== command
)
2488 return cmd_descr
[i
].text
;
2493 EXPORT_SYMBOL_GPL(ata_get_cmd_descript
);
2496 * ata_eh_link_report - report error handling to user
2497 * @link: ATA link EH is going on
2499 * Report EH to user.
2504 static void ata_eh_link_report(struct ata_link
*link
)
2506 struct ata_port
*ap
= link
->ap
;
2507 struct ata_eh_context
*ehc
= &link
->eh_context
;
2508 const char *frozen
, *desc
;
2509 char tries_buf
[6] = "";
2510 int tag
, nr_failed
= 0;
2512 if (ehc
->i
.flags
& ATA_EHI_QUIET
)
2516 if (ehc
->i
.desc
[0] != '\0')
2519 for (tag
= 0; tag
< ATA_MAX_QUEUE
; tag
++) {
2520 struct ata_queued_cmd
*qc
= __ata_qc_from_tag(ap
, tag
);
2522 if (!(qc
->flags
& ATA_QCFLAG_FAILED
) ||
2523 ata_dev_phys_link(qc
->dev
) != link
||
2524 ((qc
->flags
& ATA_QCFLAG_QUIET
) &&
2525 qc
->err_mask
== AC_ERR_DEV
))
2527 if (qc
->flags
& ATA_QCFLAG_SENSE_VALID
&& !qc
->err_mask
)
2533 if (!nr_failed
&& !ehc
->i
.err_mask
)
2537 if (ap
->pflags
& ATA_PFLAG_FROZEN
)
2540 if (ap
->eh_tries
< ATA_EH_MAX_TRIES
)
2541 snprintf(tries_buf
, sizeof(tries_buf
), " t%d",
2545 ata_dev_err(ehc
->i
.dev
, "exception Emask 0x%x "
2546 "SAct 0x%x SErr 0x%x action 0x%x%s%s\n",
2547 ehc
->i
.err_mask
, link
->sactive
, ehc
->i
.serror
,
2548 ehc
->i
.action
, frozen
, tries_buf
);
2550 ata_dev_err(ehc
->i
.dev
, "%s\n", desc
);
2552 ata_link_err(link
, "exception Emask 0x%x "
2553 "SAct 0x%x SErr 0x%x action 0x%x%s%s\n",
2554 ehc
->i
.err_mask
, link
->sactive
, ehc
->i
.serror
,
2555 ehc
->i
.action
, frozen
, tries_buf
);
2557 ata_link_err(link
, "%s\n", desc
);
2560 #ifdef CONFIG_ATA_VERBOSE_ERROR
2563 "SError: { %s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s}\n",
2564 ehc
->i
.serror
& SERR_DATA_RECOVERED
? "RecovData " : "",
2565 ehc
->i
.serror
& SERR_COMM_RECOVERED
? "RecovComm " : "",
2566 ehc
->i
.serror
& SERR_DATA
? "UnrecovData " : "",
2567 ehc
->i
.serror
& SERR_PERSISTENT
? "Persist " : "",
2568 ehc
->i
.serror
& SERR_PROTOCOL
? "Proto " : "",
2569 ehc
->i
.serror
& SERR_INTERNAL
? "HostInt " : "",
2570 ehc
->i
.serror
& SERR_PHYRDY_CHG
? "PHYRdyChg " : "",
2571 ehc
->i
.serror
& SERR_PHY_INT_ERR
? "PHYInt " : "",
2572 ehc
->i
.serror
& SERR_COMM_WAKE
? "CommWake " : "",
2573 ehc
->i
.serror
& SERR_10B_8B_ERR
? "10B8B " : "",
2574 ehc
->i
.serror
& SERR_DISPARITY
? "Dispar " : "",
2575 ehc
->i
.serror
& SERR_CRC
? "BadCRC " : "",
2576 ehc
->i
.serror
& SERR_HANDSHAKE
? "Handshk " : "",
2577 ehc
->i
.serror
& SERR_LINK_SEQ_ERR
? "LinkSeq " : "",
2578 ehc
->i
.serror
& SERR_TRANS_ST_ERROR
? "TrStaTrns " : "",
2579 ehc
->i
.serror
& SERR_UNRECOG_FIS
? "UnrecFIS " : "",
2580 ehc
->i
.serror
& SERR_DEV_XCHG
? "DevExch " : "");
2583 for (tag
= 0; tag
< ATA_MAX_QUEUE
; tag
++) {
2584 struct ata_queued_cmd
*qc
= __ata_qc_from_tag(ap
, tag
);
2585 struct ata_taskfile
*cmd
= &qc
->tf
, *res
= &qc
->result_tf
;
2586 char data_buf
[20] = "";
2587 char cdb_buf
[70] = "";
2589 if (!(qc
->flags
& ATA_QCFLAG_FAILED
) ||
2590 ata_dev_phys_link(qc
->dev
) != link
|| !qc
->err_mask
)
2593 if (qc
->dma_dir
!= DMA_NONE
) {
2594 static const char *dma_str
[] = {
2595 [DMA_BIDIRECTIONAL
] = "bidi",
2596 [DMA_TO_DEVICE
] = "out",
2597 [DMA_FROM_DEVICE
] = "in",
2599 static const char *prot_str
[] = {
2600 [ATA_PROT_PIO
] = "pio",
2601 [ATA_PROT_DMA
] = "dma",
2602 [ATA_PROT_NCQ
] = "ncq",
2603 [ATAPI_PROT_PIO
] = "pio",
2604 [ATAPI_PROT_DMA
] = "dma",
2607 snprintf(data_buf
, sizeof(data_buf
), " %s %u %s",
2608 prot_str
[qc
->tf
.protocol
], qc
->nbytes
,
2609 dma_str
[qc
->dma_dir
]);
2612 if (ata_is_atapi(qc
->tf
.protocol
)) {
2613 const u8
*cdb
= qc
->cdb
;
2614 size_t cdb_len
= qc
->dev
->cdb_len
;
2617 cdb
= qc
->scsicmd
->cmnd
;
2618 cdb_len
= qc
->scsicmd
->cmd_len
;
2620 __scsi_format_command(cdb_buf
, sizeof(cdb_buf
),
2623 const char *descr
= ata_get_cmd_descript(cmd
->command
);
2625 ata_dev_err(qc
->dev
, "failed command: %s\n",
2629 ata_dev_err(qc
->dev
,
2630 "cmd %02x/%02x:%02x:%02x:%02x:%02x/%02x:%02x:%02x:%02x:%02x/%02x "
2632 "res %02x/%02x:%02x:%02x:%02x:%02x/%02x:%02x:%02x:%02x:%02x/%02x "
2633 "Emask 0x%x (%s)%s\n",
2634 cmd
->command
, cmd
->feature
, cmd
->nsect
,
2635 cmd
->lbal
, cmd
->lbam
, cmd
->lbah
,
2636 cmd
->hob_feature
, cmd
->hob_nsect
,
2637 cmd
->hob_lbal
, cmd
->hob_lbam
, cmd
->hob_lbah
,
2638 cmd
->device
, qc
->tag
, data_buf
, cdb_buf
,
2639 res
->command
, res
->feature
, res
->nsect
,
2640 res
->lbal
, res
->lbam
, res
->lbah
,
2641 res
->hob_feature
, res
->hob_nsect
,
2642 res
->hob_lbal
, res
->hob_lbam
, res
->hob_lbah
,
2643 res
->device
, qc
->err_mask
, ata_err_string(qc
->err_mask
),
2644 qc
->err_mask
& AC_ERR_NCQ
? " <F>" : "");
2646 #ifdef CONFIG_ATA_VERBOSE_ERROR
2647 if (res
->command
& (ATA_BUSY
| ATA_DRDY
| ATA_DF
| ATA_DRQ
|
2648 ATA_SENSE
| ATA_ERR
)) {
2649 if (res
->command
& ATA_BUSY
)
2650 ata_dev_err(qc
->dev
, "status: { Busy }\n");
2652 ata_dev_err(qc
->dev
, "status: { %s%s%s%s%s}\n",
2653 res
->command
& ATA_DRDY
? "DRDY " : "",
2654 res
->command
& ATA_DF
? "DF " : "",
2655 res
->command
& ATA_DRQ
? "DRQ " : "",
2656 res
->command
& ATA_SENSE
? "SENSE " : "",
2657 res
->command
& ATA_ERR
? "ERR " : "");
2660 if (cmd
->command
!= ATA_CMD_PACKET
&&
2661 (res
->feature
& (ATA_ICRC
| ATA_UNC
| ATA_AMNF
|
2662 ATA_IDNF
| ATA_ABORTED
)))
2663 ata_dev_err(qc
->dev
, "error: { %s%s%s%s%s}\n",
2664 res
->feature
& ATA_ICRC
? "ICRC " : "",
2665 res
->feature
& ATA_UNC
? "UNC " : "",
2666 res
->feature
& ATA_AMNF
? "AMNF " : "",
2667 res
->feature
& ATA_IDNF
? "IDNF " : "",
2668 res
->feature
& ATA_ABORTED
? "ABRT " : "");
2674 * ata_eh_report - report error handling to user
2675 * @ap: ATA port to report EH about
2677 * Report EH to user.
2682 void ata_eh_report(struct ata_port
*ap
)
2684 struct ata_link
*link
;
2686 ata_for_each_link(link
, ap
, HOST_FIRST
)
2687 ata_eh_link_report(link
);
2690 static int ata_do_reset(struct ata_link
*link
, ata_reset_fn_t reset
,
2691 unsigned int *classes
, unsigned long deadline
,
2694 struct ata_device
*dev
;
2697 ata_for_each_dev(dev
, link
, ALL
)
2698 classes
[dev
->devno
] = ATA_DEV_UNKNOWN
;
2700 return reset(link
, classes
, deadline
);
2703 static int ata_eh_followup_srst_needed(struct ata_link
*link
, int rc
)
2705 if ((link
->flags
& ATA_LFLAG_NO_SRST
) || ata_link_offline(link
))
2709 if (sata_pmp_supported(link
->ap
) && ata_is_host_link(link
))
2714 int ata_eh_reset(struct ata_link
*link
, int classify
,
2715 ata_prereset_fn_t prereset
, ata_reset_fn_t softreset
,
2716 ata_reset_fn_t hardreset
, ata_postreset_fn_t postreset
)
2718 struct ata_port
*ap
= link
->ap
;
2719 struct ata_link
*slave
= ap
->slave_link
;
2720 struct ata_eh_context
*ehc
= &link
->eh_context
;
2721 struct ata_eh_context
*sehc
= slave
? &slave
->eh_context
: NULL
;
2722 unsigned int *classes
= ehc
->classes
;
2723 unsigned int lflags
= link
->flags
;
2724 int verbose
= !(ehc
->i
.flags
& ATA_EHI_QUIET
);
2725 int max_tries
= 0, try = 0;
2726 struct ata_link
*failed_link
;
2727 struct ata_device
*dev
;
2728 unsigned long deadline
, now
;
2729 ata_reset_fn_t reset
;
2730 unsigned long flags
;
2737 while (ata_eh_reset_timeouts
[max_tries
] != ULONG_MAX
)
2739 if (link
->flags
& ATA_LFLAG_RST_ONCE
)
2741 if (link
->flags
& ATA_LFLAG_NO_HRST
)
2743 if (link
->flags
& ATA_LFLAG_NO_SRST
)
2746 /* make sure each reset attempt is at least COOL_DOWN apart */
2747 if (ehc
->i
.flags
& ATA_EHI_DID_RESET
) {
2749 WARN_ON(time_after(ehc
->last_reset
, now
));
2750 deadline
= ata_deadline(ehc
->last_reset
,
2751 ATA_EH_RESET_COOL_DOWN
);
2752 if (time_before(now
, deadline
))
2753 schedule_timeout_uninterruptible(deadline
- now
);
2756 spin_lock_irqsave(ap
->lock
, flags
);
2757 ap
->pflags
|= ATA_PFLAG_RESETTING
;
2758 spin_unlock_irqrestore(ap
->lock
, flags
);
2760 ata_eh_about_to_do(link
, NULL
, ATA_EH_RESET
);
2762 ata_for_each_dev(dev
, link
, ALL
) {
2763 /* If we issue an SRST then an ATA drive (not ATAPI)
2764 * may change configuration and be in PIO0 timing. If
2765 * we do a hard reset (or are coming from power on)
2766 * this is true for ATA or ATAPI. Until we've set a
2767 * suitable controller mode we should not touch the
2768 * bus as we may be talking too fast.
2770 dev
->pio_mode
= XFER_PIO_0
;
2771 dev
->dma_mode
= 0xff;
2773 /* If the controller has a pio mode setup function
2774 * then use it to set the chipset to rights. Don't
2775 * touch the DMA setup as that will be dealt with when
2776 * configuring devices.
2778 if (ap
->ops
->set_piomode
)
2779 ap
->ops
->set_piomode(ap
, dev
);
2782 /* prefer hardreset */
2784 ehc
->i
.action
&= ~ATA_EH_RESET
;
2787 ehc
->i
.action
|= ATA_EH_HARDRESET
;
2788 } else if (softreset
) {
2790 ehc
->i
.action
|= ATA_EH_SOFTRESET
;
2794 unsigned long deadline
= ata_deadline(jiffies
,
2795 ATA_EH_PRERESET_TIMEOUT
);
2798 sehc
->i
.action
&= ~ATA_EH_RESET
;
2799 sehc
->i
.action
|= ehc
->i
.action
;
2802 rc
= prereset(link
, deadline
);
2804 /* If present, do prereset on slave link too. Reset
2805 * is skipped iff both master and slave links report
2806 * -ENOENT or clear ATA_EH_RESET.
2808 if (slave
&& (rc
== 0 || rc
== -ENOENT
)) {
2811 tmp
= prereset(slave
, deadline
);
2815 ehc
->i
.action
|= sehc
->i
.action
;
2819 if (rc
== -ENOENT
) {
2820 ata_link_dbg(link
, "port disabled--ignoring\n");
2821 ehc
->i
.action
&= ~ATA_EH_RESET
;
2823 ata_for_each_dev(dev
, link
, ALL
)
2824 classes
[dev
->devno
] = ATA_DEV_NONE
;
2829 "prereset failed (errno=%d)\n",
2834 /* prereset() might have cleared ATA_EH_RESET. If so,
2835 * bang classes, thaw and return.
2837 if (reset
&& !(ehc
->i
.action
& ATA_EH_RESET
)) {
2838 ata_for_each_dev(dev
, link
, ALL
)
2839 classes
[dev
->devno
] = ATA_DEV_NONE
;
2840 if ((ap
->pflags
& ATA_PFLAG_FROZEN
) &&
2841 ata_is_host_link(link
))
2842 ata_eh_thaw_port(ap
);
2852 if (ata_is_host_link(link
))
2853 ata_eh_freeze_port(ap
);
2855 deadline
= ata_deadline(jiffies
, ata_eh_reset_timeouts
[try++]);
2859 ata_link_info(link
, "%s resetting link\n",
2860 reset
== softreset
? "soft" : "hard");
2862 /* mark that this EH session started with reset */
2863 ehc
->last_reset
= jiffies
;
2864 if (reset
== hardreset
)
2865 ehc
->i
.flags
|= ATA_EHI_DID_HARDRESET
;
2867 ehc
->i
.flags
|= ATA_EHI_DID_SOFTRESET
;
2869 rc
= ata_do_reset(link
, reset
, classes
, deadline
, true);
2870 if (rc
&& rc
!= -EAGAIN
) {
2875 /* hardreset slave link if existent */
2876 if (slave
&& reset
== hardreset
) {
2880 ata_link_info(slave
, "hard resetting link\n");
2882 ata_eh_about_to_do(slave
, NULL
, ATA_EH_RESET
);
2883 tmp
= ata_do_reset(slave
, reset
, classes
, deadline
,
2891 failed_link
= slave
;
2897 /* perform follow-up SRST if necessary */
2898 if (reset
== hardreset
&&
2899 ata_eh_followup_srst_needed(link
, rc
)) {
2904 "follow-up softreset required but no softreset available\n");
2910 ata_eh_about_to_do(link
, NULL
, ATA_EH_RESET
);
2911 rc
= ata_do_reset(link
, reset
, classes
, deadline
, true);
2920 "no reset method available, skipping reset\n");
2921 if (!(lflags
& ATA_LFLAG_ASSUME_CLASS
))
2922 lflags
|= ATA_LFLAG_ASSUME_ATA
;
2926 * Post-reset processing
2928 ata_for_each_dev(dev
, link
, ALL
) {
2929 /* After the reset, the device state is PIO 0 and the
2930 * controller state is undefined. Reset also wakes up
2931 * drives from sleeping mode.
2933 dev
->pio_mode
= XFER_PIO_0
;
2934 dev
->flags
&= ~ATA_DFLAG_SLEEPING
;
2936 if (ata_phys_link_offline(ata_dev_phys_link(dev
)))
2939 /* apply class override */
2940 if (lflags
& ATA_LFLAG_ASSUME_ATA
)
2941 classes
[dev
->devno
] = ATA_DEV_ATA
;
2942 else if (lflags
& ATA_LFLAG_ASSUME_SEMB
)
2943 classes
[dev
->devno
] = ATA_DEV_SEMB_UNSUP
;
2946 /* record current link speed */
2947 if (sata_scr_read(link
, SCR_STATUS
, &sstatus
) == 0)
2948 link
->sata_spd
= (sstatus
>> 4) & 0xf;
2949 if (slave
&& sata_scr_read(slave
, SCR_STATUS
, &sstatus
) == 0)
2950 slave
->sata_spd
= (sstatus
>> 4) & 0xf;
2953 if (ata_is_host_link(link
))
2954 ata_eh_thaw_port(ap
);
2956 /* postreset() should clear hardware SError. Although SError
2957 * is cleared during link resume, clearing SError here is
2958 * necessary as some PHYs raise hotplug events after SRST.
2959 * This introduces race condition where hotplug occurs between
2960 * reset and here. This race is mediated by cross checking
2961 * link onlineness and classification result later.
2964 postreset(link
, classes
);
2966 postreset(slave
, classes
);
2970 * Some controllers can't be frozen very well and may set spurious
2971 * error conditions during reset. Clear accumulated error
2972 * information and re-thaw the port if frozen. As reset is the
2973 * final recovery action and we cross check link onlineness against
2974 * device classification later, no hotplug event is lost by this.
2976 spin_lock_irqsave(link
->ap
->lock
, flags
);
2977 memset(&link
->eh_info
, 0, sizeof(link
->eh_info
));
2979 memset(&slave
->eh_info
, 0, sizeof(link
->eh_info
));
2980 ap
->pflags
&= ~ATA_PFLAG_EH_PENDING
;
2981 spin_unlock_irqrestore(link
->ap
->lock
, flags
);
2983 if (ap
->pflags
& ATA_PFLAG_FROZEN
)
2984 ata_eh_thaw_port(ap
);
2987 * Make sure onlineness and classification result correspond.
2988 * Hotplug could have happened during reset and some
2989 * controllers fail to wait while a drive is spinning up after
2990 * being hotplugged causing misdetection. By cross checking
2991 * link on/offlineness and classification result, those
2992 * conditions can be reliably detected and retried.
2995 ata_for_each_dev(dev
, link
, ALL
) {
2996 if (ata_phys_link_online(ata_dev_phys_link(dev
))) {
2997 if (classes
[dev
->devno
] == ATA_DEV_UNKNOWN
) {
2998 ata_dev_dbg(dev
, "link online but device misclassified\n");
2999 classes
[dev
->devno
] = ATA_DEV_NONE
;
3002 } else if (ata_phys_link_offline(ata_dev_phys_link(dev
))) {
3003 if (ata_class_enabled(classes
[dev
->devno
]))
3005 "link offline, clearing class %d to NONE\n",
3006 classes
[dev
->devno
]);
3007 classes
[dev
->devno
] = ATA_DEV_NONE
;
3008 } else if (classes
[dev
->devno
] == ATA_DEV_UNKNOWN
) {
3010 "link status unknown, clearing UNKNOWN to NONE\n");
3011 classes
[dev
->devno
] = ATA_DEV_NONE
;
3015 if (classify
&& nr_unknown
) {
3016 if (try < max_tries
) {
3018 "link online but %d devices misclassified, retrying\n",
3025 "link online but %d devices misclassified, "
3026 "device detection might fail\n", nr_unknown
);
3029 /* reset successful, schedule revalidation */
3030 ata_eh_done(link
, NULL
, ATA_EH_RESET
);
3032 ata_eh_done(slave
, NULL
, ATA_EH_RESET
);
3033 ehc
->last_reset
= jiffies
; /* update to completion time */
3034 ehc
->i
.action
|= ATA_EH_REVALIDATE
;
3035 link
->lpm_policy
= ATA_LPM_UNKNOWN
; /* reset LPM state */
3039 /* clear hotplug flag */
3040 ehc
->i
.flags
&= ~ATA_EHI_HOTPLUGGED
;
3042 sehc
->i
.flags
&= ~ATA_EHI_HOTPLUGGED
;
3044 spin_lock_irqsave(ap
->lock
, flags
);
3045 ap
->pflags
&= ~ATA_PFLAG_RESETTING
;
3046 spin_unlock_irqrestore(ap
->lock
, flags
);
3051 /* if SCR isn't accessible on a fan-out port, PMP needs to be reset */
3052 if (!ata_is_host_link(link
) &&
3053 sata_scr_read(link
, SCR_STATUS
, &sstatus
))
3056 if (try >= max_tries
) {
3058 * Thaw host port even if reset failed, so that the port
3059 * can be retried on the next phy event. This risks
3060 * repeated EH runs but seems to be a better tradeoff than
3061 * shutting down a port after a botched hotplug attempt.
3063 if (ata_is_host_link(link
))
3064 ata_eh_thaw_port(ap
);
3069 if (time_before(now
, deadline
)) {
3070 unsigned long delta
= deadline
- now
;
3072 ata_link_warn(failed_link
,
3073 "reset failed (errno=%d), retrying in %u secs\n",
3074 rc
, DIV_ROUND_UP(jiffies_to_msecs(delta
), 1000));
3078 delta
= schedule_timeout_uninterruptible(delta
);
3083 * While disks spinup behind PMP, some controllers fail sending SRST.
3084 * They need to be reset - as well as the PMP - before retrying.
3086 if (rc
== -ERESTART
) {
3087 if (ata_is_host_link(link
))
3088 ata_eh_thaw_port(ap
);
3092 if (try == max_tries
- 1) {
3093 sata_down_spd_limit(link
, 0);
3095 sata_down_spd_limit(slave
, 0);
3096 } else if (rc
== -EPIPE
)
3097 sata_down_spd_limit(failed_link
, 0);
3104 static inline void ata_eh_pull_park_action(struct ata_port
*ap
)
3106 struct ata_link
*link
;
3107 struct ata_device
*dev
;
3108 unsigned long flags
;
3111 * This function can be thought of as an extended version of
3112 * ata_eh_about_to_do() specially crafted to accommodate the
3113 * requirements of ATA_EH_PARK handling. Since the EH thread
3114 * does not leave the do {} while () loop in ata_eh_recover as
3115 * long as the timeout for a park request to *one* device on
3116 * the port has not expired, and since we still want to pick
3117 * up park requests to other devices on the same port or
3118 * timeout updates for the same device, we have to pull
3119 * ATA_EH_PARK actions from eh_info into eh_context.i
3120 * ourselves at the beginning of each pass over the loop.
3122 * Additionally, all write accesses to &ap->park_req_pending
3123 * through reinit_completion() (see below) or complete_all()
3124 * (see ata_scsi_park_store()) are protected by the host lock.
3125 * As a result we have that park_req_pending.done is zero on
3126 * exit from this function, i.e. when ATA_EH_PARK actions for
3127 * *all* devices on port ap have been pulled into the
3128 * respective eh_context structs. If, and only if,
3129 * park_req_pending.done is non-zero by the time we reach
3130 * wait_for_completion_timeout(), another ATA_EH_PARK action
3131 * has been scheduled for at least one of the devices on port
3132 * ap and we have to cycle over the do {} while () loop in
3133 * ata_eh_recover() again.
3136 spin_lock_irqsave(ap
->lock
, flags
);
3137 reinit_completion(&ap
->park_req_pending
);
3138 ata_for_each_link(link
, ap
, EDGE
) {
3139 ata_for_each_dev(dev
, link
, ALL
) {
3140 struct ata_eh_info
*ehi
= &link
->eh_info
;
3142 link
->eh_context
.i
.dev_action
[dev
->devno
] |=
3143 ehi
->dev_action
[dev
->devno
] & ATA_EH_PARK
;
3144 ata_eh_clear_action(link
, dev
, ehi
, ATA_EH_PARK
);
3147 spin_unlock_irqrestore(ap
->lock
, flags
);
3150 static void ata_eh_park_issue_cmd(struct ata_device
*dev
, int park
)
3152 struct ata_eh_context
*ehc
= &dev
->link
->eh_context
;
3153 struct ata_taskfile tf
;
3154 unsigned int err_mask
;
3156 ata_tf_init(dev
, &tf
);
3158 ehc
->unloaded_mask
|= 1 << dev
->devno
;
3159 tf
.command
= ATA_CMD_IDLEIMMEDIATE
;
3165 ehc
->unloaded_mask
&= ~(1 << dev
->devno
);
3166 tf
.command
= ATA_CMD_CHK_POWER
;
3169 tf
.flags
|= ATA_TFLAG_DEVICE
| ATA_TFLAG_ISADDR
;
3170 tf
.protocol
|= ATA_PROT_NODATA
;
3171 err_mask
= ata_exec_internal(dev
, &tf
, NULL
, DMA_NONE
, NULL
, 0, 0);
3172 if (park
&& (err_mask
|| tf
.lbal
!= 0xc4)) {
3173 ata_dev_err(dev
, "head unload failed!\n");
3174 ehc
->unloaded_mask
&= ~(1 << dev
->devno
);
3178 static int ata_eh_revalidate_and_attach(struct ata_link
*link
,
3179 struct ata_device
**r_failed_dev
)
3181 struct ata_port
*ap
= link
->ap
;
3182 struct ata_eh_context
*ehc
= &link
->eh_context
;
3183 struct ata_device
*dev
;
3184 unsigned int new_mask
= 0;
3185 unsigned long flags
;
3190 /* For PATA drive side cable detection to work, IDENTIFY must
3191 * be done backwards such that PDIAG- is released by the slave
3192 * device before the master device is identified.
3194 ata_for_each_dev(dev
, link
, ALL_REVERSE
) {
3195 unsigned int action
= ata_eh_dev_action(dev
);
3196 unsigned int readid_flags
= 0;
3198 if (ehc
->i
.flags
& ATA_EHI_DID_RESET
)
3199 readid_flags
|= ATA_READID_POSTRESET
;
3201 if ((action
& ATA_EH_REVALIDATE
) && ata_dev_enabled(dev
)) {
3202 WARN_ON(dev
->class == ATA_DEV_PMP
);
3204 if (ata_phys_link_offline(ata_dev_phys_link(dev
))) {
3209 ata_eh_about_to_do(link
, dev
, ATA_EH_REVALIDATE
);
3210 rc
= ata_dev_revalidate(dev
, ehc
->classes
[dev
->devno
],
3215 ata_eh_done(link
, dev
, ATA_EH_REVALIDATE
);
3217 /* Configuration may have changed, reconfigure
3220 ehc
->i
.flags
|= ATA_EHI_SETMODE
;
3222 /* schedule the scsi_rescan_device() here */
3223 schedule_work(&(ap
->scsi_rescan_task
));
3224 } else if (dev
->class == ATA_DEV_UNKNOWN
&&
3225 ehc
->tries
[dev
->devno
] &&
3226 ata_class_enabled(ehc
->classes
[dev
->devno
])) {
3227 /* Temporarily set dev->class, it will be
3228 * permanently set once all configurations are
3229 * complete. This is necessary because new
3230 * device configuration is done in two
3233 dev
->class = ehc
->classes
[dev
->devno
];
3235 if (dev
->class == ATA_DEV_PMP
)
3236 rc
= sata_pmp_attach(dev
);
3238 rc
= ata_dev_read_id(dev
, &dev
->class,
3239 readid_flags
, dev
->id
);
3241 /* read_id might have changed class, store and reset */
3242 ehc
->classes
[dev
->devno
] = dev
->class;
3243 dev
->class = ATA_DEV_UNKNOWN
;
3247 /* clear error info accumulated during probe */
3248 ata_ering_clear(&dev
->ering
);
3249 new_mask
|= 1 << dev
->devno
;
3252 /* IDENTIFY was issued to non-existent
3253 * device. No need to reset. Just
3254 * thaw and ignore the device.
3256 ata_eh_thaw_port(ap
);
3264 /* PDIAG- should have been released, ask cable type if post-reset */
3265 if ((ehc
->i
.flags
& ATA_EHI_DID_RESET
) && ata_is_host_link(link
)) {
3266 if (ap
->ops
->cable_detect
)
3267 ap
->cbl
= ap
->ops
->cable_detect(ap
);
3271 /* Configure new devices forward such that user doesn't see
3272 * device detection messages backwards.
3274 ata_for_each_dev(dev
, link
, ALL
) {
3275 if (!(new_mask
& (1 << dev
->devno
)))
3278 dev
->class = ehc
->classes
[dev
->devno
];
3280 if (dev
->class == ATA_DEV_PMP
)
3283 ehc
->i
.flags
|= ATA_EHI_PRINTINFO
;
3284 rc
= ata_dev_configure(dev
);
3285 ehc
->i
.flags
&= ~ATA_EHI_PRINTINFO
;
3287 dev
->class = ATA_DEV_UNKNOWN
;
3291 spin_lock_irqsave(ap
->lock
, flags
);
3292 ap
->pflags
|= ATA_PFLAG_SCSI_HOTPLUG
;
3293 spin_unlock_irqrestore(ap
->lock
, flags
);
3295 /* new device discovered, configure xfermode */
3296 ehc
->i
.flags
|= ATA_EHI_SETMODE
;
3302 *r_failed_dev
= dev
;
3303 DPRINTK("EXIT rc=%d\n", rc
);
3308 * ata_set_mode - Program timings and issue SET FEATURES - XFER
3309 * @link: link on which timings will be programmed
3310 * @r_failed_dev: out parameter for failed device
3312 * Set ATA device disk transfer mode (PIO3, UDMA6, etc.). If
3313 * ata_set_mode() fails, pointer to the failing device is
3314 * returned in @r_failed_dev.
3317 * PCI/etc. bus probe sem.
3320 * 0 on success, negative errno otherwise
3322 int ata_set_mode(struct ata_link
*link
, struct ata_device
**r_failed_dev
)
3324 struct ata_port
*ap
= link
->ap
;
3325 struct ata_device
*dev
;
3328 /* if data transfer is verified, clear DUBIOUS_XFER on ering top */
3329 ata_for_each_dev(dev
, link
, ENABLED
) {
3330 if (!(dev
->flags
& ATA_DFLAG_DUBIOUS_XFER
)) {
3331 struct ata_ering_entry
*ent
;
3333 ent
= ata_ering_top(&dev
->ering
);
3335 ent
->eflags
&= ~ATA_EFLAG_DUBIOUS_XFER
;
3339 /* has private set_mode? */
3340 if (ap
->ops
->set_mode
)
3341 rc
= ap
->ops
->set_mode(link
, r_failed_dev
);
3343 rc
= ata_do_set_mode(link
, r_failed_dev
);
3345 /* if transfer mode has changed, set DUBIOUS_XFER on device */
3346 ata_for_each_dev(dev
, link
, ENABLED
) {
3347 struct ata_eh_context
*ehc
= &link
->eh_context
;
3348 u8 saved_xfer_mode
= ehc
->saved_xfer_mode
[dev
->devno
];
3349 u8 saved_ncq
= !!(ehc
->saved_ncq_enabled
& (1 << dev
->devno
));
3351 if (dev
->xfer_mode
!= saved_xfer_mode
||
3352 ata_ncq_enabled(dev
) != saved_ncq
)
3353 dev
->flags
|= ATA_DFLAG_DUBIOUS_XFER
;
3360 * atapi_eh_clear_ua - Clear ATAPI UNIT ATTENTION after reset
3361 * @dev: ATAPI device to clear UA for
3363 * Resets and other operations can make an ATAPI device raise
3364 * UNIT ATTENTION which causes the next operation to fail. This
3365 * function clears UA.
3368 * EH context (may sleep).
3371 * 0 on success, -errno on failure.
3373 static int atapi_eh_clear_ua(struct ata_device
*dev
)
3377 for (i
= 0; i
< ATA_EH_UA_TRIES
; i
++) {
3378 u8
*sense_buffer
= dev
->link
->ap
->sector_buf
;
3380 unsigned int err_mask
;
3382 err_mask
= atapi_eh_tur(dev
, &sense_key
);
3383 if (err_mask
!= 0 && err_mask
!= AC_ERR_DEV
) {
3385 "TEST_UNIT_READY failed (err_mask=0x%x)\n",
3390 if (!err_mask
|| sense_key
!= UNIT_ATTENTION
)
3393 err_mask
= atapi_eh_request_sense(dev
, sense_buffer
, sense_key
);
3395 ata_dev_warn(dev
, "failed to clear "
3396 "UNIT ATTENTION (err_mask=0x%x)\n", err_mask
);
3401 ata_dev_warn(dev
, "UNIT ATTENTION persists after %d tries\n",
3408 * ata_eh_maybe_retry_flush - Retry FLUSH if necessary
3409 * @dev: ATA device which may need FLUSH retry
3411 * If @dev failed FLUSH, it needs to be reported upper layer
3412 * immediately as it means that @dev failed to remap and already
3413 * lost at least a sector and further FLUSH retrials won't make
3414 * any difference to the lost sector. However, if FLUSH failed
3415 * for other reasons, for example transmission error, FLUSH needs
3418 * This function determines whether FLUSH failure retry is
3419 * necessary and performs it if so.
3422 * 0 if EH can continue, -errno if EH needs to be repeated.
3424 static int ata_eh_maybe_retry_flush(struct ata_device
*dev
)
3426 struct ata_link
*link
= dev
->link
;
3427 struct ata_port
*ap
= link
->ap
;
3428 struct ata_queued_cmd
*qc
;
3429 struct ata_taskfile tf
;
3430 unsigned int err_mask
;
3433 /* did flush fail for this device? */
3434 if (!ata_tag_valid(link
->active_tag
))
3437 qc
= __ata_qc_from_tag(ap
, link
->active_tag
);
3438 if (qc
->dev
!= dev
|| (qc
->tf
.command
!= ATA_CMD_FLUSH_EXT
&&
3439 qc
->tf
.command
!= ATA_CMD_FLUSH
))
3442 /* if the device failed it, it should be reported to upper layers */
3443 if (qc
->err_mask
& AC_ERR_DEV
)
3446 /* flush failed for some other reason, give it another shot */
3447 ata_tf_init(dev
, &tf
);
3449 tf
.command
= qc
->tf
.command
;
3450 tf
.flags
|= ATA_TFLAG_DEVICE
;
3451 tf
.protocol
= ATA_PROT_NODATA
;
3453 ata_dev_warn(dev
, "retrying FLUSH 0x%x Emask 0x%x\n",
3454 tf
.command
, qc
->err_mask
);
3456 err_mask
= ata_exec_internal(dev
, &tf
, NULL
, DMA_NONE
, NULL
, 0, 0);
3459 * FLUSH is complete but there's no way to
3460 * successfully complete a failed command from EH.
3461 * Making sure retry is allowed at least once and
3462 * retrying it should do the trick - whatever was in
3463 * the cache is already on the platter and this won't
3464 * cause infinite loop.
3466 qc
->scsicmd
->allowed
= max(qc
->scsicmd
->allowed
, 1);
3468 ata_dev_warn(dev
, "FLUSH failed Emask 0x%x\n",
3472 /* if device failed it, report it to upper layers */
3473 if (err_mask
& AC_ERR_DEV
) {
3474 qc
->err_mask
|= AC_ERR_DEV
;
3476 if (!(ap
->pflags
& ATA_PFLAG_FROZEN
))
3484 * ata_eh_set_lpm - configure SATA interface power management
3485 * @link: link to configure power management
3486 * @policy: the link power management policy
3487 * @r_failed_dev: out parameter for failed device
3489 * Enable SATA Interface power management. This will enable
3490 * Device Interface Power Management (DIPM) for min_power
3491 * policy, and then call driver specific callbacks for
3492 * enabling Host Initiated Power management.
3498 * 0 on success, -errno on failure.
3500 static int ata_eh_set_lpm(struct ata_link
*link
, enum ata_lpm_policy policy
,
3501 struct ata_device
**r_failed_dev
)
3503 struct ata_port
*ap
= ata_is_host_link(link
) ? link
->ap
: NULL
;
3504 struct ata_eh_context
*ehc
= &link
->eh_context
;
3505 struct ata_device
*dev
, *link_dev
= NULL
, *lpm_dev
= NULL
;
3506 enum ata_lpm_policy old_policy
= link
->lpm_policy
;
3507 bool no_dipm
= link
->ap
->flags
& ATA_FLAG_NO_DIPM
;
3508 unsigned int hints
= ATA_LPM_EMPTY
| ATA_LPM_HIPM
;
3509 unsigned int err_mask
;
3512 /* if the link or host doesn't do LPM, noop */
3513 if ((link
->flags
& ATA_LFLAG_NO_LPM
) || (ap
&& !ap
->ops
->set_lpm
))
3517 * DIPM is enabled only for MIN_POWER as some devices
3518 * misbehave when the host NACKs transition to SLUMBER. Order
3519 * device and link configurations such that the host always
3520 * allows DIPM requests.
3522 ata_for_each_dev(dev
, link
, ENABLED
) {
3523 bool hipm
= ata_id_has_hipm(dev
->id
);
3524 bool dipm
= ata_id_has_dipm(dev
->id
) && !no_dipm
;
3526 /* find the first enabled and LPM enabled devices */
3530 if (!lpm_dev
&& (hipm
|| dipm
))
3533 hints
&= ~ATA_LPM_EMPTY
;
3535 hints
&= ~ATA_LPM_HIPM
;
3537 /* disable DIPM before changing link config */
3538 if (policy
!= ATA_LPM_MIN_POWER
&& dipm
) {
3539 err_mask
= ata_dev_set_feature(dev
,
3540 SETFEATURES_SATA_DISABLE
, SATA_DIPM
);
3541 if (err_mask
&& err_mask
!= AC_ERR_DEV
) {
3543 "failed to disable DIPM, Emask 0x%x\n",
3552 rc
= ap
->ops
->set_lpm(link
, policy
, hints
);
3553 if (!rc
&& ap
->slave_link
)
3554 rc
= ap
->ops
->set_lpm(ap
->slave_link
, policy
, hints
);
3556 rc
= sata_pmp_set_lpm(link
, policy
, hints
);
3559 * Attribute link config failure to the first (LPM) enabled
3560 * device on the link.
3563 if (rc
== -EOPNOTSUPP
) {
3564 link
->flags
|= ATA_LFLAG_NO_LPM
;
3567 dev
= lpm_dev
? lpm_dev
: link_dev
;
3572 * Low level driver acked the transition. Issue DIPM command
3573 * with the new policy set.
3575 link
->lpm_policy
= policy
;
3576 if (ap
&& ap
->slave_link
)
3577 ap
->slave_link
->lpm_policy
= policy
;
3579 /* host config updated, enable DIPM if transitioning to MIN_POWER */
3580 ata_for_each_dev(dev
, link
, ENABLED
) {
3581 if (policy
== ATA_LPM_MIN_POWER
&& !no_dipm
&&
3582 ata_id_has_dipm(dev
->id
)) {
3583 err_mask
= ata_dev_set_feature(dev
,
3584 SETFEATURES_SATA_ENABLE
, SATA_DIPM
);
3585 if (err_mask
&& err_mask
!= AC_ERR_DEV
) {
3587 "failed to enable DIPM, Emask 0x%x\n",
3598 /* restore the old policy */
3599 link
->lpm_policy
= old_policy
;
3600 if (ap
&& ap
->slave_link
)
3601 ap
->slave_link
->lpm_policy
= old_policy
;
3603 /* if no device or only one more chance is left, disable LPM */
3604 if (!dev
|| ehc
->tries
[dev
->devno
] <= 2) {
3605 ata_link_warn(link
, "disabling LPM on the link\n");
3606 link
->flags
|= ATA_LFLAG_NO_LPM
;
3609 *r_failed_dev
= dev
;
3613 int ata_link_nr_enabled(struct ata_link
*link
)
3615 struct ata_device
*dev
;
3618 ata_for_each_dev(dev
, link
, ENABLED
)
3623 static int ata_link_nr_vacant(struct ata_link
*link
)
3625 struct ata_device
*dev
;
3628 ata_for_each_dev(dev
, link
, ALL
)
3629 if (dev
->class == ATA_DEV_UNKNOWN
)
3634 static int ata_eh_skip_recovery(struct ata_link
*link
)
3636 struct ata_port
*ap
= link
->ap
;
3637 struct ata_eh_context
*ehc
= &link
->eh_context
;
3638 struct ata_device
*dev
;
3640 /* skip disabled links */
3641 if (link
->flags
& ATA_LFLAG_DISABLED
)
3644 /* skip if explicitly requested */
3645 if (ehc
->i
.flags
& ATA_EHI_NO_RECOVERY
)
3648 /* thaw frozen port and recover failed devices */
3649 if ((ap
->pflags
& ATA_PFLAG_FROZEN
) || ata_link_nr_enabled(link
))
3652 /* reset at least once if reset is requested */
3653 if ((ehc
->i
.action
& ATA_EH_RESET
) &&
3654 !(ehc
->i
.flags
& ATA_EHI_DID_RESET
))
3657 /* skip if class codes for all vacant slots are ATA_DEV_NONE */
3658 ata_for_each_dev(dev
, link
, ALL
) {
3659 if (dev
->class == ATA_DEV_UNKNOWN
&&
3660 ehc
->classes
[dev
->devno
] != ATA_DEV_NONE
)
3667 static int ata_count_probe_trials_cb(struct ata_ering_entry
*ent
, void *void_arg
)
3669 u64 interval
= msecs_to_jiffies(ATA_EH_PROBE_TRIAL_INTERVAL
);
3670 u64 now
= get_jiffies_64();
3671 int *trials
= void_arg
;
3673 if ((ent
->eflags
& ATA_EFLAG_OLD_ER
) ||
3674 (ent
->timestamp
< now
- min(now
, interval
)))
3681 static int ata_eh_schedule_probe(struct ata_device
*dev
)
3683 struct ata_eh_context
*ehc
= &dev
->link
->eh_context
;
3684 struct ata_link
*link
= ata_dev_phys_link(dev
);
3687 if (!(ehc
->i
.probe_mask
& (1 << dev
->devno
)) ||
3688 (ehc
->did_probe_mask
& (1 << dev
->devno
)))
3691 ata_eh_detach_dev(dev
);
3693 ehc
->did_probe_mask
|= (1 << dev
->devno
);
3694 ehc
->i
.action
|= ATA_EH_RESET
;
3695 ehc
->saved_xfer_mode
[dev
->devno
] = 0;
3696 ehc
->saved_ncq_enabled
&= ~(1 << dev
->devno
);
3698 /* the link maybe in a deep sleep, wake it up */
3699 if (link
->lpm_policy
> ATA_LPM_MAX_POWER
) {
3700 if (ata_is_host_link(link
))
3701 link
->ap
->ops
->set_lpm(link
, ATA_LPM_MAX_POWER
,
3704 sata_pmp_set_lpm(link
, ATA_LPM_MAX_POWER
,
3708 /* Record and count probe trials on the ering. The specific
3709 * error mask used is irrelevant. Because a successful device
3710 * detection clears the ering, this count accumulates only if
3711 * there are consecutive failed probes.
3713 * If the count is equal to or higher than ATA_EH_PROBE_TRIALS
3714 * in the last ATA_EH_PROBE_TRIAL_INTERVAL, link speed is
3715 * forced to 1.5Gbps.
3717 * This is to work around cases where failed link speed
3718 * negotiation results in device misdetection leading to
3719 * infinite DEVXCHG or PHRDY CHG events.
3721 ata_ering_record(&dev
->ering
, 0, AC_ERR_OTHER
);
3722 ata_ering_map(&dev
->ering
, ata_count_probe_trials_cb
, &trials
);
3724 if (trials
> ATA_EH_PROBE_TRIALS
)
3725 sata_down_spd_limit(link
, 1);
3730 static int ata_eh_handle_dev_fail(struct ata_device
*dev
, int err
)
3732 struct ata_eh_context
*ehc
= &dev
->link
->eh_context
;
3734 /* -EAGAIN from EH routine indicates retry without prejudice.
3735 * The requester is responsible for ensuring forward progress.
3738 ehc
->tries
[dev
->devno
]--;
3742 /* device missing or wrong IDENTIFY data, schedule probing */
3743 ehc
->i
.probe_mask
|= (1 << dev
->devno
);
3745 /* give it just one more chance */
3746 ehc
->tries
[dev
->devno
] = min(ehc
->tries
[dev
->devno
], 1);
3748 if (ehc
->tries
[dev
->devno
] == 1) {
3749 /* This is the last chance, better to slow
3750 * down than lose it.
3752 sata_down_spd_limit(ata_dev_phys_link(dev
), 0);
3753 if (dev
->pio_mode
> XFER_PIO_0
)
3754 ata_down_xfermask_limit(dev
, ATA_DNXFER_PIO
);
3758 if (ata_dev_enabled(dev
) && !ehc
->tries
[dev
->devno
]) {
3759 /* disable device if it has used up all its chances */
3760 ata_dev_disable(dev
);
3762 /* detach if offline */
3763 if (ata_phys_link_offline(ata_dev_phys_link(dev
)))
3764 ata_eh_detach_dev(dev
);
3766 /* schedule probe if necessary */
3767 if (ata_eh_schedule_probe(dev
)) {
3768 ehc
->tries
[dev
->devno
] = ATA_EH_DEV_TRIES
;
3769 memset(ehc
->cmd_timeout_idx
[dev
->devno
], 0,
3770 sizeof(ehc
->cmd_timeout_idx
[dev
->devno
]));
3775 ehc
->i
.action
|= ATA_EH_RESET
;
3781 * ata_eh_recover - recover host port after error
3782 * @ap: host port to recover
3783 * @prereset: prereset method (can be NULL)
3784 * @softreset: softreset method (can be NULL)
3785 * @hardreset: hardreset method (can be NULL)
3786 * @postreset: postreset method (can be NULL)
3787 * @r_failed_link: out parameter for failed link
3789 * This is the alpha and omega, eum and yang, heart and soul of
3790 * libata exception handling. On entry, actions required to
3791 * recover each link and hotplug requests are recorded in the
3792 * link's eh_context. This function executes all the operations
3793 * with appropriate retrials and fallbacks to resurrect failed
3794 * devices, detach goners and greet newcomers.
3797 * Kernel thread context (may sleep).
3800 * 0 on success, -errno on failure.
3802 int ata_eh_recover(struct ata_port
*ap
, ata_prereset_fn_t prereset
,
3803 ata_reset_fn_t softreset
, ata_reset_fn_t hardreset
,
3804 ata_postreset_fn_t postreset
,
3805 struct ata_link
**r_failed_link
)
3807 struct ata_link
*link
;
3808 struct ata_device
*dev
;
3810 unsigned long flags
, deadline
;
3814 /* prep for recovery */
3815 ata_for_each_link(link
, ap
, EDGE
) {
3816 struct ata_eh_context
*ehc
= &link
->eh_context
;
3818 /* re-enable link? */
3819 if (ehc
->i
.action
& ATA_EH_ENABLE_LINK
) {
3820 ata_eh_about_to_do(link
, NULL
, ATA_EH_ENABLE_LINK
);
3821 spin_lock_irqsave(ap
->lock
, flags
);
3822 link
->flags
&= ~ATA_LFLAG_DISABLED
;
3823 spin_unlock_irqrestore(ap
->lock
, flags
);
3824 ata_eh_done(link
, NULL
, ATA_EH_ENABLE_LINK
);
3827 ata_for_each_dev(dev
, link
, ALL
) {
3828 if (link
->flags
& ATA_LFLAG_NO_RETRY
)
3829 ehc
->tries
[dev
->devno
] = 1;
3831 ehc
->tries
[dev
->devno
] = ATA_EH_DEV_TRIES
;
3833 /* collect port action mask recorded in dev actions */
3834 ehc
->i
.action
|= ehc
->i
.dev_action
[dev
->devno
] &
3835 ~ATA_EH_PERDEV_MASK
;
3836 ehc
->i
.dev_action
[dev
->devno
] &= ATA_EH_PERDEV_MASK
;
3838 /* process hotplug request */
3839 if (dev
->flags
& ATA_DFLAG_DETACH
)
3840 ata_eh_detach_dev(dev
);
3842 /* schedule probe if necessary */
3843 if (!ata_dev_enabled(dev
))
3844 ata_eh_schedule_probe(dev
);
3851 /* if UNLOADING, finish immediately */
3852 if (ap
->pflags
& ATA_PFLAG_UNLOADING
)
3856 ata_for_each_link(link
, ap
, EDGE
) {
3857 struct ata_eh_context
*ehc
= &link
->eh_context
;
3859 /* skip EH if possible. */
3860 if (ata_eh_skip_recovery(link
))
3863 ata_for_each_dev(dev
, link
, ALL
)
3864 ehc
->classes
[dev
->devno
] = ATA_DEV_UNKNOWN
;
3868 ata_for_each_link(link
, ap
, EDGE
) {
3869 struct ata_eh_context
*ehc
= &link
->eh_context
;
3871 if (!(ehc
->i
.action
& ATA_EH_RESET
))
3874 rc
= ata_eh_reset(link
, ata_link_nr_vacant(link
),
3875 prereset
, softreset
, hardreset
, postreset
);
3877 ata_link_err(link
, "reset failed, giving up\n");
3886 * clears ATA_EH_PARK in eh_info and resets
3887 * ap->park_req_pending
3889 ata_eh_pull_park_action(ap
);
3892 ata_for_each_link(link
, ap
, EDGE
) {
3893 ata_for_each_dev(dev
, link
, ALL
) {
3894 struct ata_eh_context
*ehc
= &link
->eh_context
;
3897 if (dev
->class != ATA_DEV_ATA
&&
3898 dev
->class != ATA_DEV_ZAC
)
3900 if (!(ehc
->i
.dev_action
[dev
->devno
] &
3903 tmp
= dev
->unpark_deadline
;
3904 if (time_before(deadline
, tmp
))
3906 else if (time_before_eq(tmp
, jiffies
))
3908 if (ehc
->unloaded_mask
& (1 << dev
->devno
))
3911 ata_eh_park_issue_cmd(dev
, 1);
3916 if (time_before_eq(deadline
, now
))
3920 deadline
= wait_for_completion_timeout(&ap
->park_req_pending
,
3924 ata_for_each_link(link
, ap
, EDGE
) {
3925 ata_for_each_dev(dev
, link
, ALL
) {
3926 if (!(link
->eh_context
.unloaded_mask
&
3930 ata_eh_park_issue_cmd(dev
, 0);
3931 ata_eh_done(link
, dev
, ATA_EH_PARK
);
3937 ata_for_each_link(link
, ap
, PMP_FIRST
) {
3938 struct ata_eh_context
*ehc
= &link
->eh_context
;
3940 if (sata_pmp_attached(ap
) && ata_is_host_link(link
))
3943 /* revalidate existing devices and attach new ones */
3944 rc
= ata_eh_revalidate_and_attach(link
, &dev
);
3948 /* if PMP got attached, return, pmp EH will take care of it */
3949 if (link
->device
->class == ATA_DEV_PMP
) {
3954 /* configure transfer mode if necessary */
3955 if (ehc
->i
.flags
& ATA_EHI_SETMODE
) {
3956 rc
= ata_set_mode(link
, &dev
);
3959 ehc
->i
.flags
&= ~ATA_EHI_SETMODE
;
3962 /* If reset has been issued, clear UA to avoid
3963 * disrupting the current users of the device.
3965 if (ehc
->i
.flags
& ATA_EHI_DID_RESET
) {
3966 ata_for_each_dev(dev
, link
, ALL
) {
3967 if (dev
->class != ATA_DEV_ATAPI
)
3969 rc
= atapi_eh_clear_ua(dev
);
3972 if (zpodd_dev_enabled(dev
))
3973 zpodd_post_poweron(dev
);
3977 /* retry flush if necessary */
3978 ata_for_each_dev(dev
, link
, ALL
) {
3979 if (dev
->class != ATA_DEV_ATA
&&
3980 dev
->class != ATA_DEV_ZAC
)
3982 rc
= ata_eh_maybe_retry_flush(dev
);
3988 /* configure link power saving */
3989 if (link
->lpm_policy
!= ap
->target_lpm_policy
) {
3990 rc
= ata_eh_set_lpm(link
, ap
->target_lpm_policy
, &dev
);
3995 /* this link is okay now */
4002 ata_eh_handle_dev_fail(dev
, rc
);
4004 if (ap
->pflags
& ATA_PFLAG_FROZEN
) {
4005 /* PMP reset requires working host port.
4006 * Can't retry if it's frozen.
4008 if (sata_pmp_attached(ap
))
4018 if (rc
&& r_failed_link
)
4019 *r_failed_link
= link
;
4021 DPRINTK("EXIT, rc=%d\n", rc
);
4026 * ata_eh_finish - finish up EH
4027 * @ap: host port to finish EH for
4029 * Recovery is complete. Clean up EH states and retry or finish
4035 void ata_eh_finish(struct ata_port
*ap
)
4039 /* retry or finish qcs */
4040 for (tag
= 0; tag
< ATA_MAX_QUEUE
; tag
++) {
4041 struct ata_queued_cmd
*qc
= __ata_qc_from_tag(ap
, tag
);
4043 if (!(qc
->flags
& ATA_QCFLAG_FAILED
))
4047 /* FIXME: Once EH migration is complete,
4048 * generate sense data in this function,
4049 * considering both err_mask and tf.
4051 if (qc
->flags
& ATA_QCFLAG_RETRY
)
4052 ata_eh_qc_retry(qc
);
4054 ata_eh_qc_complete(qc
);
4056 if (qc
->flags
& ATA_QCFLAG_SENSE_VALID
) {
4057 ata_eh_qc_complete(qc
);
4059 /* feed zero TF to sense generation */
4060 memset(&qc
->result_tf
, 0, sizeof(qc
->result_tf
));
4061 ata_eh_qc_retry(qc
);
4066 /* make sure nr_active_links is zero after EH */
4067 WARN_ON(ap
->nr_active_links
);
4068 ap
->nr_active_links
= 0;
4072 * ata_do_eh - do standard error handling
4073 * @ap: host port to handle error for
4075 * @prereset: prereset method (can be NULL)
4076 * @softreset: softreset method (can be NULL)
4077 * @hardreset: hardreset method (can be NULL)
4078 * @postreset: postreset method (can be NULL)
4080 * Perform standard error handling sequence.
4083 * Kernel thread context (may sleep).
4085 void ata_do_eh(struct ata_port
*ap
, ata_prereset_fn_t prereset
,
4086 ata_reset_fn_t softreset
, ata_reset_fn_t hardreset
,
4087 ata_postreset_fn_t postreset
)
4089 struct ata_device
*dev
;
4095 rc
= ata_eh_recover(ap
, prereset
, softreset
, hardreset
, postreset
,
4098 ata_for_each_dev(dev
, &ap
->link
, ALL
)
4099 ata_dev_disable(dev
);
4106 * ata_std_error_handler - standard error handler
4107 * @ap: host port to handle error for
4109 * Standard error handler
4112 * Kernel thread context (may sleep).
4114 void ata_std_error_handler(struct ata_port
*ap
)
4116 struct ata_port_operations
*ops
= ap
->ops
;
4117 ata_reset_fn_t hardreset
= ops
->hardreset
;
4119 /* ignore built-in hardreset if SCR access is not available */
4120 if (hardreset
== sata_std_hardreset
&& !sata_scr_valid(&ap
->link
))
4123 ata_do_eh(ap
, ops
->prereset
, ops
->softreset
, hardreset
, ops
->postreset
);
4128 * ata_eh_handle_port_suspend - perform port suspend operation
4129 * @ap: port to suspend
4134 * Kernel thread context (may sleep).
4136 static void ata_eh_handle_port_suspend(struct ata_port
*ap
)
4138 unsigned long flags
;
4140 struct ata_device
*dev
;
4142 /* are we suspending? */
4143 spin_lock_irqsave(ap
->lock
, flags
);
4144 if (!(ap
->pflags
& ATA_PFLAG_PM_PENDING
) ||
4145 ap
->pm_mesg
.event
& PM_EVENT_RESUME
) {
4146 spin_unlock_irqrestore(ap
->lock
, flags
);
4149 spin_unlock_irqrestore(ap
->lock
, flags
);
4151 WARN_ON(ap
->pflags
& ATA_PFLAG_SUSPENDED
);
4154 * If we have a ZPODD attached, check its zero
4155 * power ready status before the port is frozen.
4156 * Only needed for runtime suspend.
4158 if (PMSG_IS_AUTO(ap
->pm_mesg
)) {
4159 ata_for_each_dev(dev
, &ap
->link
, ENABLED
) {
4160 if (zpodd_dev_enabled(dev
))
4161 zpodd_on_suspend(dev
);
4165 /* tell ACPI we're suspending */
4166 rc
= ata_acpi_on_suspend(ap
);
4171 ata_eh_freeze_port(ap
);
4173 if (ap
->ops
->port_suspend
)
4174 rc
= ap
->ops
->port_suspend(ap
, ap
->pm_mesg
);
4176 ata_acpi_set_state(ap
, ap
->pm_mesg
);
4178 /* update the flags */
4179 spin_lock_irqsave(ap
->lock
, flags
);
4181 ap
->pflags
&= ~ATA_PFLAG_PM_PENDING
;
4183 ap
->pflags
|= ATA_PFLAG_SUSPENDED
;
4184 else if (ap
->pflags
& ATA_PFLAG_FROZEN
)
4185 ata_port_schedule_eh(ap
);
4187 spin_unlock_irqrestore(ap
->lock
, flags
);
4193 * ata_eh_handle_port_resume - perform port resume operation
4194 * @ap: port to resume
4199 * Kernel thread context (may sleep).
4201 static void ata_eh_handle_port_resume(struct ata_port
*ap
)
4203 struct ata_link
*link
;
4204 struct ata_device
*dev
;
4205 unsigned long flags
;
4208 /* are we resuming? */
4209 spin_lock_irqsave(ap
->lock
, flags
);
4210 if (!(ap
->pflags
& ATA_PFLAG_PM_PENDING
) ||
4211 !(ap
->pm_mesg
.event
& PM_EVENT_RESUME
)) {
4212 spin_unlock_irqrestore(ap
->lock
, flags
);
4215 spin_unlock_irqrestore(ap
->lock
, flags
);
4217 WARN_ON(!(ap
->pflags
& ATA_PFLAG_SUSPENDED
));
4220 * Error timestamps are in jiffies which doesn't run while
4221 * suspended and PHY events during resume isn't too uncommon.
4222 * When the two are combined, it can lead to unnecessary speed
4223 * downs if the machine is suspended and resumed repeatedly.
4224 * Clear error history.
4226 ata_for_each_link(link
, ap
, HOST_FIRST
)
4227 ata_for_each_dev(dev
, link
, ALL
)
4228 ata_ering_clear(&dev
->ering
);
4230 ata_acpi_set_state(ap
, ap
->pm_mesg
);
4232 if (ap
->ops
->port_resume
)
4233 rc
= ap
->ops
->port_resume(ap
);
4235 /* tell ACPI that we're resuming */
4236 ata_acpi_on_resume(ap
);
4238 /* update the flags */
4239 spin_lock_irqsave(ap
->lock
, flags
);
4240 ap
->pflags
&= ~(ATA_PFLAG_PM_PENDING
| ATA_PFLAG_SUSPENDED
);
4241 spin_unlock_irqrestore(ap
->lock
, flags
);
4243 #endif /* CONFIG_PM */