1 // SPDX-License-Identifier: GPL-2.0 2 /* 3 * Functions related to generic timeout handling of requests. 4 */ 5 #include <linux/kernel.h> 6 #include <linux/module.h> 7 #include <linux/blkdev.h> 8 #include <linux/fault-inject.h> 9 10 #include "blk.h" 11 #include "blk-mq.h" 12 13 #ifdef CONFIG_FAIL_IO_TIMEOUT 14 15 static DECLARE_FAULT_ATTR(fail_io_timeout); 16 17 static int __init setup_fail_io_timeout(char *str) 18 { 19 return setup_fault_attr(&fail_io_timeout, str); 20 } 21 __setup("fail_io_timeout=", setup_fail_io_timeout); 22 23 bool __blk_should_fake_timeout(struct request_queue *q) 24 { 25 return should_fail(&fail_io_timeout, 1); 26 } 27 EXPORT_SYMBOL_GPL(__blk_should_fake_timeout); 28 29 static int __init fail_io_timeout_debugfs(void) 30 { 31 struct dentry *dir = fault_create_debugfs_attr("fail_io_timeout", 32 NULL, &fail_io_timeout); 33 34 return PTR_ERR_OR_ZERO(dir); 35 } 36 37 late_initcall(fail_io_timeout_debugfs); 38 39 ssize_t part_timeout_show(struct device *dev, struct device_attribute *attr, 40 char *buf) 41 { 42 struct gendisk *disk = dev_to_disk(dev); 43 int set = test_bit(QUEUE_FLAG_FAIL_IO, &disk->queue->queue_flags); 44 45 return sprintf(buf, "%d\n", set != 0); 46 } 47 48 ssize_t part_timeout_store(struct device *dev, struct device_attribute *attr, 49 const char *buf, size_t count) 50 { 51 struct gendisk *disk = dev_to_disk(dev); 52 int val; 53 54 if (count) { 55 struct request_queue *q = disk->queue; 56 char *p = (char *) buf; 57 58 val = simple_strtoul(p, &p, 10); 59 if (val) 60 blk_queue_flag_set(QUEUE_FLAG_FAIL_IO, q); 61 else 62 blk_queue_flag_clear(QUEUE_FLAG_FAIL_IO, q); 63 } 64 65 return count; 66 } 67 68 #endif /* CONFIG_FAIL_IO_TIMEOUT */ 69 70 /** 71 * blk_abort_request -- Request request recovery for the specified command 72 * @req: pointer to the request of interest 73 * 74 * This function requests that the block layer start recovery for the 75 * request by deleting the timer and calling the q's timeout function. 76 * LLDDs who implement their own error recovery MAY ignore the timeout 77 * event if they generated blk_abort_request. 78 */ 79 void blk_abort_request(struct request *req) 80 { 81 /* 82 * All we need to ensure is that timeout scan takes place 83 * immediately and that scan sees the new timeout value. 84 * No need for fancy synchronizations. 85 */ 86 WRITE_ONCE(req->deadline, jiffies); 87 kblockd_schedule_work(&req->q->timeout_work); 88 } 89 EXPORT_SYMBOL_GPL(blk_abort_request); 90 91 unsigned long blk_rq_timeout(unsigned long timeout) 92 { 93 unsigned long maxt; 94 95 maxt = round_jiffies_up(jiffies + BLK_MAX_TIMEOUT); 96 if (time_after(timeout, maxt)) 97 timeout = maxt; 98 99 return timeout; 100 } 101 102 /** 103 * blk_add_timer - Start timeout timer for a single request 104 * @req: request that is about to start running. 105 * 106 * Notes: 107 * Each request has its own timer, and as it is added to the queue, we 108 * set up the timer. When the request completes, we cancel the timer. 109 */ 110 void blk_add_timer(struct request *req) 111 { 112 struct request_queue *q = req->q; 113 unsigned long expiry; 114 115 /* 116 * Some LLDs, like scsi, peek at the timeout to prevent a 117 * command from being retried forever. 118 */ 119 if (!req->timeout) 120 req->timeout = q->rq_timeout; 121 122 req->rq_flags &= ~RQF_TIMED_OUT; 123 124 expiry = jiffies + req->timeout; 125 WRITE_ONCE(req->deadline, expiry); 126 127 /* 128 * If the timer isn't already pending or this timeout is earlier 129 * than an existing one, modify the timer. Round up to next nearest 130 * second. 131 */ 132 expiry = blk_rq_timeout(round_jiffies_up(expiry)); 133 134 if (!timer_pending(&q->timeout) || 135 time_before(expiry, q->timeout.expires)) { 136 unsigned long diff = q->timeout.expires - expiry; 137 138 /* 139 * Due to added timer slack to group timers, the timer 140 * will often be a little in front of what we asked for. 141 * So apply some tolerance here too, otherwise we keep 142 * modifying the timer because expires for value X 143 * will be X + something. 144 */ 145 if (!timer_pending(&q->timeout) || (diff >= HZ / 2)) 146 mod_timer(&q->timeout, expiry); 147 } 148 149 } 150