cgroup-internal.h 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. #ifndef __CGROUP_INTERNAL_H
  3. #define __CGROUP_INTERNAL_H
  4. #include <linux/cgroup.h>
  5. #include <linux/kernfs.h>
  6. #include <linux/workqueue.h>
  7. #include <linux/list.h>
  8. #include <linux/refcount.h>
  9. /*
  10. * A cgroup can be associated with multiple css_sets as different tasks may
  11. * belong to different cgroups on different hierarchies. In the other
  12. * direction, a css_set is naturally associated with multiple cgroups.
  13. * This M:N relationship is represented by the following link structure
  14. * which exists for each association and allows traversing the associations
  15. * from both sides.
  16. */
  17. struct cgrp_cset_link {
  18. /* the cgroup and css_set this link associates */
  19. struct cgroup *cgrp;
  20. struct css_set *cset;
  21. /* list of cgrp_cset_links anchored at cgrp->cset_links */
  22. struct list_head cset_link;
  23. /* list of cgrp_cset_links anchored at css_set->cgrp_links */
  24. struct list_head cgrp_link;
  25. };
  26. /* used to track tasks and csets during migration */
  27. struct cgroup_taskset {
  28. /* the src and dst cset list running through cset->mg_node */
  29. struct list_head src_csets;
  30. struct list_head dst_csets;
  31. /* the number of tasks in the set */
  32. int nr_tasks;
  33. /* the subsys currently being processed */
  34. int ssid;
  35. /*
  36. * Fields for cgroup_taskset_*() iteration.
  37. *
  38. * Before migration is committed, the target migration tasks are on
  39. * ->mg_tasks of the csets on ->src_csets. After, on ->mg_tasks of
  40. * the csets on ->dst_csets. ->csets point to either ->src_csets
  41. * or ->dst_csets depending on whether migration is committed.
  42. *
  43. * ->cur_csets and ->cur_task point to the current task position
  44. * during iteration.
  45. */
  46. struct list_head *csets;
  47. struct css_set *cur_cset;
  48. struct task_struct *cur_task;
  49. };
  50. /* migration context also tracks preloading */
  51. struct cgroup_mgctx {
  52. /*
  53. * Preloaded source and destination csets. Used to guarantee
  54. * atomic success or failure on actual migration.
  55. */
  56. struct list_head preloaded_src_csets;
  57. struct list_head preloaded_dst_csets;
  58. /* tasks and csets to migrate */
  59. struct cgroup_taskset tset;
  60. /* subsystems affected by migration */
  61. u16 ss_mask;
  62. };
  63. #define CGROUP_TASKSET_INIT(tset) \
  64. { \
  65. .src_csets = LIST_HEAD_INIT(tset.src_csets), \
  66. .dst_csets = LIST_HEAD_INIT(tset.dst_csets), \
  67. .csets = &tset.src_csets, \
  68. }
  69. #define CGROUP_MGCTX_INIT(name) \
  70. { \
  71. LIST_HEAD_INIT(name.preloaded_src_csets), \
  72. LIST_HEAD_INIT(name.preloaded_dst_csets), \
  73. CGROUP_TASKSET_INIT(name.tset), \
  74. }
  75. #define DEFINE_CGROUP_MGCTX(name) \
  76. struct cgroup_mgctx name = CGROUP_MGCTX_INIT(name)
  77. struct cgroup_sb_opts {
  78. u16 subsys_mask;
  79. unsigned int flags;
  80. char *release_agent;
  81. bool cpuset_clone_children;
  82. char *name;
  83. /* User explicitly requested empty subsystem */
  84. bool none;
  85. };
  86. extern struct mutex cgroup_mutex;
  87. extern spinlock_t css_set_lock;
  88. extern struct cgroup_subsys *cgroup_subsys[];
  89. extern struct list_head cgroup_roots;
  90. extern struct file_system_type cgroup_fs_type;
  91. /* iterate across the hierarchies */
  92. #define for_each_root(root) \
  93. list_for_each_entry((root), &cgroup_roots, root_list)
  94. /**
  95. * for_each_subsys - iterate all enabled cgroup subsystems
  96. * @ss: the iteration cursor
  97. * @ssid: the index of @ss, CGROUP_SUBSYS_COUNT after reaching the end
  98. */
  99. #define for_each_subsys(ss, ssid) \
  100. for ((ssid) = 0; (ssid) < CGROUP_SUBSYS_COUNT && \
  101. (((ss) = cgroup_subsys[ssid]) || true); (ssid)++)
  102. static inline bool cgroup_is_dead(const struct cgroup *cgrp)
  103. {
  104. return !(cgrp->self.flags & CSS_ONLINE);
  105. }
  106. static inline bool notify_on_release(const struct cgroup *cgrp)
  107. {
  108. return test_bit(CGRP_NOTIFY_ON_RELEASE, &cgrp->flags);
  109. }
  110. void put_css_set_locked(struct css_set *cset);
  111. static inline void put_css_set(struct css_set *cset)
  112. {
  113. unsigned long flags;
  114. /*
  115. * Ensure that the refcount doesn't hit zero while any readers
  116. * can see it. Similar to atomic_dec_and_lock(), but for an
  117. * rwlock
  118. */
  119. if (refcount_dec_not_one(&cset->refcount))
  120. return;
  121. spin_lock_irqsave(&css_set_lock, flags);
  122. put_css_set_locked(cset);
  123. spin_unlock_irqrestore(&css_set_lock, flags);
  124. }
  125. /*
  126. * refcounted get/put for css_set objects
  127. */
  128. static inline void get_css_set(struct css_set *cset)
  129. {
  130. refcount_inc(&cset->refcount);
  131. }
  132. bool cgroup_ssid_enabled(int ssid);
  133. bool cgroup_on_dfl(const struct cgroup *cgrp);
  134. bool cgroup_is_thread_root(struct cgroup *cgrp);
  135. bool cgroup_is_threaded(struct cgroup *cgrp);
  136. struct cgroup_root *cgroup_root_from_kf(struct kernfs_root *kf_root);
  137. struct cgroup *task_cgroup_from_root(struct task_struct *task,
  138. struct cgroup_root *root);
  139. struct cgroup *cgroup_kn_lock_live(struct kernfs_node *kn, bool drain_offline);
  140. void cgroup_kn_unlock(struct kernfs_node *kn);
  141. int cgroup_path_ns_locked(struct cgroup *cgrp, char *buf, size_t buflen,
  142. struct cgroup_namespace *ns);
  143. void cgroup_free_root(struct cgroup_root *root);
  144. void init_cgroup_root(struct cgroup_root *root, struct cgroup_sb_opts *opts);
  145. int cgroup_setup_root(struct cgroup_root *root, u16 ss_mask, int ref_flags);
  146. int rebind_subsystems(struct cgroup_root *dst_root, u16 ss_mask);
  147. struct dentry *cgroup_do_mount(struct file_system_type *fs_type, int flags,
  148. struct cgroup_root *root, unsigned long magic,
  149. struct cgroup_namespace *ns);
  150. int cgroup_migrate_vet_dst(struct cgroup *dst_cgrp);
  151. void cgroup_migrate_finish(struct cgroup_mgctx *mgctx);
  152. void cgroup_migrate_add_src(struct css_set *src_cset, struct cgroup *dst_cgrp,
  153. struct cgroup_mgctx *mgctx);
  154. int cgroup_migrate_prepare_dst(struct cgroup_mgctx *mgctx);
  155. int cgroup_migrate(struct task_struct *leader, bool threadgroup,
  156. struct cgroup_mgctx *mgctx);
  157. int cgroup_attach_task(struct cgroup *dst_cgrp, struct task_struct *leader,
  158. bool threadgroup);
  159. struct task_struct *cgroup_procs_write_start(char *buf, bool threadgroup)
  160. __acquires(&cgroup_threadgroup_rwsem);
  161. void cgroup_procs_write_finish(struct task_struct *task)
  162. __releases(&cgroup_threadgroup_rwsem);
  163. void cgroup_lock_and_drain_offline(struct cgroup *cgrp);
  164. int cgroup_mkdir(struct kernfs_node *parent_kn, const char *name, umode_t mode);
  165. int cgroup_rmdir(struct kernfs_node *kn);
  166. int cgroup_show_path(struct seq_file *sf, struct kernfs_node *kf_node,
  167. struct kernfs_root *kf_root);
  168. int cgroup_task_count(const struct cgroup *cgrp);
  169. /*
  170. * namespace.c
  171. */
  172. extern const struct proc_ns_operations cgroupns_operations;
  173. /*
  174. * cgroup-v1.c
  175. */
  176. extern struct cftype cgroup1_base_files[];
  177. extern const struct file_operations proc_cgroupstats_operations;
  178. extern struct kernfs_syscall_ops cgroup1_kf_syscall_ops;
  179. bool cgroup1_ssid_disabled(int ssid);
  180. void cgroup1_pidlist_destroy_all(struct cgroup *cgrp);
  181. void cgroup1_release_agent(struct work_struct *work);
  182. void cgroup1_check_for_release(struct cgroup *cgrp);
  183. struct dentry *cgroup1_mount(struct file_system_type *fs_type, int flags,
  184. void *data, unsigned long magic,
  185. struct cgroup_namespace *ns);
  186. #endif /* __CGROUP_INTERNAL_H */