Release 4.15 include/linux/cpuidle.h
/*
* cpuidle.h - a generic framework for CPU idle power management
*
* (C) 2007 Venkatesh Pallipadi <venkatesh.pallipadi@intel.com>
* Shaohua Li <shaohua.li@intel.com>
* Adam Belay <abelay@novell.com>
*
* This code is licenced under the GPL.
*/
#ifndef _LINUX_CPUIDLE_H
#define _LINUX_CPUIDLE_H
#include <linux/percpu.h>
#include <linux/list.h>
#include <linux/hrtimer.h>
#define CPUIDLE_STATE_MAX 10
#define CPUIDLE_NAME_LEN 16
#define CPUIDLE_DESC_LEN 32
struct module;
struct cpuidle_device;
struct cpuidle_driver;
/****************************
* CPUIDLE DEVICE INTERFACE *
****************************/
struct cpuidle_state_usage {
unsigned long long disable;
unsigned long long usage;
unsigned long long time; /* in US */
};
struct cpuidle_state {
char name[CPUIDLE_NAME_LEN];
char desc[CPUIDLE_DESC_LEN];
unsigned int flags;
unsigned int exit_latency; /* in US */
int power_usage; /* in mW */
unsigned int target_residency; /* in US */
bool disabled; /* disabled on all CPUs */
int (*enter) (struct cpuidle_device *dev,
struct cpuidle_driver *drv,
int index);
int (*enter_dead) (struct cpuidle_device *dev, int index);
/*
* CPUs execute ->enter_s2idle with the local tick or entire timekeeping
* suspended, so it must not re-enable interrupts at any point (even
* temporarily) or attempt to change states of clock event devices.
*/
void (*enter_s2idle) (struct cpuidle_device *dev,
struct cpuidle_driver *drv,
int index);
};
/* Idle State Flags */
#define CPUIDLE_FLAG_NONE (0x00)
#define CPUIDLE_FLAG_POLLING (0x01)
/* polling state */
#define CPUIDLE_FLAG_COUPLED (0x02)
/* state applies to multiple cpus */
#define CPUIDLE_FLAG_TIMER_STOP (0x04)
/* timer is stopped on this state */
#define CPUIDLE_DRIVER_FLAGS_MASK (0xFFFF0000)
struct cpuidle_device_kobj;
struct cpuidle_state_kobj;
struct cpuidle_driver_kobj;
struct cpuidle_device {
unsigned int registered:1;
unsigned int enabled:1;
unsigned int use_deepest_state:1;
unsigned int cpu;
int last_residency;
struct cpuidle_state_usage states_usage[CPUIDLE_STATE_MAX];
struct cpuidle_state_kobj *kobjs[CPUIDLE_STATE_MAX];
struct cpuidle_driver_kobj *kobj_driver;
struct cpuidle_device_kobj *kobj_dev;
struct list_head device_list;
#ifdef CONFIG_ARCH_NEEDS_CPU_IDLE_COUPLED
cpumask_t coupled_cpus;
struct cpuidle_coupled *coupled;
#endif
};
DECLARE_PER_CPU(struct cpuidle_device *, cpuidle_devices);
DECLARE_PER_CPU(struct cpuidle_device, cpuidle_dev);
/**
* cpuidle_get_last_residency - retrieves the last state's residency time
* @dev: the target CPU
*/
static inline int cpuidle_get_last_residency(struct cpuidle_device *dev)
{
return dev->last_residency;
}
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 17 | 100.00% | 1 | 100.00% |
Total | 17 | 100.00% | 1 | 100.00% |
/****************************
* CPUIDLE DRIVER INTERFACE *
****************************/
struct cpuidle_driver {
const char *name;
struct module *owner;
int refcnt;
/* used by the cpuidle framework to setup the broadcast timer */
unsigned int bctimer:1;
/* states array must be ordered in decreasing power consumption */
struct cpuidle_state states[CPUIDLE_STATE_MAX];
int state_count;
int safe_state_index;
/* the driver handles the cpus in cpumask */
struct cpumask *cpumask;
};
#ifdef CONFIG_CPU_IDLE
extern void disable_cpuidle(void);
extern bool cpuidle_not_available(struct cpuidle_driver *drv,
struct cpuidle_device *dev);
extern int cpuidle_select(struct cpuidle_driver *drv,
struct cpuidle_device *dev);
extern int cpuidle_enter(struct cpuidle_driver *drv,
struct cpuidle_device *dev, int index);
extern void cpuidle_reflect(struct cpuidle_device *dev, int index);
extern int cpuidle_register_driver(struct cpuidle_driver *drv);
extern struct cpuidle_driver *cpuidle_get_driver(void);
extern struct cpuidle_driver *cpuidle_driver_ref(void);
extern void cpuidle_driver_unref(void);
extern void cpuidle_unregister_driver(struct cpuidle_driver *drv);
extern int cpuidle_register_device(struct cpuidle_device *dev);
extern void cpuidle_unregister_device(struct cpuidle_device *dev);
extern int cpuidle_register(struct cpuidle_driver *drv,
const struct cpumask *const coupled_cpus);
extern void cpuidle_unregister(struct cpuidle_driver *drv);
extern void cpuidle_pause_and_lock(void);
extern void cpuidle_resume_and_unlock(void);
extern void cpuidle_pause(void);
extern void cpuidle_resume(void);
extern int cpuidle_enable_device(struct cpuidle_device *dev);
extern void cpuidle_disable_device(struct cpuidle_device *dev);
extern int cpuidle_play_dead(void);
extern struct cpuidle_driver *cpuidle_get_cpu_driver(struct cpuidle_device *dev);
static inline struct cpuidle_device *cpuidle_get_device(void)
{return __this_cpu_read(cpuidle_devices); }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Catalin Marinas | 17 | 100.00% | 1 | 100.00% |
Total | 17 | 100.00% | 1 | 100.00% |
#else
static inline void disable_cpuidle(void) { }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 8 | 100.00% | 1 | 100.00% |
Total | 8 | 100.00% | 1 | 100.00% |
static inline bool cpuidle_not_available(struct cpuidle_driver *drv,
struct cpuidle_device *dev)
{return true; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Rafael J. Wysocki | 20 | 100.00% | 1 | 100.00% |
Total | 20 | 100.00% | 1 | 100.00% |
static inline int cpuidle_select(struct cpuidle_driver *drv,
struct cpuidle_device *dev)
{return -ENODEV; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Daniel Lezcano | 21 | 100.00% | 1 | 100.00% |
Total | 21 | 100.00% | 1 | 100.00% |
static inline int cpuidle_enter(struct cpuidle_driver *drv,
struct cpuidle_device *dev, int index)
{return -ENODEV; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Daniel Lezcano | 24 | 100.00% | 1 | 100.00% |
Total | 24 | 100.00% | 1 | 100.00% |
static inline void cpuidle_reflect(struct cpuidle_device *dev, int index) { }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Daniel Lezcano | 14 | 100.00% | 1 | 100.00% |
Total | 14 | 100.00% | 1 | 100.00% |
static inline int cpuidle_register_driver(struct cpuidle_driver *drv)
{return -ENODEV; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 16 | 100.00% | 2 | 100.00% |
Total | 16 | 100.00% | 2 | 100.00% |
static inline struct cpuidle_driver *cpuidle_get_driver(void) {return NULL; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 14 | 100.00% | 1 | 100.00% |
Total | 14 | 100.00% | 1 | 100.00% |
static inline struct cpuidle_driver *cpuidle_driver_ref(void) {return NULL; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Rafael J. Wysocki | 14 | 100.00% | 1 | 100.00% |
Total | 14 | 100.00% | 1 | 100.00% |
static inline void cpuidle_driver_unref(void) {}
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Rafael J. Wysocki | 8 | 100.00% | 1 | 100.00% |
Total | 8 | 100.00% | 1 | 100.00% |
static inline void cpuidle_unregister_driver(struct cpuidle_driver *drv) { }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 11 | 100.00% | 1 | 100.00% |
Total | 11 | 100.00% | 1 | 100.00% |
static inline int cpuidle_register_device(struct cpuidle_device *dev)
{return -ENODEV; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 16 | 100.00% | 2 | 100.00% |
Total | 16 | 100.00% | 2 | 100.00% |
static inline void cpuidle_unregister_device(struct cpuidle_device *dev) { }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 11 | 100.00% | 1 | 100.00% |
Total | 11 | 100.00% | 1 | 100.00% |
static inline int cpuidle_register(struct cpuidle_driver *drv,
const struct cpumask *const coupled_cpus)
{return -ENODEV; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Daniel Lezcano | 23 | 100.00% | 1 | 100.00% |
Total | 23 | 100.00% | 1 | 100.00% |
static inline void cpuidle_unregister(struct cpuidle_driver *drv) { }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Daniel Lezcano | 11 | 100.00% | 1 | 100.00% |
Total | 11 | 100.00% | 1 | 100.00% |
static inline void cpuidle_pause_and_lock(void) { }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 8 | 100.00% | 1 | 100.00% |
Total | 8 | 100.00% | 1 | 100.00% |
static inline void cpuidle_resume_and_unlock(void) { }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 8 | 100.00% | 1 | 100.00% |
Total | 8 | 100.00% | 1 | 100.00% |
static inline void cpuidle_pause(void) { }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Preeti U. Murthy | 8 | 100.00% | 1 | 100.00% |
Total | 8 | 100.00% | 1 | 100.00% |
static inline void cpuidle_resume(void) { }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Preeti U. Murthy | 8 | 100.00% | 1 | 100.00% |
Total | 8 | 100.00% | 1 | 100.00% |
static inline int cpuidle_enable_device(struct cpuidle_device *dev)
{return -ENODEV; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 16 | 100.00% | 2 | 100.00% |
Total | 16 | 100.00% | 2 | 100.00% |
static inline void cpuidle_disable_device(struct cpuidle_device *dev) { }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 11 | 100.00% | 1 | 100.00% |
Total | 11 | 100.00% | 1 | 100.00% |
static inline int cpuidle_play_dead(void) {return -ENODEV; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Boris Ostrovsky | 9 | 69.23% | 1 | 50.00% |
Robert Lee | 4 | 30.77% | 1 | 50.00% |
Total | 13 | 100.00% | 2 | 100.00% |
static inline struct cpuidle_driver *cpuidle_get_cpu_driver(
struct cpuidle_device *dev) {return NULL; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Rafael J. Wysocki | 17 | 100.00% | 2 | 100.00% |
Total | 17 | 100.00% | 2 | 100.00% |
static inline struct cpuidle_device *cpuidle_get_device(void) {return NULL; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Catalin Marinas | 14 | 100.00% | 1 | 100.00% |
Total | 14 | 100.00% | 1 | 100.00% |
#endif
#ifdef CONFIG_CPU_IDLE
extern int cpuidle_find_deepest_state(struct cpuidle_driver *drv,
struct cpuidle_device *dev);
extern int cpuidle_enter_s2idle(struct cpuidle_driver *drv,
struct cpuidle_device *dev);
extern void cpuidle_use_deepest_state(bool enable);
#else
static inline int cpuidle_find_deepest_state(struct cpuidle_driver *drv,
struct cpuidle_device *dev)
{return -ENODEV; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Rafael J. Wysocki | 21 | 100.00% | 3 | 100.00% |
Total | 21 | 100.00% | 3 | 100.00% |
static inline int cpuidle_enter_s2idle(struct cpuidle_driver *drv,
struct cpuidle_device *dev)
{return -ENODEV; }
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Daniel Lezcano | 14 | 66.67% | 1 | 33.33% |
Rafael J. Wysocki | 7 | 33.33% | 2 | 66.67% |
Total | 21 | 100.00% | 3 | 100.00% |
static inline void cpuidle_use_deepest_state(bool enable)
{
}
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Jacob jun Pan | 9 | 100.00% | 1 | 100.00% |
Total | 9 | 100.00% | 1 | 100.00% |
#endif
/* kernel/sched/idle.c */
extern void sched_idle_set_state(struct cpuidle_state *idle_state);
extern void default_idle_call(void);
#ifdef CONFIG_ARCH_NEEDS_CPU_IDLE_COUPLED
void cpuidle_coupled_parallel_barrier(struct cpuidle_device *dev, atomic_t *a);
#else
static inline void cpuidle_coupled_parallel_barrier(struct cpuidle_device *dev, atomic_t *a)
{
}
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Arnd Bergmann | 15 | 100.00% | 1 | 100.00% |
Total | 15 | 100.00% | 1 | 100.00% |
#endif
#ifdef CONFIG_ARCH_HAS_CPU_RELAX
void cpuidle_poll_state_init(struct cpuidle_driver *drv);
#else
static inline void cpuidle_poll_state_init(struct cpuidle_driver *drv) {}
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Rafael J. Wysocki | 11 | 100.00% | 2 | 100.00% |
Total | 11 | 100.00% | 2 | 100.00% |
#endif
/******************************
* CPUIDLE GOVERNOR INTERFACE *
******************************/
struct cpuidle_governor {
char name[CPUIDLE_NAME_LEN];
struct list_head governor_list;
unsigned int rating;
int (*enable) (struct cpuidle_driver *drv,
struct cpuidle_device *dev);
void (*disable) (struct cpuidle_driver *drv,
struct cpuidle_device *dev);
int (*select) (struct cpuidle_driver *drv,
struct cpuidle_device *dev);
void (*reflect) (struct cpuidle_device *dev, int index);
};
#ifdef CONFIG_CPU_IDLE
extern int cpuidle_register_governor(struct cpuidle_governor *gov);
#else
static inline int cpuidle_register_governor(struct cpuidle_governor *gov)
{return 0;}
Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 15 | 100.00% | 1 | 100.00% |
Total | 15 | 100.00% | 1 | 100.00% |
#endif
#define CPU_PM_CPU_IDLE_ENTER(low_level_idle_enter, idx) \
({ \
int __ret; \
\
if (!idx) { \
cpu_do_idle(); \
return idx; \
} \
\
__ret = cpu_pm_enter(); \
if (!__ret) { \
__ret = low_level_idle_enter(idx); \
cpu_pm_exit(); \
} \
\
__ret ? -1 : idx; \
})
#endif /* _LINUX_CPUIDLE_H */
Overall Contributors
Person | Tokens | Prop | Commits | CommitProp |
Len Brown | 469 | 38.70% | 6 | 12.24% |
Daniel Lezcano | 235 | 19.39% | 12 | 24.49% |
Rafael J. Wysocki | 229 | 18.89% | 12 | 24.49% |
Deepthi Dharwar | 57 | 4.70% | 3 | 6.12% |
Colin Cross | 36 | 2.97% | 2 | 4.08% |
Catalin Marinas | 31 | 2.56% | 1 | 2.04% |
Preeti U. Murthy | 30 | 2.48% | 1 | 2.04% |
Boris Ostrovsky | 29 | 2.39% | 1 | 2.04% |
Jacob jun Pan | 25 | 2.06% | 1 | 2.04% |
Arnd Bergmann | 17 | 1.40% | 1 | 2.04% |
Venkatesh Pallipadi | 16 | 1.32% | 2 | 4.08% |
Sudeep Holla | 10 | 0.83% | 1 | 2.04% |
Paul Burton | 8 | 0.66% | 1 | 2.04% |
Robert Lee | 7 | 0.58% | 1 | 2.04% |
Liu ShuoX | 5 | 0.41% | 1 | 2.04% |
Gautham R. Shenoy | 4 | 0.33% | 1 | 2.04% |
Paul Gortmaker | 3 | 0.25% | 1 | 2.04% |
Harvey Harrison | 1 | 0.08% | 1 | 2.04% |
Total | 1212 | 100.00% | 49 | 100.00% |
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.