Merge tag 'fixes-non-critical-for-linus' of git://git.kernel.org/pub/scm/linux/kernel...
[linux-2.6.git] / Documentation / thermal / cpu-cooling-api.txt
blobfca24c931ec8dcb737012b6b67f6b88a8fef2223
1 CPU cooling APIs How To
2 ===================================
4 Written by Amit Daniel Kachhap <amit.kachhap@linaro.org>
6 Updated: 12 May 2012
8 Copyright (c)  2012 Samsung Electronics Co., Ltd(http://www.samsung.com)
10 0. Introduction
12 The generic cpu cooling(freq clipping) provides registration/unregistration APIs
13 to the caller. The binding of the cooling devices to the trip point is left for
14 the user. The registration APIs returns the cooling device pointer.
16 1. cpu cooling APIs
18 1.1 cpufreq registration/unregistration APIs
19 1.1.1 struct thermal_cooling_device *cpufreq_cooling_register(
20         struct cpumask *clip_cpus)
22     This interface function registers the cpufreq cooling device with the name
23     "thermal-cpufreq-%x". This api can support multiple instances of cpufreq
24     cooling devices.
26    clip_cpus: cpumask of cpus where the frequency constraints will happen.
28 1.1.2 void cpufreq_cooling_unregister(struct thermal_cooling_device *cdev)
30     This interface function unregisters the "thermal-cpufreq-%x" cooling device.
32     cdev: Cooling device pointer which has to be unregistered.