mm/damon/sysfs: link DAMON for virtual address spaces monitoring
authorSeongJae Park <sj@kernel.org>
Tue, 22 Mar 2022 21:49:30 +0000 (14:49 -0700)
committerLinus Torvalds <torvalds@linux-foundation.org>
Tue, 22 Mar 2022 22:57:13 +0000 (15:57 -0700)
This commit links the DAMON sysfs interface to DAMON so that users can
control DAMON via the interface.  In detail, this commit makes writing
'on' to 'state' file constructs DAMON contexts based on values that users
have written to relevant sysfs files and start the context.  It supports
only virtual address spaces monitoring at the moment, though.

The files hierarchy of DAMON sysfs interface after this commit is shown
below.  In the below figure, parents-children relations are represented
with indentations, each directory is having ``/`` suffix, and files in
each directory are separated by comma (",").

    /sys/kernel/mm/damon/admin
    │ kdamonds/nr_kdamonds
    │ │ 0/state,pid
    │ │ │ contexts/nr_contexts
    │ │ │ │ 0/operations
    │ │ │ │ │ monitoring_attrs/
    │ │ │ │ │ │ intervals/sample_us,aggr_us,update_us
    │ │ │ │ │ │ nr_regions/min,max
    │ │ │ │ │ targets/nr_targets
    │ │ │ │ │ │ 0/pid_target
    │ │ │ │ │ │ ...
    │ │ │ │ ...
    │ │ ...

The usage is straightforward.  Writing a number ('N') to each 'nr_*' file
makes directories named '0' to 'N-1'.  Users can construct DAMON contexts
by writing proper values to the files in the straightforward manner and
start each kdamond by writing 'on' to 'kdamonds/<N>/state'.

Link: https://lkml.kernel.org/r/20220228081314.5770-5-sj@kernel.org
Signed-off-by: SeongJae Park <sj@kernel.org>
Cc: David Rientjes <rientjes@google.com>
Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Shuah Khan <skhan@linuxfoundation.org>
Cc: Xin Hao <xhao@linux.alibaba.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
mm/damon/sysfs.c

index 4455e4bef88dbe2cb1a1daf8b87311982e2b6a54..39b2b8d82819044b1cdc3c42ef13d09d0936ee7b 100644 (file)
@@ -808,22 +808,208 @@ static void damon_sysfs_kdamond_rm_dirs(struct damon_sysfs_kdamond *kdamond)
        kobject_put(&kdamond->contexts->kobj);
 }
 
+static bool damon_sysfs_ctx_running(struct damon_ctx *ctx)
+{
+       bool running;
+
+       mutex_lock(&ctx->kdamond_lock);
+       running = ctx->kdamond != NULL;
+       mutex_unlock(&ctx->kdamond_lock);
+       return running;
+}
+
 static ssize_t state_show(struct kobject *kobj, struct kobj_attribute *attr,
                char *buf)
 {
-       return -EINVAL;
+       struct damon_sysfs_kdamond *kdamond = container_of(kobj,
+                       struct damon_sysfs_kdamond, kobj);
+       struct damon_ctx *ctx = kdamond->damon_ctx;
+       bool running;
+
+       if (!ctx)
+               running = false;
+       else
+               running = damon_sysfs_ctx_running(ctx);
+
+       return sysfs_emit(buf, "%s\n", running ? "on" : "off");
+}
+
+static int damon_sysfs_set_attrs(struct damon_ctx *ctx,
+               struct damon_sysfs_attrs *sys_attrs)
+{
+       struct damon_sysfs_intervals *sys_intervals = sys_attrs->intervals;
+       struct damon_sysfs_ul_range *sys_nr_regions =
+               sys_attrs->nr_regions_range;
+
+       return damon_set_attrs(ctx, sys_intervals->sample_us,
+                       sys_intervals->aggr_us, sys_intervals->update_us,
+                       sys_nr_regions->min, sys_nr_regions->max);
+}
+
+static void damon_sysfs_destroy_targets(struct damon_ctx *ctx)
+{
+       struct damon_target *t, *next;
+
+       damon_for_each_target_safe(t, next, ctx) {
+               if (ctx->ops.id == DAMON_OPS_VADDR)
+                       put_pid(t->pid);
+               damon_destroy_target(t);
+       }
+}
+
+static int damon_sysfs_set_targets(struct damon_ctx *ctx,
+               struct damon_sysfs_targets *sysfs_targets)
+{
+       int i;
+
+       for (i = 0; i < sysfs_targets->nr; i++) {
+               struct damon_sysfs_target *sys_target =
+                       sysfs_targets->targets_arr[i];
+               struct damon_target *t = damon_new_target();
+
+               if (!t) {
+                       damon_sysfs_destroy_targets(ctx);
+                       return -ENOMEM;
+               }
+               if (ctx->ops.id == DAMON_OPS_VADDR) {
+                       t->pid = find_get_pid(sys_target->pid);
+                       if (!t->pid) {
+                               damon_sysfs_destroy_targets(ctx);
+                               return -EINVAL;
+                       }
+               }
+               damon_add_target(ctx, t);
+       }
+       return 0;
+}
+
+static void damon_sysfs_before_terminate(struct damon_ctx *ctx)
+{
+       struct damon_target *t, *next;
+
+       if (ctx->ops.id != DAMON_OPS_VADDR)
+               return;
+
+       mutex_lock(&ctx->kdamond_lock);
+       damon_for_each_target_safe(t, next, ctx) {
+               put_pid(t->pid);
+               damon_destroy_target(t);
+       }
+       mutex_unlock(&ctx->kdamond_lock);
+}
+
+static struct damon_ctx *damon_sysfs_build_ctx(
+               struct damon_sysfs_context *sys_ctx)
+{
+       struct damon_ctx *ctx = damon_new_ctx();
+       int err;
+
+       if (!ctx)
+               return ERR_PTR(-ENOMEM);
+
+       err = damon_select_ops(ctx, sys_ctx->ops_id);
+       if (err)
+               goto out;
+       err = damon_sysfs_set_attrs(ctx, sys_ctx->attrs);
+       if (err)
+               goto out;
+       err = damon_sysfs_set_targets(ctx, sys_ctx->targets);
+       if (err)
+               goto out;
+
+       ctx->callback.before_terminate = damon_sysfs_before_terminate;
+       return ctx;
+
+out:
+       damon_destroy_ctx(ctx);
+       return ERR_PTR(err);
+}
+
+static int damon_sysfs_turn_damon_on(struct damon_sysfs_kdamond *kdamond)
+{
+       struct damon_ctx *ctx;
+       int err;
+
+       if (kdamond->damon_ctx &&
+                       damon_sysfs_ctx_running(kdamond->damon_ctx))
+               return -EBUSY;
+       /* TODO: support multiple contexts per kdamond */
+       if (kdamond->contexts->nr != 1)
+               return -EINVAL;
+
+       if (kdamond->damon_ctx)
+               damon_destroy_ctx(kdamond->damon_ctx);
+       kdamond->damon_ctx = NULL;
+
+       ctx = damon_sysfs_build_ctx(kdamond->contexts->contexts_arr[0]);
+       if (IS_ERR(ctx))
+               return PTR_ERR(ctx);
+       err = damon_start(&ctx, 1, false);
+       if (err) {
+               damon_destroy_ctx(ctx);
+               return err;
+       }
+       kdamond->damon_ctx = ctx;
+       return err;
+}
+
+static int damon_sysfs_turn_damon_off(struct damon_sysfs_kdamond *kdamond)
+{
+       if (!kdamond->damon_ctx)
+               return -EINVAL;
+       return damon_stop(&kdamond->damon_ctx, 1);
+       /*
+        * To allow users show final monitoring results of already turned-off
+        * DAMON, we free kdamond->damon_ctx in next
+        * damon_sysfs_turn_damon_on(), or kdamonds_nr_store()
+        */
 }
 
 static ssize_t state_store(struct kobject *kobj, struct kobj_attribute *attr,
                const char *buf, size_t count)
 {
-       return -EINVAL;
+       struct damon_sysfs_kdamond *kdamond = container_of(kobj,
+                       struct damon_sysfs_kdamond, kobj);
+       ssize_t ret;
+
+       if (!mutex_trylock(&damon_sysfs_lock))
+               return -EBUSY;
+       if (sysfs_streq(buf, "on"))
+               ret = damon_sysfs_turn_damon_on(kdamond);
+       else if (sysfs_streq(buf, "off"))
+               ret = damon_sysfs_turn_damon_off(kdamond);
+       else
+               ret = -EINVAL;
+       mutex_unlock(&damon_sysfs_lock);
+       if (!ret)
+               ret = count;
+       return ret;
 }
 
 static ssize_t pid_show(struct kobject *kobj,
                struct kobj_attribute *attr, char *buf)
 {
-       return -EINVAL;
+       struct damon_sysfs_kdamond *kdamond = container_of(kobj,
+                       struct damon_sysfs_kdamond, kobj);
+       struct damon_ctx *ctx;
+       int pid;
+
+       if (!mutex_trylock(&damon_sysfs_lock))
+               return -EBUSY;
+       ctx = kdamond->damon_ctx;
+       if (!ctx) {
+               pid = -1;
+               goto out;
+       }
+       mutex_lock(&ctx->kdamond_lock);
+       if (!ctx->kdamond)
+               pid = -1;
+       else
+               pid = ctx->kdamond->pid;
+       mutex_unlock(&ctx->kdamond_lock);
+out:
+       mutex_unlock(&damon_sysfs_lock);
+       return sysfs_emit(buf, "%d\n", pid);
 }
 
 static void damon_sysfs_kdamond_release(struct kobject *kobj)