xref: /linux/drivers/base/power/qos.c (revision 3d0fe49454652117522f60bfbefb978ba0e5300b)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Devices PM QoS constraints management
4  *
5  * Copyright (C) 2011 Texas Instruments, Inc.
6  *
7  * This module exposes the interface to kernel space for specifying
8  * per-device PM QoS dependencies. It provides infrastructure for registration
9  * of:
10  *
11  * Dependents on a QoS value : register requests
12  * Watchers of QoS value : get notified when target QoS value changes
13  *
14  * This QoS design is best effort based. Dependents register their QoS needs.
15  * Watchers register to keep track of the current QoS needs of the system.
16  * Watchers can register a per-device notification callback using the
17  * dev_pm_qos_*_notifier API. The notification chain data is stored in the
18  * per-device constraint data struct.
19  *
20  * Note about the per-device constraint data struct allocation:
21  * . The per-device constraints data struct ptr is stored into the device
22  *    dev_pm_info.
23  * . To minimize the data usage by the per-device constraints, the data struct
24  *   is only allocated at the first call to dev_pm_qos_add_request.
25  * . The data is later free'd when the device is removed from the system.
26  *  . A global mutex protects the constraints users from the data being
27  *     allocated and free'd.
28  */
29 
30 #include <linux/pm_qos.h>
31 #include <linux/spinlock.h>
32 #include <linux/slab.h>
33 #include <linux/device.h>
34 #include <linux/mutex.h>
35 #include <linux/export.h>
36 #include <linux/pm_runtime.h>
37 #include <linux/err.h>
38 #include <trace/events/power.h>
39 
40 #include "power.h"
41 
42 static DEFINE_MUTEX(dev_pm_qos_mtx);
43 static DEFINE_MUTEX(dev_pm_qos_sysfs_mtx);
44 
45 /**
46  * __dev_pm_qos_flags - Check PM QoS flags for a given device.
47  * @dev: Device to check the PM QoS flags for.
48  * @mask: Flags to check against.
49  *
50  * This routine must be called with dev->power.lock held.
51  */
52 enum pm_qos_flags_status __dev_pm_qos_flags(struct device *dev, s32 mask)
53 {
54 	struct dev_pm_qos *qos = dev->power.qos;
55 	struct pm_qos_flags *pqf;
56 	s32 val;
57 
58 	lockdep_assert_held(&dev->power.lock);
59 
60 	if (IS_ERR_OR_NULL(qos))
61 		return PM_QOS_FLAGS_UNDEFINED;
62 
63 	pqf = &qos->flags;
64 	if (list_empty(&pqf->list))
65 		return PM_QOS_FLAGS_UNDEFINED;
66 
67 	val = pqf->effective_flags & mask;
68 	if (val)
69 		return (val == mask) ? PM_QOS_FLAGS_ALL : PM_QOS_FLAGS_SOME;
70 
71 	return PM_QOS_FLAGS_NONE;
72 }
73 
74 /**
75  * dev_pm_qos_flags - Check PM QoS flags for a given device (locked).
76  * @dev: Device to check the PM QoS flags for.
77  * @mask: Flags to check against.
78  */
79 enum pm_qos_flags_status dev_pm_qos_flags(struct device *dev, s32 mask)
80 {
81 	unsigned long irqflags;
82 	enum pm_qos_flags_status ret;
83 
84 	spin_lock_irqsave(&dev->power.lock, irqflags);
85 	ret = __dev_pm_qos_flags(dev, mask);
86 	spin_unlock_irqrestore(&dev->power.lock, irqflags);
87 
88 	return ret;
89 }
90 EXPORT_SYMBOL_GPL(dev_pm_qos_flags);
91 
92 /**
93  * __dev_pm_qos_resume_latency - Get resume latency constraint for a given device.
94  * @dev: Device to get the PM QoS constraint value for.
95  *
96  * This routine must be called with dev->power.lock held.
97  */
98 s32 __dev_pm_qos_resume_latency(struct device *dev)
99 {
100 	lockdep_assert_held(&dev->power.lock);
101 
102 	return dev_pm_qos_raw_resume_latency(dev);
103 }
104 
105 /**
106  * dev_pm_qos_read_value - Get PM QoS constraint for a given device (locked).
107  * @dev: Device to get the PM QoS constraint value for.
108  * @type: QoS request type.
109  */
110 s32 dev_pm_qos_read_value(struct device *dev, enum dev_pm_qos_req_type type)
111 {
112 	struct dev_pm_qos *qos = dev->power.qos;
113 	unsigned long flags;
114 	s32 ret;
115 
116 	spin_lock_irqsave(&dev->power.lock, flags);
117 
118 	switch (type) {
119 	case DEV_PM_QOS_RESUME_LATENCY:
120 		ret = IS_ERR_OR_NULL(qos) ? PM_QOS_RESUME_LATENCY_NO_CONSTRAINT
121 			: pm_qos_read_value(&qos->resume_latency);
122 		break;
123 	case DEV_PM_QOS_MIN_FREQUENCY:
124 		ret = IS_ERR_OR_NULL(qos) ? PM_QOS_MIN_FREQUENCY_DEFAULT_VALUE
125 			: freq_qos_read_value(&qos->freq, FREQ_QOS_MIN);
126 		break;
127 	case DEV_PM_QOS_MAX_FREQUENCY:
128 		ret = IS_ERR_OR_NULL(qos) ? PM_QOS_MAX_FREQUENCY_DEFAULT_VALUE
129 			: freq_qos_read_value(&qos->freq, FREQ_QOS_MAX);
130 		break;
131 	default:
132 		WARN_ON(1);
133 		ret = 0;
134 	}
135 
136 	spin_unlock_irqrestore(&dev->power.lock, flags);
137 
138 	return ret;
139 }
140 
141 /**
142  * apply_constraint - Add/modify/remove device PM QoS request.
143  * @req: Constraint request to apply
144  * @action: Action to perform (add/update/remove).
145  * @value: Value to assign to the QoS request.
146  *
147  * Internal function to update the constraints list using the PM QoS core
148  * code and if needed call the per-device callbacks.
149  */
150 static int apply_constraint(struct dev_pm_qos_request *req,
151 			    enum pm_qos_req_action action, s32 value)
152 {
153 	struct dev_pm_qos *qos = req->dev->power.qos;
154 	int ret;
155 
156 	switch(req->type) {
157 	case DEV_PM_QOS_RESUME_LATENCY:
158 		if (WARN_ON(action != PM_QOS_REMOVE_REQ && value < 0))
159 			value = 0;
160 
161 		ret = pm_qos_update_target(&qos->resume_latency,
162 					   &req->data.pnode, action, value);
163 		break;
164 	case DEV_PM_QOS_LATENCY_TOLERANCE:
165 		ret = pm_qos_update_target(&qos->latency_tolerance,
166 					   &req->data.pnode, action, value);
167 		if (ret) {
168 			value = pm_qos_read_value(&qos->latency_tolerance);
169 			req->dev->power.set_latency_tolerance(req->dev, value);
170 		}
171 		break;
172 	case DEV_PM_QOS_MIN_FREQUENCY:
173 	case DEV_PM_QOS_MAX_FREQUENCY:
174 		ret = freq_qos_apply(&req->data.freq, action, value);
175 		break;
176 	case DEV_PM_QOS_FLAGS:
177 		ret = pm_qos_update_flags(&qos->flags, &req->data.flr,
178 					  action, value);
179 		break;
180 	default:
181 		ret = -EINVAL;
182 	}
183 
184 	return ret;
185 }
186 
187 /*
188  * dev_pm_qos_constraints_allocate
189  * @dev: device to allocate data for
190  *
191  * Called at the first call to add_request, for constraint data allocation
192  * Must be called with the dev_pm_qos_mtx mutex held
193  */
194 static int dev_pm_qos_constraints_allocate(struct device *dev)
195 {
196 	struct dev_pm_qos *qos;
197 	struct pm_qos_constraints *c;
198 	struct blocking_notifier_head *n;
199 
200 	qos = kzalloc(sizeof(*qos), GFP_KERNEL);
201 	if (!qos)
202 		return -ENOMEM;
203 
204 	n = kzalloc(3 * sizeof(*n), GFP_KERNEL);
205 	if (!n) {
206 		kfree(qos);
207 		return -ENOMEM;
208 	}
209 
210 	c = &qos->resume_latency;
211 	plist_head_init(&c->list);
212 	c->target_value = PM_QOS_RESUME_LATENCY_DEFAULT_VALUE;
213 	c->default_value = PM_QOS_RESUME_LATENCY_DEFAULT_VALUE;
214 	c->no_constraint_value = PM_QOS_RESUME_LATENCY_NO_CONSTRAINT;
215 	c->type = PM_QOS_MIN;
216 	c->notifiers = n;
217 	BLOCKING_INIT_NOTIFIER_HEAD(n);
218 
219 	c = &qos->latency_tolerance;
220 	plist_head_init(&c->list);
221 	c->target_value = PM_QOS_LATENCY_TOLERANCE_DEFAULT_VALUE;
222 	c->default_value = PM_QOS_LATENCY_TOLERANCE_DEFAULT_VALUE;
223 	c->no_constraint_value = PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT;
224 	c->type = PM_QOS_MIN;
225 
226 	freq_constraints_init(&qos->freq);
227 
228 	INIT_LIST_HEAD(&qos->flags.list);
229 
230 	spin_lock_irq(&dev->power.lock);
231 	dev->power.qos = qos;
232 	spin_unlock_irq(&dev->power.lock);
233 
234 	return 0;
235 }
236 
237 static void __dev_pm_qos_hide_latency_limit(struct device *dev);
238 static void __dev_pm_qos_hide_flags(struct device *dev);
239 
240 /**
241  * dev_pm_qos_constraints_destroy
242  * @dev: target device
243  *
244  * Called from the device PM subsystem on device removal under device_pm_lock().
245  */
246 void dev_pm_qos_constraints_destroy(struct device *dev)
247 {
248 	struct dev_pm_qos *qos;
249 	struct dev_pm_qos_request *req, *tmp;
250 	struct pm_qos_constraints *c;
251 	struct pm_qos_flags *f;
252 
253 	mutex_lock(&dev_pm_qos_sysfs_mtx);
254 
255 	/*
256 	 * If the device's PM QoS resume latency limit or PM QoS flags have been
257 	 * exposed to user space, they have to be hidden at this point.
258 	 */
259 	pm_qos_sysfs_remove_resume_latency(dev);
260 	pm_qos_sysfs_remove_flags(dev);
261 
262 	mutex_lock(&dev_pm_qos_mtx);
263 
264 	__dev_pm_qos_hide_latency_limit(dev);
265 	__dev_pm_qos_hide_flags(dev);
266 
267 	qos = dev->power.qos;
268 	if (!qos)
269 		goto out;
270 
271 	/* Flush the constraints lists for the device. */
272 	c = &qos->resume_latency;
273 	plist_for_each_entry_safe(req, tmp, &c->list, data.pnode) {
274 		/*
275 		 * Update constraints list and call the notification
276 		 * callbacks if needed
277 		 */
278 		apply_constraint(req, PM_QOS_REMOVE_REQ, PM_QOS_DEFAULT_VALUE);
279 		memset(req, 0, sizeof(*req));
280 	}
281 
282 	c = &qos->latency_tolerance;
283 	plist_for_each_entry_safe(req, tmp, &c->list, data.pnode) {
284 		apply_constraint(req, PM_QOS_REMOVE_REQ, PM_QOS_DEFAULT_VALUE);
285 		memset(req, 0, sizeof(*req));
286 	}
287 
288 	c = &qos->freq.min_freq;
289 	plist_for_each_entry_safe(req, tmp, &c->list, data.freq.pnode) {
290 		apply_constraint(req, PM_QOS_REMOVE_REQ,
291 				 PM_QOS_MIN_FREQUENCY_DEFAULT_VALUE);
292 		memset(req, 0, sizeof(*req));
293 	}
294 
295 	c = &qos->freq.max_freq;
296 	plist_for_each_entry_safe(req, tmp, &c->list, data.freq.pnode) {
297 		apply_constraint(req, PM_QOS_REMOVE_REQ,
298 				 PM_QOS_MAX_FREQUENCY_DEFAULT_VALUE);
299 		memset(req, 0, sizeof(*req));
300 	}
301 
302 	f = &qos->flags;
303 	list_for_each_entry_safe(req, tmp, &f->list, data.flr.node) {
304 		apply_constraint(req, PM_QOS_REMOVE_REQ, PM_QOS_DEFAULT_VALUE);
305 		memset(req, 0, sizeof(*req));
306 	}
307 
308 	spin_lock_irq(&dev->power.lock);
309 	dev->power.qos = ERR_PTR(-ENODEV);
310 	spin_unlock_irq(&dev->power.lock);
311 
312 	kfree(qos->resume_latency.notifiers);
313 	kfree(qos);
314 
315  out:
316 	mutex_unlock(&dev_pm_qos_mtx);
317 
318 	mutex_unlock(&dev_pm_qos_sysfs_mtx);
319 }
320 
321 static bool dev_pm_qos_invalid_req_type(struct device *dev,
322 					enum dev_pm_qos_req_type type)
323 {
324 	return type == DEV_PM_QOS_LATENCY_TOLERANCE &&
325 	       !dev->power.set_latency_tolerance;
326 }
327 
328 static int __dev_pm_qos_add_request(struct device *dev,
329 				    struct dev_pm_qos_request *req,
330 				    enum dev_pm_qos_req_type type, s32 value)
331 {
332 	int ret = 0;
333 
334 	if (!dev || !req || dev_pm_qos_invalid_req_type(dev, type))
335 		return -EINVAL;
336 
337 	if (WARN(dev_pm_qos_request_active(req),
338 		 "%s() called for already added request\n", __func__))
339 		return -EINVAL;
340 
341 	if (IS_ERR(dev->power.qos))
342 		ret = -ENODEV;
343 	else if (!dev->power.qos)
344 		ret = dev_pm_qos_constraints_allocate(dev);
345 
346 	trace_dev_pm_qos_add_request(dev_name(dev), type, value);
347 	if (ret)
348 		return ret;
349 
350 	req->dev = dev;
351 	req->type = type;
352 	if (req->type == DEV_PM_QOS_MIN_FREQUENCY)
353 		ret = freq_qos_add_request(&dev->power.qos->freq,
354 					   &req->data.freq,
355 					   FREQ_QOS_MIN, value);
356 	else if (req->type == DEV_PM_QOS_MAX_FREQUENCY)
357 		ret = freq_qos_add_request(&dev->power.qos->freq,
358 					   &req->data.freq,
359 					   FREQ_QOS_MAX, value);
360 	else
361 		ret = apply_constraint(req, PM_QOS_ADD_REQ, value);
362 
363 	return ret;
364 }
365 
366 /**
367  * dev_pm_qos_add_request - inserts new qos request into the list
368  * @dev: target device for the constraint
369  * @req: pointer to a preallocated handle
370  * @type: type of the request
371  * @value: defines the qos request
372  *
373  * This function inserts a new entry in the device constraints list of
374  * requested qos performance characteristics. It recomputes the aggregate
375  * QoS expectations of parameters and initializes the dev_pm_qos_request
376  * handle.  Caller needs to save this handle for later use in updates and
377  * removal.
378  *
379  * Returns 1 if the aggregated constraint value has changed,
380  * 0 if the aggregated constraint value has not changed,
381  * -EINVAL in case of wrong parameters, -ENOMEM if there's not enough memory
382  * to allocate for data structures, -ENODEV if the device has just been removed
383  * from the system.
384  *
385  * Callers should ensure that the target device is not RPM_SUSPENDED before
386  * using this function for requests of type DEV_PM_QOS_FLAGS.
387  */
388 int dev_pm_qos_add_request(struct device *dev, struct dev_pm_qos_request *req,
389 			   enum dev_pm_qos_req_type type, s32 value)
390 {
391 	int ret;
392 
393 	mutex_lock(&dev_pm_qos_mtx);
394 	ret = __dev_pm_qos_add_request(dev, req, type, value);
395 	mutex_unlock(&dev_pm_qos_mtx);
396 	return ret;
397 }
398 EXPORT_SYMBOL_GPL(dev_pm_qos_add_request);
399 
400 /**
401  * __dev_pm_qos_update_request - Modify an existing device PM QoS request.
402  * @req : PM QoS request to modify.
403  * @new_value: New value to request.
404  */
405 static int __dev_pm_qos_update_request(struct dev_pm_qos_request *req,
406 				       s32 new_value)
407 {
408 	s32 curr_value;
409 	int ret = 0;
410 
411 	if (!req) /*guard against callers passing in null */
412 		return -EINVAL;
413 
414 	if (WARN(!dev_pm_qos_request_active(req),
415 		 "%s() called for unknown object\n", __func__))
416 		return -EINVAL;
417 
418 	if (IS_ERR_OR_NULL(req->dev->power.qos))
419 		return -ENODEV;
420 
421 	switch(req->type) {
422 	case DEV_PM_QOS_RESUME_LATENCY:
423 	case DEV_PM_QOS_LATENCY_TOLERANCE:
424 		curr_value = req->data.pnode.prio;
425 		break;
426 	case DEV_PM_QOS_MIN_FREQUENCY:
427 	case DEV_PM_QOS_MAX_FREQUENCY:
428 		curr_value = req->data.freq.pnode.prio;
429 		break;
430 	case DEV_PM_QOS_FLAGS:
431 		curr_value = req->data.flr.flags;
432 		break;
433 	default:
434 		return -EINVAL;
435 	}
436 
437 	trace_dev_pm_qos_update_request(dev_name(req->dev), req->type,
438 					new_value);
439 	if (curr_value != new_value)
440 		ret = apply_constraint(req, PM_QOS_UPDATE_REQ, new_value);
441 
442 	return ret;
443 }
444 
445 /**
446  * dev_pm_qos_update_request - modifies an existing qos request
447  * @req : handle to list element holding a dev_pm_qos request to use
448  * @new_value: defines the qos request
449  *
450  * Updates an existing dev PM qos request along with updating the
451  * target value.
452  *
453  * Attempts are made to make this code callable on hot code paths.
454  *
455  * Returns 1 if the aggregated constraint value has changed,
456  * 0 if the aggregated constraint value has not changed,
457  * -EINVAL in case of wrong parameters, -ENODEV if the device has been
458  * removed from the system
459  *
460  * Callers should ensure that the target device is not RPM_SUSPENDED before
461  * using this function for requests of type DEV_PM_QOS_FLAGS.
462  */
463 int dev_pm_qos_update_request(struct dev_pm_qos_request *req, s32 new_value)
464 {
465 	int ret;
466 
467 	mutex_lock(&dev_pm_qos_mtx);
468 	ret = __dev_pm_qos_update_request(req, new_value);
469 	mutex_unlock(&dev_pm_qos_mtx);
470 	return ret;
471 }
472 EXPORT_SYMBOL_GPL(dev_pm_qos_update_request);
473 
474 static int __dev_pm_qos_remove_request(struct dev_pm_qos_request *req)
475 {
476 	int ret;
477 
478 	if (!req) /*guard against callers passing in null */
479 		return -EINVAL;
480 
481 	if (WARN(!dev_pm_qos_request_active(req),
482 		 "%s() called for unknown object\n", __func__))
483 		return -EINVAL;
484 
485 	if (IS_ERR_OR_NULL(req->dev->power.qos))
486 		return -ENODEV;
487 
488 	trace_dev_pm_qos_remove_request(dev_name(req->dev), req->type,
489 					PM_QOS_DEFAULT_VALUE);
490 	ret = apply_constraint(req, PM_QOS_REMOVE_REQ, PM_QOS_DEFAULT_VALUE);
491 	memset(req, 0, sizeof(*req));
492 	return ret;
493 }
494 
495 /**
496  * dev_pm_qos_remove_request - modifies an existing qos request
497  * @req: handle to request list element
498  *
499  * Will remove pm qos request from the list of constraints and
500  * recompute the current target value. Call this on slow code paths.
501  *
502  * Returns 1 if the aggregated constraint value has changed,
503  * 0 if the aggregated constraint value has not changed,
504  * -EINVAL in case of wrong parameters, -ENODEV if the device has been
505  * removed from the system
506  *
507  * Callers should ensure that the target device is not RPM_SUSPENDED before
508  * using this function for requests of type DEV_PM_QOS_FLAGS.
509  */
510 int dev_pm_qos_remove_request(struct dev_pm_qos_request *req)
511 {
512 	int ret;
513 
514 	mutex_lock(&dev_pm_qos_mtx);
515 	ret = __dev_pm_qos_remove_request(req);
516 	mutex_unlock(&dev_pm_qos_mtx);
517 	return ret;
518 }
519 EXPORT_SYMBOL_GPL(dev_pm_qos_remove_request);
520 
521 /**
522  * dev_pm_qos_add_notifier - sets notification entry for changes to target value
523  * of per-device PM QoS constraints
524  *
525  * @dev: target device for the constraint
526  * @notifier: notifier block managed by caller.
527  * @type: request type.
528  *
529  * Will register the notifier into a notification chain that gets called
530  * upon changes to the target value for the device.
531  *
532  * If the device's constraints object doesn't exist when this routine is called,
533  * it will be created (or error code will be returned if that fails).
534  */
535 int dev_pm_qos_add_notifier(struct device *dev, struct notifier_block *notifier,
536 			    enum dev_pm_qos_req_type type)
537 {
538 	int ret = 0;
539 
540 	mutex_lock(&dev_pm_qos_mtx);
541 
542 	if (IS_ERR(dev->power.qos))
543 		ret = -ENODEV;
544 	else if (!dev->power.qos)
545 		ret = dev_pm_qos_constraints_allocate(dev);
546 
547 	if (ret)
548 		goto unlock;
549 
550 	switch (type) {
551 	case DEV_PM_QOS_RESUME_LATENCY:
552 		ret = blocking_notifier_chain_register(dev->power.qos->resume_latency.notifiers,
553 						       notifier);
554 		break;
555 	case DEV_PM_QOS_MIN_FREQUENCY:
556 		ret = freq_qos_add_notifier(&dev->power.qos->freq,
557 					    FREQ_QOS_MIN, notifier);
558 		break;
559 	case DEV_PM_QOS_MAX_FREQUENCY:
560 		ret = freq_qos_add_notifier(&dev->power.qos->freq,
561 					    FREQ_QOS_MAX, notifier);
562 		break;
563 	default:
564 		WARN_ON(1);
565 		ret = -EINVAL;
566 	}
567 
568 unlock:
569 	mutex_unlock(&dev_pm_qos_mtx);
570 	return ret;
571 }
572 EXPORT_SYMBOL_GPL(dev_pm_qos_add_notifier);
573 
574 /**
575  * dev_pm_qos_remove_notifier - deletes notification for changes to target value
576  * of per-device PM QoS constraints
577  *
578  * @dev: target device for the constraint
579  * @notifier: notifier block to be removed.
580  * @type: request type.
581  *
582  * Will remove the notifier from the notification chain that gets called
583  * upon changes to the target value.
584  */
585 int dev_pm_qos_remove_notifier(struct device *dev,
586 			       struct notifier_block *notifier,
587 			       enum dev_pm_qos_req_type type)
588 {
589 	int ret = 0;
590 
591 	mutex_lock(&dev_pm_qos_mtx);
592 
593 	/* Silently return if the constraints object is not present. */
594 	if (IS_ERR_OR_NULL(dev->power.qos))
595 		goto unlock;
596 
597 	switch (type) {
598 	case DEV_PM_QOS_RESUME_LATENCY:
599 		ret = blocking_notifier_chain_unregister(dev->power.qos->resume_latency.notifiers,
600 							 notifier);
601 		break;
602 	case DEV_PM_QOS_MIN_FREQUENCY:
603 		ret = freq_qos_remove_notifier(&dev->power.qos->freq,
604 					       FREQ_QOS_MIN, notifier);
605 		break;
606 	case DEV_PM_QOS_MAX_FREQUENCY:
607 		ret = freq_qos_remove_notifier(&dev->power.qos->freq,
608 					       FREQ_QOS_MAX, notifier);
609 		break;
610 	default:
611 		WARN_ON(1);
612 		ret = -EINVAL;
613 	}
614 
615 unlock:
616 	mutex_unlock(&dev_pm_qos_mtx);
617 	return ret;
618 }
619 EXPORT_SYMBOL_GPL(dev_pm_qos_remove_notifier);
620 
621 /**
622  * dev_pm_qos_add_ancestor_request - Add PM QoS request for device's ancestor.
623  * @dev: Device whose ancestor to add the request for.
624  * @req: Pointer to the preallocated handle.
625  * @type: Type of the request.
626  * @value: Constraint latency value.
627  */
628 int dev_pm_qos_add_ancestor_request(struct device *dev,
629 				    struct dev_pm_qos_request *req,
630 				    enum dev_pm_qos_req_type type, s32 value)
631 {
632 	struct device *ancestor = dev->parent;
633 	int ret = -ENODEV;
634 
635 	switch (type) {
636 	case DEV_PM_QOS_RESUME_LATENCY:
637 		while (ancestor && !ancestor->power.ignore_children)
638 			ancestor = ancestor->parent;
639 
640 		break;
641 	case DEV_PM_QOS_LATENCY_TOLERANCE:
642 		while (ancestor && !ancestor->power.set_latency_tolerance)
643 			ancestor = ancestor->parent;
644 
645 		break;
646 	default:
647 		ancestor = NULL;
648 	}
649 	if (ancestor)
650 		ret = dev_pm_qos_add_request(ancestor, req, type, value);
651 
652 	if (ret < 0)
653 		req->dev = NULL;
654 
655 	return ret;
656 }
657 EXPORT_SYMBOL_GPL(dev_pm_qos_add_ancestor_request);
658 
659 static void __dev_pm_qos_drop_user_request(struct device *dev,
660 					   enum dev_pm_qos_req_type type)
661 {
662 	struct dev_pm_qos_request *req = NULL;
663 
664 	switch(type) {
665 	case DEV_PM_QOS_RESUME_LATENCY:
666 		req = dev->power.qos->resume_latency_req;
667 		dev->power.qos->resume_latency_req = NULL;
668 		break;
669 	case DEV_PM_QOS_LATENCY_TOLERANCE:
670 		req = dev->power.qos->latency_tolerance_req;
671 		dev->power.qos->latency_tolerance_req = NULL;
672 		break;
673 	case DEV_PM_QOS_FLAGS:
674 		req = dev->power.qos->flags_req;
675 		dev->power.qos->flags_req = NULL;
676 		break;
677 	default:
678 		WARN_ON(1);
679 		return;
680 	}
681 	__dev_pm_qos_remove_request(req);
682 	kfree(req);
683 }
684 
685 static void dev_pm_qos_drop_user_request(struct device *dev,
686 					 enum dev_pm_qos_req_type type)
687 {
688 	mutex_lock(&dev_pm_qos_mtx);
689 	__dev_pm_qos_drop_user_request(dev, type);
690 	mutex_unlock(&dev_pm_qos_mtx);
691 }
692 
693 /**
694  * dev_pm_qos_expose_latency_limit - Expose PM QoS latency limit to user space.
695  * @dev: Device whose PM QoS latency limit is to be exposed to user space.
696  * @value: Initial value of the latency limit.
697  */
698 int dev_pm_qos_expose_latency_limit(struct device *dev, s32 value)
699 {
700 	struct dev_pm_qos_request *req;
701 	int ret;
702 
703 	if (!device_is_registered(dev) || value < 0)
704 		return -EINVAL;
705 
706 	req = kzalloc(sizeof(*req), GFP_KERNEL);
707 	if (!req)
708 		return -ENOMEM;
709 
710 	ret = dev_pm_qos_add_request(dev, req, DEV_PM_QOS_RESUME_LATENCY, value);
711 	if (ret < 0) {
712 		kfree(req);
713 		return ret;
714 	}
715 
716 	mutex_lock(&dev_pm_qos_sysfs_mtx);
717 
718 	mutex_lock(&dev_pm_qos_mtx);
719 
720 	if (IS_ERR_OR_NULL(dev->power.qos))
721 		ret = -ENODEV;
722 	else if (dev->power.qos->resume_latency_req)
723 		ret = -EEXIST;
724 
725 	if (ret < 0) {
726 		__dev_pm_qos_remove_request(req);
727 		kfree(req);
728 		mutex_unlock(&dev_pm_qos_mtx);
729 		goto out;
730 	}
731 	dev->power.qos->resume_latency_req = req;
732 
733 	mutex_unlock(&dev_pm_qos_mtx);
734 
735 	ret = pm_qos_sysfs_add_resume_latency(dev);
736 	if (ret)
737 		dev_pm_qos_drop_user_request(dev, DEV_PM_QOS_RESUME_LATENCY);
738 
739  out:
740 	mutex_unlock(&dev_pm_qos_sysfs_mtx);
741 	return ret;
742 }
743 EXPORT_SYMBOL_GPL(dev_pm_qos_expose_latency_limit);
744 
745 static void __dev_pm_qos_hide_latency_limit(struct device *dev)
746 {
747 	if (!IS_ERR_OR_NULL(dev->power.qos) && dev->power.qos->resume_latency_req)
748 		__dev_pm_qos_drop_user_request(dev, DEV_PM_QOS_RESUME_LATENCY);
749 }
750 
751 /**
752  * dev_pm_qos_hide_latency_limit - Hide PM QoS latency limit from user space.
753  * @dev: Device whose PM QoS latency limit is to be hidden from user space.
754  */
755 void dev_pm_qos_hide_latency_limit(struct device *dev)
756 {
757 	mutex_lock(&dev_pm_qos_sysfs_mtx);
758 
759 	pm_qos_sysfs_remove_resume_latency(dev);
760 
761 	mutex_lock(&dev_pm_qos_mtx);
762 	__dev_pm_qos_hide_latency_limit(dev);
763 	mutex_unlock(&dev_pm_qos_mtx);
764 
765 	mutex_unlock(&dev_pm_qos_sysfs_mtx);
766 }
767 EXPORT_SYMBOL_GPL(dev_pm_qos_hide_latency_limit);
768 
769 /**
770  * dev_pm_qos_expose_flags - Expose PM QoS flags of a device to user space.
771  * @dev: Device whose PM QoS flags are to be exposed to user space.
772  * @val: Initial values of the flags.
773  */
774 int dev_pm_qos_expose_flags(struct device *dev, s32 val)
775 {
776 	struct dev_pm_qos_request *req;
777 	int ret;
778 
779 	if (!device_is_registered(dev))
780 		return -EINVAL;
781 
782 	req = kzalloc(sizeof(*req), GFP_KERNEL);
783 	if (!req)
784 		return -ENOMEM;
785 
786 	ret = dev_pm_qos_add_request(dev, req, DEV_PM_QOS_FLAGS, val);
787 	if (ret < 0) {
788 		kfree(req);
789 		return ret;
790 	}
791 
792 	pm_runtime_get_sync(dev);
793 	mutex_lock(&dev_pm_qos_sysfs_mtx);
794 
795 	mutex_lock(&dev_pm_qos_mtx);
796 
797 	if (IS_ERR_OR_NULL(dev->power.qos))
798 		ret = -ENODEV;
799 	else if (dev->power.qos->flags_req)
800 		ret = -EEXIST;
801 
802 	if (ret < 0) {
803 		__dev_pm_qos_remove_request(req);
804 		kfree(req);
805 		mutex_unlock(&dev_pm_qos_mtx);
806 		goto out;
807 	}
808 	dev->power.qos->flags_req = req;
809 
810 	mutex_unlock(&dev_pm_qos_mtx);
811 
812 	ret = pm_qos_sysfs_add_flags(dev);
813 	if (ret)
814 		dev_pm_qos_drop_user_request(dev, DEV_PM_QOS_FLAGS);
815 
816  out:
817 	mutex_unlock(&dev_pm_qos_sysfs_mtx);
818 	pm_runtime_put(dev);
819 	return ret;
820 }
821 EXPORT_SYMBOL_GPL(dev_pm_qos_expose_flags);
822 
823 static void __dev_pm_qos_hide_flags(struct device *dev)
824 {
825 	if (!IS_ERR_OR_NULL(dev->power.qos) && dev->power.qos->flags_req)
826 		__dev_pm_qos_drop_user_request(dev, DEV_PM_QOS_FLAGS);
827 }
828 
829 /**
830  * dev_pm_qos_hide_flags - Hide PM QoS flags of a device from user space.
831  * @dev: Device whose PM QoS flags are to be hidden from user space.
832  */
833 void dev_pm_qos_hide_flags(struct device *dev)
834 {
835 	pm_runtime_get_sync(dev);
836 	mutex_lock(&dev_pm_qos_sysfs_mtx);
837 
838 	pm_qos_sysfs_remove_flags(dev);
839 
840 	mutex_lock(&dev_pm_qos_mtx);
841 	__dev_pm_qos_hide_flags(dev);
842 	mutex_unlock(&dev_pm_qos_mtx);
843 
844 	mutex_unlock(&dev_pm_qos_sysfs_mtx);
845 	pm_runtime_put(dev);
846 }
847 EXPORT_SYMBOL_GPL(dev_pm_qos_hide_flags);
848 
849 /**
850  * dev_pm_qos_update_flags - Update PM QoS flags request owned by user space.
851  * @dev: Device to update the PM QoS flags request for.
852  * @mask: Flags to set/clear.
853  * @set: Whether to set or clear the flags (true means set).
854  */
855 int dev_pm_qos_update_flags(struct device *dev, s32 mask, bool set)
856 {
857 	s32 value;
858 	int ret;
859 
860 	pm_runtime_get_sync(dev);
861 	mutex_lock(&dev_pm_qos_mtx);
862 
863 	if (IS_ERR_OR_NULL(dev->power.qos) || !dev->power.qos->flags_req) {
864 		ret = -EINVAL;
865 		goto out;
866 	}
867 
868 	value = dev_pm_qos_requested_flags(dev);
869 	if (set)
870 		value |= mask;
871 	else
872 		value &= ~mask;
873 
874 	ret = __dev_pm_qos_update_request(dev->power.qos->flags_req, value);
875 
876  out:
877 	mutex_unlock(&dev_pm_qos_mtx);
878 	pm_runtime_put(dev);
879 	return ret;
880 }
881 
882 /**
883  * dev_pm_qos_get_user_latency_tolerance - Get user space latency tolerance.
884  * @dev: Device to obtain the user space latency tolerance for.
885  */
886 s32 dev_pm_qos_get_user_latency_tolerance(struct device *dev)
887 {
888 	s32 ret;
889 
890 	mutex_lock(&dev_pm_qos_mtx);
891 	ret = IS_ERR_OR_NULL(dev->power.qos)
892 		|| !dev->power.qos->latency_tolerance_req ?
893 			PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT :
894 			dev->power.qos->latency_tolerance_req->data.pnode.prio;
895 	mutex_unlock(&dev_pm_qos_mtx);
896 	return ret;
897 }
898 
899 /**
900  * dev_pm_qos_update_user_latency_tolerance - Update user space latency tolerance.
901  * @dev: Device to update the user space latency tolerance for.
902  * @val: New user space latency tolerance for @dev (negative values disable).
903  */
904 int dev_pm_qos_update_user_latency_tolerance(struct device *dev, s32 val)
905 {
906 	int ret;
907 
908 	mutex_lock(&dev_pm_qos_mtx);
909 
910 	if (IS_ERR_OR_NULL(dev->power.qos)
911 	    || !dev->power.qos->latency_tolerance_req) {
912 		struct dev_pm_qos_request *req;
913 
914 		if (val < 0) {
915 			if (val == PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT)
916 				ret = 0;
917 			else
918 				ret = -EINVAL;
919 			goto out;
920 		}
921 		req = kzalloc(sizeof(*req), GFP_KERNEL);
922 		if (!req) {
923 			ret = -ENOMEM;
924 			goto out;
925 		}
926 		ret = __dev_pm_qos_add_request(dev, req, DEV_PM_QOS_LATENCY_TOLERANCE, val);
927 		if (ret < 0) {
928 			kfree(req);
929 			goto out;
930 		}
931 		dev->power.qos->latency_tolerance_req = req;
932 	} else {
933 		if (val < 0) {
934 			__dev_pm_qos_drop_user_request(dev, DEV_PM_QOS_LATENCY_TOLERANCE);
935 			ret = 0;
936 		} else {
937 			ret = __dev_pm_qos_update_request(dev->power.qos->latency_tolerance_req, val);
938 		}
939 	}
940 
941  out:
942 	mutex_unlock(&dev_pm_qos_mtx);
943 	return ret;
944 }
945 EXPORT_SYMBOL_GPL(dev_pm_qos_update_user_latency_tolerance);
946 
947 /**
948  * dev_pm_qos_expose_latency_tolerance - Expose latency tolerance to userspace
949  * @dev: Device whose latency tolerance to expose
950  */
951 int dev_pm_qos_expose_latency_tolerance(struct device *dev)
952 {
953 	int ret;
954 
955 	if (!dev->power.set_latency_tolerance)
956 		return -EINVAL;
957 
958 	mutex_lock(&dev_pm_qos_sysfs_mtx);
959 	ret = pm_qos_sysfs_add_latency_tolerance(dev);
960 	mutex_unlock(&dev_pm_qos_sysfs_mtx);
961 
962 	return ret;
963 }
964 EXPORT_SYMBOL_GPL(dev_pm_qos_expose_latency_tolerance);
965 
966 /**
967  * dev_pm_qos_hide_latency_tolerance - Hide latency tolerance from userspace
968  * @dev: Device whose latency tolerance to hide
969  */
970 void dev_pm_qos_hide_latency_tolerance(struct device *dev)
971 {
972 	mutex_lock(&dev_pm_qos_sysfs_mtx);
973 	pm_qos_sysfs_remove_latency_tolerance(dev);
974 	mutex_unlock(&dev_pm_qos_sysfs_mtx);
975 
976 	/* Remove the request from user space now */
977 	pm_runtime_get_sync(dev);
978 	dev_pm_qos_update_user_latency_tolerance(dev,
979 		PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT);
980 	pm_runtime_put(dev);
981 }
982 EXPORT_SYMBOL_GPL(dev_pm_qos_hide_latency_tolerance);
983