]> git.karo-electronics.de Git - linux-beck.git/blob - kernel/cgroup.c
cgroup: fix offlining child waiting in cgroup_subtree_control_write()
[linux-beck.git] / kernel / cgroup.c
1 /*
2  *  Generic process-grouping system.
3  *
4  *  Based originally on the cpuset system, extracted by Paul Menage
5  *  Copyright (C) 2006 Google, Inc
6  *
7  *  Notifications support
8  *  Copyright (C) 2009 Nokia Corporation
9  *  Author: Kirill A. Shutemov
10  *
11  *  Copyright notices from the original cpuset code:
12  *  --------------------------------------------------
13  *  Copyright (C) 2003 BULL SA.
14  *  Copyright (C) 2004-2006 Silicon Graphics, Inc.
15  *
16  *  Portions derived from Patrick Mochel's sysfs code.
17  *  sysfs is Copyright (c) 2001-3 Patrick Mochel
18  *
19  *  2003-10-10 Written by Simon Derr.
20  *  2003-10-22 Updates by Stephen Hemminger.
21  *  2004 May-July Rework by Paul Jackson.
22  *  ---------------------------------------------------
23  *
24  *  This file is subject to the terms and conditions of the GNU General Public
25  *  License.  See the file COPYING in the main directory of the Linux
26  *  distribution for more details.
27  */
28
29 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
30
31 #include <linux/cgroup.h>
32 #include <linux/cred.h>
33 #include <linux/ctype.h>
34 #include <linux/errno.h>
35 #include <linux/init_task.h>
36 #include <linux/kernel.h>
37 #include <linux/list.h>
38 #include <linux/mm.h>
39 #include <linux/mutex.h>
40 #include <linux/mount.h>
41 #include <linux/pagemap.h>
42 #include <linux/proc_fs.h>
43 #include <linux/rcupdate.h>
44 #include <linux/sched.h>
45 #include <linux/slab.h>
46 #include <linux/spinlock.h>
47 #include <linux/rwsem.h>
48 #include <linux/string.h>
49 #include <linux/sort.h>
50 #include <linux/kmod.h>
51 #include <linux/delayacct.h>
52 #include <linux/cgroupstats.h>
53 #include <linux/hashtable.h>
54 #include <linux/pid_namespace.h>
55 #include <linux/idr.h>
56 #include <linux/vmalloc.h> /* TODO: replace with more sophisticated array */
57 #include <linux/kthread.h>
58 #include <linux/delay.h>
59
60 #include <linux/atomic.h>
61
62 /*
63  * pidlists linger the following amount before being destroyed.  The goal
64  * is avoiding frequent destruction in the middle of consecutive read calls
65  * Expiring in the middle is a performance problem not a correctness one.
66  * 1 sec should be enough.
67  */
68 #define CGROUP_PIDLIST_DESTROY_DELAY    HZ
69
70 #define CGROUP_FILE_NAME_MAX            (MAX_CGROUP_TYPE_NAMELEN +      \
71                                          MAX_CFTYPE_NAME + 2)
72
73 /*
74  * cgroup_tree_mutex nests above cgroup_mutex and protects cftypes, file
75  * creation/removal and hierarchy changing operations including cgroup
76  * creation, removal, css association and controller rebinding.  This outer
77  * lock is needed mainly to resolve the circular dependency between kernfs
78  * active ref and cgroup_mutex.  cgroup_tree_mutex nests above both.
79  */
80 static DEFINE_MUTEX(cgroup_tree_mutex);
81
82 /*
83  * cgroup_mutex is the master lock.  Any modification to cgroup or its
84  * hierarchy must be performed while holding it.
85  *
86  * css_set_rwsem protects task->cgroups pointer, the list of css_set
87  * objects, and the chain of tasks off each css_set.
88  *
89  * These locks are exported if CONFIG_PROVE_RCU so that accessors in
90  * cgroup.h can use them for lockdep annotations.
91  */
92 #ifdef CONFIG_PROVE_RCU
93 DEFINE_MUTEX(cgroup_mutex);
94 DECLARE_RWSEM(css_set_rwsem);
95 EXPORT_SYMBOL_GPL(cgroup_mutex);
96 EXPORT_SYMBOL_GPL(css_set_rwsem);
97 #else
98 static DEFINE_MUTEX(cgroup_mutex);
99 static DECLARE_RWSEM(css_set_rwsem);
100 #endif
101
102 /*
103  * Protects cgroup_idr and css_idr so that IDs can be released without
104  * grabbing cgroup_mutex.
105  */
106 static DEFINE_SPINLOCK(cgroup_idr_lock);
107
108 /*
109  * Protects cgroup_subsys->release_agent_path.  Modifying it also requires
110  * cgroup_mutex.  Reading requires either cgroup_mutex or this spinlock.
111  */
112 static DEFINE_SPINLOCK(release_agent_path_lock);
113
114 #define cgroup_assert_mutexes_or_rcu_locked()                           \
115         rcu_lockdep_assert(rcu_read_lock_held() ||                      \
116                            lockdep_is_held(&cgroup_tree_mutex) ||       \
117                            lockdep_is_held(&cgroup_mutex),              \
118                            "cgroup_[tree_]mutex or RCU read lock required");
119
120 /*
121  * cgroup destruction makes heavy use of work items and there can be a lot
122  * of concurrent destructions.  Use a separate workqueue so that cgroup
123  * destruction work items don't end up filling up max_active of system_wq
124  * which may lead to deadlock.
125  */
126 static struct workqueue_struct *cgroup_destroy_wq;
127
128 /*
129  * pidlist destructions need to be flushed on cgroup destruction.  Use a
130  * separate workqueue as flush domain.
131  */
132 static struct workqueue_struct *cgroup_pidlist_destroy_wq;
133
134 /* generate an array of cgroup subsystem pointers */
135 #define SUBSYS(_x) [_x ## _cgrp_id] = &_x ## _cgrp_subsys,
136 static struct cgroup_subsys *cgroup_subsys[] = {
137 #include <linux/cgroup_subsys.h>
138 };
139 #undef SUBSYS
140
141 /* array of cgroup subsystem names */
142 #define SUBSYS(_x) [_x ## _cgrp_id] = #_x,
143 static const char *cgroup_subsys_name[] = {
144 #include <linux/cgroup_subsys.h>
145 };
146 #undef SUBSYS
147
148 /*
149  * The default hierarchy, reserved for the subsystems that are otherwise
150  * unattached - it never has more than a single cgroup, and all tasks are
151  * part of that cgroup.
152  */
153 struct cgroup_root cgrp_dfl_root;
154
155 /*
156  * The default hierarchy always exists but is hidden until mounted for the
157  * first time.  This is for backward compatibility.
158  */
159 static bool cgrp_dfl_root_visible;
160
161 /* The list of hierarchy roots */
162
163 static LIST_HEAD(cgroup_roots);
164 static int cgroup_root_count;
165
166 /* hierarchy ID allocation and mapping, protected by cgroup_mutex */
167 static DEFINE_IDR(cgroup_hierarchy_idr);
168
169 /*
170  * Assign a monotonically increasing serial number to cgroups.  It
171  * guarantees cgroups with bigger numbers are newer than those with smaller
172  * numbers.  Also, as cgroups are always appended to the parent's
173  * ->children list, it guarantees that sibling cgroups are always sorted in
174  * the ascending serial number order on the list.  Protected by
175  * cgroup_mutex.
176  */
177 static u64 cgroup_serial_nr_next = 1;
178
179 /* This flag indicates whether tasks in the fork and exit paths should
180  * check for fork/exit handlers to call. This avoids us having to do
181  * extra work in the fork/exit path if none of the subsystems need to
182  * be called.
183  */
184 static int need_forkexit_callback __read_mostly;
185
186 static struct cftype cgroup_base_files[];
187
188 static void cgroup_put(struct cgroup *cgrp);
189 static int rebind_subsystems(struct cgroup_root *dst_root,
190                              unsigned int ss_mask);
191 static void cgroup_destroy_css_killed(struct cgroup *cgrp);
192 static int cgroup_destroy_locked(struct cgroup *cgrp);
193 static int create_css(struct cgroup *cgrp, struct cgroup_subsys *ss);
194 static void kill_css(struct cgroup_subsys_state *css);
195 static int cgroup_addrm_files(struct cgroup *cgrp, struct cftype cfts[],
196                               bool is_add);
197 static void cgroup_pidlist_destroy_all(struct cgroup *cgrp);
198
199 /* IDR wrappers which synchronize using cgroup_idr_lock */
200 static int cgroup_idr_alloc(struct idr *idr, void *ptr, int start, int end,
201                             gfp_t gfp_mask)
202 {
203         int ret;
204
205         idr_preload(gfp_mask);
206         spin_lock(&cgroup_idr_lock);
207         ret = idr_alloc(idr, ptr, start, end, gfp_mask);
208         spin_unlock(&cgroup_idr_lock);
209         idr_preload_end();
210         return ret;
211 }
212
213 static void *cgroup_idr_replace(struct idr *idr, void *ptr, int id)
214 {
215         void *ret;
216
217         spin_lock(&cgroup_idr_lock);
218         ret = idr_replace(idr, ptr, id);
219         spin_unlock(&cgroup_idr_lock);
220         return ret;
221 }
222
223 static void cgroup_idr_remove(struct idr *idr, int id)
224 {
225         spin_lock(&cgroup_idr_lock);
226         idr_remove(idr, id);
227         spin_unlock(&cgroup_idr_lock);
228 }
229
230 /**
231  * cgroup_css - obtain a cgroup's css for the specified subsystem
232  * @cgrp: the cgroup of interest
233  * @ss: the subsystem of interest (%NULL returns the dummy_css)
234  *
235  * Return @cgrp's css (cgroup_subsys_state) associated with @ss.  This
236  * function must be called either under cgroup_mutex or rcu_read_lock() and
237  * the caller is responsible for pinning the returned css if it wants to
238  * keep accessing it outside the said locks.  This function may return
239  * %NULL if @cgrp doesn't have @subsys_id enabled.
240  */
241 static struct cgroup_subsys_state *cgroup_css(struct cgroup *cgrp,
242                                               struct cgroup_subsys *ss)
243 {
244         if (ss)
245                 return rcu_dereference_check(cgrp->subsys[ss->id],
246                                         lockdep_is_held(&cgroup_tree_mutex) ||
247                                         lockdep_is_held(&cgroup_mutex));
248         else
249                 return &cgrp->dummy_css;
250 }
251
252 /**
253  * cgroup_e_css - obtain a cgroup's effective css for the specified subsystem
254  * @cgrp: the cgroup of interest
255  * @ss: the subsystem of interest (%NULL returns the dummy_css)
256  *
257  * Similar to cgroup_css() but returns the effctive css, which is defined
258  * as the matching css of the nearest ancestor including self which has @ss
259  * enabled.  If @ss is associated with the hierarchy @cgrp is on, this
260  * function is guaranteed to return non-NULL css.
261  */
262 static struct cgroup_subsys_state *cgroup_e_css(struct cgroup *cgrp,
263                                                 struct cgroup_subsys *ss)
264 {
265         lockdep_assert_held(&cgroup_mutex);
266
267         if (!ss)
268                 return &cgrp->dummy_css;
269
270         if (!(cgrp->root->subsys_mask & (1 << ss->id)))
271                 return NULL;
272
273         while (cgrp->parent &&
274                !(cgrp->parent->child_subsys_mask & (1 << ss->id)))
275                 cgrp = cgrp->parent;
276
277         return cgroup_css(cgrp, ss);
278 }
279
280 /* convenient tests for these bits */
281 static inline bool cgroup_is_dead(const struct cgroup *cgrp)
282 {
283         return test_bit(CGRP_DEAD, &cgrp->flags);
284 }
285
286 struct cgroup_subsys_state *seq_css(struct seq_file *seq)
287 {
288         struct kernfs_open_file *of = seq->private;
289         struct cgroup *cgrp = of->kn->parent->priv;
290         struct cftype *cft = seq_cft(seq);
291
292         /*
293          * This is open and unprotected implementation of cgroup_css().
294          * seq_css() is only called from a kernfs file operation which has
295          * an active reference on the file.  Because all the subsystem
296          * files are drained before a css is disassociated with a cgroup,
297          * the matching css from the cgroup's subsys table is guaranteed to
298          * be and stay valid until the enclosing operation is complete.
299          */
300         if (cft->ss)
301                 return rcu_dereference_raw(cgrp->subsys[cft->ss->id]);
302         else
303                 return &cgrp->dummy_css;
304 }
305 EXPORT_SYMBOL_GPL(seq_css);
306
307 /**
308  * cgroup_is_descendant - test ancestry
309  * @cgrp: the cgroup to be tested
310  * @ancestor: possible ancestor of @cgrp
311  *
312  * Test whether @cgrp is a descendant of @ancestor.  It also returns %true
313  * if @cgrp == @ancestor.  This function is safe to call as long as @cgrp
314  * and @ancestor are accessible.
315  */
316 bool cgroup_is_descendant(struct cgroup *cgrp, struct cgroup *ancestor)
317 {
318         while (cgrp) {
319                 if (cgrp == ancestor)
320                         return true;
321                 cgrp = cgrp->parent;
322         }
323         return false;
324 }
325
326 static int cgroup_is_releasable(const struct cgroup *cgrp)
327 {
328         const int bits =
329                 (1 << CGRP_RELEASABLE) |
330                 (1 << CGRP_NOTIFY_ON_RELEASE);
331         return (cgrp->flags & bits) == bits;
332 }
333
334 static int notify_on_release(const struct cgroup *cgrp)
335 {
336         return test_bit(CGRP_NOTIFY_ON_RELEASE, &cgrp->flags);
337 }
338
339 /**
340  * for_each_css - iterate all css's of a cgroup
341  * @css: the iteration cursor
342  * @ssid: the index of the subsystem, CGROUP_SUBSYS_COUNT after reaching the end
343  * @cgrp: the target cgroup to iterate css's of
344  *
345  * Should be called under cgroup_[tree_]mutex.
346  */
347 #define for_each_css(css, ssid, cgrp)                                   \
348         for ((ssid) = 0; (ssid) < CGROUP_SUBSYS_COUNT; (ssid)++)        \
349                 if (!((css) = rcu_dereference_check(                    \
350                                 (cgrp)->subsys[(ssid)],                 \
351                                 lockdep_is_held(&cgroup_tree_mutex) ||  \
352                                 lockdep_is_held(&cgroup_mutex)))) { }   \
353                 else
354
355 /**
356  * for_each_e_css - iterate all effective css's of a cgroup
357  * @css: the iteration cursor
358  * @ssid: the index of the subsystem, CGROUP_SUBSYS_COUNT after reaching the end
359  * @cgrp: the target cgroup to iterate css's of
360  *
361  * Should be called under cgroup_[tree_]mutex.
362  */
363 #define for_each_e_css(css, ssid, cgrp)                                 \
364         for ((ssid) = 0; (ssid) < CGROUP_SUBSYS_COUNT; (ssid)++)        \
365                 if (!((css) = cgroup_e_css(cgrp, cgroup_subsys[(ssid)]))) \
366                         ;                                               \
367                 else
368
369 /**
370  * for_each_subsys - iterate all enabled cgroup subsystems
371  * @ss: the iteration cursor
372  * @ssid: the index of @ss, CGROUP_SUBSYS_COUNT after reaching the end
373  */
374 #define for_each_subsys(ss, ssid)                                       \
375         for ((ssid) = 0; (ssid) < CGROUP_SUBSYS_COUNT &&                \
376              (((ss) = cgroup_subsys[ssid]) || true); (ssid)++)
377
378 /* iterate across the hierarchies */
379 #define for_each_root(root)                                             \
380         list_for_each_entry((root), &cgroup_roots, root_list)
381
382 /* iterate over child cgrps, lock should be held throughout iteration */
383 #define cgroup_for_each_live_child(child, cgrp)                         \
384         list_for_each_entry((child), &(cgrp)->children, sibling)        \
385                 if (({ lockdep_assert_held(&cgroup_tree_mutex);         \
386                        cgroup_is_dead(child); }))                       \
387                         ;                                               \
388                 else
389
390 /**
391  * cgroup_lock_live_group - take cgroup_mutex and check that cgrp is alive.
392  * @cgrp: the cgroup to be checked for liveness
393  *
394  * On success, returns true; the mutex should be later unlocked.  On
395  * failure returns false with no lock held.
396  */
397 static bool cgroup_lock_live_group(struct cgroup *cgrp)
398 {
399         mutex_lock(&cgroup_mutex);
400         if (cgroup_is_dead(cgrp)) {
401                 mutex_unlock(&cgroup_mutex);
402                 return false;
403         }
404         return true;
405 }
406
407 /* the list of cgroups eligible for automatic release. Protected by
408  * release_list_lock */
409 static LIST_HEAD(release_list);
410 static DEFINE_RAW_SPINLOCK(release_list_lock);
411 static void cgroup_release_agent(struct work_struct *work);
412 static DECLARE_WORK(release_agent_work, cgroup_release_agent);
413 static void check_for_release(struct cgroup *cgrp);
414
415 /*
416  * A cgroup can be associated with multiple css_sets as different tasks may
417  * belong to different cgroups on different hierarchies.  In the other
418  * direction, a css_set is naturally associated with multiple cgroups.
419  * This M:N relationship is represented by the following link structure
420  * which exists for each association and allows traversing the associations
421  * from both sides.
422  */
423 struct cgrp_cset_link {
424         /* the cgroup and css_set this link associates */
425         struct cgroup           *cgrp;
426         struct css_set          *cset;
427
428         /* list of cgrp_cset_links anchored at cgrp->cset_links */
429         struct list_head        cset_link;
430
431         /* list of cgrp_cset_links anchored at css_set->cgrp_links */
432         struct list_head        cgrp_link;
433 };
434
435 /*
436  * The default css_set - used by init and its children prior to any
437  * hierarchies being mounted. It contains a pointer to the root state
438  * for each subsystem. Also used to anchor the list of css_sets. Not
439  * reference-counted, to improve performance when child cgroups
440  * haven't been created.
441  */
442 struct css_set init_css_set = {
443         .refcount               = ATOMIC_INIT(1),
444         .cgrp_links             = LIST_HEAD_INIT(init_css_set.cgrp_links),
445         .tasks                  = LIST_HEAD_INIT(init_css_set.tasks),
446         .mg_tasks               = LIST_HEAD_INIT(init_css_set.mg_tasks),
447         .mg_preload_node        = LIST_HEAD_INIT(init_css_set.mg_preload_node),
448         .mg_node                = LIST_HEAD_INIT(init_css_set.mg_node),
449 };
450
451 static int css_set_count        = 1;    /* 1 for init_css_set */
452
453 /**
454  * cgroup_update_populated - updated populated count of a cgroup
455  * @cgrp: the target cgroup
456  * @populated: inc or dec populated count
457  *
458  * @cgrp is either getting the first task (css_set) or losing the last.
459  * Update @cgrp->populated_cnt accordingly.  The count is propagated
460  * towards root so that a given cgroup's populated_cnt is zero iff the
461  * cgroup and all its descendants are empty.
462  *
463  * @cgrp's interface file "cgroup.populated" is zero if
464  * @cgrp->populated_cnt is zero and 1 otherwise.  When @cgrp->populated_cnt
465  * changes from or to zero, userland is notified that the content of the
466  * interface file has changed.  This can be used to detect when @cgrp and
467  * its descendants become populated or empty.
468  */
469 static void cgroup_update_populated(struct cgroup *cgrp, bool populated)
470 {
471         lockdep_assert_held(&css_set_rwsem);
472
473         do {
474                 bool trigger;
475
476                 if (populated)
477                         trigger = !cgrp->populated_cnt++;
478                 else
479                         trigger = !--cgrp->populated_cnt;
480
481                 if (!trigger)
482                         break;
483
484                 if (cgrp->populated_kn)
485                         kernfs_notify(cgrp->populated_kn);
486                 cgrp = cgrp->parent;
487         } while (cgrp);
488 }
489
490 /*
491  * hash table for cgroup groups. This improves the performance to find
492  * an existing css_set. This hash doesn't (currently) take into
493  * account cgroups in empty hierarchies.
494  */
495 #define CSS_SET_HASH_BITS       7
496 static DEFINE_HASHTABLE(css_set_table, CSS_SET_HASH_BITS);
497
498 static unsigned long css_set_hash(struct cgroup_subsys_state *css[])
499 {
500         unsigned long key = 0UL;
501         struct cgroup_subsys *ss;
502         int i;
503
504         for_each_subsys(ss, i)
505                 key += (unsigned long)css[i];
506         key = (key >> 16) ^ key;
507
508         return key;
509 }
510
511 static void put_css_set_locked(struct css_set *cset, bool taskexit)
512 {
513         struct cgrp_cset_link *link, *tmp_link;
514         struct cgroup_subsys *ss;
515         int ssid;
516
517         lockdep_assert_held(&css_set_rwsem);
518
519         if (!atomic_dec_and_test(&cset->refcount))
520                 return;
521
522         /* This css_set is dead. unlink it and release cgroup refcounts */
523         for_each_subsys(ss, ssid)
524                 list_del(&cset->e_cset_node[ssid]);
525         hash_del(&cset->hlist);
526         css_set_count--;
527
528         list_for_each_entry_safe(link, tmp_link, &cset->cgrp_links, cgrp_link) {
529                 struct cgroup *cgrp = link->cgrp;
530
531                 list_del(&link->cset_link);
532                 list_del(&link->cgrp_link);
533
534                 /* @cgrp can't go away while we're holding css_set_rwsem */
535                 if (list_empty(&cgrp->cset_links)) {
536                         cgroup_update_populated(cgrp, false);
537                         if (notify_on_release(cgrp)) {
538                                 if (taskexit)
539                                         set_bit(CGRP_RELEASABLE, &cgrp->flags);
540                                 check_for_release(cgrp);
541                         }
542                 }
543
544                 kfree(link);
545         }
546
547         kfree_rcu(cset, rcu_head);
548 }
549
550 static void put_css_set(struct css_set *cset, bool taskexit)
551 {
552         /*
553          * Ensure that the refcount doesn't hit zero while any readers
554          * can see it. Similar to atomic_dec_and_lock(), but for an
555          * rwlock
556          */
557         if (atomic_add_unless(&cset->refcount, -1, 1))
558                 return;
559
560         down_write(&css_set_rwsem);
561         put_css_set_locked(cset, taskexit);
562         up_write(&css_set_rwsem);
563 }
564
565 /*
566  * refcounted get/put for css_set objects
567  */
568 static inline void get_css_set(struct css_set *cset)
569 {
570         atomic_inc(&cset->refcount);
571 }
572
573 /**
574  * compare_css_sets - helper function for find_existing_css_set().
575  * @cset: candidate css_set being tested
576  * @old_cset: existing css_set for a task
577  * @new_cgrp: cgroup that's being entered by the task
578  * @template: desired set of css pointers in css_set (pre-calculated)
579  *
580  * Returns true if "cset" matches "old_cset" except for the hierarchy
581  * which "new_cgrp" belongs to, for which it should match "new_cgrp".
582  */
583 static bool compare_css_sets(struct css_set *cset,
584                              struct css_set *old_cset,
585                              struct cgroup *new_cgrp,
586                              struct cgroup_subsys_state *template[])
587 {
588         struct list_head *l1, *l2;
589
590         /*
591          * On the default hierarchy, there can be csets which are
592          * associated with the same set of cgroups but different csses.
593          * Let's first ensure that csses match.
594          */
595         if (memcmp(template, cset->subsys, sizeof(cset->subsys)))
596                 return false;
597
598         /*
599          * Compare cgroup pointers in order to distinguish between
600          * different cgroups in hierarchies.  As different cgroups may
601          * share the same effective css, this comparison is always
602          * necessary.
603          */
604         l1 = &cset->cgrp_links;
605         l2 = &old_cset->cgrp_links;
606         while (1) {
607                 struct cgrp_cset_link *link1, *link2;
608                 struct cgroup *cgrp1, *cgrp2;
609
610                 l1 = l1->next;
611                 l2 = l2->next;
612                 /* See if we reached the end - both lists are equal length. */
613                 if (l1 == &cset->cgrp_links) {
614                         BUG_ON(l2 != &old_cset->cgrp_links);
615                         break;
616                 } else {
617                         BUG_ON(l2 == &old_cset->cgrp_links);
618                 }
619                 /* Locate the cgroups associated with these links. */
620                 link1 = list_entry(l1, struct cgrp_cset_link, cgrp_link);
621                 link2 = list_entry(l2, struct cgrp_cset_link, cgrp_link);
622                 cgrp1 = link1->cgrp;
623                 cgrp2 = link2->cgrp;
624                 /* Hierarchies should be linked in the same order. */
625                 BUG_ON(cgrp1->root != cgrp2->root);
626
627                 /*
628                  * If this hierarchy is the hierarchy of the cgroup
629                  * that's changing, then we need to check that this
630                  * css_set points to the new cgroup; if it's any other
631                  * hierarchy, then this css_set should point to the
632                  * same cgroup as the old css_set.
633                  */
634                 if (cgrp1->root == new_cgrp->root) {
635                         if (cgrp1 != new_cgrp)
636                                 return false;
637                 } else {
638                         if (cgrp1 != cgrp2)
639                                 return false;
640                 }
641         }
642         return true;
643 }
644
645 /**
646  * find_existing_css_set - init css array and find the matching css_set
647  * @old_cset: the css_set that we're using before the cgroup transition
648  * @cgrp: the cgroup that we're moving into
649  * @template: out param for the new set of csses, should be clear on entry
650  */
651 static struct css_set *find_existing_css_set(struct css_set *old_cset,
652                                         struct cgroup *cgrp,
653                                         struct cgroup_subsys_state *template[])
654 {
655         struct cgroup_root *root = cgrp->root;
656         struct cgroup_subsys *ss;
657         struct css_set *cset;
658         unsigned long key;
659         int i;
660
661         /*
662          * Build the set of subsystem state objects that we want to see in the
663          * new css_set. while subsystems can change globally, the entries here
664          * won't change, so no need for locking.
665          */
666         for_each_subsys(ss, i) {
667                 if (root->subsys_mask & (1UL << i)) {
668                         /*
669                          * @ss is in this hierarchy, so we want the
670                          * effective css from @cgrp.
671                          */
672                         template[i] = cgroup_e_css(cgrp, ss);
673                 } else {
674                         /*
675                          * @ss is not in this hierarchy, so we don't want
676                          * to change the css.
677                          */
678                         template[i] = old_cset->subsys[i];
679                 }
680         }
681
682         key = css_set_hash(template);
683         hash_for_each_possible(css_set_table, cset, hlist, key) {
684                 if (!compare_css_sets(cset, old_cset, cgrp, template))
685                         continue;
686
687                 /* This css_set matches what we need */
688                 return cset;
689         }
690
691         /* No existing cgroup group matched */
692         return NULL;
693 }
694
695 static void free_cgrp_cset_links(struct list_head *links_to_free)
696 {
697         struct cgrp_cset_link *link, *tmp_link;
698
699         list_for_each_entry_safe(link, tmp_link, links_to_free, cset_link) {
700                 list_del(&link->cset_link);
701                 kfree(link);
702         }
703 }
704
705 /**
706  * allocate_cgrp_cset_links - allocate cgrp_cset_links
707  * @count: the number of links to allocate
708  * @tmp_links: list_head the allocated links are put on
709  *
710  * Allocate @count cgrp_cset_link structures and chain them on @tmp_links
711  * through ->cset_link.  Returns 0 on success or -errno.
712  */
713 static int allocate_cgrp_cset_links(int count, struct list_head *tmp_links)
714 {
715         struct cgrp_cset_link *link;
716         int i;
717
718         INIT_LIST_HEAD(tmp_links);
719
720         for (i = 0; i < count; i++) {
721                 link = kzalloc(sizeof(*link), GFP_KERNEL);
722                 if (!link) {
723                         free_cgrp_cset_links(tmp_links);
724                         return -ENOMEM;
725                 }
726                 list_add(&link->cset_link, tmp_links);
727         }
728         return 0;
729 }
730
731 /**
732  * link_css_set - a helper function to link a css_set to a cgroup
733  * @tmp_links: cgrp_cset_link objects allocated by allocate_cgrp_cset_links()
734  * @cset: the css_set to be linked
735  * @cgrp: the destination cgroup
736  */
737 static void link_css_set(struct list_head *tmp_links, struct css_set *cset,
738                          struct cgroup *cgrp)
739 {
740         struct cgrp_cset_link *link;
741
742         BUG_ON(list_empty(tmp_links));
743
744         if (cgroup_on_dfl(cgrp))
745                 cset->dfl_cgrp = cgrp;
746
747         link = list_first_entry(tmp_links, struct cgrp_cset_link, cset_link);
748         link->cset = cset;
749         link->cgrp = cgrp;
750
751         if (list_empty(&cgrp->cset_links))
752                 cgroup_update_populated(cgrp, true);
753         list_move(&link->cset_link, &cgrp->cset_links);
754
755         /*
756          * Always add links to the tail of the list so that the list
757          * is sorted by order of hierarchy creation
758          */
759         list_add_tail(&link->cgrp_link, &cset->cgrp_links);
760 }
761
762 /**
763  * find_css_set - return a new css_set with one cgroup updated
764  * @old_cset: the baseline css_set
765  * @cgrp: the cgroup to be updated
766  *
767  * Return a new css_set that's equivalent to @old_cset, but with @cgrp
768  * substituted into the appropriate hierarchy.
769  */
770 static struct css_set *find_css_set(struct css_set *old_cset,
771                                     struct cgroup *cgrp)
772 {
773         struct cgroup_subsys_state *template[CGROUP_SUBSYS_COUNT] = { };
774         struct css_set *cset;
775         struct list_head tmp_links;
776         struct cgrp_cset_link *link;
777         struct cgroup_subsys *ss;
778         unsigned long key;
779         int ssid;
780
781         lockdep_assert_held(&cgroup_mutex);
782
783         /* First see if we already have a cgroup group that matches
784          * the desired set */
785         down_read(&css_set_rwsem);
786         cset = find_existing_css_set(old_cset, cgrp, template);
787         if (cset)
788                 get_css_set(cset);
789         up_read(&css_set_rwsem);
790
791         if (cset)
792                 return cset;
793
794         cset = kzalloc(sizeof(*cset), GFP_KERNEL);
795         if (!cset)
796                 return NULL;
797
798         /* Allocate all the cgrp_cset_link objects that we'll need */
799         if (allocate_cgrp_cset_links(cgroup_root_count, &tmp_links) < 0) {
800                 kfree(cset);
801                 return NULL;
802         }
803
804         atomic_set(&cset->refcount, 1);
805         INIT_LIST_HEAD(&cset->cgrp_links);
806         INIT_LIST_HEAD(&cset->tasks);
807         INIT_LIST_HEAD(&cset->mg_tasks);
808         INIT_LIST_HEAD(&cset->mg_preload_node);
809         INIT_LIST_HEAD(&cset->mg_node);
810         INIT_HLIST_NODE(&cset->hlist);
811
812         /* Copy the set of subsystem state objects generated in
813          * find_existing_css_set() */
814         memcpy(cset->subsys, template, sizeof(cset->subsys));
815
816         down_write(&css_set_rwsem);
817         /* Add reference counts and links from the new css_set. */
818         list_for_each_entry(link, &old_cset->cgrp_links, cgrp_link) {
819                 struct cgroup *c = link->cgrp;
820
821                 if (c->root == cgrp->root)
822                         c = cgrp;
823                 link_css_set(&tmp_links, cset, c);
824         }
825
826         BUG_ON(!list_empty(&tmp_links));
827
828         css_set_count++;
829
830         /* Add @cset to the hash table */
831         key = css_set_hash(cset->subsys);
832         hash_add(css_set_table, &cset->hlist, key);
833
834         for_each_subsys(ss, ssid)
835                 list_add_tail(&cset->e_cset_node[ssid],
836                               &cset->subsys[ssid]->cgroup->e_csets[ssid]);
837
838         up_write(&css_set_rwsem);
839
840         return cset;
841 }
842
843 static struct cgroup_root *cgroup_root_from_kf(struct kernfs_root *kf_root)
844 {
845         struct cgroup *root_cgrp = kf_root->kn->priv;
846
847         return root_cgrp->root;
848 }
849
850 static int cgroup_init_root_id(struct cgroup_root *root)
851 {
852         int id;
853
854         lockdep_assert_held(&cgroup_mutex);
855
856         id = idr_alloc_cyclic(&cgroup_hierarchy_idr, root, 0, 0, GFP_KERNEL);
857         if (id < 0)
858                 return id;
859
860         root->hierarchy_id = id;
861         return 0;
862 }
863
864 static void cgroup_exit_root_id(struct cgroup_root *root)
865 {
866         lockdep_assert_held(&cgroup_mutex);
867
868         if (root->hierarchy_id) {
869                 idr_remove(&cgroup_hierarchy_idr, root->hierarchy_id);
870                 root->hierarchy_id = 0;
871         }
872 }
873
874 static void cgroup_free_root(struct cgroup_root *root)
875 {
876         if (root) {
877                 /* hierarhcy ID shoulid already have been released */
878                 WARN_ON_ONCE(root->hierarchy_id);
879
880                 idr_destroy(&root->cgroup_idr);
881                 kfree(root);
882         }
883 }
884
885 static void cgroup_destroy_root(struct cgroup_root *root)
886 {
887         struct cgroup *cgrp = &root->cgrp;
888         struct cgrp_cset_link *link, *tmp_link;
889
890         mutex_lock(&cgroup_tree_mutex);
891         mutex_lock(&cgroup_mutex);
892
893         BUG_ON(atomic_read(&root->nr_cgrps));
894         BUG_ON(!list_empty(&cgrp->children));
895
896         /* Rebind all subsystems back to the default hierarchy */
897         rebind_subsystems(&cgrp_dfl_root, root->subsys_mask);
898
899         /*
900          * Release all the links from cset_links to this hierarchy's
901          * root cgroup
902          */
903         down_write(&css_set_rwsem);
904
905         list_for_each_entry_safe(link, tmp_link, &cgrp->cset_links, cset_link) {
906                 list_del(&link->cset_link);
907                 list_del(&link->cgrp_link);
908                 kfree(link);
909         }
910         up_write(&css_set_rwsem);
911
912         if (!list_empty(&root->root_list)) {
913                 list_del(&root->root_list);
914                 cgroup_root_count--;
915         }
916
917         cgroup_exit_root_id(root);
918
919         mutex_unlock(&cgroup_mutex);
920         mutex_unlock(&cgroup_tree_mutex);
921
922         kernfs_destroy_root(root->kf_root);
923         cgroup_free_root(root);
924 }
925
926 /* look up cgroup associated with given css_set on the specified hierarchy */
927 static struct cgroup *cset_cgroup_from_root(struct css_set *cset,
928                                             struct cgroup_root *root)
929 {
930         struct cgroup *res = NULL;
931
932         lockdep_assert_held(&cgroup_mutex);
933         lockdep_assert_held(&css_set_rwsem);
934
935         if (cset == &init_css_set) {
936                 res = &root->cgrp;
937         } else {
938                 struct cgrp_cset_link *link;
939
940                 list_for_each_entry(link, &cset->cgrp_links, cgrp_link) {
941                         struct cgroup *c = link->cgrp;
942
943                         if (c->root == root) {
944                                 res = c;
945                                 break;
946                         }
947                 }
948         }
949
950         BUG_ON(!res);
951         return res;
952 }
953
954 /*
955  * Return the cgroup for "task" from the given hierarchy. Must be
956  * called with cgroup_mutex and css_set_rwsem held.
957  */
958 static struct cgroup *task_cgroup_from_root(struct task_struct *task,
959                                             struct cgroup_root *root)
960 {
961         /*
962          * No need to lock the task - since we hold cgroup_mutex the
963          * task can't change groups, so the only thing that can happen
964          * is that it exits and its css is set back to init_css_set.
965          */
966         return cset_cgroup_from_root(task_css_set(task), root);
967 }
968
969 /*
970  * A task must hold cgroup_mutex to modify cgroups.
971  *
972  * Any task can increment and decrement the count field without lock.
973  * So in general, code holding cgroup_mutex can't rely on the count
974  * field not changing.  However, if the count goes to zero, then only
975  * cgroup_attach_task() can increment it again.  Because a count of zero
976  * means that no tasks are currently attached, therefore there is no
977  * way a task attached to that cgroup can fork (the other way to
978  * increment the count).  So code holding cgroup_mutex can safely
979  * assume that if the count is zero, it will stay zero. Similarly, if
980  * a task holds cgroup_mutex on a cgroup with zero count, it
981  * knows that the cgroup won't be removed, as cgroup_rmdir()
982  * needs that mutex.
983  *
984  * The fork and exit callbacks cgroup_fork() and cgroup_exit(), don't
985  * (usually) take cgroup_mutex.  These are the two most performance
986  * critical pieces of code here.  The exception occurs on cgroup_exit(),
987  * when a task in a notify_on_release cgroup exits.  Then cgroup_mutex
988  * is taken, and if the cgroup count is zero, a usermode call made
989  * to the release agent with the name of the cgroup (path relative to
990  * the root of cgroup file system) as the argument.
991  *
992  * A cgroup can only be deleted if both its 'count' of using tasks
993  * is zero, and its list of 'children' cgroups is empty.  Since all
994  * tasks in the system use _some_ cgroup, and since there is always at
995  * least one task in the system (init, pid == 1), therefore, root cgroup
996  * always has either children cgroups and/or using tasks.  So we don't
997  * need a special hack to ensure that root cgroup cannot be deleted.
998  *
999  * P.S.  One more locking exception.  RCU is used to guard the
1000  * update of a tasks cgroup pointer by cgroup_attach_task()
1001  */
1002
1003 static int cgroup_populate_dir(struct cgroup *cgrp, unsigned int subsys_mask);
1004 static struct kernfs_syscall_ops cgroup_kf_syscall_ops;
1005 static const struct file_operations proc_cgroupstats_operations;
1006
1007 static char *cgroup_file_name(struct cgroup *cgrp, const struct cftype *cft,
1008                               char *buf)
1009 {
1010         if (cft->ss && !(cft->flags & CFTYPE_NO_PREFIX) &&
1011             !(cgrp->root->flags & CGRP_ROOT_NOPREFIX))
1012                 snprintf(buf, CGROUP_FILE_NAME_MAX, "%s.%s",
1013                          cft->ss->name, cft->name);
1014         else
1015                 strncpy(buf, cft->name, CGROUP_FILE_NAME_MAX);
1016         return buf;
1017 }
1018
1019 /**
1020  * cgroup_file_mode - deduce file mode of a control file
1021  * @cft: the control file in question
1022  *
1023  * returns cft->mode if ->mode is not 0
1024  * returns S_IRUGO|S_IWUSR if it has both a read and a write handler
1025  * returns S_IRUGO if it has only a read handler
1026  * returns S_IWUSR if it has only a write hander
1027  */
1028 static umode_t cgroup_file_mode(const struct cftype *cft)
1029 {
1030         umode_t mode = 0;
1031
1032         if (cft->mode)
1033                 return cft->mode;
1034
1035         if (cft->read_u64 || cft->read_s64 || cft->seq_show)
1036                 mode |= S_IRUGO;
1037
1038         if (cft->write_u64 || cft->write_s64 || cft->write_string ||
1039             cft->trigger)
1040                 mode |= S_IWUSR;
1041
1042         return mode;
1043 }
1044
1045 static void cgroup_free_fn(struct work_struct *work)
1046 {
1047         struct cgroup *cgrp = container_of(work, struct cgroup, destroy_work);
1048
1049         atomic_dec(&cgrp->root->nr_cgrps);
1050         cgroup_pidlist_destroy_all(cgrp);
1051
1052         if (cgrp->parent) {
1053                 /*
1054                  * We get a ref to the parent, and put the ref when this
1055                  * cgroup is being freed, so it's guaranteed that the
1056                  * parent won't be destroyed before its children.
1057                  */
1058                 cgroup_put(cgrp->parent);
1059                 kernfs_put(cgrp->kn);
1060                 kfree(cgrp);
1061         } else {
1062                 /*
1063                  * This is root cgroup's refcnt reaching zero, which
1064                  * indicates that the root should be released.
1065                  */
1066                 cgroup_destroy_root(cgrp->root);
1067         }
1068 }
1069
1070 static void cgroup_free_rcu(struct rcu_head *head)
1071 {
1072         struct cgroup *cgrp = container_of(head, struct cgroup, rcu_head);
1073
1074         INIT_WORK(&cgrp->destroy_work, cgroup_free_fn);
1075         queue_work(cgroup_destroy_wq, &cgrp->destroy_work);
1076 }
1077
1078 static void cgroup_get(struct cgroup *cgrp)
1079 {
1080         WARN_ON_ONCE(cgroup_is_dead(cgrp));
1081         WARN_ON_ONCE(atomic_read(&cgrp->refcnt) <= 0);
1082         atomic_inc(&cgrp->refcnt);
1083 }
1084
1085 static void cgroup_put(struct cgroup *cgrp)
1086 {
1087         if (!atomic_dec_and_test(&cgrp->refcnt))
1088                 return;
1089         if (WARN_ON_ONCE(cgrp->parent && !cgroup_is_dead(cgrp)))
1090                 return;
1091
1092         cgroup_idr_remove(&cgrp->root->cgroup_idr, cgrp->id);
1093         cgrp->id = -1;
1094
1095         call_rcu(&cgrp->rcu_head, cgroup_free_rcu);
1096 }
1097
1098 static void cgroup_rm_file(struct cgroup *cgrp, const struct cftype *cft)
1099 {
1100         char name[CGROUP_FILE_NAME_MAX];
1101
1102         lockdep_assert_held(&cgroup_tree_mutex);
1103         kernfs_remove_by_name(cgrp->kn, cgroup_file_name(cgrp, cft, name));
1104 }
1105
1106 /**
1107  * cgroup_clear_dir - remove subsys files in a cgroup directory
1108  * @cgrp: target cgroup
1109  * @subsys_mask: mask of the subsystem ids whose files should be removed
1110  */
1111 static void cgroup_clear_dir(struct cgroup *cgrp, unsigned int subsys_mask)
1112 {
1113         struct cgroup_subsys *ss;
1114         int i;
1115
1116         for_each_subsys(ss, i) {
1117                 struct cftype *cfts;
1118
1119                 if (!(subsys_mask & (1 << i)))
1120                         continue;
1121                 list_for_each_entry(cfts, &ss->cfts, node)
1122                         cgroup_addrm_files(cgrp, cfts, false);
1123         }
1124 }
1125
1126 static int rebind_subsystems(struct cgroup_root *dst_root, unsigned int ss_mask)
1127 {
1128         struct cgroup_subsys *ss;
1129         int ssid, i, ret;
1130
1131         lockdep_assert_held(&cgroup_tree_mutex);
1132         lockdep_assert_held(&cgroup_mutex);
1133
1134         for_each_subsys(ss, ssid) {
1135                 if (!(ss_mask & (1 << ssid)))
1136                         continue;
1137
1138                 /* if @ss has non-root csses attached to it, can't move */
1139                 if (css_next_child(NULL, cgroup_css(&ss->root->cgrp, ss)))
1140                         return -EBUSY;
1141
1142                 /* can't move between two non-dummy roots either */
1143                 if (ss->root != &cgrp_dfl_root && dst_root != &cgrp_dfl_root)
1144                         return -EBUSY;
1145         }
1146
1147         ret = cgroup_populate_dir(&dst_root->cgrp, ss_mask);
1148         if (ret) {
1149                 if (dst_root != &cgrp_dfl_root)
1150                         return ret;
1151
1152                 /*
1153                  * Rebinding back to the default root is not allowed to
1154                  * fail.  Using both default and non-default roots should
1155                  * be rare.  Moving subsystems back and forth even more so.
1156                  * Just warn about it and continue.
1157                  */
1158                 if (cgrp_dfl_root_visible) {
1159                         pr_warn("failed to create files (%d) while rebinding 0x%x to default root\n",
1160                                 ret, ss_mask);
1161                         pr_warn("you may retry by moving them to a different hierarchy and unbinding\n");
1162                 }
1163         }
1164
1165         /*
1166          * Nothing can fail from this point on.  Remove files for the
1167          * removed subsystems and rebind each subsystem.
1168          */
1169         mutex_unlock(&cgroup_mutex);
1170         for_each_subsys(ss, ssid)
1171                 if (ss_mask & (1 << ssid))
1172                         cgroup_clear_dir(&ss->root->cgrp, 1 << ssid);
1173         mutex_lock(&cgroup_mutex);
1174
1175         for_each_subsys(ss, ssid) {
1176                 struct cgroup_root *src_root;
1177                 struct cgroup_subsys_state *css;
1178                 struct css_set *cset;
1179
1180                 if (!(ss_mask & (1 << ssid)))
1181                         continue;
1182
1183                 src_root = ss->root;
1184                 css = cgroup_css(&src_root->cgrp, ss);
1185
1186                 WARN_ON(!css || cgroup_css(&dst_root->cgrp, ss));
1187
1188                 RCU_INIT_POINTER(src_root->cgrp.subsys[ssid], NULL);
1189                 rcu_assign_pointer(dst_root->cgrp.subsys[ssid], css);
1190                 ss->root = dst_root;
1191                 css->cgroup = &dst_root->cgrp;
1192
1193                 down_write(&css_set_rwsem);
1194                 hash_for_each(css_set_table, i, cset, hlist)
1195                         list_move_tail(&cset->e_cset_node[ss->id],
1196                                        &dst_root->cgrp.e_csets[ss->id]);
1197                 up_write(&css_set_rwsem);
1198
1199                 src_root->subsys_mask &= ~(1 << ssid);
1200                 src_root->cgrp.child_subsys_mask &= ~(1 << ssid);
1201
1202                 /* default hierarchy doesn't enable controllers by default */
1203                 dst_root->subsys_mask |= 1 << ssid;
1204                 if (dst_root != &cgrp_dfl_root)
1205                         dst_root->cgrp.child_subsys_mask |= 1 << ssid;
1206
1207                 if (ss->bind)
1208                         ss->bind(css);
1209         }
1210
1211         kernfs_activate(dst_root->cgrp.kn);
1212         return 0;
1213 }
1214
1215 static int cgroup_show_options(struct seq_file *seq,
1216                                struct kernfs_root *kf_root)
1217 {
1218         struct cgroup_root *root = cgroup_root_from_kf(kf_root);
1219         struct cgroup_subsys *ss;
1220         int ssid;
1221
1222         for_each_subsys(ss, ssid)
1223                 if (root->subsys_mask & (1 << ssid))
1224                         seq_printf(seq, ",%s", ss->name);
1225         if (root->flags & CGRP_ROOT_SANE_BEHAVIOR)
1226                 seq_puts(seq, ",sane_behavior");
1227         if (root->flags & CGRP_ROOT_NOPREFIX)
1228                 seq_puts(seq, ",noprefix");
1229         if (root->flags & CGRP_ROOT_XATTR)
1230                 seq_puts(seq, ",xattr");
1231
1232         spin_lock(&release_agent_path_lock);
1233         if (strlen(root->release_agent_path))
1234                 seq_printf(seq, ",release_agent=%s", root->release_agent_path);
1235         spin_unlock(&release_agent_path_lock);
1236
1237         if (test_bit(CGRP_CPUSET_CLONE_CHILDREN, &root->cgrp.flags))
1238                 seq_puts(seq, ",clone_children");
1239         if (strlen(root->name))
1240                 seq_printf(seq, ",name=%s", root->name);
1241         return 0;
1242 }
1243
1244 struct cgroup_sb_opts {
1245         unsigned int subsys_mask;
1246         unsigned int flags;
1247         char *release_agent;
1248         bool cpuset_clone_children;
1249         char *name;
1250         /* User explicitly requested empty subsystem */
1251         bool none;
1252 };
1253
1254 static int parse_cgroupfs_options(char *data, struct cgroup_sb_opts *opts)
1255 {
1256         char *token, *o = data;
1257         bool all_ss = false, one_ss = false;
1258         unsigned int mask = -1U;
1259         struct cgroup_subsys *ss;
1260         int i;
1261
1262 #ifdef CONFIG_CPUSETS
1263         mask = ~(1U << cpuset_cgrp_id);
1264 #endif
1265
1266         memset(opts, 0, sizeof(*opts));
1267
1268         while ((token = strsep(&o, ",")) != NULL) {
1269                 if (!*token)
1270                         return -EINVAL;
1271                 if (!strcmp(token, "none")) {
1272                         /* Explicitly have no subsystems */
1273                         opts->none = true;
1274                         continue;
1275                 }
1276                 if (!strcmp(token, "all")) {
1277                         /* Mutually exclusive option 'all' + subsystem name */
1278                         if (one_ss)
1279                                 return -EINVAL;
1280                         all_ss = true;
1281                         continue;
1282                 }
1283                 if (!strcmp(token, "__DEVEL__sane_behavior")) {
1284                         opts->flags |= CGRP_ROOT_SANE_BEHAVIOR;
1285                         continue;
1286                 }
1287                 if (!strcmp(token, "noprefix")) {
1288                         opts->flags |= CGRP_ROOT_NOPREFIX;
1289                         continue;
1290                 }
1291                 if (!strcmp(token, "clone_children")) {
1292                         opts->cpuset_clone_children = true;
1293                         continue;
1294                 }
1295                 if (!strcmp(token, "xattr")) {
1296                         opts->flags |= CGRP_ROOT_XATTR;
1297                         continue;
1298                 }
1299                 if (!strncmp(token, "release_agent=", 14)) {
1300                         /* Specifying two release agents is forbidden */
1301                         if (opts->release_agent)
1302                                 return -EINVAL;
1303                         opts->release_agent =
1304                                 kstrndup(token + 14, PATH_MAX - 1, GFP_KERNEL);
1305                         if (!opts->release_agent)
1306                                 return -ENOMEM;
1307                         continue;
1308                 }
1309                 if (!strncmp(token, "name=", 5)) {
1310                         const char *name = token + 5;
1311                         /* Can't specify an empty name */
1312                         if (!strlen(name))
1313                                 return -EINVAL;
1314                         /* Must match [\w.-]+ */
1315                         for (i = 0; i < strlen(name); i++) {
1316                                 char c = name[i];
1317                                 if (isalnum(c))
1318                                         continue;
1319                                 if ((c == '.') || (c == '-') || (c == '_'))
1320                                         continue;
1321                                 return -EINVAL;
1322                         }
1323                         /* Specifying two names is forbidden */
1324                         if (opts->name)
1325                                 return -EINVAL;
1326                         opts->name = kstrndup(name,
1327                                               MAX_CGROUP_ROOT_NAMELEN - 1,
1328                                               GFP_KERNEL);
1329                         if (!opts->name)
1330                                 return -ENOMEM;
1331
1332                         continue;
1333                 }
1334
1335                 for_each_subsys(ss, i) {
1336                         if (strcmp(token, ss->name))
1337                                 continue;
1338                         if (ss->disabled)
1339                                 continue;
1340
1341                         /* Mutually exclusive option 'all' + subsystem name */
1342                         if (all_ss)
1343                                 return -EINVAL;
1344                         opts->subsys_mask |= (1 << i);
1345                         one_ss = true;
1346
1347                         break;
1348                 }
1349                 if (i == CGROUP_SUBSYS_COUNT)
1350                         return -ENOENT;
1351         }
1352
1353         /* Consistency checks */
1354
1355         if (opts->flags & CGRP_ROOT_SANE_BEHAVIOR) {
1356                 pr_warn("sane_behavior: this is still under development and its behaviors will change, proceed at your own risk\n");
1357
1358                 if ((opts->flags & (CGRP_ROOT_NOPREFIX | CGRP_ROOT_XATTR)) ||
1359                     opts->cpuset_clone_children || opts->release_agent ||
1360                     opts->name) {
1361                         pr_err("sane_behavior: noprefix, xattr, clone_children, release_agent and name are not allowed\n");
1362                         return -EINVAL;
1363                 }
1364         } else {
1365                 /*
1366                  * If the 'all' option was specified select all the
1367                  * subsystems, otherwise if 'none', 'name=' and a subsystem
1368                  * name options were not specified, let's default to 'all'
1369                  */
1370                 if (all_ss || (!one_ss && !opts->none && !opts->name))
1371                         for_each_subsys(ss, i)
1372                                 if (!ss->disabled)
1373                                         opts->subsys_mask |= (1 << i);
1374
1375                 /*
1376                  * We either have to specify by name or by subsystems. (So
1377                  * all empty hierarchies must have a name).
1378                  */
1379                 if (!opts->subsys_mask && !opts->name)
1380                         return -EINVAL;
1381         }
1382
1383         /*
1384          * Option noprefix was introduced just for backward compatibility
1385          * with the old cpuset, so we allow noprefix only if mounting just
1386          * the cpuset subsystem.
1387          */
1388         if ((opts->flags & CGRP_ROOT_NOPREFIX) && (opts->subsys_mask & mask))
1389                 return -EINVAL;
1390
1391
1392         /* Can't specify "none" and some subsystems */
1393         if (opts->subsys_mask && opts->none)
1394                 return -EINVAL;
1395
1396         return 0;
1397 }
1398
1399 static int cgroup_remount(struct kernfs_root *kf_root, int *flags, char *data)
1400 {
1401         int ret = 0;
1402         struct cgroup_root *root = cgroup_root_from_kf(kf_root);
1403         struct cgroup_sb_opts opts;
1404         unsigned int added_mask, removed_mask;
1405
1406         if (root->flags & CGRP_ROOT_SANE_BEHAVIOR) {
1407                 pr_err("sane_behavior: remount is not allowed\n");
1408                 return -EINVAL;
1409         }
1410
1411         mutex_lock(&cgroup_tree_mutex);
1412         mutex_lock(&cgroup_mutex);
1413
1414         /* See what subsystems are wanted */
1415         ret = parse_cgroupfs_options(data, &opts);
1416         if (ret)
1417                 goto out_unlock;
1418
1419         if (opts.subsys_mask != root->subsys_mask || opts.release_agent)
1420                 pr_warn("option changes via remount are deprecated (pid=%d comm=%s)\n",
1421                         task_tgid_nr(current), current->comm);
1422
1423         added_mask = opts.subsys_mask & ~root->subsys_mask;
1424         removed_mask = root->subsys_mask & ~opts.subsys_mask;
1425
1426         /* Don't allow flags or name to change at remount */
1427         if (((opts.flags ^ root->flags) & CGRP_ROOT_OPTION_MASK) ||
1428             (opts.name && strcmp(opts.name, root->name))) {
1429                 pr_err("option or name mismatch, new: 0x%x \"%s\", old: 0x%x \"%s\"\n",
1430                        opts.flags & CGRP_ROOT_OPTION_MASK, opts.name ?: "",
1431                        root->flags & CGRP_ROOT_OPTION_MASK, root->name);
1432                 ret = -EINVAL;
1433                 goto out_unlock;
1434         }
1435
1436         /* remounting is not allowed for populated hierarchies */
1437         if (!list_empty(&root->cgrp.children)) {
1438                 ret = -EBUSY;
1439                 goto out_unlock;
1440         }
1441
1442         ret = rebind_subsystems(root, added_mask);
1443         if (ret)
1444                 goto out_unlock;
1445
1446         rebind_subsystems(&cgrp_dfl_root, removed_mask);
1447
1448         if (opts.release_agent) {
1449                 spin_lock(&release_agent_path_lock);
1450                 strcpy(root->release_agent_path, opts.release_agent);
1451                 spin_unlock(&release_agent_path_lock);
1452         }
1453  out_unlock:
1454         kfree(opts.release_agent);
1455         kfree(opts.name);
1456         mutex_unlock(&cgroup_mutex);
1457         mutex_unlock(&cgroup_tree_mutex);
1458         return ret;
1459 }
1460
1461 /*
1462  * To reduce the fork() overhead for systems that are not actually using
1463  * their cgroups capability, we don't maintain the lists running through
1464  * each css_set to its tasks until we see the list actually used - in other
1465  * words after the first mount.
1466  */
1467 static bool use_task_css_set_links __read_mostly;
1468
1469 static void cgroup_enable_task_cg_lists(void)
1470 {
1471         struct task_struct *p, *g;
1472
1473         down_write(&css_set_rwsem);
1474
1475         if (use_task_css_set_links)
1476                 goto out_unlock;
1477
1478         use_task_css_set_links = true;
1479
1480         /*
1481          * We need tasklist_lock because RCU is not safe against
1482          * while_each_thread(). Besides, a forking task that has passed
1483          * cgroup_post_fork() without seeing use_task_css_set_links = 1
1484          * is not guaranteed to have its child immediately visible in the
1485          * tasklist if we walk through it with RCU.
1486          */
1487         read_lock(&tasklist_lock);
1488         do_each_thread(g, p) {
1489                 WARN_ON_ONCE(!list_empty(&p->cg_list) ||
1490                              task_css_set(p) != &init_css_set);
1491
1492                 /*
1493                  * We should check if the process is exiting, otherwise
1494                  * it will race with cgroup_exit() in that the list
1495                  * entry won't be deleted though the process has exited.
1496                  * Do it while holding siglock so that we don't end up
1497                  * racing against cgroup_exit().
1498                  */
1499                 spin_lock_irq(&p->sighand->siglock);
1500                 if (!(p->flags & PF_EXITING)) {
1501                         struct css_set *cset = task_css_set(p);
1502
1503                         list_add(&p->cg_list, &cset->tasks);
1504                         get_css_set(cset);
1505                 }
1506                 spin_unlock_irq(&p->sighand->siglock);
1507         } while_each_thread(g, p);
1508         read_unlock(&tasklist_lock);
1509 out_unlock:
1510         up_write(&css_set_rwsem);
1511 }
1512
1513 static void init_cgroup_housekeeping(struct cgroup *cgrp)
1514 {
1515         struct cgroup_subsys *ss;
1516         int ssid;
1517
1518         atomic_set(&cgrp->refcnt, 1);
1519         INIT_LIST_HEAD(&cgrp->sibling);
1520         INIT_LIST_HEAD(&cgrp->children);
1521         INIT_LIST_HEAD(&cgrp->cset_links);
1522         INIT_LIST_HEAD(&cgrp->release_list);
1523         INIT_LIST_HEAD(&cgrp->pidlists);
1524         mutex_init(&cgrp->pidlist_mutex);
1525         cgrp->dummy_css.cgroup = cgrp;
1526
1527         for_each_subsys(ss, ssid)
1528                 INIT_LIST_HEAD(&cgrp->e_csets[ssid]);
1529
1530         init_waitqueue_head(&cgrp->offline_waitq);
1531 }
1532
1533 static void init_cgroup_root(struct cgroup_root *root,
1534                              struct cgroup_sb_opts *opts)
1535 {
1536         struct cgroup *cgrp = &root->cgrp;
1537
1538         INIT_LIST_HEAD(&root->root_list);
1539         atomic_set(&root->nr_cgrps, 1);
1540         cgrp->root = root;
1541         init_cgroup_housekeeping(cgrp);
1542         idr_init(&root->cgroup_idr);
1543
1544         root->flags = opts->flags;
1545         if (opts->release_agent)
1546                 strcpy(root->release_agent_path, opts->release_agent);
1547         if (opts->name)
1548                 strcpy(root->name, opts->name);
1549         if (opts->cpuset_clone_children)
1550                 set_bit(CGRP_CPUSET_CLONE_CHILDREN, &root->cgrp.flags);
1551 }
1552
1553 static int cgroup_setup_root(struct cgroup_root *root, unsigned int ss_mask)
1554 {
1555         LIST_HEAD(tmp_links);
1556         struct cgroup *root_cgrp = &root->cgrp;
1557         struct css_set *cset;
1558         int i, ret;
1559
1560         lockdep_assert_held(&cgroup_tree_mutex);
1561         lockdep_assert_held(&cgroup_mutex);
1562
1563         ret = cgroup_idr_alloc(&root->cgroup_idr, root_cgrp, 1, 2, GFP_NOWAIT);
1564         if (ret < 0)
1565                 goto out;
1566         root_cgrp->id = ret;
1567
1568         /*
1569          * We're accessing css_set_count without locking css_set_rwsem here,
1570          * but that's OK - it can only be increased by someone holding
1571          * cgroup_lock, and that's us. The worst that can happen is that we
1572          * have some link structures left over
1573          */
1574         ret = allocate_cgrp_cset_links(css_set_count, &tmp_links);
1575         if (ret)
1576                 goto out;
1577
1578         ret = cgroup_init_root_id(root);
1579         if (ret)
1580                 goto out;
1581
1582         root->kf_root = kernfs_create_root(&cgroup_kf_syscall_ops,
1583                                            KERNFS_ROOT_CREATE_DEACTIVATED,
1584                                            root_cgrp);
1585         if (IS_ERR(root->kf_root)) {
1586                 ret = PTR_ERR(root->kf_root);
1587                 goto exit_root_id;
1588         }
1589         root_cgrp->kn = root->kf_root->kn;
1590
1591         ret = cgroup_addrm_files(root_cgrp, cgroup_base_files, true);
1592         if (ret)
1593                 goto destroy_root;
1594
1595         ret = rebind_subsystems(root, ss_mask);
1596         if (ret)
1597                 goto destroy_root;
1598
1599         /*
1600          * There must be no failure case after here, since rebinding takes
1601          * care of subsystems' refcounts, which are explicitly dropped in
1602          * the failure exit path.
1603          */
1604         list_add(&root->root_list, &cgroup_roots);
1605         cgroup_root_count++;
1606
1607         /*
1608          * Link the root cgroup in this hierarchy into all the css_set
1609          * objects.
1610          */
1611         down_write(&css_set_rwsem);
1612         hash_for_each(css_set_table, i, cset, hlist)
1613                 link_css_set(&tmp_links, cset, root_cgrp);
1614         up_write(&css_set_rwsem);
1615
1616         BUG_ON(!list_empty(&root_cgrp->children));
1617         BUG_ON(atomic_read(&root->nr_cgrps) != 1);
1618
1619         kernfs_activate(root_cgrp->kn);
1620         ret = 0;
1621         goto out;
1622
1623 destroy_root:
1624         kernfs_destroy_root(root->kf_root);
1625         root->kf_root = NULL;
1626 exit_root_id:
1627         cgroup_exit_root_id(root);
1628 out:
1629         free_cgrp_cset_links(&tmp_links);
1630         return ret;
1631 }
1632
1633 static struct dentry *cgroup_mount(struct file_system_type *fs_type,
1634                          int flags, const char *unused_dev_name,
1635                          void *data)
1636 {
1637         struct cgroup_root *root;
1638         struct cgroup_sb_opts opts;
1639         struct dentry *dentry;
1640         int ret;
1641         bool new_sb;
1642
1643         /*
1644          * The first time anyone tries to mount a cgroup, enable the list
1645          * linking each css_set to its tasks and fix up all existing tasks.
1646          */
1647         if (!use_task_css_set_links)
1648                 cgroup_enable_task_cg_lists();
1649
1650         mutex_lock(&cgroup_tree_mutex);
1651         mutex_lock(&cgroup_mutex);
1652
1653         /* First find the desired set of subsystems */
1654         ret = parse_cgroupfs_options(data, &opts);
1655         if (ret)
1656                 goto out_unlock;
1657 retry:
1658         /* look for a matching existing root */
1659         if (!opts.subsys_mask && !opts.none && !opts.name) {
1660                 cgrp_dfl_root_visible = true;
1661                 root = &cgrp_dfl_root;
1662                 cgroup_get(&root->cgrp);
1663                 ret = 0;
1664                 goto out_unlock;
1665         }
1666
1667         for_each_root(root) {
1668                 bool name_match = false;
1669
1670                 if (root == &cgrp_dfl_root)
1671                         continue;
1672
1673                 /*
1674                  * If we asked for a name then it must match.  Also, if
1675                  * name matches but sybsys_mask doesn't, we should fail.
1676                  * Remember whether name matched.
1677                  */
1678                 if (opts.name) {
1679                         if (strcmp(opts.name, root->name))
1680                                 continue;
1681                         name_match = true;
1682                 }
1683
1684                 /*
1685                  * If we asked for subsystems (or explicitly for no
1686                  * subsystems) then they must match.
1687                  */
1688                 if ((opts.subsys_mask || opts.none) &&
1689                     (opts.subsys_mask != root->subsys_mask)) {
1690                         if (!name_match)
1691                                 continue;
1692                         ret = -EBUSY;
1693                         goto out_unlock;
1694                 }
1695
1696                 if ((root->flags ^ opts.flags) & CGRP_ROOT_OPTION_MASK) {
1697                         if ((root->flags | opts.flags) & CGRP_ROOT_SANE_BEHAVIOR) {
1698                                 pr_err("sane_behavior: new mount options should match the existing superblock\n");
1699                                 ret = -EINVAL;
1700                                 goto out_unlock;
1701                         } else {
1702                                 pr_warn("new mount options do not match the existing superblock, will be ignored\n");
1703                         }
1704                 }
1705
1706                 /*
1707                  * A root's lifetime is governed by its root cgroup.  Zero
1708                  * ref indicate that the root is being destroyed.  Wait for
1709                  * destruction to complete so that the subsystems are free.
1710                  * We can use wait_queue for the wait but this path is
1711                  * super cold.  Let's just sleep for a bit and retry.
1712                  */
1713                 if (!atomic_inc_not_zero(&root->cgrp.refcnt)) {
1714                         mutex_unlock(&cgroup_mutex);
1715                         mutex_unlock(&cgroup_tree_mutex);
1716                         msleep(10);
1717                         mutex_lock(&cgroup_tree_mutex);
1718                         mutex_lock(&cgroup_mutex);
1719                         goto retry;
1720                 }
1721
1722                 ret = 0;
1723                 goto out_unlock;
1724         }
1725
1726         /*
1727          * No such thing, create a new one.  name= matching without subsys
1728          * specification is allowed for already existing hierarchies but we
1729          * can't create new one without subsys specification.
1730          */
1731         if (!opts.subsys_mask && !opts.none) {
1732                 ret = -EINVAL;
1733                 goto out_unlock;
1734         }
1735
1736         root = kzalloc(sizeof(*root), GFP_KERNEL);
1737         if (!root) {
1738                 ret = -ENOMEM;
1739                 goto out_unlock;
1740         }
1741
1742         init_cgroup_root(root, &opts);
1743
1744         ret = cgroup_setup_root(root, opts.subsys_mask);
1745         if (ret)
1746                 cgroup_free_root(root);
1747
1748 out_unlock:
1749         mutex_unlock(&cgroup_mutex);
1750         mutex_unlock(&cgroup_tree_mutex);
1751
1752         kfree(opts.release_agent);
1753         kfree(opts.name);
1754
1755         if (ret)
1756                 return ERR_PTR(ret);
1757
1758         dentry = kernfs_mount(fs_type, flags, root->kf_root, &new_sb);
1759         if (IS_ERR(dentry) || !new_sb)
1760                 cgroup_put(&root->cgrp);
1761         return dentry;
1762 }
1763
1764 static void cgroup_kill_sb(struct super_block *sb)
1765 {
1766         struct kernfs_root *kf_root = kernfs_root_from_sb(sb);
1767         struct cgroup_root *root = cgroup_root_from_kf(kf_root);
1768
1769         cgroup_put(&root->cgrp);
1770         kernfs_kill_sb(sb);
1771 }
1772
1773 static struct file_system_type cgroup_fs_type = {
1774         .name = "cgroup",
1775         .mount = cgroup_mount,
1776         .kill_sb = cgroup_kill_sb,
1777 };
1778
1779 static struct kobject *cgroup_kobj;
1780
1781 /**
1782  * task_cgroup_path - cgroup path of a task in the first cgroup hierarchy
1783  * @task: target task
1784  * @buf: the buffer to write the path into
1785  * @buflen: the length of the buffer
1786  *
1787  * Determine @task's cgroup on the first (the one with the lowest non-zero
1788  * hierarchy_id) cgroup hierarchy and copy its path into @buf.  This
1789  * function grabs cgroup_mutex and shouldn't be used inside locks used by
1790  * cgroup controller callbacks.
1791  *
1792  * Return value is the same as kernfs_path().
1793  */
1794 char *task_cgroup_path(struct task_struct *task, char *buf, size_t buflen)
1795 {
1796         struct cgroup_root *root;
1797         struct cgroup *cgrp;
1798         int hierarchy_id = 1;
1799         char *path = NULL;
1800
1801         mutex_lock(&cgroup_mutex);
1802         down_read(&css_set_rwsem);
1803
1804         root = idr_get_next(&cgroup_hierarchy_idr, &hierarchy_id);
1805
1806         if (root) {
1807                 cgrp = task_cgroup_from_root(task, root);
1808                 path = cgroup_path(cgrp, buf, buflen);
1809         } else {
1810                 /* if no hierarchy exists, everyone is in "/" */
1811                 if (strlcpy(buf, "/", buflen) < buflen)
1812                         path = buf;
1813         }
1814
1815         up_read(&css_set_rwsem);
1816         mutex_unlock(&cgroup_mutex);
1817         return path;
1818 }
1819 EXPORT_SYMBOL_GPL(task_cgroup_path);
1820
1821 /* used to track tasks and other necessary states during migration */
1822 struct cgroup_taskset {
1823         /* the src and dst cset list running through cset->mg_node */
1824         struct list_head        src_csets;
1825         struct list_head        dst_csets;
1826
1827         /*
1828          * Fields for cgroup_taskset_*() iteration.
1829          *
1830          * Before migration is committed, the target migration tasks are on
1831          * ->mg_tasks of the csets on ->src_csets.  After, on ->mg_tasks of
1832          * the csets on ->dst_csets.  ->csets point to either ->src_csets
1833          * or ->dst_csets depending on whether migration is committed.
1834          *
1835          * ->cur_csets and ->cur_task point to the current task position
1836          * during iteration.
1837          */
1838         struct list_head        *csets;
1839         struct css_set          *cur_cset;
1840         struct task_struct      *cur_task;
1841 };
1842
1843 /**
1844  * cgroup_taskset_first - reset taskset and return the first task
1845  * @tset: taskset of interest
1846  *
1847  * @tset iteration is initialized and the first task is returned.
1848  */
1849 struct task_struct *cgroup_taskset_first(struct cgroup_taskset *tset)
1850 {
1851         tset->cur_cset = list_first_entry(tset->csets, struct css_set, mg_node);
1852         tset->cur_task = NULL;
1853
1854         return cgroup_taskset_next(tset);
1855 }
1856
1857 /**
1858  * cgroup_taskset_next - iterate to the next task in taskset
1859  * @tset: taskset of interest
1860  *
1861  * Return the next task in @tset.  Iteration must have been initialized
1862  * with cgroup_taskset_first().
1863  */
1864 struct task_struct *cgroup_taskset_next(struct cgroup_taskset *tset)
1865 {
1866         struct css_set *cset = tset->cur_cset;
1867         struct task_struct *task = tset->cur_task;
1868
1869         while (&cset->mg_node != tset->csets) {
1870                 if (!task)
1871                         task = list_first_entry(&cset->mg_tasks,
1872                                                 struct task_struct, cg_list);
1873                 else
1874                         task = list_next_entry(task, cg_list);
1875
1876                 if (&task->cg_list != &cset->mg_tasks) {
1877                         tset->cur_cset = cset;
1878                         tset->cur_task = task;
1879                         return task;
1880                 }
1881
1882                 cset = list_next_entry(cset, mg_node);
1883                 task = NULL;
1884         }
1885
1886         return NULL;
1887 }
1888
1889 /**
1890  * cgroup_task_migrate - move a task from one cgroup to another.
1891  * @old_cgrp: the cgroup @tsk is being migrated from
1892  * @tsk: the task being migrated
1893  * @new_cset: the new css_set @tsk is being attached to
1894  *
1895  * Must be called with cgroup_mutex, threadgroup and css_set_rwsem locked.
1896  */
1897 static void cgroup_task_migrate(struct cgroup *old_cgrp,
1898                                 struct task_struct *tsk,
1899                                 struct css_set *new_cset)
1900 {
1901         struct css_set *old_cset;
1902
1903         lockdep_assert_held(&cgroup_mutex);
1904         lockdep_assert_held(&css_set_rwsem);
1905
1906         /*
1907          * We are synchronized through threadgroup_lock() against PF_EXITING
1908          * setting such that we can't race against cgroup_exit() changing the
1909          * css_set to init_css_set and dropping the old one.
1910          */
1911         WARN_ON_ONCE(tsk->flags & PF_EXITING);
1912         old_cset = task_css_set(tsk);
1913
1914         get_css_set(new_cset);
1915         rcu_assign_pointer(tsk->cgroups, new_cset);
1916
1917         /*
1918          * Use move_tail so that cgroup_taskset_first() still returns the
1919          * leader after migration.  This works because cgroup_migrate()
1920          * ensures that the dst_cset of the leader is the first on the
1921          * tset's dst_csets list.
1922          */
1923         list_move_tail(&tsk->cg_list, &new_cset->mg_tasks);
1924
1925         /*
1926          * We just gained a reference on old_cset by taking it from the
1927          * task. As trading it for new_cset is protected by cgroup_mutex,
1928          * we're safe to drop it here; it will be freed under RCU.
1929          */
1930         set_bit(CGRP_RELEASABLE, &old_cgrp->flags);
1931         put_css_set_locked(old_cset, false);
1932 }
1933
1934 /**
1935  * cgroup_migrate_finish - cleanup after attach
1936  * @preloaded_csets: list of preloaded css_sets
1937  *
1938  * Undo cgroup_migrate_add_src() and cgroup_migrate_prepare_dst().  See
1939  * those functions for details.
1940  */
1941 static void cgroup_migrate_finish(struct list_head *preloaded_csets)
1942 {
1943         struct css_set *cset, *tmp_cset;
1944
1945         lockdep_assert_held(&cgroup_mutex);
1946
1947         down_write(&css_set_rwsem);
1948         list_for_each_entry_safe(cset, tmp_cset, preloaded_csets, mg_preload_node) {
1949                 cset->mg_src_cgrp = NULL;
1950                 cset->mg_dst_cset = NULL;
1951                 list_del_init(&cset->mg_preload_node);
1952                 put_css_set_locked(cset, false);
1953         }
1954         up_write(&css_set_rwsem);
1955 }
1956
1957 /**
1958  * cgroup_migrate_add_src - add a migration source css_set
1959  * @src_cset: the source css_set to add
1960  * @dst_cgrp: the destination cgroup
1961  * @preloaded_csets: list of preloaded css_sets
1962  *
1963  * Tasks belonging to @src_cset are about to be migrated to @dst_cgrp.  Pin
1964  * @src_cset and add it to @preloaded_csets, which should later be cleaned
1965  * up by cgroup_migrate_finish().
1966  *
1967  * This function may be called without holding threadgroup_lock even if the
1968  * target is a process.  Threads may be created and destroyed but as long
1969  * as cgroup_mutex is not dropped, no new css_set can be put into play and
1970  * the preloaded css_sets are guaranteed to cover all migrations.
1971  */
1972 static void cgroup_migrate_add_src(struct css_set *src_cset,
1973                                    struct cgroup *dst_cgrp,
1974                                    struct list_head *preloaded_csets)
1975 {
1976         struct cgroup *src_cgrp;
1977
1978         lockdep_assert_held(&cgroup_mutex);
1979         lockdep_assert_held(&css_set_rwsem);
1980
1981         src_cgrp = cset_cgroup_from_root(src_cset, dst_cgrp->root);
1982
1983         if (!list_empty(&src_cset->mg_preload_node))
1984                 return;
1985
1986         WARN_ON(src_cset->mg_src_cgrp);
1987         WARN_ON(!list_empty(&src_cset->mg_tasks));
1988         WARN_ON(!list_empty(&src_cset->mg_node));
1989
1990         src_cset->mg_src_cgrp = src_cgrp;
1991         get_css_set(src_cset);
1992         list_add(&src_cset->mg_preload_node, preloaded_csets);
1993 }
1994
1995 /**
1996  * cgroup_migrate_prepare_dst - prepare destination css_sets for migration
1997  * @dst_cgrp: the destination cgroup (may be %NULL)
1998  * @preloaded_csets: list of preloaded source css_sets
1999  *
2000  * Tasks are about to be moved to @dst_cgrp and all the source css_sets
2001  * have been preloaded to @preloaded_csets.  This function looks up and
2002  * pins all destination css_sets, links each to its source, and append them
2003  * to @preloaded_csets.  If @dst_cgrp is %NULL, the destination of each
2004  * source css_set is assumed to be its cgroup on the default hierarchy.
2005  *
2006  * This function must be called after cgroup_migrate_add_src() has been
2007  * called on each migration source css_set.  After migration is performed
2008  * using cgroup_migrate(), cgroup_migrate_finish() must be called on
2009  * @preloaded_csets.
2010  */
2011 static int cgroup_migrate_prepare_dst(struct cgroup *dst_cgrp,
2012                                       struct list_head *preloaded_csets)
2013 {
2014         LIST_HEAD(csets);
2015         struct css_set *src_cset, *tmp_cset;
2016
2017         lockdep_assert_held(&cgroup_mutex);
2018
2019         /*
2020          * Except for the root, child_subsys_mask must be zero for a cgroup
2021          * with tasks so that child cgroups don't compete against tasks.
2022          */
2023         if (dst_cgrp && cgroup_on_dfl(dst_cgrp) && dst_cgrp->parent &&
2024             dst_cgrp->child_subsys_mask)
2025                 return -EBUSY;
2026
2027         /* look up the dst cset for each src cset and link it to src */
2028         list_for_each_entry_safe(src_cset, tmp_cset, preloaded_csets, mg_preload_node) {
2029                 struct css_set *dst_cset;
2030
2031                 dst_cset = find_css_set(src_cset,
2032                                         dst_cgrp ?: src_cset->dfl_cgrp);
2033                 if (!dst_cset)
2034                         goto err;
2035
2036                 WARN_ON_ONCE(src_cset->mg_dst_cset || dst_cset->mg_dst_cset);
2037
2038                 /*
2039                  * If src cset equals dst, it's noop.  Drop the src.
2040                  * cgroup_migrate() will skip the cset too.  Note that we
2041                  * can't handle src == dst as some nodes are used by both.
2042                  */
2043                 if (src_cset == dst_cset) {
2044                         src_cset->mg_src_cgrp = NULL;
2045                         list_del_init(&src_cset->mg_preload_node);
2046                         put_css_set(src_cset, false);
2047                         put_css_set(dst_cset, false);
2048                         continue;
2049                 }
2050
2051                 src_cset->mg_dst_cset = dst_cset;
2052
2053                 if (list_empty(&dst_cset->mg_preload_node))
2054                         list_add(&dst_cset->mg_preload_node, &csets);
2055                 else
2056                         put_css_set(dst_cset, false);
2057         }
2058
2059         list_splice_tail(&csets, preloaded_csets);
2060         return 0;
2061 err:
2062         cgroup_migrate_finish(&csets);
2063         return -ENOMEM;
2064 }
2065
2066 /**
2067  * cgroup_migrate - migrate a process or task to a cgroup
2068  * @cgrp: the destination cgroup
2069  * @leader: the leader of the process or the task to migrate
2070  * @threadgroup: whether @leader points to the whole process or a single task
2071  *
2072  * Migrate a process or task denoted by @leader to @cgrp.  If migrating a
2073  * process, the caller must be holding threadgroup_lock of @leader.  The
2074  * caller is also responsible for invoking cgroup_migrate_add_src() and
2075  * cgroup_migrate_prepare_dst() on the targets before invoking this
2076  * function and following up with cgroup_migrate_finish().
2077  *
2078  * As long as a controller's ->can_attach() doesn't fail, this function is
2079  * guaranteed to succeed.  This means that, excluding ->can_attach()
2080  * failure, when migrating multiple targets, the success or failure can be
2081  * decided for all targets by invoking group_migrate_prepare_dst() before
2082  * actually starting migrating.
2083  */
2084 static int cgroup_migrate(struct cgroup *cgrp, struct task_struct *leader,
2085                           bool threadgroup)
2086 {
2087         struct cgroup_taskset tset = {
2088                 .src_csets      = LIST_HEAD_INIT(tset.src_csets),
2089                 .dst_csets      = LIST_HEAD_INIT(tset.dst_csets),
2090                 .csets          = &tset.src_csets,
2091         };
2092         struct cgroup_subsys_state *css, *failed_css = NULL;
2093         struct css_set *cset, *tmp_cset;
2094         struct task_struct *task, *tmp_task;
2095         int i, ret;
2096
2097         /*
2098          * Prevent freeing of tasks while we take a snapshot. Tasks that are
2099          * already PF_EXITING could be freed from underneath us unless we
2100          * take an rcu_read_lock.
2101          */
2102         down_write(&css_set_rwsem);
2103         rcu_read_lock();
2104         task = leader;
2105         do {
2106                 /* @task either already exited or can't exit until the end */
2107                 if (task->flags & PF_EXITING)
2108                         goto next;
2109
2110                 /* leave @task alone if post_fork() hasn't linked it yet */
2111                 if (list_empty(&task->cg_list))
2112                         goto next;
2113
2114                 cset = task_css_set(task);
2115                 if (!cset->mg_src_cgrp)
2116                         goto next;
2117
2118                 /*
2119                  * cgroup_taskset_first() must always return the leader.
2120                  * Take care to avoid disturbing the ordering.
2121                  */
2122                 list_move_tail(&task->cg_list, &cset->mg_tasks);
2123                 if (list_empty(&cset->mg_node))
2124                         list_add_tail(&cset->mg_node, &tset.src_csets);
2125                 if (list_empty(&cset->mg_dst_cset->mg_node))
2126                         list_move_tail(&cset->mg_dst_cset->mg_node,
2127                                        &tset.dst_csets);
2128         next:
2129                 if (!threadgroup)
2130                         break;
2131         } while_each_thread(leader, task);
2132         rcu_read_unlock();
2133         up_write(&css_set_rwsem);
2134
2135         /* methods shouldn't be called if no task is actually migrating */
2136         if (list_empty(&tset.src_csets))
2137                 return 0;
2138
2139         /* check that we can legitimately attach to the cgroup */
2140         for_each_e_css(css, i, cgrp) {
2141                 if (css->ss->can_attach) {
2142                         ret = css->ss->can_attach(css, &tset);
2143                         if (ret) {
2144                                 failed_css = css;
2145                                 goto out_cancel_attach;
2146                         }
2147                 }
2148         }
2149
2150         /*
2151          * Now that we're guaranteed success, proceed to move all tasks to
2152          * the new cgroup.  There are no failure cases after here, so this
2153          * is the commit point.
2154          */
2155         down_write(&css_set_rwsem);
2156         list_for_each_entry(cset, &tset.src_csets, mg_node) {
2157                 list_for_each_entry_safe(task, tmp_task, &cset->mg_tasks, cg_list)
2158                         cgroup_task_migrate(cset->mg_src_cgrp, task,
2159                                             cset->mg_dst_cset);
2160         }
2161         up_write(&css_set_rwsem);
2162
2163         /*
2164          * Migration is committed, all target tasks are now on dst_csets.
2165          * Nothing is sensitive to fork() after this point.  Notify
2166          * controllers that migration is complete.
2167          */
2168         tset.csets = &tset.dst_csets;
2169
2170         for_each_e_css(css, i, cgrp)
2171                 if (css->ss->attach)
2172                         css->ss->attach(css, &tset);
2173
2174         ret = 0;
2175         goto out_release_tset;
2176
2177 out_cancel_attach:
2178         for_each_e_css(css, i, cgrp) {
2179                 if (css == failed_css)
2180                         break;
2181                 if (css->ss->cancel_attach)
2182                         css->ss->cancel_attach(css, &tset);
2183         }
2184 out_release_tset:
2185         down_write(&css_set_rwsem);
2186         list_splice_init(&tset.dst_csets, &tset.src_csets);
2187         list_for_each_entry_safe(cset, tmp_cset, &tset.src_csets, mg_node) {
2188                 list_splice_tail_init(&cset->mg_tasks, &cset->tasks);
2189                 list_del_init(&cset->mg_node);
2190         }
2191         up_write(&css_set_rwsem);
2192         return ret;
2193 }
2194
2195 /**
2196  * cgroup_attach_task - attach a task or a whole threadgroup to a cgroup
2197  * @dst_cgrp: the cgroup to attach to
2198  * @leader: the task or the leader of the threadgroup to be attached
2199  * @threadgroup: attach the whole threadgroup?
2200  *
2201  * Call holding cgroup_mutex and threadgroup_lock of @leader.
2202  */
2203 static int cgroup_attach_task(struct cgroup *dst_cgrp,
2204                               struct task_struct *leader, bool threadgroup)
2205 {
2206         LIST_HEAD(preloaded_csets);
2207         struct task_struct *task;
2208         int ret;
2209
2210         /* look up all src csets */
2211         down_read(&css_set_rwsem);
2212         rcu_read_lock();
2213         task = leader;
2214         do {
2215                 cgroup_migrate_add_src(task_css_set(task), dst_cgrp,
2216                                        &preloaded_csets);
2217                 if (!threadgroup)
2218                         break;
2219         } while_each_thread(leader, task);
2220         rcu_read_unlock();
2221         up_read(&css_set_rwsem);
2222
2223         /* prepare dst csets and commit */
2224         ret = cgroup_migrate_prepare_dst(dst_cgrp, &preloaded_csets);
2225         if (!ret)
2226                 ret = cgroup_migrate(dst_cgrp, leader, threadgroup);
2227
2228         cgroup_migrate_finish(&preloaded_csets);
2229         return ret;
2230 }
2231
2232 /*
2233  * Find the task_struct of the task to attach by vpid and pass it along to the
2234  * function to attach either it or all tasks in its threadgroup. Will lock
2235  * cgroup_mutex and threadgroup.
2236  */
2237 static int attach_task_by_pid(struct cgroup *cgrp, u64 pid, bool threadgroup)
2238 {
2239         struct task_struct *tsk;
2240         const struct cred *cred = current_cred(), *tcred;
2241         int ret;
2242
2243         if (!cgroup_lock_live_group(cgrp))
2244                 return -ENODEV;
2245
2246 retry_find_task:
2247         rcu_read_lock();
2248         if (pid) {
2249                 tsk = find_task_by_vpid(pid);
2250                 if (!tsk) {
2251                         rcu_read_unlock();
2252                         ret = -ESRCH;
2253                         goto out_unlock_cgroup;
2254                 }
2255                 /*
2256                  * even if we're attaching all tasks in the thread group, we
2257                  * only need to check permissions on one of them.
2258                  */
2259                 tcred = __task_cred(tsk);
2260                 if (!uid_eq(cred->euid, GLOBAL_ROOT_UID) &&
2261                     !uid_eq(cred->euid, tcred->uid) &&
2262                     !uid_eq(cred->euid, tcred->suid)) {
2263                         rcu_read_unlock();
2264                         ret = -EACCES;
2265                         goto out_unlock_cgroup;
2266                 }
2267         } else
2268                 tsk = current;
2269
2270         if (threadgroup)
2271                 tsk = tsk->group_leader;
2272
2273         /*
2274          * Workqueue threads may acquire PF_NO_SETAFFINITY and become
2275          * trapped in a cpuset, or RT worker may be born in a cgroup
2276          * with no rt_runtime allocated.  Just say no.
2277          */
2278         if (tsk == kthreadd_task || (tsk->flags & PF_NO_SETAFFINITY)) {
2279                 ret = -EINVAL;
2280                 rcu_read_unlock();
2281                 goto out_unlock_cgroup;
2282         }
2283
2284         get_task_struct(tsk);
2285         rcu_read_unlock();
2286
2287         threadgroup_lock(tsk);
2288         if (threadgroup) {
2289                 if (!thread_group_leader(tsk)) {
2290                         /*
2291                          * a race with de_thread from another thread's exec()
2292                          * may strip us of our leadership, if this happens,
2293                          * there is no choice but to throw this task away and
2294                          * try again; this is
2295                          * "double-double-toil-and-trouble-check locking".
2296                          */
2297                         threadgroup_unlock(tsk);
2298                         put_task_struct(tsk);
2299                         goto retry_find_task;
2300                 }
2301         }
2302
2303         ret = cgroup_attach_task(cgrp, tsk, threadgroup);
2304
2305         threadgroup_unlock(tsk);
2306
2307         put_task_struct(tsk);
2308 out_unlock_cgroup:
2309         mutex_unlock(&cgroup_mutex);
2310         return ret;
2311 }
2312
2313 /**
2314  * cgroup_attach_task_all - attach task 'tsk' to all cgroups of task 'from'
2315  * @from: attach to all cgroups of a given task
2316  * @tsk: the task to be attached
2317  */
2318 int cgroup_attach_task_all(struct task_struct *from, struct task_struct *tsk)
2319 {
2320         struct cgroup_root *root;
2321         int retval = 0;
2322
2323         mutex_lock(&cgroup_mutex);
2324         for_each_root(root) {
2325                 struct cgroup *from_cgrp;
2326
2327                 if (root == &cgrp_dfl_root)
2328                         continue;
2329
2330                 down_read(&css_set_rwsem);
2331                 from_cgrp = task_cgroup_from_root(from, root);
2332                 up_read(&css_set_rwsem);
2333
2334                 retval = cgroup_attach_task(from_cgrp, tsk, false);
2335                 if (retval)
2336                         break;
2337         }
2338         mutex_unlock(&cgroup_mutex);
2339
2340         return retval;
2341 }
2342 EXPORT_SYMBOL_GPL(cgroup_attach_task_all);
2343
2344 static int cgroup_tasks_write(struct cgroup_subsys_state *css,
2345                               struct cftype *cft, u64 pid)
2346 {
2347         return attach_task_by_pid(css->cgroup, pid, false);
2348 }
2349
2350 static int cgroup_procs_write(struct cgroup_subsys_state *css,
2351                               struct cftype *cft, u64 tgid)
2352 {
2353         return attach_task_by_pid(css->cgroup, tgid, true);
2354 }
2355
2356 static int cgroup_release_agent_write(struct cgroup_subsys_state *css,
2357                                       struct cftype *cft, char *buffer)
2358 {
2359         struct cgroup_root *root = css->cgroup->root;
2360
2361         BUILD_BUG_ON(sizeof(root->release_agent_path) < PATH_MAX);
2362         if (!cgroup_lock_live_group(css->cgroup))
2363                 return -ENODEV;
2364         spin_lock(&release_agent_path_lock);
2365         strlcpy(root->release_agent_path, buffer,
2366                 sizeof(root->release_agent_path));
2367         spin_unlock(&release_agent_path_lock);
2368         mutex_unlock(&cgroup_mutex);
2369         return 0;
2370 }
2371
2372 static int cgroup_release_agent_show(struct seq_file *seq, void *v)
2373 {
2374         struct cgroup *cgrp = seq_css(seq)->cgroup;
2375
2376         if (!cgroup_lock_live_group(cgrp))
2377                 return -ENODEV;
2378         seq_puts(seq, cgrp->root->release_agent_path);
2379         seq_putc(seq, '\n');
2380         mutex_unlock(&cgroup_mutex);
2381         return 0;
2382 }
2383
2384 static int cgroup_sane_behavior_show(struct seq_file *seq, void *v)
2385 {
2386         struct cgroup *cgrp = seq_css(seq)->cgroup;
2387
2388         seq_printf(seq, "%d\n", cgroup_sane_behavior(cgrp));
2389         return 0;
2390 }
2391
2392 static void cgroup_print_ss_mask(struct seq_file *seq, unsigned int ss_mask)
2393 {
2394         struct cgroup_subsys *ss;
2395         bool printed = false;
2396         int ssid;
2397
2398         for_each_subsys(ss, ssid) {
2399                 if (ss_mask & (1 << ssid)) {
2400                         if (printed)
2401                                 seq_putc(seq, ' ');
2402                         seq_printf(seq, "%s", ss->name);
2403                         printed = true;
2404                 }
2405         }
2406         if (printed)
2407                 seq_putc(seq, '\n');
2408 }
2409
2410 /* show controllers which are currently attached to the default hierarchy */
2411 static int cgroup_root_controllers_show(struct seq_file *seq, void *v)
2412 {
2413         struct cgroup *cgrp = seq_css(seq)->cgroup;
2414
2415         cgroup_print_ss_mask(seq, cgrp->root->subsys_mask);
2416         return 0;
2417 }
2418
2419 /* show controllers which are enabled from the parent */
2420 static int cgroup_controllers_show(struct seq_file *seq, void *v)
2421 {
2422         struct cgroup *cgrp = seq_css(seq)->cgroup;
2423
2424         cgroup_print_ss_mask(seq, cgrp->parent->child_subsys_mask);
2425         return 0;
2426 }
2427
2428 /* show controllers which are enabled for a given cgroup's children */
2429 static int cgroup_subtree_control_show(struct seq_file *seq, void *v)
2430 {
2431         struct cgroup *cgrp = seq_css(seq)->cgroup;
2432
2433         cgroup_print_ss_mask(seq, cgrp->child_subsys_mask);
2434         return 0;
2435 }
2436
2437 /**
2438  * cgroup_update_dfl_csses - update css assoc of a subtree in default hierarchy
2439  * @cgrp: root of the subtree to update csses for
2440  *
2441  * @cgrp's child_subsys_mask has changed and its subtree's (self excluded)
2442  * css associations need to be updated accordingly.  This function looks up
2443  * all css_sets which are attached to the subtree, creates the matching
2444  * updated css_sets and migrates the tasks to the new ones.
2445  */
2446 static int cgroup_update_dfl_csses(struct cgroup *cgrp)
2447 {
2448         LIST_HEAD(preloaded_csets);
2449         struct cgroup_subsys_state *css;
2450         struct css_set *src_cset;
2451         int ret;
2452
2453         lockdep_assert_held(&cgroup_tree_mutex);
2454         lockdep_assert_held(&cgroup_mutex);
2455
2456         /* look up all csses currently attached to @cgrp's subtree */
2457         down_read(&css_set_rwsem);
2458         css_for_each_descendant_pre(css, cgroup_css(cgrp, NULL)) {
2459                 struct cgrp_cset_link *link;
2460
2461                 /* self is not affected by child_subsys_mask change */
2462                 if (css->cgroup == cgrp)
2463                         continue;
2464
2465                 list_for_each_entry(link, &css->cgroup->cset_links, cset_link)
2466                         cgroup_migrate_add_src(link->cset, cgrp,
2467                                                &preloaded_csets);
2468         }
2469         up_read(&css_set_rwsem);
2470
2471         /* NULL dst indicates self on default hierarchy */
2472         ret = cgroup_migrate_prepare_dst(NULL, &preloaded_csets);
2473         if (ret)
2474                 goto out_finish;
2475
2476         list_for_each_entry(src_cset, &preloaded_csets, mg_preload_node) {
2477                 struct task_struct *last_task = NULL, *task;
2478
2479                 /* src_csets precede dst_csets, break on the first dst_cset */
2480                 if (!src_cset->mg_src_cgrp)
2481                         break;
2482
2483                 /*
2484                  * All tasks in src_cset need to be migrated to the
2485                  * matching dst_cset.  Empty it process by process.  We
2486                  * walk tasks but migrate processes.  The leader might even
2487                  * belong to a different cset but such src_cset would also
2488                  * be among the target src_csets because the default
2489                  * hierarchy enforces per-process membership.
2490                  */
2491                 while (true) {
2492                         down_read(&css_set_rwsem);
2493                         task = list_first_entry_or_null(&src_cset->tasks,
2494                                                 struct task_struct, cg_list);
2495                         if (task) {
2496                                 task = task->group_leader;
2497                                 WARN_ON_ONCE(!task_css_set(task)->mg_src_cgrp);
2498                                 get_task_struct(task);
2499                         }
2500                         up_read(&css_set_rwsem);
2501
2502                         if (!task)
2503                                 break;
2504
2505                         /* guard against possible infinite loop */
2506                         if (WARN(last_task == task,
2507                                  "cgroup: update_dfl_csses failed to make progress, aborting in inconsistent state\n"))
2508                                 goto out_finish;
2509                         last_task = task;
2510
2511                         threadgroup_lock(task);
2512                         /* raced against de_thread() from another thread? */
2513                         if (!thread_group_leader(task)) {
2514                                 threadgroup_unlock(task);
2515                                 put_task_struct(task);
2516                                 continue;
2517                         }
2518
2519                         ret = cgroup_migrate(src_cset->dfl_cgrp, task, true);
2520
2521                         threadgroup_unlock(task);
2522                         put_task_struct(task);
2523
2524                         if (WARN(ret, "cgroup: failed to update controllers for the default hierarchy (%d), further operations may crash or hang\n", ret))
2525                                 goto out_finish;
2526                 }
2527         }
2528
2529 out_finish:
2530         cgroup_migrate_finish(&preloaded_csets);
2531         return ret;
2532 }
2533
2534 /* change the enabled child controllers for a cgroup in the default hierarchy */
2535 static int cgroup_subtree_control_write(struct cgroup_subsys_state *dummy_css,
2536                                         struct cftype *cft, char *buffer)
2537 {
2538         unsigned int enable_req = 0, disable_req = 0, enable, disable;
2539         struct cgroup *cgrp = dummy_css->cgroup, *child;
2540         struct cgroup_subsys *ss;
2541         char *tok, *p;
2542         int ssid, ret;
2543
2544         /*
2545          * Parse input - white space separated list of subsystem names
2546          * prefixed with either + or -.
2547          */
2548         p = buffer;
2549         while ((tok = strsep(&p, " \t\n"))) {
2550                 for_each_subsys(ss, ssid) {
2551                         if (ss->disabled || strcmp(tok + 1, ss->name))
2552                                 continue;
2553
2554                         if (*tok == '+') {
2555                                 enable_req |= 1 << ssid;
2556                                 disable_req &= ~(1 << ssid);
2557                         } else if (*tok == '-') {
2558                                 disable_req |= 1 << ssid;
2559                                 enable_req &= ~(1 << ssid);
2560                         } else {
2561                                 return -EINVAL;
2562                         }
2563                         break;
2564                 }
2565                 if (ssid == CGROUP_SUBSYS_COUNT)
2566                         return -EINVAL;
2567         }
2568
2569         /*
2570          * We're gonna grab cgroup_tree_mutex which nests outside kernfs
2571          * active_ref.  cgroup_lock_live_group() already provides enough
2572          * protection.  Ensure @cgrp stays accessible and break the
2573          * active_ref protection.
2574          */
2575         cgroup_get(cgrp);
2576         kernfs_break_active_protection(cgrp->control_kn);
2577 retry:
2578         enable = enable_req;
2579         disable = disable_req;
2580
2581         mutex_lock(&cgroup_tree_mutex);
2582
2583         for_each_subsys(ss, ssid) {
2584                 if (enable & (1 << ssid)) {
2585                         if (cgrp->child_subsys_mask & (1 << ssid)) {
2586                                 enable &= ~(1 << ssid);
2587                                 continue;
2588                         }
2589
2590                         /*
2591                          * Because css offlining is asynchronous, userland
2592                          * might try to re-enable the same controller while
2593                          * the previous instance is still around.  In such
2594                          * cases, wait till it's gone using offline_waitq.
2595                          */
2596                         cgroup_for_each_live_child(child, cgrp) {
2597                                 DEFINE_WAIT(wait);
2598
2599                                 if (!cgroup_css(child, ss))
2600                                         continue;
2601
2602                                 cgroup_get(child);
2603                                 prepare_to_wait(&child->offline_waitq, &wait,
2604                                                 TASK_UNINTERRUPTIBLE);
2605                                 mutex_unlock(&cgroup_tree_mutex);
2606                                 schedule();
2607                                 finish_wait(&child->offline_waitq, &wait);
2608                                 cgroup_put(child);
2609                                 goto retry;
2610                         }
2611
2612                         /* unavailable or not enabled on the parent? */
2613                         if (!(cgrp_dfl_root.subsys_mask & (1 << ssid)) ||
2614                             (cgrp->parent &&
2615                              !(cgrp->parent->child_subsys_mask & (1 << ssid)))) {
2616                                 ret = -ENOENT;
2617                                 goto out_unlock_tree;
2618                         }
2619                 } else if (disable & (1 << ssid)) {
2620                         if (!(cgrp->child_subsys_mask & (1 << ssid))) {
2621                                 disable &= ~(1 << ssid);
2622                                 continue;
2623                         }
2624
2625                         /* a child has it enabled? */
2626                         cgroup_for_each_live_child(child, cgrp) {
2627                                 if (child->child_subsys_mask & (1 << ssid)) {
2628                                         ret = -EBUSY;
2629                                         goto out_unlock_tree;
2630                                 }
2631                         }
2632                 }
2633         }
2634
2635         if (!enable && !disable) {
2636                 ret = 0;
2637                 goto out_unlock_tree;
2638         }
2639
2640         if (!cgroup_lock_live_group(cgrp)) {
2641                 ret = -ENODEV;
2642                 goto out_unlock_tree;
2643         }
2644
2645         /*
2646          * Except for the root, child_subsys_mask must be zero for a cgroup
2647          * with tasks so that child cgroups don't compete against tasks.
2648          */
2649         if (enable && cgrp->parent && !list_empty(&cgrp->cset_links)) {
2650                 ret = -EBUSY;
2651                 goto out_unlock;
2652         }
2653
2654         /*
2655          * Create csses for enables and update child_subsys_mask.  This
2656          * changes cgroup_e_css() results which in turn makes the
2657          * subsequent cgroup_update_dfl_csses() associate all tasks in the
2658          * subtree to the updated csses.
2659          */
2660         for_each_subsys(ss, ssid) {
2661                 if (!(enable & (1 << ssid)))
2662                         continue;
2663
2664                 cgroup_for_each_live_child(child, cgrp) {
2665                         ret = create_css(child, ss);
2666                         if (ret)
2667                                 goto err_undo_css;
2668                 }
2669         }
2670
2671         cgrp->child_subsys_mask |= enable;
2672         cgrp->child_subsys_mask &= ~disable;
2673
2674         ret = cgroup_update_dfl_csses(cgrp);
2675         if (ret)
2676                 goto err_undo_css;
2677
2678         /* all tasks are now migrated away from the old csses, kill them */
2679         for_each_subsys(ss, ssid) {
2680                 if (!(disable & (1 << ssid)))
2681                         continue;
2682
2683                 cgroup_for_each_live_child(child, cgrp)
2684                         kill_css(cgroup_css(child, ss));
2685         }
2686
2687         kernfs_activate(cgrp->kn);
2688         ret = 0;
2689 out_unlock:
2690         mutex_unlock(&cgroup_mutex);
2691 out_unlock_tree:
2692         mutex_unlock(&cgroup_tree_mutex);
2693         kernfs_unbreak_active_protection(cgrp->control_kn);
2694         cgroup_put(cgrp);
2695         return ret;
2696
2697 err_undo_css:
2698         cgrp->child_subsys_mask &= ~enable;
2699         cgrp->child_subsys_mask |= disable;
2700
2701         for_each_subsys(ss, ssid) {
2702                 if (!(enable & (1 << ssid)))
2703                         continue;
2704
2705                 cgroup_for_each_live_child(child, cgrp) {
2706                         struct cgroup_subsys_state *css = cgroup_css(child, ss);
2707                         if (css)
2708                                 kill_css(css);
2709                 }
2710         }
2711         goto out_unlock;
2712 }
2713
2714 static int cgroup_populated_show(struct seq_file *seq, void *v)
2715 {
2716         seq_printf(seq, "%d\n", (bool)seq_css(seq)->cgroup->populated_cnt);
2717         return 0;
2718 }
2719
2720 static ssize_t cgroup_file_write(struct kernfs_open_file *of, char *buf,
2721                                  size_t nbytes, loff_t off)
2722 {
2723         struct cgroup *cgrp = of->kn->parent->priv;
2724         struct cftype *cft = of->kn->priv;
2725         struct cgroup_subsys_state *css;
2726         int ret;
2727
2728         /*
2729          * kernfs guarantees that a file isn't deleted with operations in
2730          * flight, which means that the matching css is and stays alive and
2731          * doesn't need to be pinned.  The RCU locking is not necessary
2732          * either.  It's just for the convenience of using cgroup_css().
2733          */
2734         rcu_read_lock();
2735         css = cgroup_css(cgrp, cft->ss);
2736         rcu_read_unlock();
2737
2738         if (cft->write_string) {
2739                 ret = cft->write_string(css, cft, strstrip(buf));
2740         } else if (cft->write_u64) {
2741                 unsigned long long v;
2742                 ret = kstrtoull(buf, 0, &v);
2743                 if (!ret)
2744                         ret = cft->write_u64(css, cft, v);
2745         } else if (cft->write_s64) {
2746                 long long v;
2747                 ret = kstrtoll(buf, 0, &v);
2748                 if (!ret)
2749                         ret = cft->write_s64(css, cft, v);
2750         } else if (cft->trigger) {
2751                 ret = cft->trigger(css, (unsigned int)cft->private);
2752         } else {
2753                 ret = -EINVAL;
2754         }
2755
2756         return ret ?: nbytes;
2757 }
2758
2759 static void *cgroup_seqfile_start(struct seq_file *seq, loff_t *ppos)
2760 {
2761         return seq_cft(seq)->seq_start(seq, ppos);
2762 }
2763
2764 static void *cgroup_seqfile_next(struct seq_file *seq, void *v, loff_t *ppos)
2765 {
2766         return seq_cft(seq)->seq_next(seq, v, ppos);
2767 }
2768
2769 static void cgroup_seqfile_stop(struct seq_file *seq, void *v)
2770 {
2771         seq_cft(seq)->seq_stop(seq, v);
2772 }
2773
2774 static int cgroup_seqfile_show(struct seq_file *m, void *arg)
2775 {
2776         struct cftype *cft = seq_cft(m);
2777         struct cgroup_subsys_state *css = seq_css(m);
2778
2779         if (cft->seq_show)
2780                 return cft->seq_show(m, arg);
2781
2782         if (cft->read_u64)
2783                 seq_printf(m, "%llu\n", cft->read_u64(css, cft));
2784         else if (cft->read_s64)
2785                 seq_printf(m, "%lld\n", cft->read_s64(css, cft));
2786         else
2787                 return -EINVAL;
2788         return 0;
2789 }
2790
2791 static struct kernfs_ops cgroup_kf_single_ops = {
2792         .atomic_write_len       = PAGE_SIZE,
2793         .write                  = cgroup_file_write,
2794         .seq_show               = cgroup_seqfile_show,
2795 };
2796
2797 static struct kernfs_ops cgroup_kf_ops = {
2798         .atomic_write_len       = PAGE_SIZE,
2799         .write                  = cgroup_file_write,
2800         .seq_start              = cgroup_seqfile_start,
2801         .seq_next               = cgroup_seqfile_next,
2802         .seq_stop               = cgroup_seqfile_stop,
2803         .seq_show               = cgroup_seqfile_show,
2804 };
2805
2806 /*
2807  * cgroup_rename - Only allow simple rename of directories in place.
2808  */
2809 static int cgroup_rename(struct kernfs_node *kn, struct kernfs_node *new_parent,
2810                          const char *new_name_str)
2811 {
2812         struct cgroup *cgrp = kn->priv;
2813         int ret;
2814
2815         if (kernfs_type(kn) != KERNFS_DIR)
2816                 return -ENOTDIR;
2817         if (kn->parent != new_parent)
2818                 return -EIO;
2819
2820         /*
2821          * This isn't a proper migration and its usefulness is very
2822          * limited.  Disallow if sane_behavior.
2823          */
2824         if (cgroup_sane_behavior(cgrp))
2825                 return -EPERM;
2826
2827         /*
2828          * We're gonna grab cgroup_tree_mutex which nests outside kernfs
2829          * active_ref.  kernfs_rename() doesn't require active_ref
2830          * protection.  Break them before grabbing cgroup_tree_mutex.
2831          */
2832         kernfs_break_active_protection(new_parent);
2833         kernfs_break_active_protection(kn);
2834
2835         mutex_lock(&cgroup_tree_mutex);
2836         mutex_lock(&cgroup_mutex);
2837
2838         ret = kernfs_rename(kn, new_parent, new_name_str);
2839
2840         mutex_unlock(&cgroup_mutex);
2841         mutex_unlock(&cgroup_tree_mutex);
2842
2843         kernfs_unbreak_active_protection(kn);
2844         kernfs_unbreak_active_protection(new_parent);
2845         return ret;
2846 }
2847
2848 /* set uid and gid of cgroup dirs and files to that of the creator */
2849 static int cgroup_kn_set_ugid(struct kernfs_node *kn)
2850 {
2851         struct iattr iattr = { .ia_valid = ATTR_UID | ATTR_GID,
2852                                .ia_uid = current_fsuid(),
2853                                .ia_gid = current_fsgid(), };
2854
2855         if (uid_eq(iattr.ia_uid, GLOBAL_ROOT_UID) &&
2856             gid_eq(iattr.ia_gid, GLOBAL_ROOT_GID))
2857                 return 0;
2858
2859         return kernfs_setattr(kn, &iattr);
2860 }
2861
2862 static int cgroup_add_file(struct cgroup *cgrp, struct cftype *cft)
2863 {
2864         char name[CGROUP_FILE_NAME_MAX];
2865         struct kernfs_node *kn;
2866         struct lock_class_key *key = NULL;
2867         int ret;
2868
2869 #ifdef CONFIG_DEBUG_LOCK_ALLOC
2870         key = &cft->lockdep_key;
2871 #endif
2872         kn = __kernfs_create_file(cgrp->kn, cgroup_file_name(cgrp, cft, name),
2873                                   cgroup_file_mode(cft), 0, cft->kf_ops, cft,
2874                                   NULL, false, key);
2875         if (IS_ERR(kn))
2876                 return PTR_ERR(kn);
2877
2878         ret = cgroup_kn_set_ugid(kn);
2879         if (ret) {
2880                 kernfs_remove(kn);
2881                 return ret;
2882         }
2883
2884         if (cft->seq_show == cgroup_subtree_control_show)
2885                 cgrp->control_kn = kn;
2886         else if (cft->seq_show == cgroup_populated_show)
2887                 cgrp->populated_kn = kn;
2888         return 0;
2889 }
2890
2891 /**
2892  * cgroup_addrm_files - add or remove files to a cgroup directory
2893  * @cgrp: the target cgroup
2894  * @cfts: array of cftypes to be added
2895  * @is_add: whether to add or remove
2896  *
2897  * Depending on @is_add, add or remove files defined by @cfts on @cgrp.
2898  * For removals, this function never fails.  If addition fails, this
2899  * function doesn't remove files already added.  The caller is responsible
2900  * for cleaning up.
2901  */
2902 static int cgroup_addrm_files(struct cgroup *cgrp, struct cftype cfts[],
2903                               bool is_add)
2904 {
2905         struct cftype *cft;
2906         int ret;
2907
2908         lockdep_assert_held(&cgroup_tree_mutex);
2909
2910         for (cft = cfts; cft->name[0] != '\0'; cft++) {
2911                 /* does cft->flags tell us to skip this file on @cgrp? */
2912                 if ((cft->flags & CFTYPE_ONLY_ON_DFL) && !cgroup_on_dfl(cgrp))
2913                         continue;
2914                 if ((cft->flags & CFTYPE_INSANE) && cgroup_sane_behavior(cgrp))
2915                         continue;
2916                 if ((cft->flags & CFTYPE_NOT_ON_ROOT) && !cgrp->parent)
2917                         continue;
2918                 if ((cft->flags & CFTYPE_ONLY_ON_ROOT) && cgrp->parent)
2919                         continue;
2920
2921                 if (is_add) {
2922                         ret = cgroup_add_file(cgrp, cft);
2923                         if (ret) {
2924                                 pr_warn("%s: failed to add %s, err=%d\n",
2925                                         __func__, cft->name, ret);
2926                                 return ret;
2927                         }
2928                 } else {
2929                         cgroup_rm_file(cgrp, cft);
2930                 }
2931         }
2932         return 0;
2933 }
2934
2935 static int cgroup_apply_cftypes(struct cftype *cfts, bool is_add)
2936 {
2937         LIST_HEAD(pending);
2938         struct cgroup_subsys *ss = cfts[0].ss;
2939         struct cgroup *root = &ss->root->cgrp;
2940         struct cgroup_subsys_state *css;
2941         int ret = 0;
2942
2943         lockdep_assert_held(&cgroup_tree_mutex);
2944
2945         /* add/rm files for all cgroups created before */
2946         css_for_each_descendant_pre(css, cgroup_css(root, ss)) {
2947                 struct cgroup *cgrp = css->cgroup;
2948
2949                 if (cgroup_is_dead(cgrp))
2950                         continue;
2951
2952                 ret = cgroup_addrm_files(cgrp, cfts, is_add);
2953                 if (ret)
2954                         break;
2955         }
2956
2957         if (is_add && !ret)
2958                 kernfs_activate(root->kn);
2959         return ret;
2960 }
2961
2962 static void cgroup_exit_cftypes(struct cftype *cfts)
2963 {
2964         struct cftype *cft;
2965
2966         for (cft = cfts; cft->name[0] != '\0'; cft++) {
2967                 /* free copy for custom atomic_write_len, see init_cftypes() */
2968                 if (cft->max_write_len && cft->max_write_len != PAGE_SIZE)
2969                         kfree(cft->kf_ops);
2970                 cft->kf_ops = NULL;
2971                 cft->ss = NULL;
2972         }
2973 }
2974
2975 static int cgroup_init_cftypes(struct cgroup_subsys *ss, struct cftype *cfts)
2976 {
2977         struct cftype *cft;
2978
2979         for (cft = cfts; cft->name[0] != '\0'; cft++) {
2980                 struct kernfs_ops *kf_ops;
2981
2982                 WARN_ON(cft->ss || cft->kf_ops);
2983
2984                 if (cft->seq_start)
2985                         kf_ops = &cgroup_kf_ops;
2986                 else
2987                         kf_ops = &cgroup_kf_single_ops;
2988
2989                 /*
2990                  * Ugh... if @cft wants a custom max_write_len, we need to
2991                  * make a copy of kf_ops to set its atomic_write_len.
2992                  */
2993                 if (cft->max_write_len && cft->max_write_len != PAGE_SIZE) {
2994                         kf_ops = kmemdup(kf_ops, sizeof(*kf_ops), GFP_KERNEL);
2995                         if (!kf_ops) {
2996                                 cgroup_exit_cftypes(cfts);
2997                                 return -ENOMEM;
2998                         }
2999                         kf_ops->atomic_write_len = cft->max_write_len;
3000                 }
3001
3002                 cft->kf_ops = kf_ops;
3003                 cft->ss = ss;
3004         }
3005
3006         return 0;
3007 }
3008
3009 static int cgroup_rm_cftypes_locked(struct cftype *cfts)
3010 {
3011         lockdep_assert_held(&cgroup_tree_mutex);
3012
3013         if (!cfts || !cfts[0].ss)
3014                 return -ENOENT;
3015
3016         list_del(&cfts->node);
3017         cgroup_apply_cftypes(cfts, false);
3018         cgroup_exit_cftypes(cfts);
3019         return 0;
3020 }
3021
3022 /**
3023  * cgroup_rm_cftypes - remove an array of cftypes from a subsystem
3024  * @cfts: zero-length name terminated array of cftypes
3025  *
3026  * Unregister @cfts.  Files described by @cfts are removed from all
3027  * existing cgroups and all future cgroups won't have them either.  This
3028  * function can be called anytime whether @cfts' subsys is attached or not.
3029  *
3030  * Returns 0 on successful unregistration, -ENOENT if @cfts is not
3031  * registered.
3032  */
3033 int cgroup_rm_cftypes(struct cftype *cfts)
3034 {
3035         int ret;
3036
3037         mutex_lock(&cgroup_tree_mutex);
3038         ret = cgroup_rm_cftypes_locked(cfts);
3039         mutex_unlock(&cgroup_tree_mutex);
3040         return ret;
3041 }
3042
3043 /**
3044  * cgroup_add_cftypes - add an array of cftypes to a subsystem
3045  * @ss: target cgroup subsystem
3046  * @cfts: zero-length name terminated array of cftypes
3047  *
3048  * Register @cfts to @ss.  Files described by @cfts are created for all
3049  * existing cgroups to which @ss is attached and all future cgroups will
3050  * have them too.  This function can be called anytime whether @ss is
3051  * attached or not.
3052  *
3053  * Returns 0 on successful registration, -errno on failure.  Note that this
3054  * function currently returns 0 as long as @cfts registration is successful
3055  * even if some file creation attempts on existing cgroups fail.
3056  */
3057 int cgroup_add_cftypes(struct cgroup_subsys *ss, struct cftype *cfts)
3058 {
3059         int ret;
3060
3061         if (!cfts || cfts[0].name[0] == '\0')
3062                 return 0;
3063
3064         ret = cgroup_init_cftypes(ss, cfts);
3065         if (ret)
3066                 return ret;
3067
3068         mutex_lock(&cgroup_tree_mutex);
3069
3070         list_add_tail(&cfts->node, &ss->cfts);
3071         ret = cgroup_apply_cftypes(cfts, true);
3072         if (ret)
3073                 cgroup_rm_cftypes_locked(cfts);
3074
3075         mutex_unlock(&cgroup_tree_mutex);
3076         return ret;
3077 }
3078
3079 /**
3080  * cgroup_task_count - count the number of tasks in a cgroup.
3081  * @cgrp: the cgroup in question
3082  *
3083  * Return the number of tasks in the cgroup.
3084  */
3085 static int cgroup_task_count(const struct cgroup *cgrp)
3086 {
3087         int count = 0;
3088         struct cgrp_cset_link *link;
3089
3090         down_read(&css_set_rwsem);
3091         list_for_each_entry(link, &cgrp->cset_links, cset_link)
3092                 count += atomic_read(&link->cset->refcount);
3093         up_read(&css_set_rwsem);
3094         return count;
3095 }
3096
3097 /**
3098  * css_next_child - find the next child of a given css
3099  * @pos_css: the current position (%NULL to initiate traversal)
3100  * @parent_css: css whose children to walk
3101  *
3102  * This function returns the next child of @parent_css and should be called
3103  * under either cgroup_mutex or RCU read lock.  The only requirement is
3104  * that @parent_css and @pos_css are accessible.  The next sibling is
3105  * guaranteed to be returned regardless of their states.
3106  */
3107 struct cgroup_subsys_state *
3108 css_next_child(struct cgroup_subsys_state *pos_css,
3109                struct cgroup_subsys_state *parent_css)
3110 {
3111         struct cgroup *pos = pos_css ? pos_css->cgroup : NULL;
3112         struct cgroup *cgrp = parent_css->cgroup;
3113         struct cgroup *next;
3114
3115         cgroup_assert_mutexes_or_rcu_locked();
3116
3117         /*
3118          * @pos could already have been removed.  Once a cgroup is removed,
3119          * its ->sibling.next is no longer updated when its next sibling
3120          * changes.  As CGRP_DEAD assertion is serialized and happens
3121          * before the cgroup is taken off the ->sibling list, if we see it
3122          * unasserted, it's guaranteed that the next sibling hasn't
3123          * finished its grace period even if it's already removed, and thus
3124          * safe to dereference from this RCU critical section.  If
3125          * ->sibling.next is inaccessible, cgroup_is_dead() is guaranteed
3126          * to be visible as %true here.
3127          *
3128          * If @pos is dead, its next pointer can't be dereferenced;
3129          * however, as each cgroup is given a monotonically increasing
3130          * unique serial number and always appended to the sibling list,
3131          * the next one can be found by walking the parent's children until
3132          * we see a cgroup with higher serial number than @pos's.  While
3133          * this path can be slower, it's taken only when either the current
3134          * cgroup is removed or iteration and removal race.
3135          */
3136         if (!pos) {
3137                 next = list_entry_rcu(cgrp->children.next, struct cgroup, sibling);
3138         } else if (likely(!cgroup_is_dead(pos))) {
3139                 next = list_entry_rcu(pos->sibling.next, struct cgroup, sibling);
3140         } else {
3141                 list_for_each_entry_rcu(next, &cgrp->children, sibling)
3142                         if (next->serial_nr > pos->serial_nr)
3143                                 break;
3144         }
3145
3146         /*
3147          * @next, if not pointing to the head, can be dereferenced and is
3148          * the next sibling; however, it might have @ss disabled.  If so,
3149          * fast-forward to the next enabled one.
3150          */
3151         while (&next->sibling != &cgrp->children) {
3152                 struct cgroup_subsys_state *next_css = cgroup_css(next, parent_css->ss);
3153
3154                 if (next_css)
3155                         return next_css;
3156                 next = list_entry_rcu(next->sibling.next, struct cgroup, sibling);
3157         }
3158         return NULL;
3159 }
3160
3161 /**
3162  * css_next_descendant_pre - find the next descendant for pre-order walk
3163  * @pos: the current position (%NULL to initiate traversal)
3164  * @root: css whose descendants to walk
3165  *
3166  * To be used by css_for_each_descendant_pre().  Find the next descendant
3167  * to visit for pre-order traversal of @root's descendants.  @root is
3168  * included in the iteration and the first node to be visited.
3169  *
3170  * While this function requires cgroup_mutex or RCU read locking, it
3171  * doesn't require the whole traversal to be contained in a single critical
3172  * section.  This function will return the correct next descendant as long
3173  * as both @pos and @root are accessible and @pos is a descendant of @root.
3174  */
3175 struct cgroup_subsys_state *
3176 css_next_descendant_pre(struct cgroup_subsys_state *pos,
3177                         struct cgroup_subsys_state *root)
3178 {
3179         struct cgroup_subsys_state *next;
3180
3181         cgroup_assert_mutexes_or_rcu_locked();
3182
3183         /* if first iteration, visit @root */
3184         if (!pos)
3185                 return root;
3186
3187         /* visit the first child if exists */
3188         next = css_next_child(NULL, pos);
3189         if (next)
3190                 return next;
3191
3192         /* no child, visit my or the closest ancestor's next sibling */
3193         while (pos != root) {
3194                 next = css_next_child(pos, css_parent(pos));
3195                 if (next)
3196                         return next;
3197                 pos = css_parent(pos);
3198         }
3199
3200         return NULL;
3201 }
3202
3203 /**
3204  * css_rightmost_descendant - return the rightmost descendant of a css
3205  * @pos: css of interest
3206  *
3207  * Return the rightmost descendant of @pos.  If there's no descendant, @pos
3208  * is returned.  This can be used during pre-order traversal to skip
3209  * subtree of @pos.
3210  *
3211  * While this function requires cgroup_mutex or RCU read locking, it
3212  * doesn't require the whole traversal to be contained in a single critical
3213  * section.  This function will return the correct rightmost descendant as
3214  * long as @pos is accessible.
3215  */
3216 struct cgroup_subsys_state *
3217 css_rightmost_descendant(struct cgroup_subsys_state *pos)
3218 {
3219         struct cgroup_subsys_state *last, *tmp;
3220
3221         cgroup_assert_mutexes_or_rcu_locked();
3222
3223         do {
3224                 last = pos;
3225                 /* ->prev isn't RCU safe, walk ->next till the end */
3226                 pos = NULL;
3227                 css_for_each_child(tmp, last)
3228                         pos = tmp;
3229         } while (pos);
3230
3231         return last;
3232 }
3233
3234 static struct cgroup_subsys_state *
3235 css_leftmost_descendant(struct cgroup_subsys_state *pos)
3236 {
3237         struct cgroup_subsys_state *last;
3238
3239         do {
3240                 last = pos;
3241                 pos = css_next_child(NULL, pos);
3242         } while (pos);
3243
3244         return last;
3245 }
3246
3247 /**
3248  * css_next_descendant_post - find the next descendant for post-order walk
3249  * @pos: the current position (%NULL to initiate traversal)
3250  * @root: css whose descendants to walk
3251  *
3252  * To be used by css_for_each_descendant_post().  Find the next descendant
3253  * to visit for post-order traversal of @root's descendants.  @root is
3254  * included in the iteration and the last node to be visited.
3255  *
3256  * While this function requires cgroup_mutex or RCU read locking, it
3257  * doesn't require the whole traversal to be contained in a single critical
3258  * section.  This function will return the correct next descendant as long
3259  * as both @pos and @cgroup are accessible and @pos is a descendant of
3260  * @cgroup.
3261  */
3262 struct cgroup_subsys_state *
3263 css_next_descendant_post(struct cgroup_subsys_state *pos,
3264                          struct cgroup_subsys_state *root)
3265 {
3266         struct cgroup_subsys_state *next;
3267
3268         cgroup_assert_mutexes_or_rcu_locked();
3269
3270         /* if first iteration, visit leftmost descendant which may be @root */
3271         if (!pos)
3272                 return css_leftmost_descendant(root);
3273
3274         /* if we visited @root, we're done */
3275         if (pos == root)
3276                 return NULL;
3277
3278         /* if there's an unvisited sibling, visit its leftmost descendant */
3279         next = css_next_child(pos, css_parent(pos));
3280         if (next)
3281                 return css_leftmost_descendant(next);
3282
3283         /* no sibling left, visit parent */
3284         return css_parent(pos);
3285 }
3286
3287 /**
3288  * css_advance_task_iter - advance a task itererator to the next css_set
3289  * @it: the iterator to advance
3290  *
3291  * Advance @it to the next css_set to walk.
3292  */
3293 static void css_advance_task_iter(struct css_task_iter *it)
3294 {
3295         struct list_head *l = it->cset_pos;
3296         struct cgrp_cset_link *link;
3297         struct css_set *cset;
3298
3299         /* Advance to the next non-empty css_set */
3300         do {
3301                 l = l->next;
3302                 if (l == it->cset_head) {
3303                         it->cset_pos = NULL;
3304                         return;
3305                 }
3306
3307                 if (it->ss) {
3308                         cset = container_of(l, struct css_set,
3309                                             e_cset_node[it->ss->id]);
3310                 } else {
3311                         link = list_entry(l, struct cgrp_cset_link, cset_link);
3312                         cset = link->cset;
3313                 }
3314         } while (list_empty(&cset->tasks) && list_empty(&cset->mg_tasks));
3315
3316         it->cset_pos = l;
3317
3318         if (!list_empty(&cset->tasks))
3319                 it->task_pos = cset->tasks.next;
3320         else
3321                 it->task_pos = cset->mg_tasks.next;
3322
3323         it->tasks_head = &cset->tasks;
3324         it->mg_tasks_head = &cset->mg_tasks;
3325 }
3326
3327 /**
3328  * css_task_iter_start - initiate task iteration
3329  * @css: the css to walk tasks of
3330  * @it: the task iterator to use
3331  *
3332  * Initiate iteration through the tasks of @css.  The caller can call
3333  * css_task_iter_next() to walk through the tasks until the function
3334  * returns NULL.  On completion of iteration, css_task_iter_end() must be
3335  * called.
3336  *
3337  * Note that this function acquires a lock which is released when the
3338  * iteration finishes.  The caller can't sleep while iteration is in
3339  * progress.
3340  */
3341 void css_task_iter_start(struct cgroup_subsys_state *css,
3342                          struct css_task_iter *it)
3343         __acquires(css_set_rwsem)
3344 {
3345         /* no one should try to iterate before mounting cgroups */
3346         WARN_ON_ONCE(!use_task_css_set_links);
3347
3348         down_read(&css_set_rwsem);
3349
3350         it->ss = css->ss;
3351
3352         if (it->ss)
3353                 it->cset_pos = &css->cgroup->e_csets[css->ss->id];
3354         else
3355                 it->cset_pos = &css->cgroup->cset_links;
3356
3357         it->cset_head = it->cset_pos;
3358
3359         css_advance_task_iter(it);
3360 }
3361
3362 /**
3363  * css_task_iter_next - return the next task for the iterator
3364  * @it: the task iterator being iterated
3365  *
3366  * The "next" function for task iteration.  @it should have been
3367  * initialized via css_task_iter_start().  Returns NULL when the iteration
3368  * reaches the end.
3369  */
3370 struct task_struct *css_task_iter_next(struct css_task_iter *it)
3371 {
3372         struct task_struct *res;
3373         struct list_head *l = it->task_pos;
3374
3375         /* If the iterator cg is NULL, we have no tasks */
3376         if (!it->cset_pos)
3377                 return NULL;
3378         res = list_entry(l, struct task_struct, cg_list);
3379
3380         /*
3381          * Advance iterator to find next entry.  cset->tasks is consumed
3382          * first and then ->mg_tasks.  After ->mg_tasks, we move onto the
3383          * next cset.
3384          */
3385         l = l->next;
3386
3387         if (l == it->tasks_head)
3388                 l = it->mg_tasks_head->next;
3389
3390         if (l == it->mg_tasks_head)
3391                 css_advance_task_iter(it);
3392         else
3393                 it->task_pos = l;
3394
3395         return res;
3396 }
3397
3398 /**
3399  * css_task_iter_end - finish task iteration
3400  * @it: the task iterator to finish
3401  *
3402  * Finish task iteration started by css_task_iter_start().
3403  */
3404 void css_task_iter_end(struct css_task_iter *it)
3405         __releases(css_set_rwsem)
3406 {
3407         up_read(&css_set_rwsem);
3408 }
3409
3410 /**
3411  * cgroup_trasnsfer_tasks - move tasks from one cgroup to another
3412  * @to: cgroup to which the tasks will be moved
3413  * @from: cgroup in which the tasks currently reside
3414  *
3415  * Locking rules between cgroup_post_fork() and the migration path
3416  * guarantee that, if a task is forking while being migrated, the new child
3417  * is guaranteed to be either visible in the source cgroup after the
3418  * parent's migration is complete or put into the target cgroup.  No task
3419  * can slip out of migration through forking.
3420  */
3421 int cgroup_transfer_tasks(struct cgroup *to, struct cgroup *from)
3422 {
3423         LIST_HEAD(preloaded_csets);
3424         struct cgrp_cset_link *link;
3425         struct css_task_iter it;
3426         struct task_struct *task;
3427         int ret;
3428
3429         mutex_lock(&cgroup_mutex);
3430
3431         /* all tasks in @from are being moved, all csets are source */
3432         down_read(&css_set_rwsem);
3433         list_for_each_entry(link, &from->cset_links, cset_link)
3434                 cgroup_migrate_add_src(link->cset, to, &preloaded_csets);
3435         up_read(&css_set_rwsem);
3436
3437         ret = cgroup_migrate_prepare_dst(to, &preloaded_csets);
3438         if (ret)
3439                 goto out_err;
3440
3441         /*
3442          * Migrate tasks one-by-one until @form is empty.  This fails iff
3443          * ->can_attach() fails.
3444          */
3445         do {
3446                 css_task_iter_start(&from->dummy_css, &it);
3447                 task = css_task_iter_next(&it);
3448                 if (task)
3449                         get_task_struct(task);
3450                 css_task_iter_end(&it);
3451
3452                 if (task) {
3453                         ret = cgroup_migrate(to, task, false);
3454                         put_task_struct(task);
3455                 }
3456         } while (task && !ret);
3457 out_err:
3458         cgroup_migrate_finish(&preloaded_csets);
3459         mutex_unlock(&cgroup_mutex);
3460         return ret;
3461 }
3462
3463 /*
3464  * Stuff for reading the 'tasks'/'procs' files.
3465  *
3466  * Reading this file can return large amounts of data if a cgroup has
3467  * *lots* of attached tasks. So it may need several calls to read(),
3468  * but we cannot guarantee that the information we produce is correct
3469  * unless we produce it entirely atomically.
3470  *
3471  */
3472
3473 /* which pidlist file are we talking about? */
3474 enum cgroup_filetype {
3475         CGROUP_FILE_PROCS,
3476         CGROUP_FILE_TASKS,
3477 };
3478
3479 /*
3480  * A pidlist is a list of pids that virtually represents the contents of one
3481  * of the cgroup files ("procs" or "tasks"). We keep a list of such pidlists,
3482  * a pair (one each for procs, tasks) for each pid namespace that's relevant
3483  * to the cgroup.
3484  */
3485 struct cgroup_pidlist {
3486         /*
3487          * used to find which pidlist is wanted. doesn't change as long as
3488          * this particular list stays in the list.
3489         */
3490         struct { enum cgroup_filetype type; struct pid_namespace *ns; } key;
3491         /* array of xids */
3492         pid_t *list;
3493         /* how many elements the above list has */
3494         int length;
3495         /* each of these stored in a list by its cgroup */
3496         struct list_head links;
3497         /* pointer to the cgroup we belong to, for list removal purposes */
3498         struct cgroup *owner;
3499         /* for delayed destruction */
3500         struct delayed_work destroy_dwork;
3501 };
3502
3503 /*
3504  * The following two functions "fix" the issue where there are more pids
3505  * than kmalloc will give memory for; in such cases, we use vmalloc/vfree.
3506  * TODO: replace with a kernel-wide solution to this problem
3507  */
3508 #define PIDLIST_TOO_LARGE(c) ((c) * sizeof(pid_t) > (PAGE_SIZE * 2))
3509 static void *pidlist_allocate(int count)
3510 {
3511         if (PIDLIST_TOO_LARGE(count))
3512                 return vmalloc(count * sizeof(pid_t));
3513         else
3514                 return kmalloc(count * sizeof(pid_t), GFP_KERNEL);
3515 }
3516
3517 static void pidlist_free(void *p)
3518 {
3519         if (is_vmalloc_addr(p))
3520                 vfree(p);
3521         else
3522                 kfree(p);
3523 }
3524
3525 /*
3526  * Used to destroy all pidlists lingering waiting for destroy timer.  None
3527  * should be left afterwards.
3528  */
3529 static void cgroup_pidlist_destroy_all(struct cgroup *cgrp)
3530 {
3531         struct cgroup_pidlist *l, *tmp_l;
3532
3533         mutex_lock(&cgrp->pidlist_mutex);
3534         list_for_each_entry_safe(l, tmp_l, &cgrp->pidlists, links)
3535                 mod_delayed_work(cgroup_pidlist_destroy_wq, &l->destroy_dwork, 0);
3536         mutex_unlock(&cgrp->pidlist_mutex);
3537
3538         flush_workqueue(cgroup_pidlist_destroy_wq);
3539         BUG_ON(!list_empty(&cgrp->pidlists));
3540 }
3541
3542 static void cgroup_pidlist_destroy_work_fn(struct work_struct *work)
3543 {
3544         struct delayed_work *dwork = to_delayed_work(work);
3545         struct cgroup_pidlist *l = container_of(dwork, struct cgroup_pidlist,
3546                                                 destroy_dwork);
3547         struct cgroup_pidlist *tofree = NULL;
3548
3549         mutex_lock(&l->owner->pidlist_mutex);
3550
3551         /*
3552          * Destroy iff we didn't get queued again.  The state won't change
3553          * as destroy_dwork can only be queued while locked.
3554          */
3555         if (!delayed_work_pending(dwork)) {
3556                 list_del(&l->links);
3557                 pidlist_free(l->list);
3558                 put_pid_ns(l->key.ns);
3559                 tofree = l;
3560         }
3561
3562         mutex_unlock(&l->owner->pidlist_mutex);
3563         kfree(tofree);
3564 }
3565
3566 /*
3567  * pidlist_uniq - given a kmalloc()ed list, strip out all duplicate entries
3568  * Returns the number of unique elements.
3569  */
3570 static int pidlist_uniq(pid_t *list, int length)
3571 {
3572         int src, dest = 1;
3573
3574         /*
3575          * we presume the 0th element is unique, so i starts at 1. trivial
3576          * edge cases first; no work needs to be done for either
3577          */
3578         if (length == 0 || length == 1)
3579                 return length;
3580         /* src and dest walk down the list; dest counts unique elements */
3581         for (src = 1; src < length; src++) {
3582                 /* find next unique element */
3583                 while (list[src] == list[src-1]) {
3584                         src++;
3585                         if (src == length)
3586                                 goto after;
3587                 }
3588                 /* dest always points to where the next unique element goes */
3589                 list[dest] = list[src];
3590                 dest++;
3591         }
3592 after:
3593         return dest;
3594 }
3595
3596 /*
3597  * The two pid files - task and cgroup.procs - guaranteed that the result
3598  * is sorted, which forced this whole pidlist fiasco.  As pid order is
3599  * different per namespace, each namespace needs differently sorted list,
3600  * making it impossible to use, for example, single rbtree of member tasks
3601  * sorted by task pointer.  As pidlists can be fairly large, allocating one
3602  * per open file is dangerous, so cgroup had to implement shared pool of
3603  * pidlists keyed by cgroup and namespace.
3604  *
3605  * All this extra complexity was caused by the original implementation
3606  * committing to an entirely unnecessary property.  In the long term, we
3607  * want to do away with it.  Explicitly scramble sort order if
3608  * sane_behavior so that no such expectation exists in the new interface.
3609  *
3610  * Scrambling is done by swapping every two consecutive bits, which is
3611  * non-identity one-to-one mapping which disturbs sort order sufficiently.
3612  */
3613 static pid_t pid_fry(pid_t pid)
3614 {
3615         unsigned a = pid & 0x55555555;
3616         unsigned b = pid & 0xAAAAAAAA;
3617
3618         return (a << 1) | (b >> 1);
3619 }
3620
3621 static pid_t cgroup_pid_fry(struct cgroup *cgrp, pid_t pid)
3622 {
3623         if (cgroup_sane_behavior(cgrp))
3624                 return pid_fry(pid);
3625         else
3626                 return pid;
3627 }
3628
3629 static int cmppid(const void *a, const void *b)
3630 {
3631         return *(pid_t *)a - *(pid_t *)b;
3632 }
3633
3634 static int fried_cmppid(const void *a, const void *b)
3635 {
3636         return pid_fry(*(pid_t *)a) - pid_fry(*(pid_t *)b);
3637 }
3638
3639 static struct cgroup_pidlist *cgroup_pidlist_find(struct cgroup *cgrp,
3640                                                   enum cgroup_filetype type)
3641 {
3642         struct cgroup_pidlist *l;
3643         /* don't need task_nsproxy() if we're looking at ourself */
3644         struct pid_namespace *ns = task_active_pid_ns(current);
3645
3646         lockdep_assert_held(&cgrp->pidlist_mutex);
3647
3648         list_for_each_entry(l, &cgrp->pidlists, links)
3649                 if (l->key.type == type && l->key.ns == ns)
3650                         return l;
3651         return NULL;
3652 }
3653
3654 /*
3655  * find the appropriate pidlist for our purpose (given procs vs tasks)
3656  * returns with the lock on that pidlist already held, and takes care
3657  * of the use count, or returns NULL with no locks held if we're out of
3658  * memory.
3659  */
3660 static struct cgroup_pidlist *cgroup_pidlist_find_create(struct cgroup *cgrp,
3661                                                 enum cgroup_filetype type)
3662 {
3663         struct cgroup_pidlist *l;
3664
3665         lockdep_assert_held(&cgrp->pidlist_mutex);
3666
3667         l = cgroup_pidlist_find(cgrp, type);
3668         if (l)
3669                 return l;
3670
3671         /* entry not found; create a new one */
3672         l = kzalloc(sizeof(struct cgroup_pidlist), GFP_KERNEL);
3673         if (!l)
3674                 return l;
3675
3676         INIT_DELAYED_WORK(&l->destroy_dwork, cgroup_pidlist_destroy_work_fn);
3677         l->key.type = type;
3678         /* don't need task_nsproxy() if we're looking at ourself */
3679         l->key.ns = get_pid_ns(task_active_pid_ns(current));
3680         l->owner = cgrp;
3681         list_add(&l->links, &cgrp->pidlists);
3682         return l;
3683 }
3684
3685 /*
3686  * Load a cgroup's pidarray with either procs' tgids or tasks' pids
3687  */
3688 static int pidlist_array_load(struct cgroup *cgrp, enum cgroup_filetype type,
3689                               struct cgroup_pidlist **lp)
3690 {
3691         pid_t *array;
3692         int length;
3693         int pid, n = 0; /* used for populating the array */
3694         struct css_task_iter it;
3695         struct task_struct *tsk;
3696         struct cgroup_pidlist *l;
3697
3698         lockdep_assert_held(&cgrp->pidlist_mutex);
3699
3700         /*
3701          * If cgroup gets more users after we read count, we won't have
3702          * enough space - tough.  This race is indistinguishable to the
3703          * caller from the case that the additional cgroup users didn't
3704          * show up until sometime later on.
3705          */
3706         length = cgroup_task_count(cgrp);
3707         array = pidlist_allocate(length);
3708         if (!array)
3709                 return -ENOMEM;
3710         /* now, populate the array */
3711         css_task_iter_start(&cgrp->dummy_css, &it);
3712         while ((tsk = css_task_iter_next(&it))) {
3713                 if (unlikely(n == length))
3714                         break;
3715                 /* get tgid or pid for procs or tasks file respectively */
3716                 if (type == CGROUP_FILE_PROCS)
3717                         pid = task_tgid_vnr(tsk);
3718                 else
3719                         pid = task_pid_vnr(tsk);
3720                 if (pid > 0) /* make sure to only use valid results */
3721                         array[n++] = pid;
3722         }
3723         css_task_iter_end(&it);
3724         length = n;
3725         /* now sort & (if procs) strip out duplicates */
3726         if (cgroup_sane_behavior(cgrp))
3727                 sort(array, length, sizeof(pid_t), fried_cmppid, NULL);
3728         else
3729                 sort(array, length, sizeof(pid_t), cmppid, NULL);
3730         if (type == CGROUP_FILE_PROCS)
3731                 length = pidlist_uniq(array, length);
3732
3733         l = cgroup_pidlist_find_create(cgrp, type);
3734         if (!l) {
3735                 mutex_unlock(&cgrp->pidlist_mutex);
3736                 pidlist_free(array);
3737                 return -ENOMEM;
3738         }
3739
3740         /* store array, freeing old if necessary */
3741         pidlist_free(l->list);
3742         l->list = array;
3743         l->length = length;
3744         *lp = l;
3745         return 0;
3746 }
3747
3748 /**
3749  * cgroupstats_build - build and fill cgroupstats
3750  * @stats: cgroupstats to fill information into
3751  * @dentry: A dentry entry belonging to the cgroup for which stats have
3752  * been requested.
3753  *
3754  * Build and fill cgroupstats so that taskstats can export it to user
3755  * space.
3756  */
3757 int cgroupstats_build(struct cgroupstats *stats, struct dentry *dentry)
3758 {
3759         struct kernfs_node *kn = kernfs_node_from_dentry(dentry);
3760         struct cgroup *cgrp;
3761         struct css_task_iter it;
3762         struct task_struct *tsk;
3763
3764         /* it should be kernfs_node belonging to cgroupfs and is a directory */
3765         if (dentry->d_sb->s_type != &cgroup_fs_type || !kn ||
3766             kernfs_type(kn) != KERNFS_DIR)
3767                 return -EINVAL;
3768
3769         mutex_lock(&cgroup_mutex);
3770
3771         /*
3772          * We aren't being called from kernfs and there's no guarantee on
3773          * @kn->priv's validity.  For this and css_tryget_from_dir(),
3774          * @kn->priv is RCU safe.  Let's do the RCU dancing.
3775          */
3776         rcu_read_lock();
3777         cgrp = rcu_dereference(kn->priv);
3778         if (!cgrp || cgroup_is_dead(cgrp)) {
3779                 rcu_read_unlock();
3780                 mutex_unlock(&cgroup_mutex);
3781                 return -ENOENT;
3782         }
3783         rcu_read_unlock();
3784
3785         css_task_iter_start(&cgrp->dummy_css, &it);
3786         while ((tsk = css_task_iter_next(&it))) {
3787                 switch (tsk->state) {
3788                 case TASK_RUNNING:
3789                         stats->nr_running++;
3790                         break;
3791                 case TASK_INTERRUPTIBLE:
3792                         stats->nr_sleeping++;
3793                         break;
3794                 case TASK_UNINTERRUPTIBLE:
3795                         stats->nr_uninterruptible++;
3796                         break;
3797                 case TASK_STOPPED:
3798                         stats->nr_stopped++;
3799                         break;
3800                 default:
3801                         if (delayacct_is_task_waiting_on_io(tsk))
3802                                 stats->nr_io_wait++;
3803                         break;
3804                 }
3805         }
3806         css_task_iter_end(&it);
3807
3808         mutex_unlock(&cgroup_mutex);
3809         return 0;
3810 }
3811
3812
3813 /*
3814  * seq_file methods for the tasks/procs files. The seq_file position is the
3815  * next pid to display; the seq_file iterator is a pointer to the pid
3816  * in the cgroup->l->list array.
3817  */
3818
3819 static void *cgroup_pidlist_start(struct seq_file *s, loff_t *pos)
3820 {
3821         /*
3822          * Initially we receive a position value that corresponds to
3823          * one more than the last pid shown (or 0 on the first call or
3824          * after a seek to the start). Use a binary-search to find the
3825          * next pid to display, if any
3826          */
3827         struct kernfs_open_file *of = s->private;
3828         struct cgroup *cgrp = seq_css(s)->cgroup;
3829         struct cgroup_pidlist *l;
3830         enum cgroup_filetype type = seq_cft(s)->private;
3831         int index = 0, pid = *pos;
3832         int *iter, ret;
3833
3834         mutex_lock(&cgrp->pidlist_mutex);
3835
3836         /*
3837          * !NULL @of->priv indicates that this isn't the first start()
3838          * after open.  If the matching pidlist is around, we can use that.
3839          * Look for it.  Note that @of->priv can't be used directly.  It
3840          * could already have been destroyed.
3841          */
3842         if (of->priv)
3843                 of->priv = cgroup_pidlist_find(cgrp, type);
3844
3845         /*
3846          * Either this is the first start() after open or the matching
3847          * pidlist has been destroyed inbetween.  Create a new one.
3848          */
3849         if (!of->priv) {
3850                 ret = pidlist_array_load(cgrp, type,
3851                                          (struct cgroup_pidlist **)&of->priv);
3852                 if (ret)
3853                         return ERR_PTR(ret);
3854         }
3855         l = of->priv;
3856
3857         if (pid) {
3858                 int end = l->length;
3859
3860                 while (index < end) {
3861                         int mid = (index + end) / 2;
3862                         if (cgroup_pid_fry(cgrp, l->list[mid]) == pid) {
3863                                 index = mid;
3864                                 break;
3865                         } else if (cgroup_pid_fry(cgrp, l->list[mid]) <= pid)
3866                                 index = mid + 1;
3867                         else
3868                                 end = mid;
3869                 }
3870         }
3871         /* If we're off the end of the array, we're done */
3872         if (index >= l->length)
3873                 return NULL;
3874         /* Update the abstract position to be the actual pid that we found */
3875         iter = l->list + index;
3876         *pos = cgroup_pid_fry(cgrp, *iter);
3877         return iter;
3878 }
3879
3880 static void cgroup_pidlist_stop(struct seq_file *s, void *v)
3881 {
3882         struct kernfs_open_file *of = s->private;
3883         struct cgroup_pidlist *l = of->priv;
3884
3885         if (l)
3886                 mod_delayed_work(cgroup_pidlist_destroy_wq, &l->destroy_dwork,
3887                                  CGROUP_PIDLIST_DESTROY_DELAY);
3888         mutex_unlock(&seq_css(s)->cgroup->pidlist_mutex);
3889 }
3890
3891 static void *cgroup_pidlist_next(struct seq_file *s, void *v, loff_t *pos)
3892 {
3893         struct kernfs_open_file *of = s->private;
3894         struct cgroup_pidlist *l = of->priv;
3895         pid_t *p = v;
3896         pid_t *end = l->list + l->length;
3897         /*
3898          * Advance to the next pid in the array. If this goes off the
3899          * end, we're done
3900          */
3901         p++;
3902         if (p >= end) {
3903                 return NULL;
3904         } else {
3905                 *pos = cgroup_pid_fry(seq_css(s)->cgroup, *p);
3906                 return p;
3907         }
3908 }
3909
3910 static int cgroup_pidlist_show(struct seq_file *s, void *v)
3911 {
3912         return seq_printf(s, "%d\n", *(int *)v);
3913 }
3914
3915 static u64 cgroup_read_notify_on_release(struct cgroup_subsys_state *css,
3916                                          struct cftype *cft)
3917 {
3918         return notify_on_release(css->cgroup);
3919 }
3920
3921 static int cgroup_write_notify_on_release(struct cgroup_subsys_state *css,
3922                                           struct cftype *cft, u64 val)
3923 {
3924         clear_bit(CGRP_RELEASABLE, &css->cgroup->flags);
3925         if (val)
3926                 set_bit(CGRP_NOTIFY_ON_RELEASE, &css->cgroup->flags);
3927         else
3928                 clear_bit(CGRP_NOTIFY_ON_RELEASE, &css->cgroup->flags);
3929         return 0;
3930 }
3931
3932 static u64 cgroup_clone_children_read(struct cgroup_subsys_state *css,
3933                                       struct cftype *cft)
3934 {
3935         return test_bit(CGRP_CPUSET_CLONE_CHILDREN, &css->cgroup->flags);
3936 }
3937
3938 static int cgroup_clone_children_write(struct cgroup_subsys_state *css,
3939                                        struct cftype *cft, u64 val)
3940 {
3941         if (val)
3942                 set_bit(CGRP_CPUSET_CLONE_CHILDREN, &css->cgroup->flags);
3943         else
3944                 clear_bit(CGRP_CPUSET_CLONE_CHILDREN, &css->cgroup->flags);
3945         return 0;
3946 }
3947
3948 static struct cftype cgroup_base_files[] = {
3949         {
3950                 .name = "cgroup.procs",
3951                 .seq_start = cgroup_pidlist_start,
3952                 .seq_next = cgroup_pidlist_next,
3953                 .seq_stop = cgroup_pidlist_stop,
3954                 .seq_show = cgroup_pidlist_show,
3955                 .private = CGROUP_FILE_PROCS,
3956                 .write_u64 = cgroup_procs_write,
3957                 .mode = S_IRUGO | S_IWUSR,
3958         },
3959         {
3960                 .name = "cgroup.clone_children",
3961                 .flags = CFTYPE_INSANE,
3962                 .read_u64 = cgroup_clone_children_read,
3963                 .write_u64 = cgroup_clone_children_write,
3964         },
3965         {
3966                 .name = "cgroup.sane_behavior",
3967                 .flags = CFTYPE_ONLY_ON_ROOT,
3968                 .seq_show = cgroup_sane_behavior_show,
3969         },
3970         {
3971                 .name = "cgroup.controllers",
3972                 .flags = CFTYPE_ONLY_ON_DFL | CFTYPE_ONLY_ON_ROOT,
3973                 .seq_show = cgroup_root_controllers_show,
3974         },
3975         {
3976                 .name = "cgroup.controllers",
3977                 .flags = CFTYPE_ONLY_ON_DFL | CFTYPE_NOT_ON_ROOT,
3978                 .seq_show = cgroup_controllers_show,
3979         },
3980         {
3981                 .name = "cgroup.subtree_control",
3982                 .flags = CFTYPE_ONLY_ON_DFL,
3983                 .seq_show = cgroup_subtree_control_show,
3984                 .write_string = cgroup_subtree_control_write,
3985         },
3986         {
3987                 .name = "cgroup.populated",
3988                 .flags = CFTYPE_ONLY_ON_DFL | CFTYPE_NOT_ON_ROOT,
3989                 .seq_show = cgroup_populated_show,
3990         },
3991
3992         /*
3993          * Historical crazy stuff.  These don't have "cgroup."  prefix and
3994          * don't exist if sane_behavior.  If you're depending on these, be
3995          * prepared to be burned.
3996          */
3997         {
3998                 .name = "tasks",
3999                 .flags = CFTYPE_INSANE,         /* use "procs" instead */
4000                 .seq_start = cgroup_pidlist_start,
4001                 .seq_next = cgroup_pidlist_next,
4002                 .seq_stop = cgroup_pidlist_stop,
4003                 .seq_show = cgroup_pidlist_show,
4004                 .private = CGROUP_FILE_TASKS,
4005                 .write_u64 = cgroup_tasks_write,
4006                 .mode = S_IRUGO | S_IWUSR,
4007         },
4008         {
4009                 .name = "notify_on_release",
4010                 .flags = CFTYPE_INSANE,
4011                 .read_u64 = cgroup_read_notify_on_release,
4012                 .write_u64 = cgroup_write_notify_on_release,
4013         },
4014         {
4015                 .name = "release_agent",
4016                 .flags = CFTYPE_INSANE | CFTYPE_ONLY_ON_ROOT,
4017                 .seq_show = cgroup_release_agent_show,
4018                 .write_string = cgroup_release_agent_write,
4019                 .max_write_len = PATH_MAX - 1,
4020         },
4021         { }     /* terminate */
4022 };
4023
4024 /**
4025  * cgroup_populate_dir - create subsys files in a cgroup directory
4026  * @cgrp: target cgroup
4027  * @subsys_mask: mask of the subsystem ids whose files should be added
4028  *
4029  * On failure, no file is added.
4030  */
4031 static int cgroup_populate_dir(struct cgroup *cgrp, unsigned int subsys_mask)
4032 {
4033         struct cgroup_subsys *ss;
4034         int i, ret = 0;
4035
4036         /* process cftsets of each subsystem */
4037         for_each_subsys(ss, i) {
4038                 struct cftype *cfts;
4039
4040                 if (!(subsys_mask & (1 << i)))
4041                         continue;
4042
4043                 list_for_each_entry(cfts, &ss->cfts, node) {
4044                         ret = cgroup_addrm_files(cgrp, cfts, true);
4045                         if (ret < 0)
4046                                 goto err;
4047                 }
4048         }
4049         return 0;
4050 err:
4051         cgroup_clear_dir(cgrp, subsys_mask);
4052         return ret;
4053 }
4054
4055 /*
4056  * css destruction is four-stage process.
4057  *
4058  * 1. Destruction starts.  Killing of the percpu_ref is initiated.
4059  *    Implemented in kill_css().
4060  *
4061  * 2. When the percpu_ref is confirmed to be visible as killed on all CPUs
4062  *    and thus css_tryget() is guaranteed to fail, the css can be offlined
4063  *    by invoking offline_css().  After offlining, the base ref is put.
4064  *    Implemented in css_killed_work_fn().
4065  *
4066  * 3. When the percpu_ref reaches zero, the only possible remaining
4067  *    accessors are inside RCU read sections.  css_release() schedules the
4068  *    RCU callback.
4069  *
4070  * 4. After the grace period, the css can be freed.  Implemented in
4071  *    css_free_work_fn().
4072  *
4073  * It is actually hairier because both step 2 and 4 require process context
4074  * and thus involve punting to css->destroy_work adding two additional
4075  * steps to the already complex sequence.
4076  */
4077 static void css_free_work_fn(struct work_struct *work)
4078 {
4079         struct cgroup_subsys_state *css =
4080                 container_of(work, struct cgroup_subsys_state, destroy_work);
4081         struct cgroup *cgrp = css->cgroup;
4082
4083         if (css->parent)
4084                 css_put(css->parent);
4085
4086         css->ss->css_free(css);
4087         cgroup_put(cgrp);
4088 }
4089
4090 static void css_free_rcu_fn(struct rcu_head *rcu_head)
4091 {
4092         struct cgroup_subsys_state *css =
4093                 container_of(rcu_head, struct cgroup_subsys_state, rcu_head);
4094
4095         INIT_WORK(&css->destroy_work, css_free_work_fn);
4096         queue_work(cgroup_destroy_wq, &css->destroy_work);
4097 }
4098
4099 static void css_release(struct percpu_ref *ref)
4100 {
4101         struct cgroup_subsys_state *css =
4102                 container_of(ref, struct cgroup_subsys_state, refcnt);
4103         struct cgroup_subsys *ss = css->ss;
4104
4105         RCU_INIT_POINTER(css->cgroup->subsys[ss->id], NULL);
4106         cgroup_idr_remove(&ss->css_idr, css->id);
4107
4108         call_rcu(&css->rcu_head, css_free_rcu_fn);
4109 }
4110
4111 static void init_and_link_css(struct cgroup_subsys_state *css,
4112                               struct cgroup_subsys *ss, struct cgroup *cgrp)
4113 {
4114         cgroup_get(cgrp);
4115
4116         css->cgroup = cgrp;
4117         css->ss = ss;
4118         css->flags = 0;
4119
4120         if (cgrp->parent) {
4121                 css->parent = cgroup_css(cgrp->parent, ss);
4122                 css_get(css->parent);
4123         } else {
4124                 css->flags |= CSS_ROOT;
4125         }
4126
4127         BUG_ON(cgroup_css(cgrp, ss));
4128 }
4129
4130 /* invoke ->css_online() on a new CSS and mark it online if successful */
4131 static int online_css(struct cgroup_subsys_state *css)
4132 {
4133         struct cgroup_subsys *ss = css->ss;
4134         int ret = 0;
4135
4136         lockdep_assert_held(&cgroup_tree_mutex);
4137         lockdep_assert_held(&cgroup_mutex);
4138
4139         if (ss->css_online)
4140                 ret = ss->css_online(css);
4141         if (!ret) {
4142                 css->flags |= CSS_ONLINE;
4143                 css->cgroup->nr_css++;
4144                 rcu_assign_pointer(css->cgroup->subsys[ss->id], css);
4145         }
4146         return ret;
4147 }
4148
4149 /* if the CSS is online, invoke ->css_offline() on it and mark it offline */
4150 static void offline_css(struct cgroup_subsys_state *css)
4151 {
4152         struct cgroup_subsys *ss = css->ss;
4153
4154         lockdep_assert_held(&cgroup_tree_mutex);
4155         lockdep_assert_held(&cgroup_mutex);
4156
4157         if (!(css->flags & CSS_ONLINE))
4158                 return;
4159
4160         if (ss->css_offline)
4161                 ss->css_offline(css);
4162
4163         css->flags &= ~CSS_ONLINE;
4164         css->cgroup->nr_css--;
4165         RCU_INIT_POINTER(css->cgroup->subsys[ss->id], NULL);
4166
4167         wake_up_all(&css->cgroup->offline_waitq);
4168 }
4169
4170 /**
4171  * create_css - create a cgroup_subsys_state
4172  * @cgrp: the cgroup new css will be associated with
4173  * @ss: the subsys of new css
4174  *
4175  * Create a new css associated with @cgrp - @ss pair.  On success, the new
4176  * css is online and installed in @cgrp with all interface files created.
4177  * Returns 0 on success, -errno on failure.
4178  */
4179 static int create_css(struct cgroup *cgrp, struct cgroup_subsys *ss)
4180 {
4181         struct cgroup *parent = cgrp->parent;
4182         struct cgroup_subsys_state *css;
4183         int err;
4184
4185         lockdep_assert_held(&cgroup_mutex);
4186
4187         css = ss->css_alloc(cgroup_css(parent, ss));
4188         if (IS_ERR(css))
4189                 return PTR_ERR(css);
4190
4191         init_and_link_css(css, ss, cgrp);
4192
4193         err = percpu_ref_init(&css->refcnt, css_release);
4194         if (err)
4195                 goto err_free_css;
4196
4197         err = cgroup_idr_alloc(&ss->css_idr, NULL, 2, 0, GFP_NOWAIT);
4198         if (err < 0)
4199                 goto err_free_percpu_ref;
4200         css->id = err;
4201
4202         err = cgroup_populate_dir(cgrp, 1 << ss->id);
4203         if (err)
4204                 goto err_free_id;
4205
4206         /* @css is ready to be brought online now, make it visible */
4207         cgroup_idr_replace(&ss->css_idr, css, css->id);
4208
4209         err = online_css(css);
4210         if (err)
4211                 goto err_clear_dir;
4212
4213         if (ss->broken_hierarchy && !ss->warned_broken_hierarchy &&
4214             parent->parent) {
4215                 pr_warn("%s (%d) created nested cgroup for controller \"%s\" which has incomplete hierarchy support. Nested cgroups may change behavior in the future.\n",
4216                         current->comm, current->pid, ss->name);
4217                 if (!strcmp(ss->name, "memory"))
4218                         pr_warn("\"memory\" requires setting use_hierarchy to 1 on the root\n");
4219                 ss->warned_broken_hierarchy = true;
4220         }
4221
4222         return 0;
4223
4224 err_clear_dir:
4225         cgroup_clear_dir(css->cgroup, 1 << css->ss->id);
4226 err_free_id:
4227         cgroup_idr_remove(&ss->css_idr, css->id);
4228 err_free_percpu_ref:
4229         percpu_ref_cancel_init(&css->refcnt);
4230 err_free_css:
4231         call_rcu(&css->rcu_head, css_free_rcu_fn);
4232         return err;
4233 }
4234
4235 /**
4236  * cgroup_create - create a cgroup
4237  * @parent: cgroup that will be parent of the new cgroup
4238  * @name: name of the new cgroup
4239  * @mode: mode to set on new cgroup
4240  */
4241 static long cgroup_create(struct cgroup *parent, const char *name,
4242                           umode_t mode)
4243 {
4244         struct cgroup *cgrp;
4245         struct cgroup_root *root = parent->root;
4246         int ssid, err;
4247         struct cgroup_subsys *ss;
4248         struct kernfs_node *kn;
4249
4250         /* allocate the cgroup and its ID, 0 is reserved for the root */
4251         cgrp = kzalloc(sizeof(*cgrp), GFP_KERNEL);
4252         if (!cgrp)
4253                 return -ENOMEM;
4254
4255         mutex_lock(&cgroup_tree_mutex);
4256
4257         /*
4258          * Only live parents can have children.  Note that the liveliness
4259          * check isn't strictly necessary because cgroup_mkdir() and
4260          * cgroup_rmdir() are fully synchronized by i_mutex; however, do it
4261          * anyway so that locking is contained inside cgroup proper and we
4262          * don't get nasty surprises if we ever grow another caller.
4263          */
4264         if (!cgroup_lock_live_group(parent)) {
4265                 err = -ENODEV;
4266                 goto err_unlock_tree;
4267         }
4268
4269         /*
4270          * Temporarily set the pointer to NULL, so idr_find() won't return
4271          * a half-baked cgroup.
4272          */
4273         cgrp->id = cgroup_idr_alloc(&root->cgroup_idr, NULL, 2, 0, GFP_NOWAIT);
4274         if (cgrp->id < 0) {
4275                 err = -ENOMEM;
4276                 goto err_unlock;
4277         }
4278
4279         init_cgroup_housekeeping(cgrp);
4280
4281         cgrp->parent = parent;
4282         cgrp->dummy_css.parent = &parent->dummy_css;
4283         cgrp->root = parent->root;
4284
4285         if (notify_on_release(parent))
4286                 set_bit(CGRP_NOTIFY_ON_RELEASE, &cgrp->flags);
4287
4288         if (test_bit(CGRP_CPUSET_CLONE_CHILDREN, &parent->flags))
4289                 set_bit(CGRP_CPUSET_CLONE_CHILDREN, &cgrp->flags);
4290
4291         /* create the directory */
4292         kn = kernfs_create_dir(parent->kn, name, mode, cgrp);
4293         if (IS_ERR(kn)) {
4294                 err = PTR_ERR(kn);
4295                 goto err_free_id;
4296         }
4297         cgrp->kn = kn;
4298
4299         /*
4300          * This extra ref will be put in cgroup_free_fn() and guarantees
4301          * that @cgrp->kn is always accessible.
4302          */
4303         kernfs_get(kn);
4304
4305         cgrp->serial_nr = cgroup_serial_nr_next++;
4306
4307         /* allocation complete, commit to creation */
4308         list_add_tail_rcu(&cgrp->sibling, &cgrp->parent->children);
4309         atomic_inc(&root->nr_cgrps);
4310         cgroup_get(parent);
4311
4312         /*
4313          * @cgrp is now fully operational.  If something fails after this
4314          * point, it'll be released via the normal destruction path.
4315          */
4316         cgroup_idr_replace(&root->cgroup_idr, cgrp, cgrp->id);
4317
4318         err = cgroup_kn_set_ugid(kn);
4319         if (err)
4320                 goto err_destroy;
4321
4322         err = cgroup_addrm_files(cgrp, cgroup_base_files, true);
4323         if (err)
4324                 goto err_destroy;
4325
4326         /* let's create and online css's */
4327         for_each_subsys(ss, ssid) {
4328                 if (parent->child_subsys_mask & (1 << ssid)) {
4329                         err = create_css(cgrp, ss);
4330                         if (err)
4331                                 goto err_destroy;
4332                 }
4333         }
4334
4335         /*
4336          * On the default hierarchy, a child doesn't automatically inherit
4337          * child_subsys_mask from the parent.  Each is configured manually.
4338          */
4339         if (!cgroup_on_dfl(cgrp))
4340                 cgrp->child_subsys_mask = parent->child_subsys_mask;
4341
4342         kernfs_activate(kn);
4343
4344         mutex_unlock(&cgroup_mutex);
4345         mutex_unlock(&cgroup_tree_mutex);
4346
4347         return 0;
4348
4349 err_free_id:
4350         cgroup_idr_remove(&root->cgroup_idr, cgrp->id);
4351 err_unlock:
4352         mutex_unlock(&cgroup_mutex);
4353 err_unlock_tree:
4354         mutex_unlock(&cgroup_tree_mutex);
4355         kfree(cgrp);
4356         return err;
4357
4358 err_destroy:
4359         cgroup_destroy_locked(cgrp);
4360         mutex_unlock(&cgroup_mutex);
4361         mutex_unlock(&cgroup_tree_mutex);
4362         return err;
4363 }
4364
4365 static int cgroup_mkdir(struct kernfs_node *parent_kn, const char *name,
4366                         umode_t mode)
4367 {
4368         struct cgroup *parent = parent_kn->priv;
4369         int ret;
4370
4371         /*
4372          * cgroup_create() grabs cgroup_tree_mutex which nests outside
4373          * kernfs active_ref and cgroup_create() already synchronizes
4374          * properly against removal through cgroup_lock_live_group().
4375          * Break it before calling cgroup_create().
4376          */
4377         cgroup_get(parent);
4378         kernfs_break_active_protection(parent_kn);
4379
4380         ret = cgroup_create(parent, name, mode);
4381
4382         kernfs_unbreak_active_protection(parent_kn);
4383         cgroup_put(parent);
4384         return ret;
4385 }
4386
4387 /*
4388  * This is called when the refcnt of a css is confirmed to be killed.
4389  * css_tryget() is now guaranteed to fail.
4390  */
4391 static void css_killed_work_fn(struct work_struct *work)
4392 {
4393         struct cgroup_subsys_state *css =
4394                 container_of(work, struct cgroup_subsys_state, destroy_work);
4395         struct cgroup *cgrp = css->cgroup;
4396
4397         mutex_lock(&cgroup_tree_mutex);
4398         mutex_lock(&cgroup_mutex);
4399
4400         /*
4401          * css_tryget() is guaranteed to fail now.  Tell subsystems to
4402          * initate destruction.
4403          */
4404         offline_css(css);
4405
4406         /*
4407          * If @cgrp is marked dead, it's waiting for refs of all css's to
4408          * be disabled before proceeding to the second phase of cgroup
4409          * destruction.  If we are the last one, kick it off.
4410          */
4411         if (!cgrp->nr_css && cgroup_is_dead(cgrp))
4412                 cgroup_destroy_css_killed(cgrp);
4413
4414         mutex_unlock(&cgroup_mutex);
4415         mutex_unlock(&cgroup_tree_mutex);
4416
4417         /*
4418          * Put the css refs from kill_css().  Each css holds an extra
4419          * reference to the cgroup's dentry and cgroup removal proceeds
4420          * regardless of css refs.  On the last put of each css, whenever
4421          * that may be, the extra dentry ref is put so that dentry
4422          * destruction happens only after all css's are released.
4423          */
4424         css_put(css);
4425 }
4426
4427 /* css kill confirmation processing requires process context, bounce */
4428 static void css_killed_ref_fn(struct percpu_ref *ref)
4429 {
4430         struct cgroup_subsys_state *css =
4431                 container_of(ref, struct cgroup_subsys_state, refcnt);
4432
4433         INIT_WORK(&css->destroy_work, css_killed_work_fn);
4434         queue_work(cgroup_destroy_wq, &css->destroy_work);
4435 }
4436
4437 /**
4438  * kill_css - destroy a css
4439  * @css: css to destroy
4440  *
4441  * This function initiates destruction of @css by removing cgroup interface
4442  * files and putting its base reference.  ->css_offline() will be invoked
4443  * asynchronously once css_tryget() is guaranteed to fail and when the
4444  * reference count reaches zero, @css will be released.
4445  */
4446 static void kill_css(struct cgroup_subsys_state *css)
4447 {
4448         lockdep_assert_held(&cgroup_tree_mutex);
4449
4450         /*
4451          * This must happen before css is disassociated with its cgroup.
4452          * See seq_css() for details.
4453          */
4454         cgroup_clear_dir(css->cgroup, 1 << css->ss->id);
4455
4456         /*
4457          * Killing would put the base ref, but we need to keep it alive
4458          * until after ->css_offline().
4459          */
4460         css_get(css);
4461
4462         /*
4463          * cgroup core guarantees that, by the time ->css_offline() is
4464          * invoked, no new css reference will be given out via
4465          * css_tryget().  We can't simply call percpu_ref_kill() and
4466          * proceed to offlining css's because percpu_ref_kill() doesn't
4467          * guarantee that the ref is seen as killed on all CPUs on return.
4468          *
4469          * Use percpu_ref_kill_and_confirm() to get notifications as each
4470          * css is confirmed to be seen as killed on all CPUs.
4471          */
4472         percpu_ref_kill_and_confirm(&css->refcnt, css_killed_ref_fn);
4473 }
4474
4475 /**
4476  * cgroup_destroy_locked - the first stage of cgroup destruction
4477  * @cgrp: cgroup to be destroyed
4478  *
4479  * css's make use of percpu refcnts whose killing latency shouldn't be
4480  * exposed to userland and are RCU protected.  Also, cgroup core needs to
4481  * guarantee that css_tryget() won't succeed by the time ->css_offline() is
4482  * invoked.  To satisfy all the requirements, destruction is implemented in
4483  * the following two steps.
4484  *
4485  * s1. Verify @cgrp can be destroyed and mark it dying.  Remove all
4486  *     userland visible parts and start killing the percpu refcnts of
4487  *     css's.  Set up so that the next stage will be kicked off once all
4488  *     the percpu refcnts are confirmed to be killed.
4489  *
4490  * s2. Invoke ->css_offline(), mark the cgroup dead and proceed with the
4491  *     rest of destruction.  Once all cgroup references are gone, the
4492  *     cgroup is RCU-freed.
4493  *
4494  * This function implements s1.  After this step, @cgrp is gone as far as
4495  * the userland is concerned and a new cgroup with the same name may be
4496  * created.  As cgroup doesn't care about the names internally, this
4497  * doesn't cause any problem.
4498  */
4499 static int cgroup_destroy_locked(struct cgroup *cgrp)
4500         __releases(&cgroup_mutex) __acquires(&cgroup_mutex)
4501 {
4502         struct cgroup *child;
4503         struct cgroup_subsys_state *css;
4504         bool empty;
4505         int ssid;
4506
4507         lockdep_assert_held(&cgroup_tree_mutex);
4508         lockdep_assert_held(&cgroup_mutex);
4509
4510         /*
4511          * css_set_rwsem synchronizes access to ->cset_links and prevents
4512          * @cgrp from being removed while put_css_set() is in progress.
4513          */
4514         down_read(&css_set_rwsem);
4515         empty = list_empty(&cgrp->cset_links);
4516         up_read(&css_set_rwsem);
4517         if (!empty)
4518                 return -EBUSY;
4519
4520         /*
4521          * Make sure there's no live children.  We can't test ->children
4522          * emptiness as dead children linger on it while being destroyed;
4523          * otherwise, "rmdir parent/child parent" may fail with -EBUSY.
4524          */
4525         empty = true;
4526         rcu_read_lock();
4527         list_for_each_entry_rcu(child, &cgrp->children, sibling) {
4528                 empty = cgroup_is_dead(child);
4529                 if (!empty)
4530                         break;
4531         }
4532         rcu_read_unlock();
4533         if (!empty)
4534                 return -EBUSY;
4535
4536         /*
4537          * Mark @cgrp dead.  This prevents further task migration and child
4538          * creation by disabling cgroup_lock_live_group().  Note that
4539          * CGRP_DEAD assertion is depended upon by css_next_child() to
4540          * resume iteration after dropping RCU read lock.  See
4541          * css_next_child() for details.
4542          */
4543         set_bit(CGRP_DEAD, &cgrp->flags);
4544
4545         /*
4546          * Initiate massacre of all css's.  cgroup_destroy_css_killed()
4547          * will be invoked to perform the rest of destruction once the
4548          * percpu refs of all css's are confirmed to be killed.  This
4549          * involves removing the subsystem's files, drop cgroup_mutex.
4550          */
4551         mutex_unlock(&cgroup_mutex);
4552         for_each_css(css, ssid, cgrp)
4553                 kill_css(css);
4554         mutex_lock(&cgroup_mutex);
4555
4556         /* CGRP_DEAD is set, remove from ->release_list for the last time */
4557         raw_spin_lock(&release_list_lock);
4558         if (!list_empty(&cgrp->release_list))
4559                 list_del_init(&cgrp->release_list);
4560         raw_spin_unlock(&release_list_lock);
4561
4562         /*
4563          * If @cgrp has css's attached, the second stage of cgroup
4564          * destruction is kicked off from css_killed_work_fn() after the
4565          * refs of all attached css's are killed.  If @cgrp doesn't have
4566          * any css, we kick it off here.
4567          */
4568         if (!cgrp->nr_css)
4569                 cgroup_destroy_css_killed(cgrp);
4570
4571         /* remove @cgrp directory along with the base files */
4572         mutex_unlock(&cgroup_mutex);
4573
4574         /*
4575          * There are two control paths which try to determine cgroup from
4576          * dentry without going through kernfs - cgroupstats_build() and
4577          * css_tryget_from_dir().  Those are supported by RCU protecting
4578          * clearing of cgrp->kn->priv backpointer, which should happen
4579          * after all files under it have been removed.
4580          */
4581         kernfs_remove(cgrp->kn);        /* @cgrp has an extra ref on its kn */
4582         RCU_INIT_POINTER(*(void __rcu __force **)&cgrp->kn->priv, NULL);
4583
4584         mutex_lock(&cgroup_mutex);
4585
4586         return 0;
4587 };
4588
4589 /**
4590  * cgroup_destroy_css_killed - the second step of cgroup destruction
4591  * @cgrp: the cgroup whose csses have just finished offlining
4592  *
4593  * This function is invoked from a work item for a cgroup which is being
4594  * destroyed after all css's are offlined and performs the rest of
4595  * destruction.  This is the second step of destruction described in the
4596  * comment above cgroup_destroy_locked().
4597  */
4598 static void cgroup_destroy_css_killed(struct cgroup *cgrp)
4599 {
4600         struct cgroup *parent = cgrp->parent;
4601
4602         lockdep_assert_held(&cgroup_tree_mutex);
4603         lockdep_assert_held(&cgroup_mutex);
4604
4605         /* delete this cgroup from parent->children */
4606         list_del_rcu(&cgrp->sibling);
4607
4608         cgroup_put(cgrp);
4609
4610         set_bit(CGRP_RELEASABLE, &parent->flags);
4611         check_for_release(parent);
4612 }
4613
4614 static int cgroup_rmdir(struct kernfs_node *kn)
4615 {
4616         struct cgroup *cgrp = kn->priv;
4617         int ret = 0;
4618
4619         /*
4620          * This is self-destruction but @kn can't be removed while this
4621          * callback is in progress.  Let's break active protection.  Once
4622          * the protection is broken, @cgrp can be destroyed at any point.
4623          * Pin it so that it stays accessible.
4624          */
4625         cgroup_get(cgrp);
4626         kernfs_break_active_protection(kn);
4627
4628         mutex_lock(&cgroup_tree_mutex);
4629         mutex_lock(&cgroup_mutex);
4630
4631         /*
4632          * @cgrp might already have been destroyed while we're trying to
4633          * grab the mutexes.
4634          */
4635         if (!cgroup_is_dead(cgrp))
4636                 ret = cgroup_destroy_locked(cgrp);
4637
4638         mutex_unlock(&cgroup_mutex);
4639         mutex_unlock(&cgroup_tree_mutex);
4640
4641         kernfs_unbreak_active_protection(kn);
4642         cgroup_put(cgrp);
4643         return ret;
4644 }
4645
4646 static struct kernfs_syscall_ops cgroup_kf_syscall_ops = {
4647         .remount_fs             = cgroup_remount,
4648         .show_options           = cgroup_show_options,
4649         .mkdir                  = cgroup_mkdir,
4650         .rmdir                  = cgroup_rmdir,
4651         .rename                 = cgroup_rename,
4652 };
4653
4654 static void __init cgroup_init_subsys(struct cgroup_subsys *ss, bool early)
4655 {
4656         struct cgroup_subsys_state *css;
4657
4658         printk(KERN_INFO "Initializing cgroup subsys %s\n", ss->name);
4659
4660         mutex_lock(&cgroup_tree_mutex);
4661         mutex_lock(&cgroup_mutex);
4662
4663         idr_init(&ss->css_idr);
4664         INIT_LIST_HEAD(&ss->cfts);
4665
4666         /* Create the root cgroup state for this subsystem */
4667         ss->root = &cgrp_dfl_root;
4668         css = ss->css_alloc(cgroup_css(&cgrp_dfl_root.cgrp, ss));
4669         /* We don't handle early failures gracefully */
4670         BUG_ON(IS_ERR(css));
4671         init_and_link_css(css, ss, &cgrp_dfl_root.cgrp);
4672         if (early) {
4673                 /* idr_alloc() can't be called safely during early init */
4674                 css->id = 1;
4675         } else {
4676                 css->id = cgroup_idr_alloc(&ss->css_idr, css, 1, 2, GFP_KERNEL);
4677                 BUG_ON(css->id < 0);
4678         }
4679
4680         /* Update the init_css_set to contain a subsys
4681          * pointer to this state - since the subsystem is
4682          * newly registered, all tasks and hence the
4683          * init_css_set is in the subsystem's root cgroup. */
4684         init_css_set.subsys[ss->id] = css;
4685
4686         need_forkexit_callback |= ss->fork || ss->exit;
4687
4688         /* At system boot, before all subsystems have been
4689          * registered, no tasks have been forked, so we don't
4690          * need to invoke fork callbacks here. */
4691         BUG_ON(!list_empty(&init_task.tasks));
4692
4693         BUG_ON(online_css(css));
4694
4695         cgrp_dfl_root.subsys_mask |= 1 << ss->id;
4696
4697         mutex_unlock(&cgroup_mutex);
4698         mutex_unlock(&cgroup_tree_mutex);
4699 }
4700
4701 /**
4702  * cgroup_init_early - cgroup initialization at system boot
4703  *
4704  * Initialize cgroups at system boot, and initialize any
4705  * subsystems that request early init.
4706  */
4707 int __init cgroup_init_early(void)
4708 {
4709         static struct cgroup_sb_opts __initdata opts =
4710                 { .flags = CGRP_ROOT_SANE_BEHAVIOR };
4711         struct cgroup_subsys *ss;
4712         int i;
4713
4714         init_cgroup_root(&cgrp_dfl_root, &opts);
4715         RCU_INIT_POINTER(init_task.cgroups, &init_css_set);
4716
4717         for_each_subsys(ss, i) {
4718                 WARN(!ss->css_alloc || !ss->css_free || ss->name || ss->id,
4719                      "invalid cgroup_subsys %d:%s css_alloc=%p css_free=%p name:id=%d:%s\n",
4720                      i, cgroup_subsys_name[i], ss->css_alloc, ss->css_free,
4721                      ss->id, ss->name);
4722                 WARN(strlen(cgroup_subsys_name[i]) > MAX_CGROUP_TYPE_NAMELEN,
4723                      "cgroup_subsys_name %s too long\n", cgroup_subsys_name[i]);
4724
4725                 ss->id = i;
4726                 ss->name = cgroup_subsys_name[i];
4727
4728                 if (ss->early_init)
4729                         cgroup_init_subsys(ss, true);
4730         }
4731         return 0;
4732 }
4733
4734 /**
4735  * cgroup_init - cgroup initialization
4736  *
4737  * Register cgroup filesystem and /proc file, and initialize
4738  * any subsystems that didn't request early init.
4739  */
4740 int __init cgroup_init(void)
4741 {
4742         struct cgroup_subsys *ss;
4743         unsigned long key;
4744         int ssid, err;
4745
4746         BUG_ON(cgroup_init_cftypes(NULL, cgroup_base_files));
4747
4748         mutex_lock(&cgroup_tree_mutex);
4749         mutex_lock(&cgroup_mutex);
4750
4751         /* Add init_css_set to the hash table */
4752         key = css_set_hash(init_css_set.subsys);
4753         hash_add(css_set_table, &init_css_set.hlist, key);
4754
4755         BUG_ON(cgroup_setup_root(&cgrp_dfl_root, 0));
4756
4757         mutex_unlock(&cgroup_mutex);
4758         mutex_unlock(&cgroup_tree_mutex);
4759
4760         for_each_subsys(ss, ssid) {
4761                 if (ss->early_init) {
4762                         struct cgroup_subsys_state *css =
4763                                 init_css_set.subsys[ss->id];
4764
4765                         css->id = cgroup_idr_alloc(&ss->css_idr, css, 1, 2,
4766                                                    GFP_KERNEL);
4767                         BUG_ON(css->id < 0);
4768                 } else {
4769                         cgroup_init_subsys(ss, false);
4770                 }
4771
4772                 list_add_tail(&init_css_set.e_cset_node[ssid],
4773                               &cgrp_dfl_root.cgrp.e_csets[ssid]);
4774
4775                 /*
4776                  * cftype registration needs kmalloc and can't be done
4777                  * during early_init.  Register base cftypes separately.
4778                  */
4779                 if (ss->base_cftypes)
4780                         WARN_ON(cgroup_add_cftypes(ss, ss->base_cftypes));
4781         }
4782
4783         cgroup_kobj = kobject_create_and_add("cgroup", fs_kobj);
4784         if (!cgroup_kobj)
4785                 return -ENOMEM;
4786
4787         err = register_filesystem(&cgroup_fs_type);
4788         if (err < 0) {
4789                 kobject_put(cgroup_kobj);
4790                 return err;
4791         }
4792
4793         proc_create("cgroups", 0, NULL, &proc_cgroupstats_operations);
4794         return 0;
4795 }
4796
4797 static int __init cgroup_wq_init(void)
4798 {
4799         /*
4800          * There isn't much point in executing destruction path in
4801          * parallel.  Good chunk is serialized with cgroup_mutex anyway.
4802          * Use 1 for @max_active.
4803          *
4804          * We would prefer to do this in cgroup_init() above, but that
4805          * is called before init_workqueues(): so leave this until after.
4806          */
4807         cgroup_destroy_wq = alloc_workqueue("cgroup_destroy", 0, 1);
4808         BUG_ON(!cgroup_destroy_wq);
4809
4810         /*
4811          * Used to destroy pidlists and separate to serve as flush domain.
4812          * Cap @max_active to 1 too.
4813          */
4814         cgroup_pidlist_destroy_wq = alloc_workqueue("cgroup_pidlist_destroy",
4815                                                     0, 1);
4816         BUG_ON(!cgroup_pidlist_destroy_wq);
4817
4818         return 0;
4819 }
4820 core_initcall(cgroup_wq_init);
4821
4822 /*
4823  * proc_cgroup_show()
4824  *  - Print task's cgroup paths into seq_file, one line for each hierarchy
4825  *  - Used for /proc/<pid>/cgroup.
4826  */
4827
4828 /* TODO: Use a proper seq_file iterator */
4829 int proc_cgroup_show(struct seq_file *m, void *v)
4830 {
4831         struct pid *pid;
4832         struct task_struct *tsk;
4833         char *buf, *path;
4834         int retval;
4835         struct cgroup_root *root;
4836
4837         retval = -ENOMEM;
4838         buf = kmalloc(PATH_MAX, GFP_KERNEL);
4839         if (!buf)
4840                 goto out;
4841
4842         retval = -ESRCH;
4843         pid = m->private;
4844         tsk = get_pid_task(pid, PIDTYPE_PID);
4845         if (!tsk)
4846                 goto out_free;
4847
4848         retval = 0;
4849
4850         mutex_lock(&cgroup_mutex);
4851         down_read(&css_set_rwsem);
4852
4853         for_each_root(root) {
4854                 struct cgroup_subsys *ss;
4855                 struct cgroup *cgrp;
4856                 int ssid, count = 0;
4857
4858                 if (root == &cgrp_dfl_root && !cgrp_dfl_root_visible)
4859                         continue;
4860
4861                 seq_printf(m, "%d:", root->hierarchy_id);
4862                 for_each_subsys(ss, ssid)
4863                         if (root->subsys_mask & (1 << ssid))
4864                                 seq_printf(m, "%s%s", count++ ? "," : "", ss->name);
4865                 if (strlen(root->name))
4866                         seq_printf(m, "%sname=%s", count ? "," : "",
4867                                    root->name);
4868                 seq_putc(m, ':');
4869                 cgrp = task_cgroup_from_root(tsk, root);
4870                 path = cgroup_path(cgrp, buf, PATH_MAX);
4871                 if (!path) {
4872                         retval = -ENAMETOOLONG;
4873                         goto out_unlock;
4874                 }
4875                 seq_puts(m, path);
4876                 seq_putc(m, '\n');
4877         }
4878
4879 out_unlock:
4880         up_read(&css_set_rwsem);
4881         mutex_unlock(&cgroup_mutex);
4882         put_task_struct(tsk);
4883 out_free:
4884         kfree(buf);
4885 out:
4886         return retval;
4887 }
4888
4889 /* Display information about each subsystem and each hierarchy */
4890 static int proc_cgroupstats_show(struct seq_file *m, void *v)
4891 {
4892         struct cgroup_subsys *ss;
4893         int i;
4894
4895         seq_puts(m, "#subsys_name\thierarchy\tnum_cgroups\tenabled\n");
4896         /*
4897          * ideally we don't want subsystems moving around while we do this.
4898          * cgroup_mutex is also necessary to guarantee an atomic snapshot of
4899          * subsys/hierarchy state.
4900          */
4901         mutex_lock(&cgroup_mutex);
4902
4903         for_each_subsys(ss, i)
4904                 seq_printf(m, "%s\t%d\t%d\t%d\n",
4905                            ss->name, ss->root->hierarchy_id,
4906                            atomic_read(&ss->root->nr_cgrps), !ss->disabled);
4907
4908         mutex_unlock(&cgroup_mutex);
4909         return 0;
4910 }
4911
4912 static int cgroupstats_open(struct inode *inode, struct file *file)
4913 {
4914         return single_open(file, proc_cgroupstats_show, NULL);
4915 }
4916
4917 static const struct file_operations proc_cgroupstats_operations = {
4918         .open = cgroupstats_open,
4919         .read = seq_read,
4920         .llseek = seq_lseek,
4921         .release = single_release,
4922 };
4923
4924 /**
4925  * cgroup_fork - initialize cgroup related fields during copy_process()
4926  * @child: pointer to task_struct of forking parent process.
4927  *
4928  * A task is associated with the init_css_set until cgroup_post_fork()
4929  * attaches it to the parent's css_set.  Empty cg_list indicates that
4930  * @child isn't holding reference to its css_set.
4931  */
4932 void cgroup_fork(struct task_struct *child)
4933 {
4934         RCU_INIT_POINTER(child->cgroups, &init_css_set);
4935         INIT_LIST_HEAD(&child->cg_list);
4936 }
4937
4938 /**
4939  * cgroup_post_fork - called on a new task after adding it to the task list
4940  * @child: the task in question
4941  *
4942  * Adds the task to the list running through its css_set if necessary and
4943  * call the subsystem fork() callbacks.  Has to be after the task is
4944  * visible on the task list in case we race with the first call to
4945  * cgroup_task_iter_start() - to guarantee that the new task ends up on its
4946  * list.
4947  */
4948 void cgroup_post_fork(struct task_struct *child)
4949 {
4950         struct cgroup_subsys *ss;
4951         int i;
4952
4953         /*
4954          * This may race against cgroup_enable_task_cg_links().  As that
4955          * function sets use_task_css_set_links before grabbing
4956          * tasklist_lock and we just went through tasklist_lock to add
4957          * @child, it's guaranteed that either we see the set
4958          * use_task_css_set_links or cgroup_enable_task_cg_lists() sees
4959          * @child during its iteration.
4960          *
4961          * If we won the race, @child is associated with %current's
4962          * css_set.  Grabbing css_set_rwsem guarantees both that the
4963          * association is stable, and, on completion of the parent's
4964          * migration, @child is visible in the source of migration or
4965          * already in the destination cgroup.  This guarantee is necessary
4966          * when implementing operations which need to migrate all tasks of
4967          * a cgroup to another.
4968          *
4969          * Note that if we lose to cgroup_enable_task_cg_links(), @child
4970          * will remain in init_css_set.  This is safe because all tasks are
4971          * in the init_css_set before cg_links is enabled and there's no
4972          * operation which transfers all tasks out of init_css_set.
4973          */
4974         if (use_task_css_set_links) {
4975                 struct css_set *cset;
4976
4977                 down_write(&css_set_rwsem);
4978                 cset = task_css_set(current);
4979                 if (list_empty(&child->cg_list)) {
4980                         rcu_assign_pointer(child->cgroups, cset);
4981                         list_add(&child->cg_list, &cset->tasks);
4982                         get_css_set(cset);
4983                 }
4984                 up_write(&css_set_rwsem);
4985         }
4986
4987         /*
4988          * Call ss->fork().  This must happen after @child is linked on
4989          * css_set; otherwise, @child might change state between ->fork()
4990          * and addition to css_set.
4991          */
4992         if (need_forkexit_callback) {
4993                 for_each_subsys(ss, i)
4994                         if (ss->fork)
4995                                 ss->fork(child);
4996         }
4997 }
4998
4999 /**
5000  * cgroup_exit - detach cgroup from exiting task
5001  * @tsk: pointer to task_struct of exiting process
5002  *
5003  * Description: Detach cgroup from @tsk and release it.
5004  *
5005  * Note that cgroups marked notify_on_release force every task in
5006  * them to take the global cgroup_mutex mutex when exiting.
5007  * This could impact scaling on very large systems.  Be reluctant to
5008  * use notify_on_release cgroups where very high task exit scaling
5009  * is required on large systems.
5010  *
5011  * We set the exiting tasks cgroup to the root cgroup (top_cgroup).  We
5012  * call cgroup_exit() while the task is still competent to handle
5013  * notify_on_release(), then leave the task attached to the root cgroup in
5014  * each hierarchy for the remainder of its exit.  No need to bother with
5015  * init_css_set refcnting.  init_css_set never goes away and we can't race
5016  * with migration path - PF_EXITING is visible to migration path.
5017  */
5018 void cgroup_exit(struct task_struct *tsk)
5019 {
5020         struct cgroup_subsys *ss;
5021         struct css_set *cset;
5022         bool put_cset = false;
5023         int i;
5024
5025         /*
5026          * Unlink from @tsk from its css_set.  As migration path can't race
5027          * with us, we can check cg_list without grabbing css_set_rwsem.
5028          */
5029         if (!list_empty(&tsk->cg_list)) {
5030                 down_write(&css_set_rwsem);
5031                 list_del_init(&tsk->cg_list);
5032                 up_write(&css_set_rwsem);
5033                 put_cset = true;
5034         }
5035
5036         /* Reassign the task to the init_css_set. */
5037         cset = task_css_set(tsk);
5038         RCU_INIT_POINTER(tsk->cgroups, &init_css_set);
5039
5040         if (need_forkexit_callback) {
5041                 /* see cgroup_post_fork() for details */
5042                 for_each_subsys(ss, i) {
5043                         if (ss->exit) {
5044                                 struct cgroup_subsys_state *old_css = cset->subsys[i];
5045                                 struct cgroup_subsys_state *css = task_css(tsk, i);
5046
5047                                 ss->exit(css, old_css, tsk);
5048                         }
5049                 }
5050         }
5051
5052         if (put_cset)
5053                 put_css_set(cset, true);
5054 }
5055
5056 static void check_for_release(struct cgroup *cgrp)
5057 {
5058         if (cgroup_is_releasable(cgrp) &&
5059             list_empty(&cgrp->cset_links) && list_empty(&cgrp->children)) {
5060                 /*
5061                  * Control Group is currently removeable. If it's not
5062                  * already queued for a userspace notification, queue
5063                  * it now
5064                  */
5065                 int need_schedule_work = 0;
5066
5067                 raw_spin_lock(&release_list_lock);
5068                 if (!cgroup_is_dead(cgrp) &&
5069                     list_empty(&cgrp->release_list)) {
5070                         list_add(&cgrp->release_list, &release_list);
5071                         need_schedule_work = 1;
5072                 }
5073                 raw_spin_unlock(&release_list_lock);
5074                 if (need_schedule_work)
5075                         schedule_work(&release_agent_work);
5076         }
5077 }
5078
5079 /*
5080  * Notify userspace when a cgroup is released, by running the
5081  * configured release agent with the name of the cgroup (path
5082  * relative to the root of cgroup file system) as the argument.
5083  *
5084  * Most likely, this user command will try to rmdir this cgroup.
5085  *
5086  * This races with the possibility that some other task will be
5087  * attached to this cgroup before it is removed, or that some other
5088  * user task will 'mkdir' a child cgroup of this cgroup.  That's ok.
5089  * The presumed 'rmdir' will fail quietly if this cgroup is no longer
5090  * unused, and this cgroup will be reprieved from its death sentence,
5091  * to continue to serve a useful existence.  Next time it's released,
5092  * we will get notified again, if it still has 'notify_on_release' set.
5093  *
5094  * The final arg to call_usermodehelper() is UMH_WAIT_EXEC, which
5095  * means only wait until the task is successfully execve()'d.  The
5096  * separate release agent task is forked by call_usermodehelper(),
5097  * then control in this thread returns here, without waiting for the
5098  * release agent task.  We don't bother to wait because the caller of
5099  * this routine has no use for the exit status of the release agent
5100  * task, so no sense holding our caller up for that.
5101  */
5102 static void cgroup_release_agent(struct work_struct *work)
5103 {
5104         BUG_ON(work != &release_agent_work);
5105         mutex_lock(&cgroup_mutex);
5106         raw_spin_lock(&release_list_lock);
5107         while (!list_empty(&release_list)) {
5108                 char *argv[3], *envp[3];
5109                 int i;
5110                 char *pathbuf = NULL, *agentbuf = NULL, *path;
5111                 struct cgroup *cgrp = list_entry(release_list.next,
5112                                                     struct cgroup,
5113                                                     release_list);
5114                 list_del_init(&cgrp->release_list);
5115                 raw_spin_unlock(&release_list_lock);
5116                 pathbuf = kmalloc(PATH_MAX, GFP_KERNEL);
5117                 if (!pathbuf)
5118                         goto continue_free;
5119                 path = cgroup_path(cgrp, pathbuf, PATH_MAX);
5120                 if (!path)
5121                         goto continue_free;
5122                 agentbuf = kstrdup(cgrp->root->release_agent_path, GFP_KERNEL);
5123                 if (!agentbuf)
5124                         goto continue_free;
5125
5126                 i = 0;
5127                 argv[i++] = agentbuf;
5128                 argv[i++] = path;
5129                 argv[i] = NULL;
5130
5131                 i = 0;
5132                 /* minimal command environment */
5133                 envp[i++] = "HOME=/";
5134                 envp[i++] = "PATH=/sbin:/bin:/usr/sbin:/usr/bin";
5135                 envp[i] = NULL;
5136
5137                 /* Drop the lock while we invoke the usermode helper,
5138                  * since the exec could involve hitting disk and hence
5139                  * be a slow process */
5140                 mutex_unlock(&cgroup_mutex);
5141                 call_usermodehelper(argv[0], argv, envp, UMH_WAIT_EXEC);
5142                 mutex_lock(&cgroup_mutex);
5143  continue_free:
5144                 kfree(pathbuf);
5145                 kfree(agentbuf);
5146                 raw_spin_lock(&release_list_lock);
5147         }
5148         raw_spin_unlock(&release_list_lock);
5149         mutex_unlock(&cgroup_mutex);
5150 }
5151
5152 static int __init cgroup_disable(char *str)
5153 {
5154         struct cgroup_subsys *ss;
5155         char *token;
5156         int i;
5157
5158         while ((token = strsep(&str, ",")) != NULL) {
5159                 if (!*token)
5160                         continue;
5161
5162                 for_each_subsys(ss, i) {
5163                         if (!strcmp(token, ss->name)) {
5164                                 ss->disabled = 1;
5165                                 printk(KERN_INFO "Disabling %s control group"
5166                                         " subsystem\n", ss->name);
5167                                 break;
5168                         }
5169                 }
5170         }
5171         return 1;
5172 }
5173 __setup("cgroup_disable=", cgroup_disable);
5174
5175 /**
5176  * css_tryget_from_dir - get corresponding css from the dentry of a cgroup dir
5177  * @dentry: directory dentry of interest
5178  * @ss: subsystem of interest
5179  *
5180  * If @dentry is a directory for a cgroup which has @ss enabled on it, try
5181  * to get the corresponding css and return it.  If such css doesn't exist
5182  * or can't be pinned, an ERR_PTR value is returned.
5183  */
5184 struct cgroup_subsys_state *css_tryget_from_dir(struct dentry *dentry,
5185                                                 struct cgroup_subsys *ss)
5186 {
5187         struct kernfs_node *kn = kernfs_node_from_dentry(dentry);
5188         struct cgroup_subsys_state *css = NULL;
5189         struct cgroup *cgrp;
5190
5191         /* is @dentry a cgroup dir? */
5192         if (dentry->d_sb->s_type != &cgroup_fs_type || !kn ||
5193             kernfs_type(kn) != KERNFS_DIR)
5194                 return ERR_PTR(-EBADF);
5195
5196         rcu_read_lock();
5197
5198         /*
5199          * This path doesn't originate from kernfs and @kn could already
5200          * have been or be removed at any point.  @kn->priv is RCU
5201          * protected for this access.  See destroy_locked() for details.
5202          */
5203         cgrp = rcu_dereference(kn->priv);
5204         if (cgrp)
5205                 css = cgroup_css(cgrp, ss);
5206
5207         if (!css || !css_tryget(css))
5208                 css = ERR_PTR(-ENOENT);
5209
5210         rcu_read_unlock();
5211         return css;
5212 }
5213
5214 /**
5215  * css_from_id - lookup css by id
5216  * @id: the cgroup id
5217  * @ss: cgroup subsys to be looked into
5218  *
5219  * Returns the css if there's valid one with @id, otherwise returns NULL.
5220  * Should be called under rcu_read_lock().
5221  */
5222 struct cgroup_subsys_state *css_from_id(int id, struct cgroup_subsys *ss)
5223 {
5224         WARN_ON_ONCE(!rcu_read_lock_held());
5225         return idr_find(&ss->css_idr, id);
5226 }
5227
5228 #ifdef CONFIG_CGROUP_DEBUG
5229 static struct cgroup_subsys_state *
5230 debug_css_alloc(struct cgroup_subsys_state *parent_css)
5231 {
5232         struct cgroup_subsys_state *css = kzalloc(sizeof(*css), GFP_KERNEL);
5233
5234         if (!css)
5235                 return ERR_PTR(-ENOMEM);
5236
5237         return css;
5238 }
5239
5240 static void debug_css_free(struct cgroup_subsys_state *css)
5241 {
5242         kfree(css);
5243 }
5244
5245 static u64 debug_taskcount_read(struct cgroup_subsys_state *css,
5246                                 struct cftype *cft)
5247 {
5248         return cgroup_task_count(css->cgroup);
5249 }
5250
5251 static u64 current_css_set_read(struct cgroup_subsys_state *css,
5252                                 struct cftype *cft)
5253 {
5254         return (u64)(unsigned long)current->cgroups;
5255 }
5256
5257 static u64 current_css_set_refcount_read(struct cgroup_subsys_state *css,
5258                                          struct cftype *cft)
5259 {
5260         u64 count;
5261
5262         rcu_read_lock();
5263         count = atomic_read(&task_css_set(current)->refcount);
5264         rcu_read_unlock();
5265         return count;
5266 }
5267
5268 static int current_css_set_cg_links_read(struct seq_file *seq, void *v)
5269 {
5270         struct cgrp_cset_link *link;
5271         struct css_set *cset;
5272         char *name_buf;
5273
5274         name_buf = kmalloc(NAME_MAX + 1, GFP_KERNEL);
5275         if (!name_buf)
5276                 return -ENOMEM;
5277
5278         down_read(&css_set_rwsem);
5279         rcu_read_lock();
5280         cset = rcu_dereference(current->cgroups);
5281         list_for_each_entry(link, &cset->cgrp_links, cgrp_link) {
5282                 struct cgroup *c = link->cgrp;
5283
5284                 cgroup_name(c, name_buf, NAME_MAX + 1);
5285                 seq_printf(seq, "Root %d group %s\n",
5286                            c->root->hierarchy_id, name_buf);
5287         }
5288         rcu_read_unlock();
5289         up_read(&css_set_rwsem);
5290         kfree(name_buf);
5291         return 0;
5292 }
5293
5294 #define MAX_TASKS_SHOWN_PER_CSS 25
5295 static int cgroup_css_links_read(struct seq_file *seq, void *v)
5296 {
5297         struct cgroup_subsys_state *css = seq_css(seq);
5298         struct cgrp_cset_link *link;
5299
5300         down_read(&css_set_rwsem);
5301         list_for_each_entry(link, &css->cgroup->cset_links, cset_link) {
5302                 struct css_set *cset = link->cset;
5303                 struct task_struct *task;
5304                 int count = 0;
5305
5306                 seq_printf(seq, "css_set %p\n", cset);
5307
5308                 list_for_each_entry(task, &cset->tasks, cg_list) {
5309                         if (count++ > MAX_TASKS_SHOWN_PER_CSS)
5310                                 goto overflow;
5311                         seq_printf(seq, "  task %d\n", task_pid_vnr(task));
5312                 }
5313
5314                 list_for_each_entry(task, &cset->mg_tasks, cg_list) {
5315                         if (count++ > MAX_TASKS_SHOWN_PER_CSS)
5316                                 goto overflow;
5317                         seq_printf(seq, "  task %d\n", task_pid_vnr(task));
5318                 }
5319                 continue;
5320         overflow:
5321                 seq_puts(seq, "  ...\n");
5322         }
5323         up_read(&css_set_rwsem);
5324         return 0;
5325 }
5326
5327 static u64 releasable_read(struct cgroup_subsys_state *css, struct cftype *cft)
5328 {
5329         return test_bit(CGRP_RELEASABLE, &css->cgroup->flags);
5330 }
5331
5332 static struct cftype debug_files[] =  {
5333         {
5334                 .name = "taskcount",
5335                 .read_u64 = debug_taskcount_read,
5336         },
5337
5338         {
5339                 .name = "current_css_set",
5340                 .read_u64 = current_css_set_read,
5341         },
5342
5343         {
5344                 .name = "current_css_set_refcount",
5345                 .read_u64 = current_css_set_refcount_read,
5346         },
5347
5348         {
5349                 .name = "current_css_set_cg_links",
5350                 .seq_show = current_css_set_cg_links_read,
5351         },
5352
5353         {
5354                 .name = "cgroup_css_links",
5355                 .seq_show = cgroup_css_links_read,
5356         },
5357
5358         {
5359                 .name = "releasable",
5360                 .read_u64 = releasable_read,
5361         },
5362
5363         { }     /* terminate */
5364 };
5365
5366 struct cgroup_subsys debug_cgrp_subsys = {
5367         .css_alloc = debug_css_alloc,
5368         .css_free = debug_css_free,
5369         .base_cftypes = debug_files,
5370 };
5371 #endif /* CONFIG_CGROUP_DEBUG */