[mirror_ubuntu-artful-kernel.git] / block / blk-cgroup.h

#ifndef _BLK_CGROUP_H
#define _BLK_CGROUP_H
/*
 * Common Block IO controller cgroup interface
 *
 * Based on ideas and code from CFQ, CFS and BFQ:
 * Copyright (C) 2003 Jens Axboe <axboe@kernel.dk>
 *
 * Copyright (C) 2008 Fabio Checconi <fabio@gandalf.sssup.it>
 *		      Paolo Valente <paolo.valente@unimore.it>
 *
 * Copyright (C) 2009 Vivek Goyal <vgoyal@redhat.com>
 * 	              Nauman Rafique <nauman@google.com>
 */

#include <linux/cgroup.h>
#include <linux/u64_stats_sync.h>

enum blkio_policy_id {
	BLKIO_POLICY_PROP = 0,		/* Proportional Bandwidth division */
	BLKIO_POLICY_THROTL,		/* Throttling */

	BLKIO_NR_POLICIES,
};

/* Max limits for throttle policy */
#define THROTL_IOPS_MAX		UINT_MAX

#ifdef CONFIG_BLK_CGROUP

enum stat_type {
	/* Total time spent (in ns) between request dispatch to the driver and
	 * request completion for IOs doen by this cgroup. This may not be
	 * accurate when NCQ is turned on. */
	BLKIO_STAT_SERVICE_TIME = 0,
	/* Total time spent waiting in scheduler queue in ns */
	BLKIO_STAT_WAIT_TIME,
	/* Number of IOs queued up */
	BLKIO_STAT_QUEUED,
	/* All the single valued stats go below this */
	BLKIO_STAT_TIME,
#ifdef CONFIG_DEBUG_BLK_CGROUP
	/* Time not charged to this cgroup */
	BLKIO_STAT_UNACCOUNTED_TIME,
	BLKIO_STAT_AVG_QUEUE_SIZE,
	BLKIO_STAT_IDLE_TIME,
	BLKIO_STAT_EMPTY_TIME,
	BLKIO_STAT_GROUP_WAIT_TIME,
	BLKIO_STAT_DEQUEUE
#endif
};

/* Per cpu stats */
enum stat_type_cpu {
	BLKIO_STAT_CPU_SECTORS,
	/* Total bytes transferred */
	BLKIO_STAT_CPU_SERVICE_BYTES,
	/* Total IOs serviced, post merge */
	BLKIO_STAT_CPU_SERVICED,
	/* Number of IOs merged */
	BLKIO_STAT_CPU_MERGED,
	BLKIO_STAT_CPU_NR
};

enum stat_sub_type {
	BLKIO_STAT_READ = 0,
	BLKIO_STAT_WRITE,
	BLKIO_STAT_SYNC,
	BLKIO_STAT_ASYNC,
	BLKIO_STAT_TOTAL
};

/* blkg state flags */
enum blkg_state_flags {
	BLKG_waiting = 0,
	BLKG_idling,
	BLKG_empty,
};

/* cgroup files owned by proportional weight policy */
enum blkcg_file_name_prop {
	BLKIO_PROP_weight = 1,
	BLKIO_PROP_weight_device,
	BLKIO_PROP_io_service_bytes,
	BLKIO_PROP_io_serviced,
	BLKIO_PROP_time,
	BLKIO_PROP_sectors,
	BLKIO_PROP_unaccounted_time,
	BLKIO_PROP_io_service_time,
	BLKIO_PROP_io_wait_time,
	BLKIO_PROP_io_merged,
	BLKIO_PROP_io_queued,
	BLKIO_PROP_avg_queue_size,
	BLKIO_PROP_group_wait_time,
	BLKIO_PROP_idle_time,
	BLKIO_PROP_empty_time,
	BLKIO_PROP_dequeue,
};

/* cgroup files owned by throttle policy */
enum blkcg_file_name_throtl {
	BLKIO_THROTL_read_bps_device,
	BLKIO_THROTL_write_bps_device,
	BLKIO_THROTL_read_iops_device,
	BLKIO_THROTL_write_iops_device,
	BLKIO_THROTL_io_service_bytes,
	BLKIO_THROTL_io_serviced,
};

struct blkio_cgroup {
	struct cgroup_subsys_state css;
	unsigned int weight;
	spinlock_t lock;
	struct hlist_head blkg_list;
};

struct blkio_group_stats {
	/* total disk time and nr sectors dispatched by this group */
	uint64_t time;
	uint64_t stat_arr[BLKIO_STAT_QUEUED + 1][BLKIO_STAT_TOTAL];
#ifdef CONFIG_DEBUG_BLK_CGROUP
	/* Time not charged to this cgroup */
	uint64_t unaccounted_time;

	/* Sum of number of IOs queued across all samples */
	uint64_t avg_queue_size_sum;
	/* Count of samples taken for average */
	uint64_t avg_queue_size_samples;
	/* How many times this group has been removed from service tree */
	unsigned long dequeue;

	/* Total time spent waiting for it to be assigned a timeslice. */
	uint64_t group_wait_time;
	uint64_t start_group_wait_time;

	/* Time spent idling for this blkio_group */
	uint64_t idle_time;
	uint64_t start_idle_time;
	/*
	 * Total time when we have requests queued and do not contain the
	 * current active queue.
	 */
	uint64_t empty_time;
	uint64_t start_empty_time;
	uint16_t flags;
#endif
};

/* Per cpu blkio group stats */
struct blkio_group_stats_cpu {
	uint64_t sectors;
	uint64_t stat_arr_cpu[BLKIO_STAT_CPU_NR][BLKIO_STAT_TOTAL];
	struct u64_stats_sync syncp;
};

struct blkio_group_conf {
	unsigned int weight;
	unsigned int iops[2];
	u64 bps[2];
};

/* per-blkg per-policy data */
struct blkg_policy_data {
	/* the blkg this per-policy data belongs to */
	struct blkio_group *blkg;

	/* Configuration */
	struct blkio_group_conf conf;

	struct blkio_group_stats stats;
	/* Per cpu stats pointer */
	struct blkio_group_stats_cpu __percpu *stats_cpu;

	/* pol->pdata_size bytes of private data used by policy impl */
	char pdata[] __aligned(__alignof__(unsigned long long));
};

struct blkio_group {
	/* Pointer to the associated request_queue, RCU protected */
	struct request_queue __rcu *q;
	struct list_head q_node;
	struct hlist_node blkcg_node;
	struct blkio_cgroup *blkcg;
	/* Store cgroup path */
	char path[128];
	/* reference count */
	int refcnt;

	/* Need to serialize the stats in the case of reset/update */
	spinlock_t stats_lock;
	struct blkg_policy_data *pd[BLKIO_NR_POLICIES];

	struct rcu_head rcu_head;
};

typedef void (blkio_init_group_fn)(struct blkio_group *blkg);
typedef void (blkio_update_group_weight_fn)(struct request_queue *q,
			struct blkio_group *blkg, unsigned int weight);
typedef void (blkio_update_group_read_bps_fn)(struct request_queue *q,
			struct blkio_group *blkg, u64 read_bps);
typedef void (blkio_update_group_write_bps_fn)(struct request_queue *q,
			struct blkio_group *blkg, u64 write_bps);
typedef void (blkio_update_group_read_iops_fn)(struct request_queue *q,
			struct blkio_group *blkg, unsigned int read_iops);
typedef void (blkio_update_group_write_iops_fn)(struct request_queue *q,
			struct blkio_group *blkg, unsigned int write_iops);

struct blkio_policy_ops {
	blkio_init_group_fn *blkio_init_group_fn;
	blkio_update_group_weight_fn *blkio_update_group_weight_fn;
	blkio_update_group_read_bps_fn *blkio_update_group_read_bps_fn;
	blkio_update_group_write_bps_fn *blkio_update_group_write_bps_fn;
	blkio_update_group_read_iops_fn *blkio_update_group_read_iops_fn;
	blkio_update_group_write_iops_fn *blkio_update_group_write_iops_fn;
};

struct blkio_policy_type {
	struct list_head list;
	struct blkio_policy_ops ops;
	enum blkio_policy_id plid;
	size_t pdata_size;		/* policy specific private data size */
};

extern int blkcg_init_queue(struct request_queue *q);
extern void blkcg_drain_queue(struct request_queue *q);
extern void blkcg_exit_queue(struct request_queue *q);

/* Blkio controller policy registration */
extern void blkio_policy_register(struct blkio_policy_type *);
extern void blkio_policy_unregister(struct blkio_policy_type *);
extern void blkg_destroy_all(struct request_queue *q, bool destroy_root);
extern void update_root_blkg_pd(struct request_queue *q,
				enum blkio_policy_id plid);

/**
 * blkg_to_pdata - get policy private data
 * @blkg: blkg of interest
 * @pol: policy of interest
 *
 * Return pointer to private data associated with the @blkg-@pol pair.
 */
static inline void *blkg_to_pdata(struct blkio_group *blkg,
			      struct blkio_policy_type *pol)
{
	return blkg ? blkg->pd[pol->plid]->pdata : NULL;
}

/**
 * pdata_to_blkg - get blkg associated with policy private data
 * @pdata: policy private data of interest
 * @pol: policy @pdata is for
 *
 * @pdata is policy private data for @pol.  Determine the blkg it's
 * associated with.
 */
static inline struct blkio_group *pdata_to_blkg(void *pdata,
						struct blkio_policy_type *pol)
{
	if (pdata) {
		struct blkg_policy_data *pd =
			container_of(pdata, struct blkg_policy_data, pdata);
		return pd->blkg;
	}
	return NULL;
}

static inline char *blkg_path(struct blkio_group *blkg)
{
	return blkg->path;
}

/**
 * blkg_get - get a blkg reference
 * @blkg: blkg to get
 *
 * The caller should be holding queue_lock and an existing reference.
 */
static inline void blkg_get(struct blkio_group *blkg)
{
	lockdep_assert_held(blkg->q->queue_lock);
	WARN_ON_ONCE(!blkg->refcnt);
	blkg->refcnt++;
}

void __blkg_release(struct blkio_group *blkg);

/**
 * blkg_put - put a blkg reference
 * @blkg: blkg to put
 *
 * The caller should be holding queue_lock.
 */
static inline void blkg_put(struct blkio_group *blkg)
{
	lockdep_assert_held(blkg->q->queue_lock);
	WARN_ON_ONCE(blkg->refcnt <= 0);
	if (!--blkg->refcnt)
		__blkg_release(blkg);
}

#else

struct blkio_group {
};

struct blkio_policy_type {
};

static inline int blkcg_init_queue(struct request_queue *q) { return 0; }
static inline void blkcg_drain_queue(struct request_queue *q) { }
static inline void blkcg_exit_queue(struct request_queue *q) { }
static inline void blkio_policy_register(struct blkio_policy_type *blkiop) { }
static inline void blkio_policy_unregister(struct blkio_policy_type *blkiop) { }
static inline void blkg_destroy_all(struct request_queue *q,
				    bool destory_root) { }
static inline void update_root_blkg_pd(struct request_queue *q,
				       enum blkio_policy_id plid) { }

static inline void *blkg_to_pdata(struct blkio_group *blkg,
				struct blkio_policy_type *pol) { return NULL; }
static inline struct blkio_group *pdata_to_blkg(void *pdata,
				struct blkio_policy_type *pol) { return NULL; }
static inline char *blkg_path(struct blkio_group *blkg) { return NULL; }
static inline void blkg_get(struct blkio_group *blkg) { }
static inline void blkg_put(struct blkio_group *blkg) { }

#endif

#define BLKIO_WEIGHT_MIN	10
#define BLKIO_WEIGHT_MAX	1000
#define BLKIO_WEIGHT_DEFAULT	500

#ifdef CONFIG_DEBUG_BLK_CGROUP
void blkiocg_update_avg_queue_size_stats(struct blkio_group *blkg,
					 struct blkio_policy_type *pol);
void blkiocg_update_dequeue_stats(struct blkio_group *blkg,
				  struct blkio_policy_type *pol,
				  unsigned long dequeue);
void blkiocg_update_set_idle_time_stats(struct blkio_group *blkg,
					struct blkio_policy_type *pol);
void blkiocg_update_idle_time_stats(struct blkio_group *blkg,
				    struct blkio_policy_type *pol);
void blkiocg_set_start_empty_time(struct blkio_group *blkg,
				  struct blkio_policy_type *pol);

#define BLKG_FLAG_FNS(name)						\
static inline void blkio_mark_blkg_##name(				\
		struct blkio_group_stats *stats)			\
{									\
	stats->flags |= (1 << BLKG_##name);				\
}									\
static inline void blkio_clear_blkg_##name(				\
		struct blkio_group_stats *stats)			\
{									\
	stats->flags &= ~(1 << BLKG_##name);				\
}									\
static inline int blkio_blkg_##name(struct blkio_group_stats *stats)	\
{									\
	return (stats->flags & (1 << BLKG_##name)) != 0;		\
}									\

BLKG_FLAG_FNS(waiting)
BLKG_FLAG_FNS(idling)
BLKG_FLAG_FNS(empty)
#undef BLKG_FLAG_FNS
#else
static inline void blkiocg_update_avg_queue_size_stats(struct blkio_group *blkg,
			struct blkio_policy_type *pol) { }
static inline void blkiocg_update_dequeue_stats(struct blkio_group *blkg,
			struct blkio_policy_type *pol, unsigned long dequeue) { }
static inline void blkiocg_update_set_idle_time_stats(struct blkio_group *blkg,
			struct blkio_policy_type *pol) { }
static inline void blkiocg_update_idle_time_stats(struct blkio_group *blkg,
			struct blkio_policy_type *pol) { }
static inline void blkiocg_set_start_empty_time(struct blkio_group *blkg,
			struct blkio_policy_type *pol) { }
#endif

#ifdef CONFIG_BLK_CGROUP
extern struct blkio_cgroup blkio_root_cgroup;
extern struct blkio_cgroup *cgroup_to_blkio_cgroup(struct cgroup *cgroup);
extern struct blkio_cgroup *task_blkio_cgroup(struct task_struct *tsk);
extern struct blkio_group *blkg_lookup(struct blkio_cgroup *blkcg,
				       struct request_queue *q);
struct blkio_group *blkg_lookup_create(struct blkio_cgroup *blkcg,
				       struct request_queue *q,
				       enum blkio_policy_id plid,
				       bool for_root);
void blkiocg_update_timeslice_used(struct blkio_group *blkg,
				   struct blkio_policy_type *pol,
				   unsigned long time,
				   unsigned long unaccounted_time);
void blkiocg_update_dispatch_stats(struct blkio_group *blkg,
				   struct blkio_policy_type *pol,
				   uint64_t bytes, bool direction, bool sync);
void blkiocg_update_completion_stats(struct blkio_group *blkg,
				     struct blkio_policy_type *pol,
				     uint64_t start_time,
				     uint64_t io_start_time, bool direction,
				     bool sync);
void blkiocg_update_io_merged_stats(struct blkio_group *blkg,
				    struct blkio_policy_type *pol,
				    bool direction, bool sync);
void blkiocg_update_io_add_stats(struct blkio_group *blkg,
				 struct blkio_policy_type *pol,
				 struct blkio_group *curr_blkg, bool direction,
				 bool sync);
void blkiocg_update_io_remove_stats(struct blkio_group *blkg,
				    struct blkio_policy_type *pol,
				    bool direction, bool sync);
#else
struct cgroup;
static inline struct blkio_cgroup *
cgroup_to_blkio_cgroup(struct cgroup *cgroup) { return NULL; }
static inline struct blkio_cgroup *
task_blkio_cgroup(struct task_struct *tsk) { return NULL; }

static inline struct blkio_group *blkg_lookup(struct blkio_cgroup *blkcg,
					      void *key) { return NULL; }
static inline void blkiocg_update_timeslice_used(struct blkio_group *blkg,
			struct blkio_policy_type *pol, unsigned long time,
			unsigned long unaccounted_time) { }
static inline void blkiocg_update_dispatch_stats(struct blkio_group *blkg,
			struct blkio_policy_type *pol, uint64_t bytes,
			bool direction, bool sync) { }
static inline void blkiocg_update_completion_stats(struct blkio_group *blkg,
			struct blkio_policy_type *pol, uint64_t start_time,
			uint64_t io_start_time, bool direction, bool sync) { }
static inline void blkiocg_update_io_merged_stats(struct blkio_group *blkg,
			struct blkio_policy_type *pol, bool direction,
			bool sync) { }
static inline void blkiocg_update_io_add_stats(struct blkio_group *blkg,
			struct blkio_policy_type *pol,
			struct blkio_group *curr_blkg, bool direction,
			bool sync) { }
static inline void blkiocg_update_io_remove_stats(struct blkio_group *blkg,
			struct blkio_policy_type *pol, bool direction,
			bool sync) { }
#endif
#endif /* _BLK_CGROUP_H */
Commit	Line	Data
31e4c28d VG	1	#ifndef _BLK_CGROUP_H
	2	#define _BLK_CGROUP_H
	3	/*
	4	* Common Block IO controller cgroup interface
	5	*
	6	* Based on ideas and code from CFQ, CFS and BFQ:
	7	* Copyright (C) 2003 Jens Axboe <axboe@kernel.dk>
	8	*
	9	* Copyright (C) 2008 Fabio Checconi <fabio@gandalf.sssup.it>
	10	* Paolo Valente <paolo.valente@unimore.it>
	11	*
	12	* Copyright (C) 2009 Vivek Goyal <vgoyal@redhat.com>
	13	* Nauman Rafique <nauman@google.com>
	14	*/
	15
	16	#include <linux/cgroup.h>
575969a0	17	#include <linux/u64_stats_sync.h>
31e4c28d	18
062a644d VG	19	enum blkio_policy_id {
062a644d VG	20	BLKIO_POLICY_PROP = 0, /* Proportional Bandwidth division */
4c9eefa1	21	BLKIO_POLICY_THROTL, /* Throttling */
035d10b2 TH	22
035d10b2 TH	23	BLKIO_NR_POLICIES,
062a644d VG	24	};
062a644d VG	25
9355aede VG	26	/* Max limits for throttle policy */
	27	#define THROTL_IOPS_MAX UINT_MAX
	28
32e380ae	29	#ifdef CONFIG_BLK_CGROUP
2f5ea477	30
84c124da DS	31	enum stat_type {
	32	/* Total time spent (in ns) between request dispatch to the driver and
	33	* request completion for IOs doen by this cgroup. This may not be
	34	* accurate when NCQ is turned on. */
	35	BLKIO_STAT_SERVICE_TIME = 0,
84c124da DS	36	/* Total time spent waiting in scheduler queue in ns */
84c124da DS	37	BLKIO_STAT_WAIT_TIME,
cdc1184c DS	38	/* Number of IOs queued up */
cdc1184c DS	39	BLKIO_STAT_QUEUED,
84c124da DS	40	/* All the single valued stats go below this */
84c124da DS	41	BLKIO_STAT_TIME,
a23e6869	42	#ifdef CONFIG_DEBUG_BLK_CGROUP
167400d3 JT	43	/* Time not charged to this cgroup */
167400d3 JT	44	BLKIO_STAT_UNACCOUNTED_TIME,
cdc1184c	45	BLKIO_STAT_AVG_QUEUE_SIZE,
812df48d DS	46	BLKIO_STAT_IDLE_TIME,
	47	BLKIO_STAT_EMPTY_TIME,
	48	BLKIO_STAT_GROUP_WAIT_TIME,
84c124da DS	49	BLKIO_STAT_DEQUEUE
	50	#endif
	51	};
	52
5624a4e4 VG	53	/* Per cpu stats */
	54	enum stat_type_cpu {
	55	BLKIO_STAT_CPU_SECTORS,
	56	/* Total bytes transferred */
	57	BLKIO_STAT_CPU_SERVICE_BYTES,
	58	/* Total IOs serviced, post merge */
	59	BLKIO_STAT_CPU_SERVICED,
317389a7 VG	60	/* Number of IOs merged */
317389a7 VG	61	BLKIO_STAT_CPU_MERGED,
5624a4e4 VG	62	BLKIO_STAT_CPU_NR
	63	};
	64
84c124da DS	65	enum stat_sub_type {
	66	BLKIO_STAT_READ = 0,
	67	BLKIO_STAT_WRITE,
	68	BLKIO_STAT_SYNC,
	69	BLKIO_STAT_ASYNC,
	70	BLKIO_STAT_TOTAL
303a3acb DS	71	};
303a3acb DS	72
812df48d DS	73	/* blkg state flags */
	74	enum blkg_state_flags {
	75	BLKG_waiting = 0,
	76	BLKG_idling,
	77	BLKG_empty,
	78	};
	79
062a644d VG	80	/* cgroup files owned by proportional weight policy */
	81	enum blkcg_file_name_prop {
	82	BLKIO_PROP_weight = 1,
	83	BLKIO_PROP_weight_device,
	84	BLKIO_PROP_io_service_bytes,
	85	BLKIO_PROP_io_serviced,
	86	BLKIO_PROP_time,
	87	BLKIO_PROP_sectors,
167400d3	88	BLKIO_PROP_unaccounted_time,
062a644d VG	89	BLKIO_PROP_io_service_time,
	90	BLKIO_PROP_io_wait_time,
	91	BLKIO_PROP_io_merged,
	92	BLKIO_PROP_io_queued,
	93	BLKIO_PROP_avg_queue_size,
	94	BLKIO_PROP_group_wait_time,
	95	BLKIO_PROP_idle_time,
	96	BLKIO_PROP_empty_time,
	97	BLKIO_PROP_dequeue,
	98	};
	99
4c9eefa1 VG	100	/* cgroup files owned by throttle policy */
	101	enum blkcg_file_name_throtl {
	102	BLKIO_THROTL_read_bps_device,
	103	BLKIO_THROTL_write_bps_device,
7702e8f4 VG	104	BLKIO_THROTL_read_iops_device,
7702e8f4 VG	105	BLKIO_THROTL_write_iops_device,
4c9eefa1 VG	106	BLKIO_THROTL_io_service_bytes,
	107	BLKIO_THROTL_io_serviced,
	108	};
	109
31e4c28d VG	110	struct blkio_cgroup {
	111	struct cgroup_subsys_state css;
	112	unsigned int weight;
	113	spinlock_t lock;
	114	struct hlist_head blkg_list;
	115	};
	116
303a3acb DS	117	struct blkio_group_stats {
	118	/* total disk time and nr sectors dispatched by this group */
	119	uint64_t time;
cdc1184c	120	uint64_t stat_arr[BLKIO_STAT_QUEUED + 1][BLKIO_STAT_TOTAL];
303a3acb	121	#ifdef CONFIG_DEBUG_BLK_CGROUP
a23e6869 VG	122	/* Time not charged to this cgroup */
	123	uint64_t unaccounted_time;
	124
cdc1184c DS	125	/* Sum of number of IOs queued across all samples */
	126	uint64_t avg_queue_size_sum;
	127	/* Count of samples taken for average */
	128	uint64_t avg_queue_size_samples;
303a3acb DS	129	/* How many times this group has been removed from service tree */
303a3acb DS	130	unsigned long dequeue;
812df48d DS	131
	132	/* Total time spent waiting for it to be assigned a timeslice. */
	133	uint64_t group_wait_time;
	134	uint64_t start_group_wait_time;
	135
	136	/* Time spent idling for this blkio_group */
	137	uint64_t idle_time;
	138	uint64_t start_idle_time;
	139	/*
	140	* Total time when we have requests queued and do not contain the
	141	* current active queue.
	142	*/
	143	uint64_t empty_time;
	144	uint64_t start_empty_time;
	145	uint16_t flags;
303a3acb DS	146	#endif
	147	};
	148
5624a4e4 VG	149	/* Per cpu blkio group stats */
	150	struct blkio_group_stats_cpu {
	151	uint64_t sectors;
	152	uint64_t stat_arr_cpu[BLKIO_STAT_CPU_NR][BLKIO_STAT_TOTAL];
575969a0	153	struct u64_stats_sync syncp;
5624a4e4 VG	154	};
5624a4e4 VG	155
e56da7e2 TH	156	struct blkio_group_conf {
	157	unsigned int weight;
	158	unsigned int iops[2];
	159	u64 bps[2];
	160	};
	161
0381411e TH	162	/* per-blkg per-policy data */
	163	struct blkg_policy_data {
	164	/* the blkg this per-policy data belongs to */
	165	struct blkio_group *blkg;
	166
549d3aa8 TH	167	/* Configuration */
	168	struct blkio_group_conf conf;
	169
	170	struct blkio_group_stats stats;
	171	/* Per cpu stats pointer */
	172	struct blkio_group_stats_cpu __percpu *stats_cpu;
	173
0381411e TH	174	/* pol->pdata_size bytes of private data used by policy impl */
	175	char pdata[] __aligned(__alignof__(unsigned long long));
	176	};
	177
31e4c28d	178	struct blkio_group {
ca32aefc TH	179	/* Pointer to the associated request_queue, RCU protected */
ca32aefc TH	180	struct request_queue __rcu *q;
e8989fae	181	struct list_head q_node;
31e4c28d	182	struct hlist_node blkcg_node;
7ee9c562	183	struct blkio_cgroup *blkcg;
2868ef7b VG	184	/* Store cgroup path */
2868ef7b VG	185	char path[128];
1adaf3dd TH	186	/* reference count */
1adaf3dd TH	187	int refcnt;
22084190	188
303a3acb DS	189	/* Need to serialize the stats in the case of reset/update */
303a3acb DS	190	spinlock_t stats_lock;
549d3aa8	191	struct blkg_policy_data *pd[BLKIO_NR_POLICIES];
1adaf3dd TH	192
1adaf3dd TH	193	struct rcu_head rcu_head;
31e4c28d VG	194	};
31e4c28d VG	195
0381411e	196	typedef void (blkio_init_group_fn)(struct blkio_group *blkg);
ca32aefc	197	typedef void (blkio_update_group_weight_fn)(struct request_queue *q,
fe071437	198	struct blkio_group *blkg, unsigned int weight);
ca32aefc	199	typedef void (blkio_update_group_read_bps_fn)(struct request_queue *q,
fe071437	200	struct blkio_group *blkg, u64 read_bps);
ca32aefc	201	typedef void (blkio_update_group_write_bps_fn)(struct request_queue *q,
fe071437	202	struct blkio_group *blkg, u64 write_bps);
ca32aefc	203	typedef void (blkio_update_group_read_iops_fn)(struct request_queue *q,
fe071437	204	struct blkio_group *blkg, unsigned int read_iops);
ca32aefc	205	typedef void (blkio_update_group_write_iops_fn)(struct request_queue *q,
fe071437	206	struct blkio_group *blkg, unsigned int write_iops);
3e252066 VG	207
3e252066 VG	208	struct blkio_policy_ops {
0381411e	209	blkio_init_group_fn *blkio_init_group_fn;
3e252066	210	blkio_update_group_weight_fn *blkio_update_group_weight_fn;
4c9eefa1 VG	211	blkio_update_group_read_bps_fn *blkio_update_group_read_bps_fn;
4c9eefa1 VG	212	blkio_update_group_write_bps_fn *blkio_update_group_write_bps_fn;
7702e8f4 VG	213	blkio_update_group_read_iops_fn *blkio_update_group_read_iops_fn;
7702e8f4 VG	214	blkio_update_group_write_iops_fn *blkio_update_group_write_iops_fn;
3e252066 VG	215	};
	216
	217	struct blkio_policy_type {
	218	struct list_head list;
	219	struct blkio_policy_ops ops;
062a644d	220	enum blkio_policy_id plid;
0381411e	221	size_t pdata_size; /* policy specific private data size */
3e252066 VG	222	};
3e252066 VG	223
5efd6113 TH	224	extern int blkcg_init_queue(struct request_queue *q);
	225	extern void blkcg_drain_queue(struct request_queue *q);
	226	extern void blkcg_exit_queue(struct request_queue *q);
	227
3e252066 VG	228	/* Blkio controller policy registration */
	229	extern void blkio_policy_register(struct blkio_policy_type *);
	230	extern void blkio_policy_unregister(struct blkio_policy_type *);
e8989fae TH	231	extern void blkg_destroy_all(struct request_queue *q, bool destroy_root);
	232	extern void update_root_blkg_pd(struct request_queue *q,
	233	enum blkio_policy_id plid);
3e252066	234
0381411e TH	235	/**
	236	* blkg_to_pdata - get policy private data
	237	* @blkg: blkg of interest
	238	* @pol: policy of interest
	239	*
	240	* Return pointer to private data associated with the @blkg-@pol pair.
	241	*/
	242	static inline void blkg_to_pdata(struct blkio_group blkg,
	243	struct blkio_policy_type *pol)
	244	{
549d3aa8	245	return blkg ? blkg->pd[pol->plid]->pdata : NULL;
0381411e TH	246	}
	247
	248	/**
	249	* pdata_to_blkg - get blkg associated with policy private data
	250	* @pdata: policy private data of interest
	251	* @pol: policy @pdata is for
	252	*
	253	* @pdata is policy private data for @pol. Determine the blkg it's
	254	* associated with.
	255	*/
	256	static inline struct blkio_group pdata_to_blkg(void pdata,
	257	struct blkio_policy_type *pol)
	258	{
	259	if (pdata) {
	260	struct blkg_policy_data *pd =
	261	container_of(pdata, struct blkg_policy_data, pdata);
	262	return pd->blkg;
	263	}
	264	return NULL;
	265	}
	266
afc24d49 VG	267	static inline char blkg_path(struct blkio_group blkg)
	268	{
	269	return blkg->path;
	270	}
	271
1adaf3dd TH	272	/**
	273	* blkg_get - get a blkg reference
	274	* @blkg: blkg to get
	275	*
	276	* The caller should be holding queue_lock and an existing reference.
	277	*/
	278	static inline void blkg_get(struct blkio_group *blkg)
	279	{
	280	lockdep_assert_held(blkg->q->queue_lock);
	281	WARN_ON_ONCE(!blkg->refcnt);
	282	blkg->refcnt++;
	283	}
	284
	285	void __blkg_release(struct blkio_group *blkg);
	286
	287	/**
	288	* blkg_put - put a blkg reference
	289	* @blkg: blkg to put
	290	*
	291	* The caller should be holding queue_lock.
	292	*/
	293	static inline void blkg_put(struct blkio_group *blkg)
	294	{
	295	lockdep_assert_held(blkg->q->queue_lock);
	296	WARN_ON_ONCE(blkg->refcnt <= 0);
	297	if (!--blkg->refcnt)
	298	__blkg_release(blkg);
	299	}
	300
2f5ea477 JA	301	#else
	302
	303	struct blkio_group {
	304	};
	305
3e252066 VG	306	struct blkio_policy_type {
	307	};
	308
5efd6113 TH	309	static inline int blkcg_init_queue(struct request_queue *q) { return 0; }
	310	static inline void blkcg_drain_queue(struct request_queue *q) { }
	311	static inline void blkcg_exit_queue(struct request_queue *q) { }
3e252066 VG	312	static inline void blkio_policy_register(struct blkio_policy_type *blkiop) { }
3e252066 VG	313	static inline void blkio_policy_unregister(struct blkio_policy_type *blkiop) { }
03aa264a	314	static inline void blkg_destroy_all(struct request_queue *q,
03aa264a	315	bool destory_root) { }
e8989fae TH	316	static inline void update_root_blkg_pd(struct request_queue *q,
e8989fae TH	317	enum blkio_policy_id plid) { }
3e252066	318
0381411e TH	319	static inline void blkg_to_pdata(struct blkio_group blkg,
	320	struct blkio_policy_type *pol) { return NULL; }
	321	static inline struct blkio_group pdata_to_blkg(void pdata,
	322	struct blkio_policy_type *pol) { return NULL; }
afc24d49	323	static inline char blkg_path(struct blkio_group blkg) { return NULL; }
1adaf3dd TH	324	static inline void blkg_get(struct blkio_group *blkg) { }
1adaf3dd TH	325	static inline void blkg_put(struct blkio_group *blkg) { }
afc24d49	326
2f5ea477 JA	327	#endif
2f5ea477 JA	328
df457f84	329	#define BLKIO_WEIGHT_MIN 10
31e4c28d VG	330	#define BLKIO_WEIGHT_MAX 1000
	331	#define BLKIO_WEIGHT_DEFAULT 500
	332
2868ef7b	333	#ifdef CONFIG_DEBUG_BLK_CGROUP
c1768268 TH	334	void blkiocg_update_avg_queue_size_stats(struct blkio_group *blkg,
c1768268 TH	335	struct blkio_policy_type *pol);
9195291e	336	void blkiocg_update_dequeue_stats(struct blkio_group *blkg,
c1768268 TH	337	struct blkio_policy_type *pol,
	338	unsigned long dequeue);
	339	void blkiocg_update_set_idle_time_stats(struct blkio_group *blkg,
	340	struct blkio_policy_type *pol);
	341	void blkiocg_update_idle_time_stats(struct blkio_group *blkg,
	342	struct blkio_policy_type *pol);
	343	void blkiocg_set_start_empty_time(struct blkio_group *blkg,
	344	struct blkio_policy_type *pol);
812df48d DS	345
	346	#define BLKG_FLAG_FNS(name) \
	347	static inline void blkio_mark_blkg_##name( \
	348	struct blkio_group_stats *stats) \
	349	{ \
	350	stats->flags \|= (1 << BLKG_##name); \
	351	} \
	352	static inline void blkio_clear_blkg_##name( \
	353	struct blkio_group_stats *stats) \
	354	{ \
	355	stats->flags &= ~(1 << BLKG_##name); \
	356	} \
	357	static inline int blkio_blkg_##name(struct blkio_group_stats *stats) \
	358	{ \
	359	return (stats->flags & (1 << BLKG_##name)) != 0; \
	360	} \
	361
	362	BLKG_FLAG_FNS(waiting)
	363	BLKG_FLAG_FNS(idling)
	364	BLKG_FLAG_FNS(empty)
	365	#undef BLKG_FLAG_FNS
2868ef7b	366	#else
c1768268 TH	367	static inline void blkiocg_update_avg_queue_size_stats(struct blkio_group *blkg,
c1768268 TH	368	struct blkio_policy_type *pol) { }
9195291e	369	static inline void blkiocg_update_dequeue_stats(struct blkio_group *blkg,
c1768268 TH	370	struct blkio_policy_type *pol, unsigned long dequeue) { }
	371	static inline void blkiocg_update_set_idle_time_stats(struct blkio_group *blkg,
	372	struct blkio_policy_type *pol) { }
	373	static inline void blkiocg_update_idle_time_stats(struct blkio_group *blkg,
	374	struct blkio_policy_type *pol) { }
	375	static inline void blkiocg_set_start_empty_time(struct blkio_group *blkg,
	376	struct blkio_policy_type *pol) { }
2868ef7b VG	377	#endif
2868ef7b VG	378
32e380ae	379	#ifdef CONFIG_BLK_CGROUP
31e4c28d VG	380	extern struct blkio_cgroup blkio_root_cgroup;
31e4c28d VG	381	extern struct blkio_cgroup cgroup_to_blkio_cgroup(struct cgroup cgroup);
70087dc3	382	extern struct blkio_cgroup task_blkio_cgroup(struct task_struct tsk);
cd1604fa	383	extern struct blkio_group blkg_lookup(struct blkio_cgroup blkcg,
e8989fae	384	struct request_queue *q);
cd1604fa TH	385	struct blkio_group blkg_lookup_create(struct blkio_cgroup blkcg,
	386	struct request_queue *q,
	387	enum blkio_policy_id plid,
	388	bool for_root);
303a3acb	389	void blkiocg_update_timeslice_used(struct blkio_group *blkg,
c1768268 TH	390	struct blkio_policy_type *pol,
	391	unsigned long time,
	392	unsigned long unaccounted_time);
	393	void blkiocg_update_dispatch_stats(struct blkio_group *blkg,
	394	struct blkio_policy_type *pol,
	395	uint64_t bytes, bool direction, bool sync);
84c124da	396	void blkiocg_update_completion_stats(struct blkio_group *blkg,
c1768268 TH	397	struct blkio_policy_type *pol,
	398	uint64_t start_time,
	399	uint64_t io_start_time, bool direction,
	400	bool sync);
	401	void blkiocg_update_io_merged_stats(struct blkio_group *blkg,
	402	struct blkio_policy_type *pol,
	403	bool direction, bool sync);
a11cdaa7	404	void blkiocg_update_io_add_stats(struct blkio_group *blkg,
c1768268 TH	405	struct blkio_policy_type *pol,
	406	struct blkio_group *curr_blkg, bool direction,
	407	bool sync);
a11cdaa7	408	void blkiocg_update_io_remove_stats(struct blkio_group *blkg,
c1768268 TH	409	struct blkio_policy_type *pol,
c1768268 TH	410	bool direction, bool sync);
31e4c28d	411	#else
2f5ea477	412	struct cgroup;
31e4c28d VG	413	static inline struct blkio_cgroup *
31e4c28d VG	414	cgroup_to_blkio_cgroup(struct cgroup *cgroup) { return NULL; }
70087dc3 VG	415	static inline struct blkio_cgroup *
70087dc3 VG	416	task_blkio_cgroup(struct task_struct *tsk) { return NULL; }
31e4c28d	417
cd1604fa TH	418	static inline struct blkio_group blkg_lookup(struct blkio_cgroup blkcg,
cd1604fa TH	419	void *key) { return NULL; }
303a3acb	420	static inline void blkiocg_update_timeslice_used(struct blkio_group *blkg,
c1768268 TH	421	struct blkio_policy_type *pol, unsigned long time,
c1768268 TH	422	unsigned long unaccounted_time) { }
84c124da	423	static inline void blkiocg_update_dispatch_stats(struct blkio_group *blkg,
c1768268 TH	424	struct blkio_policy_type *pol, uint64_t bytes,
c1768268 TH	425	bool direction, bool sync) { }
84c124da	426	static inline void blkiocg_update_completion_stats(struct blkio_group *blkg,
c1768268 TH	427	struct blkio_policy_type *pol, uint64_t start_time,
c1768268 TH	428	uint64_t io_start_time, bool direction, bool sync) { }
812d4026	429	static inline void blkiocg_update_io_merged_stats(struct blkio_group *blkg,
c1768268 TH	430	struct blkio_policy_type *pol, bool direction,
c1768268 TH	431	bool sync) { }
a11cdaa7	432	static inline void blkiocg_update_io_add_stats(struct blkio_group *blkg,
c1768268 TH	433	struct blkio_policy_type *pol,
	434	struct blkio_group *curr_blkg, bool direction,
	435	bool sync) { }
a11cdaa7	436	static inline void blkiocg_update_io_remove_stats(struct blkio_group *blkg,
c1768268 TH	437	struct blkio_policy_type *pol, bool direction,
c1768268 TH	438	bool sync) { }
31e4c28d VG	439	#endif
31e4c28d VG	440	#endif /* _BLK_CGROUP_H */