1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * Power Management Quality of Service (PM QoS) support base. 4 * 5 * Copyright (C) 2020 Intel Corporation 6 * 7 * Authors: 8 * Mark Gross <mgross@linux.intel.com> 9 * Rafael J. Wysocki <rafael.j.wysocki@intel.com> 10 * 11 * Provided here is an interface for specifying PM QoS dependencies. It allows 12 * entities depending on QoS constraints to register their requests which are 13 * aggregated as appropriate to produce effective constraints (target values) 14 * that can be monitored by entities needing to respect them, either by polling 15 * or through a built-in notification mechanism. 16 * 17 * In addition to the basic functionality, more specific interfaces for managing 18 * global CPU latency QoS requests and frequency QoS requests are provided. 19 */ 20 21 /*#define DEBUG*/ 22 23 #include <linux/pm_qos.h> 24 #include <linux/sched.h> 25 #include <linux/spinlock.h> 26 #include <linux/slab.h> 27 #include <linux/time.h> 28 #include <linux/fs.h> 29 #include <linux/device.h> 30 #include <linux/miscdevice.h> 31 #include <linux/string.h> 32 #include <linux/platform_device.h> 33 #include <linux/init.h> 34 #include <linux/kernel.h> 35 #include <linux/debugfs.h> 36 #include <linux/seq_file.h> 37 38 #include <linux/uaccess.h> 39 #include <linux/export.h> 40 #include <trace/events/power.h> 41 42 /* 43 * locking rule: all changes to constraints or notifiers lists 44 * or pm_qos_object list and pm_qos_objects need to happen with pm_qos_lock 45 * held, taken with _irqsave. One lock to rule them all 46 */ 47 static DEFINE_SPINLOCK(pm_qos_lock); 48 49 /** 50 * pm_qos_read_value - Return the current effective constraint value. 51 * @c: List of PM QoS constraint requests. 52 */ 53 s32 pm_qos_read_value(struct pm_qos_constraints *c) 54 { 55 return READ_ONCE(c->target_value); 56 } 57 58 static int pm_qos_get_value(struct pm_qos_constraints *c) 59 { 60 if (plist_head_empty(&c->list)) 61 return c->no_constraint_value; 62 63 switch (c->type) { 64 case PM_QOS_MIN: 65 return plist_first(&c->list)->prio; 66 67 case PM_QOS_MAX: 68 return plist_last(&c->list)->prio; 69 70 default: 71 WARN(1, "Unknown PM QoS type in %s\n", __func__); 72 return PM_QOS_DEFAULT_VALUE; 73 } 74 } 75 76 static void pm_qos_set_value(struct pm_qos_constraints *c, s32 value) 77 { 78 WRITE_ONCE(c->target_value, value); 79 } 80 81 /** 82 * pm_qos_update_target - Update a list of PM QoS constraint requests. 83 * @c: List of PM QoS requests. 84 * @node: Target list entry. 85 * @action: Action to carry out (add, update or remove). 86 * @value: New request value for the target list entry. 87 * 88 * Update the given list of PM QoS constraint requests, @c, by carrying an 89 * @action involving the @node list entry and @value on it. 90 * 91 * The recognized values of @action are PM_QOS_ADD_REQ (store @value in @node 92 * and add it to the list), PM_QOS_UPDATE_REQ (remove @node from the list, store 93 * @value in it and add it to the list again), and PM_QOS_REMOVE_REQ (remove 94 * @node from the list, ignore @value). 95 * 96 * Return: 1 if the aggregate constraint value has changed, 0 otherwise. 97 */ 98 int pm_qos_update_target(struct pm_qos_constraints *c, struct plist_node *node, 99 enum pm_qos_req_action action, int value) 100 { 101 int prev_value, curr_value, new_value; 102 unsigned long flags; 103 104 spin_lock_irqsave(&pm_qos_lock, flags); 105 106 prev_value = pm_qos_get_value(c); 107 if (value == PM_QOS_DEFAULT_VALUE) 108 new_value = c->default_value; 109 else 110 new_value = value; 111 112 switch (action) { 113 case PM_QOS_REMOVE_REQ: 114 plist_del(node, &c->list); 115 break; 116 case PM_QOS_UPDATE_REQ: 117 /* 118 * To change the list, atomically remove, reinit with new value 119 * and add, then see if the aggregate has changed. 120 */ 121 plist_del(node, &c->list); 122 fallthrough; 123 case PM_QOS_ADD_REQ: 124 plist_node_init(node, new_value); 125 plist_add(node, &c->list); 126 break; 127 default: 128 /* no action */ 129 ; 130 } 131 132 curr_value = pm_qos_get_value(c); 133 pm_qos_set_value(c, curr_value); 134 135 spin_unlock_irqrestore(&pm_qos_lock, flags); 136 137 trace_pm_qos_update_target(action, prev_value, curr_value); 138 139 if (prev_value == curr_value) 140 return 0; 141 142 if (c->notifiers) 143 blocking_notifier_call_chain(c->notifiers, curr_value, NULL); 144 145 return 1; 146 } 147 148 /** 149 * pm_qos_flags_remove_req - Remove device PM QoS flags request. 150 * @pqf: Device PM QoS flags set to remove the request from. 151 * @req: Request to remove from the set. 152 */ 153 static void pm_qos_flags_remove_req(struct pm_qos_flags *pqf, 154 struct pm_qos_flags_request *req) 155 { 156 s32 val = 0; 157 158 list_del(&req->node); 159 list_for_each_entry(req, &pqf->list, node) 160 val |= req->flags; 161 162 pqf->effective_flags = val; 163 } 164 165 /** 166 * pm_qos_update_flags - Update a set of PM QoS flags. 167 * @pqf: Set of PM QoS flags to update. 168 * @req: Request to add to the set, to modify, or to remove from the set. 169 * @action: Action to take on the set. 170 * @val: Value of the request to add or modify. 171 * 172 * Return: 1 if the aggregate constraint value has changed, 0 otherwise. 173 */ 174 bool pm_qos_update_flags(struct pm_qos_flags *pqf, 175 struct pm_qos_flags_request *req, 176 enum pm_qos_req_action action, s32 val) 177 { 178 unsigned long irqflags; 179 s32 prev_value, curr_value; 180 181 spin_lock_irqsave(&pm_qos_lock, irqflags); 182 183 prev_value = list_empty(&pqf->list) ? 0 : pqf->effective_flags; 184 185 switch (action) { 186 case PM_QOS_REMOVE_REQ: 187 pm_qos_flags_remove_req(pqf, req); 188 break; 189 case PM_QOS_UPDATE_REQ: 190 pm_qos_flags_remove_req(pqf, req); 191 fallthrough; 192 case PM_QOS_ADD_REQ: 193 req->flags = val; 194 INIT_LIST_HEAD(&req->node); 195 list_add_tail(&req->node, &pqf->list); 196 pqf->effective_flags |= val; 197 break; 198 default: 199 /* no action */ 200 ; 201 } 202 203 curr_value = list_empty(&pqf->list) ? 0 : pqf->effective_flags; 204 205 spin_unlock_irqrestore(&pm_qos_lock, irqflags); 206 207 trace_pm_qos_update_flags(action, prev_value, curr_value); 208 209 return prev_value != curr_value; 210 } 211 212 #ifdef CONFIG_CPU_IDLE 213 /* Definitions related to the CPU latency QoS. */ 214 215 static struct pm_qos_constraints cpu_latency_constraints = { 216 .list = PLIST_HEAD_INIT(cpu_latency_constraints.list), 217 .target_value = PM_QOS_CPU_LATENCY_DEFAULT_VALUE, 218 .default_value = PM_QOS_CPU_LATENCY_DEFAULT_VALUE, 219 .no_constraint_value = PM_QOS_CPU_LATENCY_DEFAULT_VALUE, 220 .type = PM_QOS_MIN, 221 }; 222 223 static inline bool cpu_latency_qos_value_invalid(s32 value) 224 { 225 return value < 0 && value != PM_QOS_DEFAULT_VALUE; 226 } 227 228 /** 229 * cpu_latency_qos_limit - Return current system-wide CPU latency QoS limit. 230 */ 231 s32 cpu_latency_qos_limit(void) 232 { 233 return pm_qos_read_value(&cpu_latency_constraints); 234 } 235 236 /** 237 * cpu_latency_qos_request_active - Check the given PM QoS request. 238 * @req: PM QoS request to check. 239 * 240 * Return: 'true' if @req has been added to the CPU latency QoS list, 'false' 241 * otherwise. 242 */ 243 bool cpu_latency_qos_request_active(struct pm_qos_request *req) 244 { 245 return req->qos == &cpu_latency_constraints; 246 } 247 EXPORT_SYMBOL_GPL(cpu_latency_qos_request_active); 248 249 static void cpu_latency_qos_apply(struct pm_qos_request *req, 250 enum pm_qos_req_action action, s32 value) 251 { 252 int ret = pm_qos_update_target(req->qos, &req->node, action, value); 253 if (ret > 0) 254 wake_up_all_idle_cpus(); 255 } 256 257 /** 258 * cpu_latency_qos_add_request - Add new CPU latency QoS request. 259 * @req: Pointer to a preallocated handle. 260 * @value: Requested constraint value. 261 * 262 * Use @value to initialize the request handle pointed to by @req, insert it as 263 * a new entry to the CPU latency QoS list and recompute the effective QoS 264 * constraint for that list. 265 * 266 * Callers need to save the handle for later use in updates and removal of the 267 * QoS request represented by it. 268 */ 269 void cpu_latency_qos_add_request(struct pm_qos_request *req, s32 value) 270 { 271 if (!req || cpu_latency_qos_value_invalid(value)) 272 return; 273 274 if (cpu_latency_qos_request_active(req)) { 275 WARN(1, KERN_ERR "%s called for already added request\n", __func__); 276 return; 277 } 278 279 trace_pm_qos_add_request(value); 280 281 req->qos = &cpu_latency_constraints; 282 cpu_latency_qos_apply(req, PM_QOS_ADD_REQ, value); 283 } 284 EXPORT_SYMBOL_GPL(cpu_latency_qos_add_request); 285 286 /** 287 * cpu_latency_qos_update_request - Modify existing CPU latency QoS request. 288 * @req : QoS request to update. 289 * @new_value: New requested constraint value. 290 * 291 * Use @new_value to update the QoS request represented by @req in the CPU 292 * latency QoS list along with updating the effective constraint value for that 293 * list. 294 */ 295 void cpu_latency_qos_update_request(struct pm_qos_request *req, s32 new_value) 296 { 297 if (!req || cpu_latency_qos_value_invalid(new_value)) 298 return; 299 300 if (!cpu_latency_qos_request_active(req)) { 301 WARN(1, KERN_ERR "%s called for unknown object\n", __func__); 302 return; 303 } 304 305 trace_pm_qos_update_request(new_value); 306 307 if (new_value == req->node.prio) 308 return; 309 310 cpu_latency_qos_apply(req, PM_QOS_UPDATE_REQ, new_value); 311 } 312 EXPORT_SYMBOL_GPL(cpu_latency_qos_update_request); 313 314 /** 315 * cpu_latency_qos_remove_request - Remove existing CPU latency QoS request. 316 * @req: QoS request to remove. 317 * 318 * Remove the CPU latency QoS request represented by @req from the CPU latency 319 * QoS list along with updating the effective constraint value for that list. 320 */ 321 void cpu_latency_qos_remove_request(struct pm_qos_request *req) 322 { 323 if (!req) 324 return; 325 326 if (!cpu_latency_qos_request_active(req)) { 327 WARN(1, KERN_ERR "%s called for unknown object\n", __func__); 328 return; 329 } 330 331 trace_pm_qos_remove_request(PM_QOS_DEFAULT_VALUE); 332 333 cpu_latency_qos_apply(req, PM_QOS_REMOVE_REQ, PM_QOS_DEFAULT_VALUE); 334 memset(req, 0, sizeof(*req)); 335 } 336 EXPORT_SYMBOL_GPL(cpu_latency_qos_remove_request); 337 338 /* User space interface to the CPU latency QoS via misc device. */ 339 340 static int cpu_latency_qos_open(struct inode *inode, struct file *filp) 341 { 342 struct pm_qos_request *req; 343 344 req = kzalloc(sizeof(*req), GFP_KERNEL); 345 if (!req) 346 return -ENOMEM; 347 348 cpu_latency_qos_add_request(req, PM_QOS_DEFAULT_VALUE); 349 filp->private_data = req; 350 351 return 0; 352 } 353 354 static int cpu_latency_qos_release(struct inode *inode, struct file *filp) 355 { 356 struct pm_qos_request *req = filp->private_data; 357 358 filp->private_data = NULL; 359 360 cpu_latency_qos_remove_request(req); 361 kfree(req); 362 363 return 0; 364 } 365 366 static ssize_t cpu_latency_qos_read(struct file *filp, char __user *buf, 367 size_t count, loff_t *f_pos) 368 { 369 struct pm_qos_request *req = filp->private_data; 370 unsigned long flags; 371 s32 value; 372 373 if (!req || !cpu_latency_qos_request_active(req)) 374 return -EINVAL; 375 376 spin_lock_irqsave(&pm_qos_lock, flags); 377 value = pm_qos_get_value(&cpu_latency_constraints); 378 spin_unlock_irqrestore(&pm_qos_lock, flags); 379 380 return simple_read_from_buffer(buf, count, f_pos, &value, sizeof(s32)); 381 } 382 383 static ssize_t cpu_latency_qos_write(struct file *filp, const char __user *buf, 384 size_t count, loff_t *f_pos) 385 { 386 s32 value; 387 388 if (count == sizeof(s32)) { 389 if (copy_from_user(&value, buf, sizeof(s32))) 390 return -EFAULT; 391 } else { 392 int ret; 393 394 ret = kstrtos32_from_user(buf, count, 16, &value); 395 if (ret) 396 return ret; 397 } 398 399 cpu_latency_qos_update_request(filp->private_data, value); 400 401 return count; 402 } 403 404 static const struct file_operations cpu_latency_qos_fops = { 405 .write = cpu_latency_qos_write, 406 .read = cpu_latency_qos_read, 407 .open = cpu_latency_qos_open, 408 .release = cpu_latency_qos_release, 409 .llseek = noop_llseek, 410 }; 411 412 static struct miscdevice cpu_latency_qos_miscdev = { 413 .minor = MISC_DYNAMIC_MINOR, 414 .name = "cpu_dma_latency", 415 .fops = &cpu_latency_qos_fops, 416 }; 417 418 #ifdef CONFIG_PM_QOS_CPU_SYSTEM_WAKEUP 419 /* The CPU system wakeup latency QoS. */ 420 static struct pm_qos_constraints cpu_wakeup_latency_constraints = { 421 .list = PLIST_HEAD_INIT(cpu_wakeup_latency_constraints.list), 422 .target_value = PM_QOS_RESUME_LATENCY_NO_CONSTRAINT, 423 .default_value = PM_QOS_RESUME_LATENCY_NO_CONSTRAINT, 424 .no_constraint_value = PM_QOS_RESUME_LATENCY_NO_CONSTRAINT, 425 .type = PM_QOS_MIN, 426 }; 427 428 /** 429 * cpu_wakeup_latency_qos_limit - Current CPU system wakeup latency QoS limit. 430 * 431 * Returns the current CPU system wakeup latency QoS limit that may have been 432 * requested by user space. 433 */ 434 s32 cpu_wakeup_latency_qos_limit(void) 435 { 436 return pm_qos_read_value(&cpu_wakeup_latency_constraints); 437 } 438 439 static int cpu_wakeup_latency_qos_open(struct inode *inode, struct file *filp) 440 { 441 struct pm_qos_request *req; 442 443 req = kzalloc(sizeof(*req), GFP_KERNEL); 444 if (!req) 445 return -ENOMEM; 446 447 req->qos = &cpu_wakeup_latency_constraints; 448 pm_qos_update_target(req->qos, &req->node, PM_QOS_ADD_REQ, 449 PM_QOS_RESUME_LATENCY_NO_CONSTRAINT); 450 filp->private_data = req; 451 452 return 0; 453 } 454 455 static int cpu_wakeup_latency_qos_release(struct inode *inode, 456 struct file *filp) 457 { 458 struct pm_qos_request *req = filp->private_data; 459 460 filp->private_data = NULL; 461 pm_qos_update_target(req->qos, &req->node, PM_QOS_REMOVE_REQ, 462 PM_QOS_RESUME_LATENCY_NO_CONSTRAINT); 463 kfree(req); 464 465 return 0; 466 } 467 468 static ssize_t cpu_wakeup_latency_qos_read(struct file *filp, char __user *buf, 469 size_t count, loff_t *f_pos) 470 { 471 s32 value = pm_qos_read_value(&cpu_wakeup_latency_constraints); 472 473 return simple_read_from_buffer(buf, count, f_pos, &value, sizeof(s32)); 474 } 475 476 static ssize_t cpu_wakeup_latency_qos_write(struct file *filp, 477 const char __user *buf, 478 size_t count, loff_t *f_pos) 479 { 480 struct pm_qos_request *req = filp->private_data; 481 s32 value; 482 483 if (count == sizeof(s32)) { 484 if (copy_from_user(&value, buf, sizeof(s32))) 485 return -EFAULT; 486 } else { 487 int ret; 488 489 ret = kstrtos32_from_user(buf, count, 16, &value); 490 if (ret) 491 return ret; 492 } 493 494 if (value < 0) 495 return -EINVAL; 496 497 pm_qos_update_target(req->qos, &req->node, PM_QOS_UPDATE_REQ, value); 498 499 return count; 500 } 501 502 static const struct file_operations cpu_wakeup_latency_qos_fops = { 503 .open = cpu_wakeup_latency_qos_open, 504 .release = cpu_wakeup_latency_qos_release, 505 .read = cpu_wakeup_latency_qos_read, 506 .write = cpu_wakeup_latency_qos_write, 507 .llseek = noop_llseek, 508 }; 509 510 static struct miscdevice cpu_wakeup_latency_qos_miscdev = { 511 .minor = MISC_DYNAMIC_MINOR, 512 .name = "cpu_wakeup_latency", 513 .fops = &cpu_wakeup_latency_qos_fops, 514 }; 515 #endif /* CONFIG_PM_QOS_CPU_SYSTEM_WAKEUP */ 516 517 static int __init cpu_latency_qos_init(void) 518 { 519 int ret; 520 521 ret = misc_register(&cpu_latency_qos_miscdev); 522 if (ret < 0) 523 pr_err("%s: %s setup failed\n", __func__, 524 cpu_latency_qos_miscdev.name); 525 526 #ifdef CONFIG_PM_QOS_CPU_SYSTEM_WAKEUP 527 ret = misc_register(&cpu_wakeup_latency_qos_miscdev); 528 if (ret < 0) 529 pr_err("%s: %s setup failed\n", __func__, 530 cpu_wakeup_latency_qos_miscdev.name); 531 #endif 532 533 return ret; 534 } 535 late_initcall(cpu_latency_qos_init); 536 #endif /* CONFIG_CPU_IDLE */ 537 538 /* Definitions related to the frequency QoS below. */ 539 540 static inline bool freq_qos_value_invalid(s32 value) 541 { 542 return value < 0 && value != PM_QOS_DEFAULT_VALUE; 543 } 544 545 /** 546 * freq_constraints_init - Initialize frequency QoS constraints. 547 * @qos: Frequency QoS constraints to initialize. 548 */ 549 void freq_constraints_init(struct freq_constraints *qos) 550 { 551 struct pm_qos_constraints *c; 552 553 c = &qos->min_freq; 554 plist_head_init(&c->list); 555 c->target_value = FREQ_QOS_MIN_DEFAULT_VALUE; 556 c->default_value = FREQ_QOS_MIN_DEFAULT_VALUE; 557 c->no_constraint_value = FREQ_QOS_MIN_DEFAULT_VALUE; 558 c->type = PM_QOS_MAX; 559 c->notifiers = &qos->min_freq_notifiers; 560 BLOCKING_INIT_NOTIFIER_HEAD(c->notifiers); 561 562 c = &qos->max_freq; 563 plist_head_init(&c->list); 564 c->target_value = FREQ_QOS_MAX_DEFAULT_VALUE; 565 c->default_value = FREQ_QOS_MAX_DEFAULT_VALUE; 566 c->no_constraint_value = FREQ_QOS_MAX_DEFAULT_VALUE; 567 c->type = PM_QOS_MIN; 568 c->notifiers = &qos->max_freq_notifiers; 569 BLOCKING_INIT_NOTIFIER_HEAD(c->notifiers); 570 } 571 572 /** 573 * freq_qos_read_value - Get frequency QoS constraint for a given list. 574 * @qos: Constraints to evaluate. 575 * @type: QoS request type. 576 */ 577 s32 freq_qos_read_value(struct freq_constraints *qos, 578 enum freq_qos_req_type type) 579 { 580 s32 ret; 581 582 switch (type) { 583 case FREQ_QOS_MIN: 584 ret = IS_ERR_OR_NULL(qos) ? 585 FREQ_QOS_MIN_DEFAULT_VALUE : 586 pm_qos_read_value(&qos->min_freq); 587 break; 588 case FREQ_QOS_MAX: 589 ret = IS_ERR_OR_NULL(qos) ? 590 FREQ_QOS_MAX_DEFAULT_VALUE : 591 pm_qos_read_value(&qos->max_freq); 592 break; 593 default: 594 WARN_ON(1); 595 ret = 0; 596 } 597 598 return ret; 599 } 600 601 /** 602 * freq_qos_apply - Add/modify/remove frequency QoS request. 603 * @req: Constraint request to apply. 604 * @action: Action to perform (add/update/remove). 605 * @value: Value to assign to the QoS request. 606 * 607 * This is only meant to be called from inside pm_qos, not drivers. 608 */ 609 int freq_qos_apply(struct freq_qos_request *req, 610 enum pm_qos_req_action action, s32 value) 611 { 612 int ret; 613 614 switch(req->type) { 615 case FREQ_QOS_MIN: 616 ret = pm_qos_update_target(&req->qos->min_freq, &req->pnode, 617 action, value); 618 break; 619 case FREQ_QOS_MAX: 620 ret = pm_qos_update_target(&req->qos->max_freq, &req->pnode, 621 action, value); 622 break; 623 default: 624 ret = -EINVAL; 625 } 626 627 return ret; 628 } 629 630 /** 631 * freq_qos_add_request - Insert new frequency QoS request into a given list. 632 * @qos: Constraints to update. 633 * @req: Preallocated request object. 634 * @type: Request type. 635 * @value: Request value. 636 * 637 * Insert a new entry into the @qos list of requests, recompute the effective 638 * QoS constraint value for that list and initialize the @req object. The 639 * caller needs to save that object for later use in updates and removal. 640 * 641 * Return 1 if the effective constraint value has changed, 0 if the effective 642 * constraint value has not changed, or a negative error code on failures. 643 */ 644 int freq_qos_add_request(struct freq_constraints *qos, 645 struct freq_qos_request *req, 646 enum freq_qos_req_type type, s32 value) 647 { 648 int ret; 649 650 if (IS_ERR_OR_NULL(qos) || !req || freq_qos_value_invalid(value)) 651 return -EINVAL; 652 653 if (WARN(freq_qos_request_active(req), 654 "%s() called for active request\n", __func__)) 655 return -EINVAL; 656 657 req->qos = qos; 658 req->type = type; 659 ret = freq_qos_apply(req, PM_QOS_ADD_REQ, value); 660 if (ret < 0) { 661 req->qos = NULL; 662 req->type = 0; 663 } 664 665 return ret; 666 } 667 EXPORT_SYMBOL_GPL(freq_qos_add_request); 668 669 /** 670 * freq_qos_update_request - Modify existing frequency QoS request. 671 * @req: Request to modify. 672 * @new_value: New request value. 673 * 674 * Update an existing frequency QoS request along with the effective constraint 675 * value for the list of requests it belongs to. 676 * 677 * Return 1 if the effective constraint value has changed, 0 if the effective 678 * constraint value has not changed, or a negative error code on failures. 679 */ 680 int freq_qos_update_request(struct freq_qos_request *req, s32 new_value) 681 { 682 if (!req || freq_qos_value_invalid(new_value)) 683 return -EINVAL; 684 685 if (WARN(!freq_qos_request_active(req), 686 "%s() called for unknown object\n", __func__)) 687 return -EINVAL; 688 689 if (req->pnode.prio == new_value) 690 return 0; 691 692 return freq_qos_apply(req, PM_QOS_UPDATE_REQ, new_value); 693 } 694 EXPORT_SYMBOL_GPL(freq_qos_update_request); 695 696 /** 697 * freq_qos_remove_request - Remove frequency QoS request from its list. 698 * @req: Request to remove. 699 * 700 * Remove the given frequency QoS request from the list of constraints it 701 * belongs to and recompute the effective constraint value for that list. 702 * 703 * Return 1 if the effective constraint value has changed, 0 if the effective 704 * constraint value has not changed, or a negative error code on failures. 705 */ 706 int freq_qos_remove_request(struct freq_qos_request *req) 707 { 708 int ret; 709 710 if (!req) 711 return -EINVAL; 712 713 if (WARN(!freq_qos_request_active(req), 714 "%s() called for unknown object\n", __func__)) 715 return -EINVAL; 716 717 ret = freq_qos_apply(req, PM_QOS_REMOVE_REQ, PM_QOS_DEFAULT_VALUE); 718 req->qos = NULL; 719 req->type = 0; 720 721 return ret; 722 } 723 EXPORT_SYMBOL_GPL(freq_qos_remove_request); 724 725 /** 726 * freq_qos_add_notifier - Add frequency QoS change notifier. 727 * @qos: List of requests to add the notifier to. 728 * @type: Request type. 729 * @notifier: Notifier block to add. 730 */ 731 int freq_qos_add_notifier(struct freq_constraints *qos, 732 enum freq_qos_req_type type, 733 struct notifier_block *notifier) 734 { 735 int ret; 736 737 if (IS_ERR_OR_NULL(qos) || !notifier) 738 return -EINVAL; 739 740 switch (type) { 741 case FREQ_QOS_MIN: 742 ret = blocking_notifier_chain_register(qos->min_freq.notifiers, 743 notifier); 744 break; 745 case FREQ_QOS_MAX: 746 ret = blocking_notifier_chain_register(qos->max_freq.notifiers, 747 notifier); 748 break; 749 default: 750 WARN_ON(1); 751 ret = -EINVAL; 752 } 753 754 return ret; 755 } 756 EXPORT_SYMBOL_GPL(freq_qos_add_notifier); 757 758 /** 759 * freq_qos_remove_notifier - Remove frequency QoS change notifier. 760 * @qos: List of requests to remove the notifier from. 761 * @type: Request type. 762 * @notifier: Notifier block to remove. 763 */ 764 int freq_qos_remove_notifier(struct freq_constraints *qos, 765 enum freq_qos_req_type type, 766 struct notifier_block *notifier) 767 { 768 int ret; 769 770 if (IS_ERR_OR_NULL(qos) || !notifier) 771 return -EINVAL; 772 773 switch (type) { 774 case FREQ_QOS_MIN: 775 ret = blocking_notifier_chain_unregister(qos->min_freq.notifiers, 776 notifier); 777 break; 778 case FREQ_QOS_MAX: 779 ret = blocking_notifier_chain_unregister(qos->max_freq.notifiers, 780 notifier); 781 break; 782 default: 783 WARN_ON(1); 784 ret = -EINVAL; 785 } 786 787 return ret; 788 } 789 EXPORT_SYMBOL_GPL(freq_qos_remove_notifier); 790