Re: [PATCH v4 01/14] perf stat: Introduce core generic print traversal engine and header stubs

[Namhyung Kim]

On Thu, Jul 16, 2026 at 12:02:50AM -0700, Ian Rogers wrote:
> This patch introduces the initial infrastructure for decoupling the perf
> stat printing API. It declares the struct perf_stat_print_callbacks
> interface and the core traversal driver perf_stat__print_cb() inside the
> newly created util/stat-print.h and util/stat-print.c files.
> 
> The generic traversal driver perf_stat__print_cb() drive traversing the
> event lists across all supported cpu aggregation modes (global, die,
> socket, cache, cluster, core, thread, none). It implements the clean
> display filtering checks (perf_stat__skip_metric_event(), hybrid
> wildcard merges) and the basic metrics allowlist filter
> (is_basic_shadow_metric()) to keep formatting callbacks decoupled.
> 
> This also introduces two format-agnostic shared helpers to centralize
> aggregation prefix formatting:
> - perf_stat__get_aggr_key(): resolves JSON key names.
> - perf_stat__get_aggr_id_char(): formats unified aggregation identifiers.
> 
> Adds empty format-specific stubs (perf_stat__print_std, _csv, _json) to
> ensure that the new print files link and compile cleanly under
> util/Build, without affecting the legacy print path.
> 
> Signed-off-by: Ian Rogers <irogers@xxxxxxxxxx>
> Assisted-by: Antigravity:gemini-3.5-flash
> Acked-by: Chun-Tse Shao <ctshao@xxxxxxxxxx>
> ---
>  tools/perf/builtin-stat.c         |  96 +++---
>  tools/perf/util/Build             |   4 +
>  tools/perf/util/stat-display.c    |  12 +-
>  tools/perf/util/stat-print-csv.c  |  13 +
>  tools/perf/util/stat-print-json.c |  13 +
>  tools/perf/util/stat-print-std.c  |  13 +
>  tools/perf/util/stat-print.c      | 500 ++++++++++++++++++++++++++++++
>  tools/perf/util/stat-print.h      | 137 ++++++++
>  tools/perf/util/stat.h            |   6 +
>  9 files changed, 744 insertions(+), 50 deletions(-)
>  create mode 100644 tools/perf/util/stat-print-csv.c
>  create mode 100644 tools/perf/util/stat-print-json.c
>  create mode 100644 tools/perf/util/stat-print-std.c
>  create mode 100644 tools/perf/util/stat-print.c
>  create mode 100644 tools/perf/util/stat-print.h
> 
> diff --git a/tools/perf/builtin-stat.c b/tools/perf/builtin-stat.c
> index 3f685beba384..532856f8be90 100644
> --- a/tools/perf/builtin-stat.c
> +++ b/tools/perf/builtin-stat.c
> @@ -40,62 +40,64 @@
>   *   Jaswinder Singh Rajput <jaswinder@xxxxxxxxxx>
>   */
>  
> +#include <errno.h>
> +#include <inttypes.h>
> +#include <locale.h>
> +#include <math.h>
> +#include <signal.h>
> +#include <stdlib.h>
> +
> +#include <linux/ctype.h>
> +#include <linux/err.h>
> +#include <linux/list_sort.h>
> +#include <linux/time64.h>
> +#include <linux/zalloc.h>
> +#include <sys/prctl.h>
> +#include <sys/resource.h>
> +#include <sys/stat.h>
> +#include <sys/time.h>
> +#include <sys/types.h>
> +#include <sys/wait.h>
> +#include <unistd.h>
> +
> +#include <api/fs/fs.h>
> +#include <internal/threadmap.h>
> +#include <perf/evlist.h>
> +#include <subcmd/parse-options.h>
> +
> +#include "asm/bug.h"
>  #include "builtin.h"
> +#include "util/affinity.h"
> +#include "util/bpf_counter.h"
>  #include "util/cgroup.h"
> -#include <subcmd/parse-options.h>
> -#include "util/parse-events.h"
> -#include "util/pmus.h"
> -#include "util/pmu.h"
> -#include "util/tool_pmu.h"
> +#include "util/color.h"
> +#include "util/counts.h"
> +#include "util/cpumap.h"
> +#include "util/debug.h"
>  #include "util/event.h"
>  #include "util/evlist.h"
>  #include "util/evsel.h"
> -#include "util/debug.h"
> -#include "util/color.h"
> -#include "util/stat.h"
>  #include "util/header.h"
> -#include "util/cpumap.h"
> -#include "util/thread_map.h"
> -#include "util/counts.h"
> -#include "util/topdown.h"
> +#include "util/intel-tpebs.h"
> +#include "util/iostat.h"
> +#include "util/metricgroup.h"
> +#include "util/parse-events.h"
> +#include "util/pfm.h"
> +#include "util/pmu.h"
> +#include "util/pmus.h"
>  #include "util/session.h"
> -#include "util/tool.h"
> +#include "util/stat-print.h"
> +#include "util/stat.h"
>  #include "util/string2.h"
> -#include "util/metricgroup.h"
>  #include "util/synthetic-events.h"
>  #include "util/target.h"
> +#include "util/thread_map.h"
>  #include "util/time-utils.h"
> +#include "util/tool.h"
> +#include "util/tool_pmu.h"
>  #include "util/top.h"
> -#include "util/affinity.h"
> -#include "util/pfm.h"
> -#include "util/bpf_counter.h"
> -#include "util/iostat.h"
> +#include "util/topdown.h"
>  #include "util/util.h"
> -#include "util/intel-tpebs.h"
> -#include "asm/bug.h"
> -
> -#include <linux/list_sort.h>
> -#include <linux/time64.h>
> -#include <linux/zalloc.h>
> -#include <api/fs/fs.h>
> -#include <errno.h>
> -#include <signal.h>
> -#include <stdlib.h>
> -#include <sys/prctl.h>
> -#include <inttypes.h>
> -#include <locale.h>
> -#include <math.h>
> -#include <sys/types.h>
> -#include <sys/stat.h>
> -#include <sys/wait.h>
> -#include <unistd.h>
> -#include <sys/time.h>
> -#include <sys/resource.h>
> -#include <linux/err.h>
> -
> -#include <linux/ctype.h>
> -#include <perf/evlist.h>
> -#include <internal/threadmap.h>
>  
>  #ifdef HAVE_BPF_SKEL
>  #include "util/bpf_skel/bperf_cgroup.h"
> @@ -123,6 +125,7 @@ static struct target target;
>  static volatile sig_atomic_t	child_pid			= -1;
>  static int			detailed_run			=  0;
>  static bool			transaction_run;
> +static bool use_perf_stat_print;

Please align.

Thanks,
Namhyung