help.c

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <api/fs/fs.h>
#include <monitor.h>


void common_help(struct help_ctx *ctx, bool enabled, bool cpus, bool pids, bool interval, bool order, bool pages, bool verbose)
{
    struct env *env = ctx->env;

    if (!enabled)
        goto can_be_enabled;

    if (cpus && env->cpumask)
        printf("-C %s ", env->cpumask);
    if (pids && env->pids)
        printf("-p %s ", env->pids);
    if (interval && env->interval)
        printf("-i %d ", env->interval);
    if (order && env->order) {
        if (env->order_mem)
            printf("--order --order-mem %lu ", env->order_mem);
        else
            printf("--order [--order-mem .] ");
    }
    if (pages && env->mmap_pages)
        printf("-m %d ", env->mmap_pages);
    if (verbose && env->verbose)
        printf("-v ");
    return;

can_be_enabled:
    if (cpus && !env->cpumask)
        printf("[-C .] ");
    if (pids && !env->pids)
        printf("[-p .] ");
    if (interval && !env->interval)
        printf("[-i .] ");
    if (order && !env->order)
        printf("[--order] [--order-mem .] ");
    if (pages && !env->mmap_pages)
        printf("[-m .] ");
    if (verbose && !env->verbose)
        printf("[-v] ");
}


static void monitor_help(struct monitor *m, struct help_ctx *ctx)
{
    if (m && m->help)
        m->help(ctx);
}

static void monitors_help(struct help_ctx *ctx)
{
    struct monitor *m = NULL;
    while((m = monitor_next(m))) {
        monitor_help(m, ctx);
    }
}

static void print_events_format(struct help_ctx *ctx)
{
    int i, j;
    char path[256];
    char *format;
    size_t size;

    for (i = 0; i < ctx->nr_list; i++) {
        for (j = 0; j < ctx->tp_list[i]->nr_tp; j++) {
            struct tp *tp = &ctx->tp_list[i]->tp[j];
            printf("%s:%s\n", tp->sys, tp->name);
            snprintf(path, sizeof(path), "kernel/debug/tracing/events/%s/%s/format", tp->sys, tp->name);
            if (sysfs__read_str(path, &format, &size) == 0) {
                write(STDOUT_FILENO, format, size);
                free(format);
            }
            printf("\n");
        }
    }
}

static int help_init(struct perf_evlist *evlist, struct env *env)
{
    struct help_ctx _ctx;
    struct help_ctx *ctx = &_ctx;
    int i;

    ctx->env = env;
    ctx->nr_list = env->nr_events + !!env->tp_alloc + !!env->tp_free;
    if (!ctx->nr_list)
        exit(0);
    ctx->tp_list = calloc(ctx->nr_list, sizeof(*ctx->tp_list));
    if (!ctx->tp_list)
        exit(-1);

    tep__ref();

    for (i = 0; i < env->nr_events; i++) {
        ctx->tp_list[i] = tp_list_new(env->events[i]);
        if (!ctx->tp_list[i]) {
            exit(-1);
        }
    }
    if (env->tp_alloc) {
        ctx->tp_list[i++] = tp_list_new(env->tp_alloc);
        if (!ctx->tp_list[i-1])
            exit(1);
    }
    if (env->tp_free) {
        ctx->tp_list[i++] = tp_list_new(env->tp_free);
        if (!ctx->tp_list[i-1])
            exit(1);
    }

    printf("\n");
    if (env->help_monitor)
        monitor_help(env->help_monitor, ctx);
    else
        monitors_help(ctx);

    printf("\n");
    print_events_format(ctx);

    exit(0);
}

static void help_exit(struct perf_evlist *evlist)
{

}

static const char *help_desc[] = PROFILER_DESC("",
    "[profiler] [PROFILER OPTION...] help",
    "Helps writing profiler commands, event attrs, event filters.", "",
    "SYNOPSIS", "",
    "    Helps writing event attrs, event filters, 'help' can be added anywhere",
    "    in the command, but must be after the profiler.", "",
    "    Profiler can be omitted.", "",
    "EXAMPLES", "",
    "    "PROGRAME" trace -e sched:sched_wakeup help",
    "    "PROGRAME" -e sched:sched_wakeup,sched:sched_switch help");
static const char *help_argv[] = PROFILER_ARGV("help",
    PROFILER_ARGV_PROFILER, "event", "alloc", "free");
static profiler help = {
    .name = "help",
    .desc = help_desc,
    .argv = help_argv,
    .init = help_init,
    .deinit = help_exit,
};
PROFILER_REGISTER(help)