Loading...
1/*
2 * scsi_pm.c Copyright (C) 2010 Alan Stern
3 *
4 * SCSI dynamic Power Management
5 * Initial version: Alan Stern <stern@rowland.harvard.edu>
6 */
7
8#include <linux/pm_runtime.h>
9#include <linux/export.h>
10#include <linux/async.h>
11
12#include <scsi/scsi.h>
13#include <scsi/scsi_device.h>
14#include <scsi/scsi_driver.h>
15#include <scsi/scsi_host.h>
16
17#include "scsi_priv.h"
18
19#ifdef CONFIG_PM_SLEEP
20
21static int do_scsi_suspend(struct device *dev, const struct dev_pm_ops *pm)
22{
23 return pm && pm->suspend ? pm->suspend(dev) : 0;
24}
25
26static int do_scsi_freeze(struct device *dev, const struct dev_pm_ops *pm)
27{
28 return pm && pm->freeze ? pm->freeze(dev) : 0;
29}
30
31static int do_scsi_poweroff(struct device *dev, const struct dev_pm_ops *pm)
32{
33 return pm && pm->poweroff ? pm->poweroff(dev) : 0;
34}
35
36static int do_scsi_resume(struct device *dev, const struct dev_pm_ops *pm)
37{
38 return pm && pm->resume ? pm->resume(dev) : 0;
39}
40
41static int do_scsi_thaw(struct device *dev, const struct dev_pm_ops *pm)
42{
43 return pm && pm->thaw ? pm->thaw(dev) : 0;
44}
45
46static int do_scsi_restore(struct device *dev, const struct dev_pm_ops *pm)
47{
48 return pm && pm->restore ? pm->restore(dev) : 0;
49}
50
51static int scsi_dev_type_suspend(struct device *dev,
52 int (*cb)(struct device *, const struct dev_pm_ops *))
53{
54 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
55 int err;
56
57 /* flush pending in-flight resume operations, suspend is synchronous */
58 async_synchronize_full_domain(&scsi_sd_pm_domain);
59
60 err = scsi_device_quiesce(to_scsi_device(dev));
61 if (err == 0) {
62 err = cb(dev, pm);
63 if (err)
64 scsi_device_resume(to_scsi_device(dev));
65 }
66 dev_dbg(dev, "scsi suspend: %d\n", err);
67 return err;
68}
69
70static int scsi_dev_type_resume(struct device *dev,
71 int (*cb)(struct device *, const struct dev_pm_ops *))
72{
73 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
74 int err = 0;
75
76 err = cb(dev, pm);
77 scsi_device_resume(to_scsi_device(dev));
78 dev_dbg(dev, "scsi resume: %d\n", err);
79
80 if (err == 0) {
81 pm_runtime_disable(dev);
82 pm_runtime_set_active(dev);
83 pm_runtime_enable(dev);
84 }
85
86 return err;
87}
88
89static int
90scsi_bus_suspend_common(struct device *dev,
91 int (*cb)(struct device *, const struct dev_pm_ops *))
92{
93 int err = 0;
94
95 if (scsi_is_sdev_device(dev)) {
96 /*
97 * All the high-level SCSI drivers that implement runtime
98 * PM treat runtime suspend, system suspend, and system
99 * hibernate nearly identically. In all cases the requirements
100 * for runtime suspension are stricter.
101 */
102 if (pm_runtime_suspended(dev))
103 return 0;
104
105 err = scsi_dev_type_suspend(dev, cb);
106 }
107
108 return err;
109}
110
111static void async_sdev_resume(void *dev, async_cookie_t cookie)
112{
113 scsi_dev_type_resume(dev, do_scsi_resume);
114}
115
116static void async_sdev_thaw(void *dev, async_cookie_t cookie)
117{
118 scsi_dev_type_resume(dev, do_scsi_thaw);
119}
120
121static void async_sdev_restore(void *dev, async_cookie_t cookie)
122{
123 scsi_dev_type_resume(dev, do_scsi_restore);
124}
125
126static int scsi_bus_resume_common(struct device *dev,
127 int (*cb)(struct device *, const struct dev_pm_ops *))
128{
129 async_func_t fn;
130
131 if (!scsi_is_sdev_device(dev))
132 fn = NULL;
133 else if (cb == do_scsi_resume)
134 fn = async_sdev_resume;
135 else if (cb == do_scsi_thaw)
136 fn = async_sdev_thaw;
137 else if (cb == do_scsi_restore)
138 fn = async_sdev_restore;
139 else
140 fn = NULL;
141
142 if (fn) {
143 async_schedule_domain(fn, dev, &scsi_sd_pm_domain);
144
145 /*
146 * If a user has disabled async probing a likely reason
147 * is due to a storage enclosure that does not inject
148 * staggered spin-ups. For safety, make resume
149 * synchronous as well in that case.
150 */
151 if (strncmp(scsi_scan_type, "async", 5) != 0)
152 async_synchronize_full_domain(&scsi_sd_pm_domain);
153 } else {
154 pm_runtime_disable(dev);
155 pm_runtime_set_active(dev);
156 pm_runtime_enable(dev);
157 }
158 return 0;
159}
160
161static int scsi_bus_prepare(struct device *dev)
162{
163 if (scsi_is_sdev_device(dev)) {
164 /* sd probing uses async_schedule. Wait until it finishes. */
165 async_synchronize_full_domain(&scsi_sd_probe_domain);
166
167 } else if (scsi_is_host_device(dev)) {
168 /* Wait until async scanning is finished */
169 scsi_complete_async_scans();
170 }
171 return 0;
172}
173
174static int scsi_bus_suspend(struct device *dev)
175{
176 return scsi_bus_suspend_common(dev, do_scsi_suspend);
177}
178
179static int scsi_bus_resume(struct device *dev)
180{
181 return scsi_bus_resume_common(dev, do_scsi_resume);
182}
183
184static int scsi_bus_freeze(struct device *dev)
185{
186 return scsi_bus_suspend_common(dev, do_scsi_freeze);
187}
188
189static int scsi_bus_thaw(struct device *dev)
190{
191 return scsi_bus_resume_common(dev, do_scsi_thaw);
192}
193
194static int scsi_bus_poweroff(struct device *dev)
195{
196 return scsi_bus_suspend_common(dev, do_scsi_poweroff);
197}
198
199static int scsi_bus_restore(struct device *dev)
200{
201 return scsi_bus_resume_common(dev, do_scsi_restore);
202}
203
204#else /* CONFIG_PM_SLEEP */
205
206#define scsi_bus_prepare NULL
207#define scsi_bus_suspend NULL
208#define scsi_bus_resume NULL
209#define scsi_bus_freeze NULL
210#define scsi_bus_thaw NULL
211#define scsi_bus_poweroff NULL
212#define scsi_bus_restore NULL
213
214#endif /* CONFIG_PM_SLEEP */
215
216#ifdef CONFIG_PM_RUNTIME
217
218static int sdev_runtime_suspend(struct device *dev)
219{
220 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
221 struct scsi_device *sdev = to_scsi_device(dev);
222 int err;
223
224 err = blk_pre_runtime_suspend(sdev->request_queue);
225 if (err)
226 return err;
227 if (pm && pm->runtime_suspend)
228 err = pm->runtime_suspend(dev);
229 blk_post_runtime_suspend(sdev->request_queue, err);
230
231 return err;
232}
233
234static int scsi_runtime_suspend(struct device *dev)
235{
236 int err = 0;
237
238 dev_dbg(dev, "scsi_runtime_suspend\n");
239 if (scsi_is_sdev_device(dev))
240 err = sdev_runtime_suspend(dev);
241
242 /* Insert hooks here for targets, hosts, and transport classes */
243
244 return err;
245}
246
247static int sdev_runtime_resume(struct device *dev)
248{
249 struct scsi_device *sdev = to_scsi_device(dev);
250 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
251 int err = 0;
252
253 blk_pre_runtime_resume(sdev->request_queue);
254 if (pm && pm->runtime_resume)
255 err = pm->runtime_resume(dev);
256 blk_post_runtime_resume(sdev->request_queue, err);
257
258 return err;
259}
260
261static int scsi_runtime_resume(struct device *dev)
262{
263 int err = 0;
264
265 dev_dbg(dev, "scsi_runtime_resume\n");
266 if (scsi_is_sdev_device(dev))
267 err = sdev_runtime_resume(dev);
268
269 /* Insert hooks here for targets, hosts, and transport classes */
270
271 return err;
272}
273
274static int scsi_runtime_idle(struct device *dev)
275{
276 dev_dbg(dev, "scsi_runtime_idle\n");
277
278 /* Insert hooks here for targets, hosts, and transport classes */
279
280 if (scsi_is_sdev_device(dev)) {
281 pm_runtime_mark_last_busy(dev);
282 pm_runtime_autosuspend(dev);
283 return -EBUSY;
284 }
285
286 return 0;
287}
288
289int scsi_autopm_get_device(struct scsi_device *sdev)
290{
291 int err;
292
293 err = pm_runtime_get_sync(&sdev->sdev_gendev);
294 if (err < 0 && err !=-EACCES)
295 pm_runtime_put_sync(&sdev->sdev_gendev);
296 else
297 err = 0;
298 return err;
299}
300EXPORT_SYMBOL_GPL(scsi_autopm_get_device);
301
302void scsi_autopm_put_device(struct scsi_device *sdev)
303{
304 pm_runtime_put_sync(&sdev->sdev_gendev);
305}
306EXPORT_SYMBOL_GPL(scsi_autopm_put_device);
307
308void scsi_autopm_get_target(struct scsi_target *starget)
309{
310 pm_runtime_get_sync(&starget->dev);
311}
312
313void scsi_autopm_put_target(struct scsi_target *starget)
314{
315 pm_runtime_put_sync(&starget->dev);
316}
317
318int scsi_autopm_get_host(struct Scsi_Host *shost)
319{
320 int err;
321
322 err = pm_runtime_get_sync(&shost->shost_gendev);
323 if (err < 0 && err !=-EACCES)
324 pm_runtime_put_sync(&shost->shost_gendev);
325 else
326 err = 0;
327 return err;
328}
329
330void scsi_autopm_put_host(struct Scsi_Host *shost)
331{
332 pm_runtime_put_sync(&shost->shost_gendev);
333}
334
335#else
336
337#define scsi_runtime_suspend NULL
338#define scsi_runtime_resume NULL
339#define scsi_runtime_idle NULL
340
341#endif /* CONFIG_PM_RUNTIME */
342
343const struct dev_pm_ops scsi_bus_pm_ops = {
344 .prepare = scsi_bus_prepare,
345 .suspend = scsi_bus_suspend,
346 .resume = scsi_bus_resume,
347 .freeze = scsi_bus_freeze,
348 .thaw = scsi_bus_thaw,
349 .poweroff = scsi_bus_poweroff,
350 .restore = scsi_bus_restore,
351 .runtime_suspend = scsi_runtime_suspend,
352 .runtime_resume = scsi_runtime_resume,
353 .runtime_idle = scsi_runtime_idle,
354};
1/*
2 * scsi_pm.c Copyright (C) 2010 Alan Stern
3 *
4 * SCSI dynamic Power Management
5 * Initial version: Alan Stern <stern@rowland.harvard.edu>
6 */
7
8#include <linux/pm_runtime.h>
9#include <linux/export.h>
10#include <linux/async.h>
11
12#include <scsi/scsi.h>
13#include <scsi/scsi_device.h>
14#include <scsi/scsi_driver.h>
15#include <scsi/scsi_host.h>
16
17#include "scsi_priv.h"
18
19static int scsi_dev_type_suspend(struct device *dev, pm_message_t msg)
20{
21 struct device_driver *drv;
22 int err;
23
24 err = scsi_device_quiesce(to_scsi_device(dev));
25 if (err == 0) {
26 drv = dev->driver;
27 if (drv && drv->suspend) {
28 err = drv->suspend(dev, msg);
29 if (err)
30 scsi_device_resume(to_scsi_device(dev));
31 }
32 }
33 dev_dbg(dev, "scsi suspend: %d\n", err);
34 return err;
35}
36
37static int scsi_dev_type_resume(struct device *dev)
38{
39 struct device_driver *drv;
40 int err = 0;
41
42 drv = dev->driver;
43 if (drv && drv->resume)
44 err = drv->resume(dev);
45 scsi_device_resume(to_scsi_device(dev));
46 dev_dbg(dev, "scsi resume: %d\n", err);
47 return err;
48}
49
50#ifdef CONFIG_PM_SLEEP
51
52static int scsi_bus_suspend_common(struct device *dev, pm_message_t msg)
53{
54 int err = 0;
55
56 if (scsi_is_sdev_device(dev)) {
57 /*
58 * sd is the only high-level SCSI driver to implement runtime
59 * PM, and sd treats runtime suspend, system suspend, and
60 * system hibernate identically (but not system freeze).
61 */
62 if (pm_runtime_suspended(dev)) {
63 if (msg.event == PM_EVENT_SUSPEND ||
64 msg.event == PM_EVENT_HIBERNATE)
65 return 0; /* already suspended */
66
67 /* wake up device so that FREEZE will succeed */
68 pm_runtime_resume(dev);
69 }
70 err = scsi_dev_type_suspend(dev, msg);
71 }
72 return err;
73}
74
75static int scsi_bus_resume_common(struct device *dev)
76{
77 int err = 0;
78
79 if (scsi_is_sdev_device(dev)) {
80 /*
81 * Parent device may have runtime suspended as soon as
82 * it is woken up during the system resume.
83 *
84 * Resume it on behalf of child.
85 */
86 pm_runtime_get_sync(dev->parent);
87 err = scsi_dev_type_resume(dev);
88 pm_runtime_put_sync(dev->parent);
89 }
90
91 if (err == 0) {
92 pm_runtime_disable(dev);
93 pm_runtime_set_active(dev);
94 pm_runtime_enable(dev);
95 }
96 return err;
97}
98
99static int scsi_bus_prepare(struct device *dev)
100{
101 if (scsi_is_sdev_device(dev)) {
102 /* sd probing uses async_schedule. Wait until it finishes. */
103 async_synchronize_full_domain(&scsi_sd_probe_domain);
104
105 } else if (scsi_is_host_device(dev)) {
106 /* Wait until async scanning is finished */
107 scsi_complete_async_scans();
108 }
109 return 0;
110}
111
112static int scsi_bus_suspend(struct device *dev)
113{
114 return scsi_bus_suspend_common(dev, PMSG_SUSPEND);
115}
116
117static int scsi_bus_freeze(struct device *dev)
118{
119 return scsi_bus_suspend_common(dev, PMSG_FREEZE);
120}
121
122static int scsi_bus_poweroff(struct device *dev)
123{
124 return scsi_bus_suspend_common(dev, PMSG_HIBERNATE);
125}
126
127#else /* CONFIG_PM_SLEEP */
128
129#define scsi_bus_resume_common NULL
130#define scsi_bus_prepare NULL
131#define scsi_bus_suspend NULL
132#define scsi_bus_freeze NULL
133#define scsi_bus_poweroff NULL
134
135#endif /* CONFIG_PM_SLEEP */
136
137#ifdef CONFIG_PM_RUNTIME
138
139static int scsi_runtime_suspend(struct device *dev)
140{
141 int err = 0;
142
143 dev_dbg(dev, "scsi_runtime_suspend\n");
144 if (scsi_is_sdev_device(dev)) {
145 err = scsi_dev_type_suspend(dev, PMSG_AUTO_SUSPEND);
146 if (err == -EAGAIN)
147 pm_schedule_suspend(dev, jiffies_to_msecs(
148 round_jiffies_up_relative(HZ/10)));
149 }
150
151 /* Insert hooks here for targets, hosts, and transport classes */
152
153 return err;
154}
155
156static int scsi_runtime_resume(struct device *dev)
157{
158 int err = 0;
159
160 dev_dbg(dev, "scsi_runtime_resume\n");
161 if (scsi_is_sdev_device(dev))
162 err = scsi_dev_type_resume(dev);
163
164 /* Insert hooks here for targets, hosts, and transport classes */
165
166 return err;
167}
168
169static int scsi_runtime_idle(struct device *dev)
170{
171 int err;
172
173 dev_dbg(dev, "scsi_runtime_idle\n");
174
175 /* Insert hooks here for targets, hosts, and transport classes */
176
177 if (scsi_is_sdev_device(dev))
178 err = pm_schedule_suspend(dev, 100);
179 else
180 err = pm_runtime_suspend(dev);
181 return err;
182}
183
184int scsi_autopm_get_device(struct scsi_device *sdev)
185{
186 int err;
187
188 err = pm_runtime_get_sync(&sdev->sdev_gendev);
189 if (err < 0 && err !=-EACCES)
190 pm_runtime_put_sync(&sdev->sdev_gendev);
191 else
192 err = 0;
193 return err;
194}
195EXPORT_SYMBOL_GPL(scsi_autopm_get_device);
196
197void scsi_autopm_put_device(struct scsi_device *sdev)
198{
199 pm_runtime_put_sync(&sdev->sdev_gendev);
200}
201EXPORT_SYMBOL_GPL(scsi_autopm_put_device);
202
203void scsi_autopm_get_target(struct scsi_target *starget)
204{
205 pm_runtime_get_sync(&starget->dev);
206}
207
208void scsi_autopm_put_target(struct scsi_target *starget)
209{
210 pm_runtime_put_sync(&starget->dev);
211}
212
213int scsi_autopm_get_host(struct Scsi_Host *shost)
214{
215 int err;
216
217 err = pm_runtime_get_sync(&shost->shost_gendev);
218 if (err < 0 && err !=-EACCES)
219 pm_runtime_put_sync(&shost->shost_gendev);
220 else
221 err = 0;
222 return err;
223}
224
225void scsi_autopm_put_host(struct Scsi_Host *shost)
226{
227 pm_runtime_put_sync(&shost->shost_gendev);
228}
229
230#else
231
232#define scsi_runtime_suspend NULL
233#define scsi_runtime_resume NULL
234#define scsi_runtime_idle NULL
235
236#endif /* CONFIG_PM_RUNTIME */
237
238const struct dev_pm_ops scsi_bus_pm_ops = {
239 .prepare = scsi_bus_prepare,
240 .suspend = scsi_bus_suspend,
241 .resume = scsi_bus_resume_common,
242 .freeze = scsi_bus_freeze,
243 .thaw = scsi_bus_resume_common,
244 .poweroff = scsi_bus_poweroff,
245 .restore = scsi_bus_resume_common,
246 .runtime_suspend = scsi_runtime_suspend,
247 .runtime_resume = scsi_runtime_resume,
248 .runtime_idle = scsi_runtime_idle,
249};