// SPDX-License-Identifier: GPL-2.0
#ifndef __TRACE_STAT_H
#define __TRACE_STAT_H

#include <linux/seq_file.h>

/*
 * If you want to provide a stat file (one-shot statistics), fill
 * an iterator with stat_start/stat_next and a stat_show callbacks.
 * The others callbacks are optional.
 */
struct tracer_stat {
 /* The name of your stat file */
 const char  *name;
 /* Iteration over statistic entries */
 void   *(*stat_start)(struct tracer_stat *trace);
 void   *(*stat_next)(void *prev, int idx);
 /* Compare two entries for stats sorting */
 cmp_func_t  stat_cmp;
 /* Print a stat entry */
 int   (*stat_show)(struct seq_file *s, void *p);
 /* Release an entry */
 void   (*stat_release)(void *stat);
 /* Print the headers of your stat entries */
 int   (*stat_headers)(struct seq_file *s);
};

/*
 * Destroy or create a stat file
 */
extern int register_stat_tracer(struct tracer_stat *trace);
extern void unregister_stat_tracer(struct tracer_stat *trace);

#endif /* __TRACE_STAT_H */