[RFC v02 1/5] PowerCap: Documentation
From: Srinivas Pandruvada
Date: Wed Aug 07 2013 - 12:13:22 EST
Added power cap framework documentation. This explains the use of power capping
framework, sysfs and programming interface.
There are two documents:
Documentation/powercap/PowerCappingFramework.txt: Explains use case and API in
details.
Documentation/ABI/testing/sysfs-class-powercap: Explains ABIs.
Reviewed-by: Len Brown <len.brown@xxxxxxxxx>
Signed-off-by: Srinivas Pandruvada <srinivas.pandruvada@xxxxxxxxxxxxxxx>
Signed-off-by: Jacob Pan <jacob.jun.pan@xxxxxxxxxxxxxxx>
Signed-off-by: Arjan van de Ven <arjan@xxxxxxxxxxxxxxx>
---
Documentation/ABI/testing/sysfs-class-powercap | 165 ++++++
Documentation/powercap/PowerCappingFramework.txt | 686 +++++++++++++++++++++++
2 files changed, 851 insertions(+)
create mode 100644 Documentation/ABI/testing/sysfs-class-powercap
create mode 100644 Documentation/powercap/PowerCappingFramework.txt
diff --git a/Documentation/ABI/testing/sysfs-class-powercap b/Documentation/ABI/testing/sysfs-class-powercap
new file mode 100644
index 0000000..0e5d6e4
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-class-powercap
@@ -0,0 +1,165 @@
+What: /sys/class/power_cap/
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ The power_cap/ class sub directory belongs to the power cap
+ subsystem. Refer to
+ Documentation/powercap/PowerCappingFramework.txt for details.
+
+What: /sys/class/power_cap/controller_name
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ The /sys/class/power_cap/controller_name directories correspond
+ to each controller under power_cap control. Here controller_name
+ is a unique name under /sys/class_power_cap. Each
+ controller_name directory contains one or more power zones.
+
+What: /sys/class/power_cap/controller_name/type
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ For controller type is "controller". This allows user space
+ to differentiate between a controller device from a power zone
+ device.
+
+What: /sys/class/power_cap/controller_name/power_zone
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ A Controller can have one or more power zones. A power zone is
+ an abstraction of devices, which can be independently monitored
+ and controlled.
+
+What: /sys/class/power_cap/controller_name/power_zone/power_zone
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ A power zone can have one or more power zones as children.
+ This child power zone provides monitoring and control for
+ a subset of device under parent. E.g. if there is parent
+ power zone for whole CPU package, each CPU cores in it can be
+ a child power zone.
+
+What: /sys/class/power_cap/controller_name/power_zone/name
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Specifies the name of this power zone.
+
+
+What: /sys/class/power_cap/controller_name/power_zone/type
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ For power zone type is "power-zone".
+
+
+What: /sys/class/power_cap/controller_name/power_zone/energy_uj
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Current energy counter in micro-joules. Write "0" to reset.
+ If the counter can not be reset, then this attribute is
+ read-only.
+
+What: /sys/class/power_cap/controller_name/power_zone/
+ max_energy_range_uj
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Range of the above energy counter in micro-joules.
+
+
+What: /sys/class/power_cap/controller_name/power_zone/power_uw
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Current power in micro-watts. Write "0" to reset.
+ If the value can not be reset, then the attribute is read
+ only.
+
+What: /sys/class/power_cap/controller_name/power_zone/
+ max_power_range_uw
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Range of the above power value in micro-watts.
+
+What: /sys/class/power_cap/controller_name/power_zone/
+ constraint_X_name
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Each power zone can define one or more constraints. Each
+ constraint can have optional name. Here "X" can have values
+ from 0 to max integer.
+
+What: /sys/class/power_cap/controller_name/power_zone/
+ constraint_X_power_limit_uw
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Power limit in micro-watts, which should be applicable for
+ the time window specified by "constraint_X_time_window_us".
+ Here "X" can have values from 0 to max integer.
+
+What: /sys/class/power_cap/controller_name/power_zone/
+ constraint_X_time_window_us
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Time window in micro seconds. This is used along with
+ constraint_X_power_limit_uw to define a power constraint.
+ Here "X" can have values from 0 to max integer.
+
+
+What: /sys/class/power_cap/controller_name/power_zone/
+ constraint_X_max_power_uw
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Maximum allowed power in micro watts for this constraint.
+ Here "X" can have values from 0 to max integer.
+
+What: /sys/class/power_cap/controller_name/power_zone/
+ constraint_X_min_power_uw
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Minimum allowed power in micro watts for this constraint.
+ Here "X" can have values from 0 to max integer.
+
+What: /sys/class/power_cap/controller_name/power_zone/
+ constraint_X_max_time_window_us
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Maximum allowed time window in micro seconds for this
+ constraint. Here "X" can have values from 0 to max integer.
+
+What: /sys/class/power_cap/controller_name/power_zone/
+ constraint_X_min_time_window_us
+Date: August 2013
+KernelVersion: 3.12
+Contact: linux-pm@xxxxxxxxxxxxxxx
+Description:
+ Minimum allowed time window in micro seconds for this
+ constraint. Here "X" can have values from 0 to max integer.
diff --git a/Documentation/powercap/PowerCappingFramework.txt b/Documentation/powercap/PowerCappingFramework.txt
new file mode 100644
index 0000000..8d9c02ee
--- /dev/null
+++ b/Documentation/powercap/PowerCappingFramework.txt
@@ -0,0 +1,686 @@
+Power Capping Framework
+==================================
+
+The Linux Power Capping Framework provides user-space with a common
+API to kernel-mode power-capping drivers. At the same time,
+it provides the hardware-specific power-capping drivers with
+a uniform API to user-space.
+
+Terminology
+=========================
+The Power Capping framework organizes power capping devices under a tree structure.
+At the root level, each device is under some "controller", which is the enabler
+of technology. For example this can be "RAPL".
+Under each controllers, there are multiple power zones, which can be independently
+monitored and controlled.
+Each power zone can be organized as a tree with parent, children and siblings.
+Each power zone defines attributes to enable power monitoring and constraints.
+
+Example sysfs interface tree:
+
+/sys/devices/virtual/power_cap
+âââ intel-rapl
+ âââ intel-rapl:0
+ â âââ constraint_0_name
+ â âââ constraint_0_power_limit_uw
+ â âââ constraint_0_time_window_us
+ â âââ constraint_1_name
+ â âââ constraint_1_power_limit_uw
+ â âââ constraint_1_time_window_us
+ â âââ device -> ../../intel-rapl
+ â âââ energy_uj
+ â âââ intel-rapl:0:0
+ â â âââ constraint_0_name
+ â â âââ constraint_0_power_limit_uw
+ â â âââ constraint_0_time_window_us
+ â â âââ constraint_1_name
+ â â âââ constraint_1_power_limit_uw
+ â â âââ constraint_1_time_window_us
+ â â âââ device -> ../../intel-rapl:0
+ â â âââ energy_uj
+ â â âââ max_energy_range_uj
+ â â âââ name
+ â â âââ power
+ â â â âââ async
+ â â â âââ autosuspend_delay_ms
+ â â â âââ control
+ â â â âââ runtime_active_kids
+ â â â âââ runtime_active_time
+ â â â âââ runtime_enabled
+ â â â âââ runtime_status
+ â â â âââ runtime_suspended_time
+ â â â âââ runtime_usage
+ â â âââ subsystem -> ../../../../../../class/power_cap
+ â â âââ type
+ â â âââ uevent
+ â âââ intel-rapl:0:1
+ â â âââ constraint_0_name
+ â â âââ constraint_0_power_limit_uw
+ â â âââ constraint_0_time_window_us
+ â â âââ constraint_1_name
+ â â âââ constraint_1_power_limit_uw
+ â â âââ constraint_1_time_window_us
+ â â âââ device -> ../../intel-rapl:0
+ â â âââ energy_uj
+ â â âââ max_energy_range_uj
+ â â âââ name
+ â â âââ power
+ â â â âââ async
+ â â â âââ autosuspend_delay_ms
+ â â â âââ control
+ â â â âââ runtime_active_kids
+ â â â âââ runtime_active_time
+ â â â âââ runtime_enabled
+ â â â âââ runtime_status
+ â â â âââ runtime_suspended_time
+ â â â âââ runtime_usage
+ â â âââ subsystem -> ../../../../../../class/power_cap
+ â â âââ type
+ â â âââ uevent
+ â âââ max_energy_range_uj
+ â âââ max_power_range_uw
+ â âââ name
+ â âââ power
+ â â âââ async
+ â â âââ autosuspend_delay_ms
+ â â âââ control
+ â â âââ runtime_active_kids
+ â â âââ runtime_active_time
+ â â âââ runtime_enabled
+ â â âââ runtime_status
+ â â âââ runtime_suspended_time
+ â â âââ runtime_usage
+ â âââ subsystem -> ../../../../../class/power_cap
+ â âââ type
+ â âââ uevent
+ âââ intel-rapl:1
+ â âââ constraint_0_name
+ â âââ constraint_0_power_limit_uw
+ â âââ constraint_0_time_window_us
+ â âââ constraint_1_name
+ â âââ constraint_1_power_limit_uw
+ â âââ constraint_1_time_window_us
+ â âââ device -> ../../intel-rapl
+ â âââ energy_uj
+ â âââ intel-rapl:1:0
+ â â âââ constraint_0_name
+ â â âââ constraint_0_power_limit_uw
+ â â âââ constraint_0_time_window_us
+ â â âââ constraint_1_name
+ â â âââ constraint_1_power_limit_uw
+ â â âââ constraint_1_time_window_us
+ â â âââ device -> ../../intel-rapl:1
+ â â âââ energy_uj
+ â â âââ max_energy_range_uj
+ â â âââ name
+ â â âââ power
+ â â â âââ async
+ â â â âââ autosuspend_delay_ms
+ â â â âââ control
+ â â â âââ runtime_active_kids
+ â â â âââ runtime_active_time
+ â â â âââ runtime_enabled
+ â â â âââ runtime_status
+ â â â âââ runtime_suspended_time
+ â â â âââ runtime_usage
+ â â âââ subsystem -> ../../../../../../class/power_cap
+ â â âââ type
+ â â âââ uevent
+ â âââ intel-rapl:1:1
+ â â âââ constraint_0_name
+ â â âââ constraint_0_power_limit_uw
+ â â âââ constraint_0_time_window_us
+ â â âââ constraint_1_name
+ â â âââ constraint_1_power_limit_uw
+ â â âââ constraint_1_time_window_us
+ â â âââ device -> ../../intel-rapl:1
+ â â âââ energy_uj
+ â â âââ max_energy_range_uj
+ â â âââ name
+ â â âââ power
+ â â â âââ async
+ â â â âââ autosuspend_delay_ms
+ â â â âââ control
+ â â â âââ runtime_active_kids
+ â â â âââ runtime_active_time
+ â â â âââ runtime_enabled
+ â â â âââ runtime_status
+ â â â âââ runtime_suspended_time
+ â â â âââ runtime_usage
+ â â âââ subsystem -> ../../../../../../class/power_cap
+ â â âââ type
+ â â âââ uevent
+ â âââ max_energy_range_uj
+ â âââ max_power_range_uw
+ â âââ name
+ â âââ powerintel-rapl:0
+ â â âââ async
+ â â âââ autosuspend_delay_ms
+ â â âââ control
+ â â âââ runtime_active_kids
+ â â âââ runtime_active_time
+ â â âââ runtime_enabled
+ â â âââ runtime_status
+ â â âââ runtime_suspended_time
+ â â âââ runtime_usage
+ â âââ subsystem -> ../../../../../class/power_cap
+ â âââ type
+ â âââ uevent
+ âââ power
+ â âââ async
+ â âââ autosuspend_delay_ms
+ â âââ control
+ â âââ runtime_active_kids
+ â âââ runtime_active_time
+ â âââ runtime_enabled
+ â âââ runtime_status
+ â âââ runtime_suspended_time
+ â âââ runtime_usage
+ âââ subsystem -> ../../../../class/power_cap
+ âââ type
+ âââ uevent
+
+
+For example, above powercap sysfs tree represents RAPL(Running Average Power Limit)
+type controls available in the Intel 64 and IA-32 Processor Architectures. Here
+under controller "intel-rapl" there are two CPU packages (package-0/1), which can
+provide power monitoring and controls (intel-rapl:0 and intel-rapl:1). Each power
+zone has a name.
+For example:
+cat /sys/class/power_cap/intel-rapl/intel-rapl:0/name
+package-0
+
+In addition to providing monitoring and control at package level, each package
+is further divided into child power zones (called domains in the RAPL specifications).
+Here zones represent controls for core and dram parts. These zones can be represented
+as children of package.
+For example:
+cat /sys/class/power_cap/intel-rapl/intel-rapl:0/intel-rapl:0:1/name
+dram
+
+Under RAPL framework there are two constraints, one for
+short term and one for long term, with two different time windows. These can be
+represented as two constraints, with different time windows, power limits and names.
+For example:
+ constraint_0_name
+ constraint_0_power_limit_uw
+ constraint_0_time_window_us
+ constraint_1_name
+ constraint_1_power_limit_uw
+ constraint_1_time_window_us
+
+Power Zone Attributes
+=================================
+Monitoring attributes
+----------------------
+
+energy_uj (rw): Current energy counter in micro joules. Write "0" to reset.
+If the counter can not be reset, then this attribute is read only.
+
+max_energy_range_uj (ro): Range of the above energy counter in micro-joules.
+
+power_uw (rw): Current power in micro watts. Write "0" to resets the value.
+If the value can not be reset, then this attribute is read only.
+
+max_power_range_uw (ro): Range of the above power value in micro-watts.
+
+name (ro): Name of this power zone.
+
+It is possible that some domains can have both power and energy counters and
+ranges, but at least one is mandatory.
+
+Constraints
+----------------
+constraint_X_power_limit_uw (rw): Power limit in micro watts, which should be
+applicable for the time window specified by "constraint_X_time_window_us".
+
+constraint_X_time_window_us (rw): Time window in micro seconds.
+
+constraint_X_name (ro): An optional name of the constraint
+
+constraint_X_max_power_uw(ro): Maximum allowed power in micro watts.
+
+constraint_X_min_power_uw(ro): Minimum allowed power in micro watts.
+
+constraint_X_max_time_window_us(ro): Maximum allowed time window in micro seconds.
+
+constraint_X_min_time_window_us(ro): Minimum allowed time window in micro seconds.
+
+In addition each node has an attribute "type", which shows, whether is a controller
+or power zone. Except power_limit_uw and time_window_us other fields are optional.
+
+Power Cap Client Driver Interface
+==================================
+The API summary:
+
+Call powercap_allocate_controller to define a controller with a name.
+Call powercap_zone_register for each power zone for this controller.
+power zones can have other power zone as a parent or don't have a
+parent.
+During powercap_zone_register defines number of constraints and callbacks.
+
+To Free a power zone call powercap_zone_unregister.
+To free a controller call powercap_deallocate_controller.
+
+Rest of this document is generated by using kernel-doc on
+powercap.h
+
+struct powercap_zone_constraint_ops - Define constraint callbacks
+
+struct powercap_zone_constraint_ops {
+ int (* set_power_limit_uw) (struct powercap_zone_device *, int, u64);
+ int (* get_power_limit_uw) (struct powercap_zone_device *, int, u64 *);
+ int (* set_time_window_us) (struct powercap_zone_device *, int, u64);
+ int (* get_time_window_us) (struct powercap_zone_device *, int, u64 *);
+ int (* get_max_power_uw) (struct powercap_zone_device *, int, u64 *);
+ int (* get_min_power_uw) (struct powercap_zone_device *, int, u64 *);
+ int (* get_max_time_window_us) (struct powercap_zone_device *, int, u64 *);
+ int (* get_min_time_window_us) (struct powercap_zone_device *, int, u64 *);
+ const char *(* get_name) (struct powercap_zone_device *, int);
+ void (* cleanup) (struct powercap_zone_device *, int);
+};
+
+Members:
+
+set_power_limit_uw
+ Set power limit in micro-watts.
+
+get_power_limit_uw
+ Get power limit in micro-watts.
+
+set_time_window_us
+ Set time window in micro-seconds.
+
+get_time_window_us
+ Get time window in micro-seconds.
+
+get_max_power_uw
+ Get max power allowed in micro-watts.
+
+get_min_power_uw
+ Get min power allowed in micro-watts.
+
+get_max_time_window_us
+ Get max time window allowed in micro-seconds.
+
+get_min_time_window_us
+ Get min time window allowed in micro-seconds.
+
+get_name
+ Get the name of constraint
+
+cleanup
+ Do any clean up before the constraint is freed
+This structure is used to define the constraint callbacks for the client
+drivers. The following callbacks are mandatory and can't be NULL:
+ set_power_limit_uw
+ get_power_limit_uw
+ set_time_window_us
+ get_time_window_us
+ get_name
+
+
+
+
+
+struct powercap_controller - Defines a powercap controller
+
+struct powercap_controller {
+ char name[POWERCAP_CTRL_NAME_LENGTH + 1];
+ struct device device;
+ struct idr idr;
+ void * root_node;
+ struct mutex node_lock;
+ struct list_head ctrl_inst;
+};
+
+Members:
+
+name[POWERCAP_CTRL_NAME_LENGTH + 1]
+ name of controller
+
+device
+ device for this controller
+
+idr
+ idr to have unique id for its child
+
+root_node
+ Root holding power zones for this controller
+
+node_lock
+ mutex for node
+
+ctrl_inst
+ link to the controller list
+
+
+
+Description:
+
+Defines powercap controller instance
+
+
+struct powercap_zone_ops - Define power zone callbacks
+
+struct powercap_zone_ops {
+ int (* get_max_energy_range_uj) (struct powercap_zone_device *, u64 *);
+ int (* get_energy_uj) (struct powercap_zone_device *, u64 *);
+ int (* reset_energy_uj) (struct powercap_zone_device *);
+ int (* get_max_power_range_uw) (struct powercap_zone_device *, u64 *);
+ int (* get_power_uw) (struct powercap_zone_device *, u64 *);
+ int (* reset_power_uw) (struct powercap_zone_device *);
+ void (* cleanup) (struct powercap_zone_device *);
+};
+
+Members:
+
+get_max_energy_range_uj
+ Get maximum range of energy counter in
+ micro-joules.
+
+get_energy_uj
+ Get current energy counter in micro-joules.
+
+reset_energy_uj
+ Reset micro-joules energy counter.
+
+get_max_power_range_uw
+ Get maximum range of power counter in
+ micro-watts.
+
+get_power_uw
+ Get current power counter in micro-watts.
+
+reset_power_uw
+ Reset micro-watts power counter.
+
+cleanup
+ Do any clean up before the zone is freed
+
+
+
+Description:
+
+This structure defines zone callbacks to be implemented by client drivers.
+Client drives can define both energy and power related callbacks. But at
+the least one type (either power or energy) is mandatory.
+
+
+struct powercap_zone_attr - Defines a per zone attribute group
+
+struct powercap_zone_attr {
+ struct attribute * zone_dev_attrs[POWERCAP_ZONE_MAX_ATTRS];
+ int zone_attr_count;
+ struct attribute * const_dev_attrs[POWERCAP_CONSTRAINTS_MAX_ATTRS];
+ int const_attr_count;
+ struct attribute_group dev_zone_attr_group;
+ struct attribute_group dev_const_attr_group;
+ int attr_grp_cnt;
+ const struct attribute_group * dev_attr_groups[POWERCAP_MAX_ATTR_GROUPS + 1];
+};
+
+Members:
+
+zone_dev_attrs[POWERCAP_ZONE_MAX_ATTRS]
+ Device attribute list for power zone.
+
+zone_attr_count
+ Number of power zone attributes.
+
+const_dev_attrs[POWERCAP_CONSTRAINTS_MAX_ATTRS]
+ Constraint attributes.
+
+const_attr_count
+ Number of constraint related attributes
+
+dev_zone_attr_group
+ Attribute group for power zone attributes
+
+dev_const_attr_group
+ Attribute group for constraints
+
+attr_grp_cnt
+ Number of attribute groups
+
+dev_attr_groups[POWERCAP_MAX_ATTR_GROUPS + 1]
+ Used to assign to dev->group
+
+
+
+Description:
+
+Used to add an attribute group unique to a zone based on registry.
+
+
+struct powercap_zone_device - Defines instance of a power cap zone
+
+struct powercap_zone_device {
+ int id;
+ char * zone_dev_name;
+ char name[POWERCAP_ZONE_NAME_LENGTH + 1];
+ void * controller_inst;
+ const struct powercap_zone_ops * ops;
+ struct device device;
+ struct powercap_zone_attr attrs;
+ void * node;
+ int const_id_cnt;
+ struct mutex lock;
+ struct idr idr;
+ struct idr * par_idr;
+ void * drv_data;
+ struct list_head constraint_list;
+};
+
+Members:
+
+id
+ Unique id
+
+zone_dev_name
+ Zone device sysfs node name
+
+name[POWERCAP_ZONE_NAME_LENGTH + 1]
+ Power zone name.
+
+controller_inst
+ Controller instance for this zone
+
+ops
+ Pointer to the zone operation structure.
+
+device
+ Instance of a device.
+
+attrs
+ Attributes associated with this device
+
+node
+ Node pointer to insert to a tree data structure.
+
+const_id_cnt
+ Constraint id count
+
+lock
+ Mutex to protect zone related operations.
+
+idr
+ Instance to an idr entry for children zones.
+
+par_idr
+ To remove reference from the parent idr
+
+drv_data
+ Driver private data
+
+constraint_list
+ Link to the next power zone for this controller.
+
+
+
+Description:
+
+This defines a power zone instance. The fields of this structure are
+private, and should not be used by client drivers.
+
+
+Name:
+
+powercap_set_zone_data - Set private data for a zone
+
+Synopsis:
+
+void powercap_set_zone_data (struct powercap_zone_device * pcd_dev,
+ void * pdata);
+
+Arguments:
+
+pcd_dev
+ A pointer to the valid zone instance.
+
+pdata
+ A pointer to the user private data.
+
+
+Description:
+
+Allows client drivers to associate some private data to zone instance.
+
+
+Name:
+
+powercap_get_zone_data - Get private data for a zone
+
+Synopsis:
+
+void * powercap_get_zone_data (struct powercap_zone_device * pcd_dev);
+
+Arguments:
+
+pcd_dev
+ A pointer to the valid zone instance.
+
+
+Description:
+
+Allows client drivers to get private data associate with a zone,
+using call to powercap_set_zone_data.
+
+
+Name:
+
+powercap_allocate_controller - Allocates a controller
+
+Synopsis:
+
+struct powercap_controller * powercap_allocate_controller (const char * controller_name);
+
+Arguments:
+
+controller_name
+ The Name of this controller, which will be shown
+ in the sysfs Interface.
+
+
+Description:
+
+Used to create a controller with the power capping class. Here controller
+can represent a type of technology, which can control a range of power zones.
+For example a controller can be RAPL (Running Average Power Limit)
+Intel 64 and IA-32 Processor Architectures. The name can be any string
+which must be unique, otherwise this function returns NULL.
+On successful allocation, this API returns a pointer to the
+controller instance.
+
+
+Name:
+
+powercap_deallocate_controller - Deallocates a controller
+
+Synopsis:
+
+void powercap_deallocate_controller (struct powercap_controller * instance);
+
+Arguments:
+
+instance
+ A pointer to the valid controller instance.
+
+
+Description:
+
+Used to deallocate a controller with the power capping class. This
+takes only one argument, which is the pointer to the instance returned
+by a call to powercap_allocate_controller.
+When a controller is deallocated, all zones and associated constraints
+are freed.
+
+
+Name:
+
+powercap_zone_register - Register a power zone
+
+Synopsis:
+
+struct powercap_zone_device * powercap_zone_register (struct powercap_controller * controller,
+ const char * name,
+ struct powercap_zone_device * parent,
+ const struct powercap_zone_ops * ops,
+ int no_constraints,
+ struct powercap_zone_constraint_ops * const_ops);
+
+Arguments:
+
+controller
+ A controller instance under which this zone operates.
+
+name
+ A name for this zone.
+
+parent
+ A pointer to the parent power zone instance if any or NULL
+
+ops
+ Pointer to zone operation callback structure.
+
+no_constraints
+ Number of constraints for this zone
+
+const_ops
+ Pointer to constraint callback structure
+
+
+Description:
+
+Used to register a power zone for a controller. Zones are organized in
+a tree like structure in sysfs under a controller.
+A power zone must a register a pointer to a structure representing zone
+callbacks.
+A power zone can have a some other power zone as a parent or it can be
+NULL to appear as a direct descendant of a controller.
+Each power zone can have number of constraints. Constraints appears
+under zones as attributes with unique id.
+
+
+Name:
+
+powercap_zone_unregister - Unregister a zone device
+
+Synopsis:
+
+int powercap_zone_unregister (struct powercap_controller * controller,
+ struct powercap_zone_device * pcd_dev);
+
+Arguments:
+
+controller
+ A pointer to the valid instance of a controller.
+
+pcd_dev
+ A pointer to the valid zone instance for a controller
+
+
+Description:
+
+Used to unregister a zone device for a controller. Once a zone is
+unregistered then all its children and associated constraints are freed.
--
1.8.3.1
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/