Merge tag 'hwmon-for-v4.20' of git://git.kernel.org/pub/scm/linux/kernel/git/groeck...
[linux-2.6-block.git] / include / linux / blk-cgroup.h
CommitLineData
b2441318 1/* SPDX-License-Identifier: GPL-2.0 */
31e4c28d
VG
2#ifndef _BLK_CGROUP_H
3#define _BLK_CGROUP_H
4/*
5 * Common Block IO controller cgroup interface
6 *
7 * Based on ideas and code from CFQ, CFS and BFQ:
8 * Copyright (C) 2003 Jens Axboe <axboe@kernel.dk>
9 *
10 * Copyright (C) 2008 Fabio Checconi <fabio@gandalf.sssup.it>
11 * Paolo Valente <paolo.valente@unimore.it>
12 *
13 * Copyright (C) 2009 Vivek Goyal <vgoyal@redhat.com>
14 * Nauman Rafique <nauman@google.com>
15 */
16
17#include <linux/cgroup.h>
24bdb8ef 18#include <linux/percpu_counter.h>
829fdb50 19#include <linux/seq_file.h>
a637120e 20#include <linux/radix-tree.h>
a051661c 21#include <linux/blkdev.h>
a5049a8a 22#include <linux/atomic.h>
902ec5b6 23#include <linux/kthread.h>
31e4c28d 24
24bdb8ef
TH
25/* percpu_counter batch for blkg_[rw]stats, per-cpu drift doesn't matter */
26#define BLKG_STAT_CPU_BATCH (INT_MAX / 2)
27
9355aede
VG
28/* Max limits for throttle policy */
29#define THROTL_IOPS_MAX UINT_MAX
30
f48ec1d7
TH
31#ifdef CONFIG_BLK_CGROUP
32
edcb0722
TH
33enum blkg_rwstat_type {
34 BLKG_RWSTAT_READ,
35 BLKG_RWSTAT_WRITE,
36 BLKG_RWSTAT_SYNC,
37 BLKG_RWSTAT_ASYNC,
636620b6 38 BLKG_RWSTAT_DISCARD,
edcb0722
TH
39
40 BLKG_RWSTAT_NR,
41 BLKG_RWSTAT_TOTAL = BLKG_RWSTAT_NR,
303a3acb
DS
42};
43
a637120e
TH
44struct blkcg_gq;
45
3c798398 46struct blkcg {
36558c8a
TH
47 struct cgroup_subsys_state css;
48 spinlock_t lock;
a637120e
TH
49
50 struct radix_tree_root blkg_tree;
55679c8d 51 struct blkcg_gq __rcu *blkg_hint;
36558c8a 52 struct hlist_head blkg_list;
9a9e8a26 53
81437648 54 struct blkcg_policy_data *cpd[BLKCG_MAX_POLS];
52ebea74 55
7876f930 56 struct list_head all_blkcgs_node;
52ebea74
TH
57#ifdef CONFIG_CGROUP_WRITEBACK
58 struct list_head cgwb_list;
59b57717 59 refcount_t cgwb_refcnt;
52ebea74 60#endif
31e4c28d
VG
61};
62
e6269c44
TH
63/*
64 * blkg_[rw]stat->aux_cnt is excluded for local stats but included for
24bdb8ef
TH
65 * recursive. Used to carry stats of dead children, and, for blkg_rwstat,
66 * to carry result values from read and sum operations.
e6269c44 67 */
edcb0722 68struct blkg_stat {
24bdb8ef 69 struct percpu_counter cpu_cnt;
e6269c44 70 atomic64_t aux_cnt;
edcb0722
TH
71};
72
73struct blkg_rwstat {
24bdb8ef 74 struct percpu_counter cpu_cnt[BLKG_RWSTAT_NR];
e6269c44 75 atomic64_t aux_cnt[BLKG_RWSTAT_NR];
edcb0722
TH
76};
77
f95a04af
TH
78/*
79 * A blkcg_gq (blkg) is association between a block cgroup (blkcg) and a
80 * request_queue (q). This is used by blkcg policies which need to track
81 * information per blkcg - q pair.
82 *
001bea73
TH
83 * There can be multiple active blkcg policies and each blkg:policy pair is
84 * represented by a blkg_policy_data which is allocated and freed by each
85 * policy's pd_alloc/free_fn() methods. A policy can allocate private data
86 * area by allocating larger data structure which embeds blkg_policy_data
87 * at the beginning.
f95a04af 88 */
0381411e 89struct blkg_policy_data {
b276a876 90 /* the blkg and policy id this per-policy data belongs to */
3c798398 91 struct blkcg_gq *blkg;
b276a876 92 int plid;
0381411e
TH
93};
94
e48453c3 95/*
e4a9bde9
TH
96 * Policies that need to keep per-blkcg data which is independent from any
97 * request_queue associated to it should implement cpd_alloc/free_fn()
98 * methods. A policy can allocate private data area by allocating larger
99 * data structure which embeds blkcg_policy_data at the beginning.
100 * cpd_init() is invoked to let each policy handle per-blkcg data.
e48453c3
AA
101 */
102struct blkcg_policy_data {
81437648
TH
103 /* the blkcg and policy id this per-policy data belongs to */
104 struct blkcg *blkcg;
e48453c3 105 int plid;
e48453c3
AA
106};
107
3c798398
TH
108/* association between a blk cgroup and a request queue */
109struct blkcg_gq {
c875f4d0 110 /* Pointer to the associated request_queue */
36558c8a
TH
111 struct request_queue *q;
112 struct list_head q_node;
113 struct hlist_node blkcg_node;
3c798398 114 struct blkcg *blkcg;
3c547865 115
ce7acfea
TH
116 /*
117 * Each blkg gets congested separately and the congestion state is
118 * propagated to the matching bdi_writeback_congested.
119 */
120 struct bdi_writeback_congested *wb_congested;
121
3c547865
TH
122 /* all non-root blkcg_gq's are guaranteed to have access to parent */
123 struct blkcg_gq *parent;
124
a051661c
TH
125 /* request allocation list for this blkcg-q pair */
126 struct request_list rl;
3c547865 127
1adaf3dd 128 /* reference count */
b3b9f24f 129 struct percpu_ref refcnt;
22084190 130
f427d909
TH
131 /* is this blkg online? protected by both blkcg and q locks */
132 bool online;
133
77ea7338
TH
134 struct blkg_rwstat stat_bytes;
135 struct blkg_rwstat stat_ios;
136
36558c8a 137 struct blkg_policy_data *pd[BLKCG_MAX_POLS];
1adaf3dd 138
36558c8a 139 struct rcu_head rcu_head;
d09d8df3
JB
140
141 atomic_t use_delay;
142 atomic64_t delay_nsec;
143 atomic64_t delay_start;
144 u64 last_delay;
145 int last_use;
31e4c28d
VG
146};
147
e4a9bde9 148typedef struct blkcg_policy_data *(blkcg_pol_alloc_cpd_fn)(gfp_t gfp);
81437648 149typedef void (blkcg_pol_init_cpd_fn)(struct blkcg_policy_data *cpd);
e4a9bde9 150typedef void (blkcg_pol_free_cpd_fn)(struct blkcg_policy_data *cpd);
69d7fde5 151typedef void (blkcg_pol_bind_cpd_fn)(struct blkcg_policy_data *cpd);
001bea73 152typedef struct blkg_policy_data *(blkcg_pol_alloc_pd_fn)(gfp_t gfp, int node);
a9520cd6
TH
153typedef void (blkcg_pol_init_pd_fn)(struct blkg_policy_data *pd);
154typedef void (blkcg_pol_online_pd_fn)(struct blkg_policy_data *pd);
155typedef void (blkcg_pol_offline_pd_fn)(struct blkg_policy_data *pd);
001bea73 156typedef void (blkcg_pol_free_pd_fn)(struct blkg_policy_data *pd);
a9520cd6 157typedef void (blkcg_pol_reset_pd_stats_fn)(struct blkg_policy_data *pd);
903d23f0
JB
158typedef size_t (blkcg_pol_stat_pd_fn)(struct blkg_policy_data *pd, char *buf,
159 size_t size);
3e252066 160
3c798398 161struct blkcg_policy {
36558c8a 162 int plid;
36558c8a 163 /* cgroup files for the policy */
2ee867dc 164 struct cftype *dfl_cftypes;
880f50e2 165 struct cftype *legacy_cftypes;
f9fcc2d3
TH
166
167 /* operations */
e4a9bde9 168 blkcg_pol_alloc_cpd_fn *cpd_alloc_fn;
e48453c3 169 blkcg_pol_init_cpd_fn *cpd_init_fn;
e4a9bde9 170 blkcg_pol_free_cpd_fn *cpd_free_fn;
69d7fde5 171 blkcg_pol_bind_cpd_fn *cpd_bind_fn;
e4a9bde9 172
001bea73 173 blkcg_pol_alloc_pd_fn *pd_alloc_fn;
f9fcc2d3 174 blkcg_pol_init_pd_fn *pd_init_fn;
f427d909
TH
175 blkcg_pol_online_pd_fn *pd_online_fn;
176 blkcg_pol_offline_pd_fn *pd_offline_fn;
001bea73 177 blkcg_pol_free_pd_fn *pd_free_fn;
f9fcc2d3 178 blkcg_pol_reset_pd_stats_fn *pd_reset_stats_fn;
903d23f0 179 blkcg_pol_stat_pd_fn *pd_stat_fn;
3e252066
VG
180};
181
3c798398 182extern struct blkcg blkcg_root;
496d5e75 183extern struct cgroup_subsys_state * const blkcg_root_css;
36558c8a 184
24f29046
TH
185struct blkcg_gq *blkg_lookup_slowpath(struct blkcg *blkcg,
186 struct request_queue *q, bool update_hint);
49f4c2dc
DZF
187struct blkcg_gq *__blkg_lookup_create(struct blkcg *blkcg,
188 struct request_queue *q);
3c798398
TH
189struct blkcg_gq *blkg_lookup_create(struct blkcg *blkcg,
190 struct request_queue *q);
36558c8a
TH
191int blkcg_init_queue(struct request_queue *q);
192void blkcg_drain_queue(struct request_queue *q);
193void blkcg_exit_queue(struct request_queue *q);
5efd6113 194
3e252066 195/* Blkio controller policy registration */
d5bf0291 196int blkcg_policy_register(struct blkcg_policy *pol);
3c798398 197void blkcg_policy_unregister(struct blkcg_policy *pol);
36558c8a 198int blkcg_activate_policy(struct request_queue *q,
3c798398 199 const struct blkcg_policy *pol);
36558c8a 200void blkcg_deactivate_policy(struct request_queue *q,
3c798398 201 const struct blkcg_policy *pol);
3e252066 202
dd165eb3 203const char *blkg_dev_name(struct blkcg_gq *blkg);
3c798398 204void blkcg_print_blkgs(struct seq_file *sf, struct blkcg *blkcg,
f95a04af
TH
205 u64 (*prfill)(struct seq_file *,
206 struct blkg_policy_data *, int),
3c798398 207 const struct blkcg_policy *pol, int data,
ec399347 208 bool show_total);
f95a04af
TH
209u64 __blkg_prfill_u64(struct seq_file *sf, struct blkg_policy_data *pd, u64 v);
210u64 __blkg_prfill_rwstat(struct seq_file *sf, struct blkg_policy_data *pd,
829fdb50 211 const struct blkg_rwstat *rwstat);
f95a04af
TH
212u64 blkg_prfill_stat(struct seq_file *sf, struct blkg_policy_data *pd, int off);
213u64 blkg_prfill_rwstat(struct seq_file *sf, struct blkg_policy_data *pd,
214 int off);
77ea7338
TH
215int blkg_print_stat_bytes(struct seq_file *sf, void *v);
216int blkg_print_stat_ios(struct seq_file *sf, void *v);
217int blkg_print_stat_bytes_recursive(struct seq_file *sf, void *v);
218int blkg_print_stat_ios_recursive(struct seq_file *sf, void *v);
829fdb50 219
f12c74ca
TH
220u64 blkg_stat_recursive_sum(struct blkcg_gq *blkg,
221 struct blkcg_policy *pol, int off);
222struct blkg_rwstat blkg_rwstat_recursive_sum(struct blkcg_gq *blkg,
223 struct blkcg_policy *pol, int off);
16b3de66 224
829fdb50 225struct blkg_conf_ctx {
36558c8a 226 struct gendisk *disk;
3c798398 227 struct blkcg_gq *blkg;
36aa9e5f 228 char *body;
829fdb50
TH
229};
230
3c798398 231int blkg_conf_prep(struct blkcg *blkcg, const struct blkcg_policy *pol,
36aa9e5f 232 char *input, struct blkg_conf_ctx *ctx);
829fdb50
TH
233void blkg_conf_finish(struct blkg_conf_ctx *ctx);
234
27e6fa99
DZF
235/**
236 * blkcg_css - find the current css
237 *
238 * Find the css associated with either the kthread or the current task.
239 * This may return a dying css, so it is up to the caller to use tryget logic
240 * to confirm it is alive and well.
241 */
242static inline struct cgroup_subsys_state *blkcg_css(void)
243{
244 struct cgroup_subsys_state *css;
245
246 css = kthread_blkcg();
247 if (css)
248 return css;
249 return task_css(current, io_cgrp_id);
250}
251
a7c6d554
TH
252static inline struct blkcg *css_to_blkcg(struct cgroup_subsys_state *css)
253{
254 return css ? container_of(css, struct blkcg, css) : NULL;
255}
256
27e6fa99
DZF
257/**
258 * __bio_blkcg - internal version of bio_blkcg for bfq and cfq
259 *
260 * DO NOT USE.
261 * There is a flaw using this version of the function. In particular, this was
262 * used in a broken paradigm where association was called on the given css. It
263 * is possible though that the returned css from task_css() is in the process
264 * of dying due to migration of the current task. So it is improper to assume
265 * *_get() is going to succeed. Both BFQ and CFQ rely on this logic and will
266 * take additional work to handle more gracefully.
267 */
268static inline struct blkcg *__bio_blkcg(struct bio *bio)
b1208b56 269{
c839e7a0
DZF
270 if (bio && bio->bi_blkg)
271 return bio->bi_blkg->blkcg;
27e6fa99
DZF
272 return css_to_blkcg(blkcg_css());
273}
902ec5b6 274
27e6fa99
DZF
275/**
276 * bio_blkcg - grab the blkcg associated with a bio
277 * @bio: target bio
278 *
279 * This returns the blkcg associated with a bio, NULL if not associated.
280 * Callers are expected to either handle NULL or know association has been
281 * done prior to calling this.
282 */
283static inline struct blkcg *bio_blkcg(struct bio *bio)
284{
c839e7a0
DZF
285 if (bio && bio->bi_blkg)
286 return bio->bi_blkg->blkcg;
27e6fa99 287 return NULL;
fd383c2d
TH
288}
289
d09d8df3
JB
290static inline bool blk_cgroup_congested(void)
291{
292 struct cgroup_subsys_state *css;
293 bool ret = false;
294
295 rcu_read_lock();
296 css = kthread_blkcg();
297 if (!css)
298 css = task_css(current, io_cgrp_id);
299 while (css) {
300 if (atomic_read(&css->cgroup->congestion_count)) {
301 ret = true;
302 break;
303 }
304 css = css->parent;
305 }
306 rcu_read_unlock();
307 return ret;
308}
309
c7c98fd3
JB
310/**
311 * bio_issue_as_root_blkg - see if this bio needs to be issued as root blkg
312 * @return: true if this bio needs to be submitted with the root blkg context.
313 *
314 * In order to avoid priority inversions we sometimes need to issue a bio as if
315 * it were attached to the root blkg, and then backcharge to the actual owning
316 * blkg. The idea is we do bio_blkcg() to look up the actual context for the
317 * bio and attach the appropriate blkg to the bio. Then we call this helper and
318 * if it is true run with the root blkg for that queue and then do any
319 * backcharging to the originating cgroup once the io is complete.
320 */
321static inline bool bio_issue_as_root_blkg(struct bio *bio)
322{
0d1e0c7c 323 return (bio->bi_opf & (REQ_META | REQ_SWAP)) != 0;
c7c98fd3
JB
324}
325
3c547865
TH
326/**
327 * blkcg_parent - get the parent of a blkcg
328 * @blkcg: blkcg of interest
329 *
330 * Return the parent blkcg of @blkcg. Can be called anytime.
331 */
332static inline struct blkcg *blkcg_parent(struct blkcg *blkcg)
333{
5c9d535b 334 return css_to_blkcg(blkcg->css.parent);
3c547865
TH
335}
336
24f29046
TH
337/**
338 * __blkg_lookup - internal version of blkg_lookup()
339 * @blkcg: blkcg of interest
340 * @q: request_queue of interest
341 * @update_hint: whether to update lookup hint with the result or not
342 *
343 * This is internal version and shouldn't be used by policy
344 * implementations. Looks up blkgs for the @blkcg - @q pair regardless of
345 * @q's bypass state. If @update_hint is %true, the caller should be
346 * holding @q->queue_lock and lookup hint is updated on success.
347 */
348static inline struct blkcg_gq *__blkg_lookup(struct blkcg *blkcg,
349 struct request_queue *q,
350 bool update_hint)
351{
352 struct blkcg_gq *blkg;
353
85b6bc9d
TH
354 if (blkcg == &blkcg_root)
355 return q->root_blkg;
356
24f29046
TH
357 blkg = rcu_dereference(blkcg->blkg_hint);
358 if (blkg && blkg->q == q)
359 return blkg;
360
361 return blkg_lookup_slowpath(blkcg, q, update_hint);
362}
363
364/**
365 * blkg_lookup - lookup blkg for the specified blkcg - q pair
366 * @blkcg: blkcg of interest
367 * @q: request_queue of interest
368 *
369 * Lookup blkg for the @blkcg - @q pair. This function should be called
370 * under RCU read lock and is guaranteed to return %NULL if @q is bypassing
371 * - see blk_queue_bypass_start() for details.
372 */
373static inline struct blkcg_gq *blkg_lookup(struct blkcg *blkcg,
374 struct request_queue *q)
375{
376 WARN_ON_ONCE(!rcu_read_lock_held());
377
378 if (unlikely(blk_queue_bypass(q)))
379 return NULL;
380 return __blkg_lookup(blkcg, q, false);
381}
382
6bad9b21 383/**
b86d865c 384 * blk_queue_root_blkg - return blkg for the (blkcg_root, @q) pair
6bad9b21
BVA
385 * @q: request_queue of interest
386 *
387 * Lookup blkg for @q at the root level. See also blkg_lookup().
388 */
b86d865c 389static inline struct blkcg_gq *blk_queue_root_blkg(struct request_queue *q)
6bad9b21 390{
b86d865c 391 return q->root_blkg;
6bad9b21
BVA
392}
393
0381411e
TH
394/**
395 * blkg_to_pdata - get policy private data
396 * @blkg: blkg of interest
397 * @pol: policy of interest
398 *
399 * Return pointer to private data associated with the @blkg-@pol pair.
400 */
f95a04af
TH
401static inline struct blkg_policy_data *blkg_to_pd(struct blkcg_gq *blkg,
402 struct blkcg_policy *pol)
0381411e 403{
f95a04af 404 return blkg ? blkg->pd[pol->plid] : NULL;
0381411e
TH
405}
406
e48453c3
AA
407static inline struct blkcg_policy_data *blkcg_to_cpd(struct blkcg *blkcg,
408 struct blkcg_policy *pol)
409{
81437648 410 return blkcg ? blkcg->cpd[pol->plid] : NULL;
e48453c3
AA
411}
412
0381411e
TH
413/**
414 * pdata_to_blkg - get blkg associated with policy private data
f95a04af 415 * @pd: policy private data of interest
0381411e 416 *
f95a04af 417 * @pd is policy private data. Determine the blkg it's associated with.
0381411e 418 */
f95a04af 419static inline struct blkcg_gq *pd_to_blkg(struct blkg_policy_data *pd)
0381411e 420{
f95a04af 421 return pd ? pd->blkg : NULL;
0381411e
TH
422}
423
81437648
TH
424static inline struct blkcg *cpd_to_blkcg(struct blkcg_policy_data *cpd)
425{
426 return cpd ? cpd->blkcg : NULL;
427}
428
59b57717
DZF
429extern void blkcg_destroy_blkgs(struct blkcg *blkcg);
430
431#ifdef CONFIG_CGROUP_WRITEBACK
432
433/**
434 * blkcg_cgwb_get - get a reference for blkcg->cgwb_list
435 * @blkcg: blkcg of interest
436 *
437 * This is used to track the number of active wb's related to a blkcg.
438 */
439static inline void blkcg_cgwb_get(struct blkcg *blkcg)
440{
441 refcount_inc(&blkcg->cgwb_refcnt);
442}
443
444/**
445 * blkcg_cgwb_put - put a reference for @blkcg->cgwb_list
446 * @blkcg: blkcg of interest
447 *
448 * This is used to track the number of active wb's related to a blkcg.
449 * When this count goes to zero, all active wb has finished so the
450 * blkcg can continue destruction by calling blkcg_destroy_blkgs().
451 * This work may occur in cgwb_release_workfn() on the cgwb_release
452 * workqueue.
453 */
454static inline void blkcg_cgwb_put(struct blkcg *blkcg)
455{
456 if (refcount_dec_and_test(&blkcg->cgwb_refcnt))
457 blkcg_destroy_blkgs(blkcg);
458}
459
460#else
461
462static inline void blkcg_cgwb_get(struct blkcg *blkcg) { }
463
464static inline void blkcg_cgwb_put(struct blkcg *blkcg)
465{
466 /* wb isn't being accounted, so trigger destruction right away */
467 blkcg_destroy_blkgs(blkcg);
468}
469
470#endif
471
54e7ed12
TH
472/**
473 * blkg_path - format cgroup path of blkg
474 * @blkg: blkg of interest
475 * @buf: target buffer
476 * @buflen: target buffer length
477 *
478 * Format the path of the cgroup of @blkg into @buf.
479 */
3c798398 480static inline int blkg_path(struct blkcg_gq *blkg, char *buf, int buflen)
afc24d49 481{
4c737b41 482 return cgroup_path(blkg->blkcg->css.cgroup, buf, buflen);
afc24d49
VG
483}
484
1adaf3dd
TH
485/**
486 * blkg_get - get a blkg reference
487 * @blkg: blkg to get
488 *
a5049a8a 489 * The caller should be holding an existing reference.
1adaf3dd 490 */
3c798398 491static inline void blkg_get(struct blkcg_gq *blkg)
1adaf3dd 492{
b3b9f24f 493 percpu_ref_get(&blkg->refcnt);
1adaf3dd
TH
494}
495
d09d8df3 496/**
101246ec 497 * blkg_tryget - try and get a blkg reference
d09d8df3
JB
498 * @blkg: blkg to get
499 *
500 * This is for use when doing an RCU lookup of the blkg. We may be in the midst
501 * of freeing this blkg, so we can only use it if the refcnt is not zero.
502 */
101246ec 503static inline bool blkg_tryget(struct blkcg_gq *blkg)
d09d8df3 504{
101246ec 505 return percpu_ref_tryget(&blkg->refcnt);
d09d8df3
JB
506}
507
07b05bcc 508/**
101246ec 509 * blkg_tryget_closest - try and get a blkg ref on the closet blkg
07b05bcc
DZF
510 * @blkg: blkg to get
511 *
512 * This walks up the blkg tree to find the closest non-dying blkg and returns
513 * the blkg that it did association with as it may not be the passed in blkg.
514 */
101246ec 515static inline struct blkcg_gq *blkg_tryget_closest(struct blkcg_gq *blkg)
07b05bcc 516{
b3b9f24f 517 while (!percpu_ref_tryget(&blkg->refcnt))
07b05bcc
DZF
518 blkg = blkg->parent;
519
520 return blkg;
521}
d09d8df3 522
1adaf3dd
TH
523/**
524 * blkg_put - put a blkg reference
525 * @blkg: blkg to put
1adaf3dd 526 */
3c798398 527static inline void blkg_put(struct blkcg_gq *blkg)
1adaf3dd 528{
b3b9f24f 529 percpu_ref_put(&blkg->refcnt);
1adaf3dd
TH
530}
531
dd4a4ffc
TH
532/**
533 * blkg_for_each_descendant_pre - pre-order walk of a blkg's descendants
534 * @d_blkg: loop cursor pointing to the current descendant
492eb21b 535 * @pos_css: used for iteration
dd4a4ffc
TH
536 * @p_blkg: target blkg to walk descendants of
537 *
538 * Walk @c_blkg through the descendants of @p_blkg. Must be used with RCU
539 * read locked. If called under either blkcg or queue lock, the iteration
540 * is guaranteed to include all and only online blkgs. The caller may
492eb21b 541 * update @pos_css by calling css_rightmost_descendant() to skip subtree.
bd8815a6 542 * @p_blkg is included in the iteration and the first node to be visited.
dd4a4ffc 543 */
492eb21b
TH
544#define blkg_for_each_descendant_pre(d_blkg, pos_css, p_blkg) \
545 css_for_each_descendant_pre((pos_css), &(p_blkg)->blkcg->css) \
546 if (((d_blkg) = __blkg_lookup(css_to_blkcg(pos_css), \
dd4a4ffc
TH
547 (p_blkg)->q, false)))
548
aa539cb3
TH
549/**
550 * blkg_for_each_descendant_post - post-order walk of a blkg's descendants
551 * @d_blkg: loop cursor pointing to the current descendant
492eb21b 552 * @pos_css: used for iteration
aa539cb3
TH
553 * @p_blkg: target blkg to walk descendants of
554 *
555 * Similar to blkg_for_each_descendant_pre() but performs post-order
bd8815a6
TH
556 * traversal instead. Synchronization rules are the same. @p_blkg is
557 * included in the iteration and the last node to be visited.
aa539cb3 558 */
492eb21b
TH
559#define blkg_for_each_descendant_post(d_blkg, pos_css, p_blkg) \
560 css_for_each_descendant_post((pos_css), &(p_blkg)->blkcg->css) \
561 if (((d_blkg) = __blkg_lookup(css_to_blkcg(pos_css), \
aa539cb3
TH
562 (p_blkg)->q, false)))
563
a051661c
TH
564/**
565 * blk_get_rl - get request_list to use
566 * @q: request_queue of interest
567 * @bio: bio which will be attached to the allocated request (may be %NULL)
568 *
569 * The caller wants to allocate a request from @q to use for @bio. Find
570 * the request_list to use and obtain a reference on it. Should be called
571 * under queue_lock. This function is guaranteed to return non-%NULL
572 * request_list.
573 */
574static inline struct request_list *blk_get_rl(struct request_queue *q,
575 struct bio *bio)
576{
577 struct blkcg *blkcg;
578 struct blkcg_gq *blkg;
579
580 rcu_read_lock();
581
e2b09899
DZF
582 if (bio && bio->bi_blkg) {
583 blkcg = bio->bi_blkg->blkcg;
584 if (blkcg == &blkcg_root)
585 goto rl_use_root;
586
587 blkg_get(bio->bi_blkg);
588 rcu_read_unlock();
589 return &bio->bi_blkg->rl;
590 }
a051661c 591
e2b09899 592 blkcg = css_to_blkcg(blkcg_css());
a051661c 593 if (blkcg == &blkcg_root)
e2b09899 594 goto rl_use_root;
a051661c 595
ae118896
TH
596 blkg = blkg_lookup(blkcg, q);
597 if (unlikely(!blkg))
e2b09899 598 blkg = __blkg_lookup_create(blkcg, q);
a051661c 599
b2c3fa54 600 if (blkg->blkcg == &blkcg_root || !blkg_tryget(blkg))
e2b09899
DZF
601 goto rl_use_root;
602
a051661c
TH
603 rcu_read_unlock();
604 return &blkg->rl;
e2b09899
DZF
605
606 /*
607 * Each blkg has its own request_list, however, the root blkcg
608 * uses the request_queue's root_rl. This is to avoid most
609 * overhead for the root blkcg.
610 */
611rl_use_root:
a051661c
TH
612 rcu_read_unlock();
613 return &q->root_rl;
614}
615
616/**
617 * blk_put_rl - put request_list
618 * @rl: request_list to put
619 *
620 * Put the reference acquired by blk_get_rl(). Should be called under
621 * queue_lock.
622 */
623static inline void blk_put_rl(struct request_list *rl)
624{
401efbf8 625 if (rl->blkg->blkcg != &blkcg_root)
a051661c
TH
626 blkg_put(rl->blkg);
627}
628
629/**
630 * blk_rq_set_rl - associate a request with a request_list
631 * @rq: request of interest
632 * @rl: target request_list
633 *
634 * Associate @rq with @rl so that accounting and freeing can know the
635 * request_list @rq came from.
636 */
637static inline void blk_rq_set_rl(struct request *rq, struct request_list *rl)
638{
639 rq->rl = rl;
640}
641
642/**
643 * blk_rq_rl - return the request_list a request came from
644 * @rq: request of interest
645 *
646 * Return the request_list @rq is allocated from.
647 */
648static inline struct request_list *blk_rq_rl(struct request *rq)
649{
650 return rq->rl;
651}
652
653struct request_list *__blk_queue_next_rl(struct request_list *rl,
654 struct request_queue *q);
655/**
656 * blk_queue_for_each_rl - iterate through all request_lists of a request_queue
657 *
658 * Should be used under queue_lock.
659 */
660#define blk_queue_for_each_rl(rl, q) \
661 for ((rl) = &(q)->root_rl; (rl); (rl) = __blk_queue_next_rl((rl), (q)))
662
24bdb8ef 663static inline int blkg_stat_init(struct blkg_stat *stat, gfp_t gfp)
90d3839b 664{
24bdb8ef
TH
665 int ret;
666
667 ret = percpu_counter_init(&stat->cpu_cnt, 0, gfp);
668 if (ret)
669 return ret;
670
e6269c44 671 atomic64_set(&stat->aux_cnt, 0);
24bdb8ef
TH
672 return 0;
673}
674
675static inline void blkg_stat_exit(struct blkg_stat *stat)
676{
677 percpu_counter_destroy(&stat->cpu_cnt);
90d3839b
PZ
678}
679
edcb0722
TH
680/**
681 * blkg_stat_add - add a value to a blkg_stat
682 * @stat: target blkg_stat
683 * @val: value to add
684 *
24bdb8ef
TH
685 * Add @val to @stat. The caller must ensure that IRQ on the same CPU
686 * don't re-enter this function for the same counter.
edcb0722
TH
687 */
688static inline void blkg_stat_add(struct blkg_stat *stat, uint64_t val)
689{
104b4e51 690 percpu_counter_add_batch(&stat->cpu_cnt, val, BLKG_STAT_CPU_BATCH);
edcb0722
TH
691}
692
693/**
694 * blkg_stat_read - read the current value of a blkg_stat
695 * @stat: blkg_stat to read
edcb0722
TH
696 */
697static inline uint64_t blkg_stat_read(struct blkg_stat *stat)
698{
24bdb8ef 699 return percpu_counter_sum_positive(&stat->cpu_cnt);
edcb0722
TH
700}
701
702/**
703 * blkg_stat_reset - reset a blkg_stat
704 * @stat: blkg_stat to reset
705 */
706static inline void blkg_stat_reset(struct blkg_stat *stat)
707{
24bdb8ef 708 percpu_counter_set(&stat->cpu_cnt, 0);
e6269c44 709 atomic64_set(&stat->aux_cnt, 0);
edcb0722
TH
710}
711
16b3de66 712/**
e6269c44 713 * blkg_stat_add_aux - add a blkg_stat into another's aux count
16b3de66
TH
714 * @to: the destination blkg_stat
715 * @from: the source
716 *
e6269c44 717 * Add @from's count including the aux one to @to's aux count.
16b3de66 718 */
e6269c44
TH
719static inline void blkg_stat_add_aux(struct blkg_stat *to,
720 struct blkg_stat *from)
16b3de66 721{
e6269c44
TH
722 atomic64_add(blkg_stat_read(from) + atomic64_read(&from->aux_cnt),
723 &to->aux_cnt);
16b3de66
TH
724}
725
24bdb8ef 726static inline int blkg_rwstat_init(struct blkg_rwstat *rwstat, gfp_t gfp)
90d3839b 727{
24bdb8ef
TH
728 int i, ret;
729
730 for (i = 0; i < BLKG_RWSTAT_NR; i++) {
731 ret = percpu_counter_init(&rwstat->cpu_cnt[i], 0, gfp);
732 if (ret) {
733 while (--i >= 0)
734 percpu_counter_destroy(&rwstat->cpu_cnt[i]);
735 return ret;
736 }
737 atomic64_set(&rwstat->aux_cnt[i], 0);
738 }
739 return 0;
740}
e6269c44 741
24bdb8ef
TH
742static inline void blkg_rwstat_exit(struct blkg_rwstat *rwstat)
743{
744 int i;
e6269c44
TH
745
746 for (i = 0; i < BLKG_RWSTAT_NR; i++)
24bdb8ef 747 percpu_counter_destroy(&rwstat->cpu_cnt[i]);
90d3839b
PZ
748}
749
edcb0722
TH
750/**
751 * blkg_rwstat_add - add a value to a blkg_rwstat
752 * @rwstat: target blkg_rwstat
ef295ecf 753 * @op: REQ_OP and flags
edcb0722
TH
754 * @val: value to add
755 *
756 * Add @val to @rwstat. The counters are chosen according to @rw. The
757 * caller is responsible for synchronizing calls to this function.
758 */
759static inline void blkg_rwstat_add(struct blkg_rwstat *rwstat,
ef295ecf 760 unsigned int op, uint64_t val)
edcb0722 761{
24bdb8ef 762 struct percpu_counter *cnt;
edcb0722 763
636620b6
TH
764 if (op_is_discard(op))
765 cnt = &rwstat->cpu_cnt[BLKG_RWSTAT_DISCARD];
766 else if (op_is_write(op))
24bdb8ef 767 cnt = &rwstat->cpu_cnt[BLKG_RWSTAT_WRITE];
edcb0722 768 else
24bdb8ef
TH
769 cnt = &rwstat->cpu_cnt[BLKG_RWSTAT_READ];
770
104b4e51 771 percpu_counter_add_batch(cnt, val, BLKG_STAT_CPU_BATCH);
24bdb8ef 772
d71d9ae1 773 if (op_is_sync(op))
24bdb8ef 774 cnt = &rwstat->cpu_cnt[BLKG_RWSTAT_SYNC];
edcb0722 775 else
24bdb8ef 776 cnt = &rwstat->cpu_cnt[BLKG_RWSTAT_ASYNC];
edcb0722 777
104b4e51 778 percpu_counter_add_batch(cnt, val, BLKG_STAT_CPU_BATCH);
edcb0722
TH
779}
780
781/**
782 * blkg_rwstat_read - read the current values of a blkg_rwstat
783 * @rwstat: blkg_rwstat to read
784 *
24bdb8ef 785 * Read the current snapshot of @rwstat and return it in the aux counts.
edcb0722 786 */
c94bed89 787static inline struct blkg_rwstat blkg_rwstat_read(struct blkg_rwstat *rwstat)
edcb0722 788{
24bdb8ef
TH
789 struct blkg_rwstat result;
790 int i;
edcb0722 791
24bdb8ef
TH
792 for (i = 0; i < BLKG_RWSTAT_NR; i++)
793 atomic64_set(&result.aux_cnt[i],
794 percpu_counter_sum_positive(&rwstat->cpu_cnt[i]));
795 return result;
edcb0722
TH
796}
797
798/**
4d5e80a7 799 * blkg_rwstat_total - read the total count of a blkg_rwstat
edcb0722
TH
800 * @rwstat: blkg_rwstat to read
801 *
802 * Return the total count of @rwstat regardless of the IO direction. This
803 * function can be called without synchronization and takes care of u64
804 * atomicity.
805 */
4d5e80a7 806static inline uint64_t blkg_rwstat_total(struct blkg_rwstat *rwstat)
edcb0722
TH
807{
808 struct blkg_rwstat tmp = blkg_rwstat_read(rwstat);
809
24bdb8ef
TH
810 return atomic64_read(&tmp.aux_cnt[BLKG_RWSTAT_READ]) +
811 atomic64_read(&tmp.aux_cnt[BLKG_RWSTAT_WRITE]);
edcb0722
TH
812}
813
814/**
815 * blkg_rwstat_reset - reset a blkg_rwstat
816 * @rwstat: blkg_rwstat to reset
817 */
818static inline void blkg_rwstat_reset(struct blkg_rwstat *rwstat)
819{
e6269c44
TH
820 int i;
821
24bdb8ef
TH
822 for (i = 0; i < BLKG_RWSTAT_NR; i++) {
823 percpu_counter_set(&rwstat->cpu_cnt[i], 0);
e6269c44 824 atomic64_set(&rwstat->aux_cnt[i], 0);
24bdb8ef 825 }
edcb0722
TH
826}
827
16b3de66 828/**
e6269c44 829 * blkg_rwstat_add_aux - add a blkg_rwstat into another's aux count
16b3de66
TH
830 * @to: the destination blkg_rwstat
831 * @from: the source
832 *
e6269c44 833 * Add @from's count including the aux one to @to's aux count.
16b3de66 834 */
e6269c44
TH
835static inline void blkg_rwstat_add_aux(struct blkg_rwstat *to,
836 struct blkg_rwstat *from)
16b3de66 837{
ddc21231 838 u64 sum[BLKG_RWSTAT_NR];
16b3de66
TH
839 int i;
840
16b3de66 841 for (i = 0; i < BLKG_RWSTAT_NR; i++)
ddc21231
AB
842 sum[i] = percpu_counter_sum_positive(&from->cpu_cnt[i]);
843
844 for (i = 0; i < BLKG_RWSTAT_NR; i++)
845 atomic64_add(sum[i] + atomic64_read(&from->aux_cnt[i]),
e6269c44 846 &to->aux_cnt[i]);
16b3de66
TH
847}
848
ae118896
TH
849#ifdef CONFIG_BLK_DEV_THROTTLING
850extern bool blk_throtl_bio(struct request_queue *q, struct blkcg_gq *blkg,
851 struct bio *bio);
852#else
853static inline bool blk_throtl_bio(struct request_queue *q, struct blkcg_gq *blkg,
854 struct bio *bio) { return false; }
855#endif
856
5bf9a1f3
DZF
857
858static inline void blkcg_bio_issue_init(struct bio *bio)
859{
860 bio_issue_init(&bio->bi_issue, bio_sectors(bio));
861}
862
ae118896
TH
863static inline bool blkcg_bio_issue_check(struct request_queue *q,
864 struct bio *bio)
865{
ae118896
TH
866 struct blkcg_gq *blkg;
867 bool throtl = false;
868
869 rcu_read_lock();
ae118896 870
a7b39b4e
DZF
871 bio_associate_create_blkg(q, bio);
872 blkg = bio->bi_blkg;
ae118896
TH
873
874 throtl = blk_throtl_bio(q, blkg, bio);
875
77ea7338 876 if (!throtl) {
c454edc2
JB
877 /*
878 * If the bio is flagged with BIO_QUEUE_ENTERED it means this
879 * is a split bio and we would have already accounted for the
880 * size of the bio.
881 */
882 if (!bio_flagged(bio, BIO_QUEUE_ENTERED))
883 blkg_rwstat_add(&blkg->stat_bytes, bio->bi_opf,
884 bio->bi_iter.bi_size);
ef295ecf 885 blkg_rwstat_add(&blkg->stat_ios, bio->bi_opf, 1);
77ea7338
TH
886 }
887
5bf9a1f3
DZF
888 blkcg_bio_issue_init(bio);
889
ae118896
TH
890 rcu_read_unlock();
891 return !throtl;
892}
893
d09d8df3
JB
894static inline void blkcg_use_delay(struct blkcg_gq *blkg)
895{
896 if (atomic_add_return(1, &blkg->use_delay) == 1)
897 atomic_inc(&blkg->blkcg->css.cgroup->congestion_count);
898}
899
900static inline int blkcg_unuse_delay(struct blkcg_gq *blkg)
901{
902 int old = atomic_read(&blkg->use_delay);
903
904 if (old == 0)
905 return 0;
906
907 /*
908 * We do this song and dance because we can race with somebody else
909 * adding or removing delay. If we just did an atomic_dec we'd end up
910 * negative and we'd already be in trouble. We need to subtract 1 and
911 * then check to see if we were the last delay so we can drop the
912 * congestion count on the cgroup.
913 */
914 while (old) {
915 int cur = atomic_cmpxchg(&blkg->use_delay, old, old - 1);
916 if (cur == old)
917 break;
918 old = cur;
919 }
920
921 if (old == 0)
922 return 0;
923 if (old == 1)
924 atomic_dec(&blkg->blkcg->css.cgroup->congestion_count);
925 return 1;
926}
927
928static inline void blkcg_clear_delay(struct blkcg_gq *blkg)
929{
930 int old = atomic_read(&blkg->use_delay);
931 if (!old)
932 return;
933 /* We only want 1 person clearing the congestion count for this blkg. */
934 while (old) {
935 int cur = atomic_cmpxchg(&blkg->use_delay, old, 0);
936 if (cur == old) {
937 atomic_dec(&blkg->blkcg->css.cgroup->congestion_count);
938 break;
939 }
940 old = cur;
941 }
942}
943
944void blkcg_add_delay(struct blkcg_gq *blkg, u64 now, u64 delta);
945void blkcg_schedule_throttle(struct request_queue *q, bool use_memdelay);
946void blkcg_maybe_throttle_current(void);
36558c8a
TH
947#else /* CONFIG_BLK_CGROUP */
948
efa7d1c7
TH
949struct blkcg {
950};
2f5ea477 951
f95a04af
TH
952struct blkg_policy_data {
953};
954
e48453c3
AA
955struct blkcg_policy_data {
956};
957
3c798398 958struct blkcg_gq {
2f5ea477
JA
959};
960
3c798398 961struct blkcg_policy {
3e252066
VG
962};
963
496d5e75
TH
964#define blkcg_root_css ((struct cgroup_subsys_state *)ERR_PTR(-EINVAL))
965
d09d8df3
JB
966static inline void blkcg_maybe_throttle_current(void) { }
967static inline bool blk_cgroup_congested(void) { return false; }
968
efa7d1c7
TH
969#ifdef CONFIG_BLOCK
970
d09d8df3
JB
971static inline void blkcg_schedule_throttle(struct request_queue *q, bool use_memdelay) { }
972
3c798398 973static inline struct blkcg_gq *blkg_lookup(struct blkcg *blkcg, void *key) { return NULL; }
b86d865c
BVA
974static inline struct blkcg_gq *blk_queue_root_blkg(struct request_queue *q)
975{ return NULL; }
5efd6113
TH
976static inline int blkcg_init_queue(struct request_queue *q) { return 0; }
977static inline void blkcg_drain_queue(struct request_queue *q) { }
978static inline void blkcg_exit_queue(struct request_queue *q) { }
d5bf0291 979static inline int blkcg_policy_register(struct blkcg_policy *pol) { return 0; }
3c798398 980static inline void blkcg_policy_unregister(struct blkcg_policy *pol) { }
a2b1693b 981static inline int blkcg_activate_policy(struct request_queue *q,
3c798398 982 const struct blkcg_policy *pol) { return 0; }
a2b1693b 983static inline void blkcg_deactivate_policy(struct request_queue *q,
3c798398
TH
984 const struct blkcg_policy *pol) { }
985
27e6fa99 986static inline struct blkcg *__bio_blkcg(struct bio *bio) { return NULL; }
b1208b56 987static inline struct blkcg *bio_blkcg(struct bio *bio) { return NULL; }
a051661c 988
f95a04af
TH
989static inline struct blkg_policy_data *blkg_to_pd(struct blkcg_gq *blkg,
990 struct blkcg_policy *pol) { return NULL; }
991static inline struct blkcg_gq *pd_to_blkg(struct blkg_policy_data *pd) { return NULL; }
3c798398
TH
992static inline char *blkg_path(struct blkcg_gq *blkg) { return NULL; }
993static inline void blkg_get(struct blkcg_gq *blkg) { }
994static inline void blkg_put(struct blkcg_gq *blkg) { }
afc24d49 995
a051661c
TH
996static inline struct request_list *blk_get_rl(struct request_queue *q,
997 struct bio *bio) { return &q->root_rl; }
998static inline void blk_put_rl(struct request_list *rl) { }
999static inline void blk_rq_set_rl(struct request *rq, struct request_list *rl) { }
1000static inline struct request_list *blk_rq_rl(struct request *rq) { return &rq->q->root_rl; }
1001
5bf9a1f3 1002static inline void blkcg_bio_issue_init(struct bio *bio) { }
ae118896
TH
1003static inline bool blkcg_bio_issue_check(struct request_queue *q,
1004 struct bio *bio) { return true; }
1005
a051661c
TH
1006#define blk_queue_for_each_rl(rl, q) \
1007 for ((rl) = &(q)->root_rl; (rl); (rl) = NULL)
1008
efa7d1c7 1009#endif /* CONFIG_BLOCK */
36558c8a
TH
1010#endif /* CONFIG_BLK_CGROUP */
1011#endif /* _BLK_CGROUP_H */