[linux-2.6-block.git] / kernel / trace / trace_probe.h

// SPDX-License-Identifier: GPL-2.0
/*
 * Common header file for probe-based Dynamic events.
 *
 * This code was copied from kernel/trace/trace_kprobe.h written by
 * Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
 *
 * Updates to make this generic:
 * Copyright (C) IBM Corporation, 2010-2011
 * Author:     Srikar Dronamraju
 */

#include <linux/seq_file.h>
#include <linux/slab.h>
#include <linux/smp.h>
#include <linux/tracefs.h>
#include <linux/types.h>
#include <linux/string.h>
#include <linux/ctype.h>
#include <linux/ptrace.h>
#include <linux/perf_event.h>
#include <linux/kprobes.h>
#include <linux/stringify.h>
#include <linux/limits.h>
#include <linux/uaccess.h>
#include <linux/bitops.h>
#include <asm/bitsperlong.h>

#include "trace.h"
#include "trace_output.h"

#define MAX_TRACE_ARGS		128
#define MAX_ARGSTR_LEN		63
#define MAX_ARRAY_LEN		64
#define MAX_ARG_NAME_LEN	32
#define MAX_STRING_SIZE		PATH_MAX

/* Reserved field names */
#define FIELD_STRING_IP		"__probe_ip"
#define FIELD_STRING_RETIP	"__probe_ret_ip"
#define FIELD_STRING_FUNC	"__probe_func"

#undef DEFINE_FIELD
#define DEFINE_FIELD(type, item, name, is_signed)			\
	do {								\
		ret = trace_define_field(event_call, #type, name,	\
					 offsetof(typeof(field), item),	\
					 sizeof(field.item), is_signed, \
					 FILTER_OTHER);			\
		if (ret)						\
			return ret;					\
	} while (0)


/* Flags for trace_probe */
#define TP_FLAG_TRACE		1
#define TP_FLAG_PROFILE		2

/* data_loc: data location, compatible with u32 */
#define make_data_loc(len, offs)	\
	(((u32)(len) << 16) | ((u32)(offs) & 0xffff))
#define get_loc_len(dl)		((u32)(dl) >> 16)
#define get_loc_offs(dl)	((u32)(dl) & 0xffff)

static nokprobe_inline void *get_loc_data(u32 *dl, void *ent)
{
	return (u8 *)ent + get_loc_offs(*dl);
}

static nokprobe_inline u32 update_data_loc(u32 loc, int consumed)
{
	u32 maxlen = get_loc_len(loc);
	u32 offset = get_loc_offs(loc);

	return make_data_loc(maxlen - consumed, offset + consumed);
}

/* Printing function type */
typedef int (*print_type_func_t)(struct trace_seq *, void *, void *);

enum fetch_op {
	FETCH_OP_NOP = 0,
	// Stage 1 (load) ops
	FETCH_OP_REG,		/* Register : .param = offset */
	FETCH_OP_STACK,		/* Stack : .param = index */
	FETCH_OP_STACKP,	/* Stack pointer */
	FETCH_OP_RETVAL,	/* Return value */
	FETCH_OP_IMM,		/* Immediate : .immediate */
	FETCH_OP_COMM,		/* Current comm */
	FETCH_OP_ARG,		/* Function argument : .param */
	FETCH_OP_FOFFS,		/* File offset: .immediate */
	// Stage 2 (dereference) op
	FETCH_OP_DEREF,		/* Dereference: .offset */
	FETCH_OP_UDEREF,	/* User-space Dereference: .offset */
	// Stage 3 (store) ops
	FETCH_OP_ST_RAW,	/* Raw: .size */
	FETCH_OP_ST_MEM,	/* Mem: .offset, .size */
	FETCH_OP_ST_UMEM,	/* Mem: .offset, .size */
	FETCH_OP_ST_STRING,	/* String: .offset, .size */
	FETCH_OP_ST_USTRING,	/* User String: .offset, .size */
	// Stage 4 (modify) op
	FETCH_OP_MOD_BF,	/* Bitfield: .basesize, .lshift, .rshift */
	// Stage 5 (loop) op
	FETCH_OP_LP_ARRAY,	/* Array: .param = loop count */
	FETCH_OP_END,
	FETCH_NOP_SYMBOL,	/* Unresolved Symbol holder */
};

struct fetch_insn {
	enum fetch_op op;
	union {
		unsigned int param;
		struct {
			unsigned int size;
			int offset;
		};
		struct {
			unsigned char basesize;
			unsigned char lshift;
			unsigned char rshift;
		};
		unsigned long immediate;
		void *data;
	};
};

/* fetch + deref*N + store + mod + end <= 16, this allows N=12, enough */
#define FETCH_INSN_MAX	16
#define FETCH_TOKEN_COMM	(-ECOMM)

/* Fetch type information table */
struct fetch_type {
	const char		*name;		/* Name of type */
	size_t			size;		/* Byte size of type */
	int			is_signed;	/* Signed flag */
	print_type_func_t	print;		/* Print functions */
	const char		*fmt;		/* Fromat string */
	const char		*fmttype;	/* Name in format file */
};

/* For defining macros, define string/string_size types */
typedef u32 string;
typedef u32 string_size;

#define PRINT_TYPE_FUNC_NAME(type)	print_type_##type
#define PRINT_TYPE_FMT_NAME(type)	print_type_format_##type

/* Printing  in basic type function template */
#define DECLARE_BASIC_PRINT_TYPE_FUNC(type)				\
int PRINT_TYPE_FUNC_NAME(type)(struct trace_seq *s, void *data, void *ent);\
extern const char PRINT_TYPE_FMT_NAME(type)[]

DECLARE_BASIC_PRINT_TYPE_FUNC(u8);
DECLARE_BASIC_PRINT_TYPE_FUNC(u16);
DECLARE_BASIC_PRINT_TYPE_FUNC(u32);
DECLARE_BASIC_PRINT_TYPE_FUNC(u64);
DECLARE_BASIC_PRINT_TYPE_FUNC(s8);
DECLARE_BASIC_PRINT_TYPE_FUNC(s16);
DECLARE_BASIC_PRINT_TYPE_FUNC(s32);
DECLARE_BASIC_PRINT_TYPE_FUNC(s64);
DECLARE_BASIC_PRINT_TYPE_FUNC(x8);
DECLARE_BASIC_PRINT_TYPE_FUNC(x16);
DECLARE_BASIC_PRINT_TYPE_FUNC(x32);
DECLARE_BASIC_PRINT_TYPE_FUNC(x64);

DECLARE_BASIC_PRINT_TYPE_FUNC(string);
DECLARE_BASIC_PRINT_TYPE_FUNC(symbol);

/* Default (unsigned long) fetch type */
#define __DEFAULT_FETCH_TYPE(t) x##t
#define _DEFAULT_FETCH_TYPE(t) __DEFAULT_FETCH_TYPE(t)
#define DEFAULT_FETCH_TYPE _DEFAULT_FETCH_TYPE(BITS_PER_LONG)
#define DEFAULT_FETCH_TYPE_STR __stringify(DEFAULT_FETCH_TYPE)

#define __ADDR_FETCH_TYPE(t) u##t
#define _ADDR_FETCH_TYPE(t) __ADDR_FETCH_TYPE(t)
#define ADDR_FETCH_TYPE _ADDR_FETCH_TYPE(BITS_PER_LONG)

#define __ASSIGN_FETCH_TYPE(_name, ptype, ftype, _size, sign, _fmttype)	\
	{.name = _name,				\
	 .size = _size,					\
	 .is_signed = sign,				\
	 .print = PRINT_TYPE_FUNC_NAME(ptype),		\
	 .fmt = PRINT_TYPE_FMT_NAME(ptype),		\
	 .fmttype = _fmttype,				\
	}
#define _ASSIGN_FETCH_TYPE(_name, ptype, ftype, _size, sign, _fmttype)	\
	__ASSIGN_FETCH_TYPE(_name, ptype, ftype, _size, sign, #_fmttype)
#define ASSIGN_FETCH_TYPE(ptype, ftype, sign)			\
	_ASSIGN_FETCH_TYPE(#ptype, ptype, ftype, sizeof(ftype), sign, ptype)

/* If ptype is an alias of atype, use this macro (show atype in format) */
#define ASSIGN_FETCH_TYPE_ALIAS(ptype, atype, ftype, sign)		\
	_ASSIGN_FETCH_TYPE(#ptype, ptype, ftype, sizeof(ftype), sign, atype)

#define ASSIGN_FETCH_TYPE_END {}
#define MAX_ARRAY_LEN	64

#ifdef CONFIG_KPROBE_EVENTS
bool trace_kprobe_on_func_entry(struct trace_event_call *call);
bool trace_kprobe_error_injectable(struct trace_event_call *call);
#else
static inline bool trace_kprobe_on_func_entry(struct trace_event_call *call)
{
	return false;
}

static inline bool trace_kprobe_error_injectable(struct trace_event_call *call)
{
	return false;
}
#endif /* CONFIG_KPROBE_EVENTS */

struct probe_arg {
	struct fetch_insn	*code;
	bool			dynamic;/* Dynamic array (string) is used */
	unsigned int		offset;	/* Offset from argument entry */
	unsigned int		count;	/* Array count */
	const char		*name;	/* Name of this argument */
	const char		*comm;	/* Command of this argument */
	char			*fmt;	/* Format string if needed */
	const struct fetch_type	*type;	/* Type of this argument */
};

struct trace_probe {
	unsigned int			flags;	/* For TP_FLAG_* */
	struct trace_event_class	class;
	struct trace_event_call		call;
	struct list_head 		files;
	ssize_t				size;	/* trace entry size */
	unsigned int			nr_args;
	struct probe_arg		args[];
};

struct event_file_link {
	struct trace_event_file		*file;
	struct list_head		list;
};

static inline bool trace_probe_test_flag(struct trace_probe *tp,
					 unsigned int flag)
{
	return !!(tp->flags & flag);
}

static inline void trace_probe_set_flag(struct trace_probe *tp,
					unsigned int flag)
{
	tp->flags |= flag;
}

static inline void trace_probe_clear_flag(struct trace_probe *tp,
					  unsigned int flag)
{
	tp->flags &= ~flag;
}

static inline bool trace_probe_is_enabled(struct trace_probe *tp)
{
	return trace_probe_test_flag(tp, TP_FLAG_TRACE | TP_FLAG_PROFILE);
}

static inline const char *trace_probe_name(struct trace_probe *tp)
{
	return trace_event_name(&tp->call);
}

static inline const char *trace_probe_group_name(struct trace_probe *tp)
{
	return tp->call.class->system;
}

static inline struct trace_event_call *
	trace_probe_event_call(struct trace_probe *tp)
{
	return &tp->call;
}

static inline int trace_probe_unregister_event_call(struct trace_probe *tp)
{
	/* tp->event is unregistered in trace_remove_event_call() */
	return trace_remove_event_call(&tp->call);
}

static inline bool trace_probe_has_single_file(struct trace_probe *tp)
{
	return !!list_is_singular(&tp->files);
}

int trace_probe_init(struct trace_probe *tp, const char *event,
		     const char *group);
void trace_probe_cleanup(struct trace_probe *tp);
int trace_probe_register_event_call(struct trace_probe *tp);
int trace_probe_add_file(struct trace_probe *tp, struct trace_event_file *file);
int trace_probe_remove_file(struct trace_probe *tp,
			    struct trace_event_file *file);
struct event_file_link *trace_probe_get_file_link(struct trace_probe *tp,
						struct trace_event_file *file);

#define trace_probe_for_each_link(pos, tp)	\
	list_for_each_entry(pos, &(tp)->files, list)
#define trace_probe_for_each_link_rcu(pos, tp)	\
	list_for_each_entry_rcu(pos, &(tp)->files, list)

/* Check the name is good for event/group/fields */
static inline bool is_good_name(const char *name)
{
	if (!isalpha(*name) && *name != '_')
		return false;
	while (*++name != '\0') {
		if (!isalpha(*name) && !isdigit(*name) && *name != '_')
			return false;
	}
	return true;
}

#define TPARG_FL_RETURN BIT(0)
#define TPARG_FL_KERNEL BIT(1)
#define TPARG_FL_FENTRY BIT(2)
#define TPARG_FL_MASK	GENMASK(2, 0)

extern int traceprobe_parse_probe_arg(struct trace_probe *tp, int i,
				char *arg, unsigned int flags);

extern int traceprobe_update_arg(struct probe_arg *arg);
extern void traceprobe_free_probe_arg(struct probe_arg *arg);

extern int traceprobe_split_symbol_offset(char *symbol, long *offset);
int traceprobe_parse_event_name(const char **pevent, const char **pgroup,
				char *buf, int offset);

extern int traceprobe_set_print_fmt(struct trace_probe *tp, bool is_return);

#ifdef CONFIG_PERF_EVENTS
extern struct trace_event_call *
create_local_trace_kprobe(char *func, void *addr, unsigned long offs,
			  bool is_return);
extern void destroy_local_trace_kprobe(struct trace_event_call *event_call);

extern struct trace_event_call *
create_local_trace_uprobe(char *name, unsigned long offs,
			  unsigned long ref_ctr_offset, bool is_return);
extern void destroy_local_trace_uprobe(struct trace_event_call *event_call);
#endif
extern int traceprobe_define_arg_fields(struct trace_event_call *event_call,
					size_t offset, struct trace_probe *tp);

#undef ERRORS
#define ERRORS	\
	C(FILE_NOT_FOUND,	"Failed to find the given file"),	\
	C(NO_REGULAR_FILE,	"Not a regular file"),			\
	C(BAD_REFCNT,		"Invalid reference counter offset"),	\
	C(REFCNT_OPEN_BRACE,	"Reference counter brace is not closed"), \
	C(BAD_REFCNT_SUFFIX,	"Reference counter has wrong suffix"),	\
	C(BAD_UPROBE_OFFS,	"Invalid uprobe offset"),		\
	C(MAXACT_NO_KPROBE,	"Maxactive is not for kprobe"),		\
	C(BAD_MAXACT,		"Invalid maxactive number"),		\
	C(MAXACT_TOO_BIG,	"Maxactive is too big"),		\
	C(BAD_PROBE_ADDR,	"Invalid probed address or symbol"),	\
	C(BAD_RETPROBE,		"Retprobe address must be an function entry"), \
	C(NO_GROUP_NAME,	"Group name is not specified"),		\
	C(GROUP_TOO_LONG,	"Group name is too long"),		\
	C(BAD_GROUP_NAME,	"Group name must follow the same rules as C identifiers"), \
	C(NO_EVENT_NAME,	"Event name is not specified"),		\
	C(EVENT_TOO_LONG,	"Event name is too long"),		\
	C(BAD_EVENT_NAME,	"Event name must follow the same rules as C identifiers"), \
	C(RETVAL_ON_PROBE,	"$retval is not available on probe"),	\
	C(BAD_STACK_NUM,	"Invalid stack number"),		\
	C(BAD_ARG_NUM,		"Invalid argument number"),		\
	C(BAD_VAR,		"Invalid $-valiable specified"),	\
	C(BAD_REG_NAME,		"Invalid register name"),		\
	C(BAD_MEM_ADDR,		"Invalid memory address"),		\
	C(FILE_ON_KPROBE,	"File offset is not available with kprobe"), \
	C(BAD_FILE_OFFS,	"Invalid file offset value"),		\
	C(SYM_ON_UPROBE,	"Symbol is not available with uprobe"),	\
	C(TOO_MANY_OPS,		"Dereference is too much nested"), 	\
	C(DEREF_NEED_BRACE,	"Dereference needs a brace"),		\
	C(BAD_DEREF_OFFS,	"Invalid dereference offset"),		\
	C(DEREF_OPEN_BRACE,	"Dereference brace is not closed"),	\
	C(COMM_CANT_DEREF,	"$comm can not be dereferenced"),	\
	C(BAD_FETCH_ARG,	"Invalid fetch argument"),		\
	C(ARRAY_NO_CLOSE,	"Array is not closed"),			\
	C(BAD_ARRAY_SUFFIX,	"Array has wrong suffix"),		\
	C(BAD_ARRAY_NUM,	"Invalid array size"),			\
	C(ARRAY_TOO_BIG,	"Array number is too big"),		\
	C(BAD_TYPE,		"Unknown type is specified"),		\
	C(BAD_STRING,		"String accepts only memory argument"),	\
	C(BAD_BITFIELD,		"Invalid bitfield"),			\
	C(ARG_NAME_TOO_LONG,	"Argument name is too long"),		\
	C(NO_ARG_NAME,		"Argument name is not specified"),	\
	C(BAD_ARG_NAME,		"Argument name must follow the same rules as C identifiers"), \
	C(USED_ARG_NAME,	"This argument name is already used"),	\
	C(ARG_TOO_LONG,		"Argument expression is too long"),	\
	C(NO_ARG_BODY,		"No argument expression"),		\
	C(BAD_INSN_BNDRY,	"Probe point is not an instruction boundary"),\
	C(FAIL_REG_PROBE,	"Failed to register probe event"),

#undef C
#define C(a, b)		TP_ERR_##a

/* Define TP_ERR_ */
enum { ERRORS };

/* Error text is defined in trace_probe.c */

struct trace_probe_log {
	const char	*subsystem;
	const char	**argv;
	int		argc;
	int		index;
};

void trace_probe_log_init(const char *subsystem, int argc, const char **argv);
void trace_probe_log_set_index(int index);
void trace_probe_log_clear(void);
void __trace_probe_log_err(int offset, int err);

#define trace_probe_log_err(offs, err)	\
	__trace_probe_log_err(offs, TP_ERR_##err)
Commit	Line	Data
bcea3f96	1	// SPDX-License-Identifier: GPL-2.0
8ab83f56 SD	2	/*
	3	* Common header file for probe-based Dynamic events.
	4	*
8ab83f56 SD	5	* This code was copied from kernel/trace/trace_kprobe.h written by
	6	* Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
	7	*
	8	* Updates to make this generic:
	9	* Copyright (C) IBM Corporation, 2010-2011
	10	* Author: Srikar Dronamraju
	11	*/
	12
	13	#include <linux/seq_file.h>
	14	#include <linux/slab.h>
	15	#include <linux/smp.h>
8434dc93	16	#include <linux/tracefs.h>
8ab83f56 SD	17	#include <linux/types.h>
	18	#include <linux/string.h>
	19	#include <linux/ctype.h>
	20	#include <linux/ptrace.h>
	21	#include <linux/perf_event.h>
	22	#include <linux/kprobes.h>
	23	#include <linux/stringify.h>
	24	#include <linux/limits.h>
	25	#include <linux/uaccess.h>
a1303af5	26	#include <linux/bitops.h>
8ab83f56 SD	27	#include <asm/bitsperlong.h>
	28
	29	#include "trace.h"
	30	#include "trace_output.h"
	31
	32	#define MAX_TRACE_ARGS 128
	33	#define MAX_ARGSTR_LEN 63
40b53b77	34	#define MAX_ARRAY_LEN 64
b4443c17	35	#define MAX_ARG_NAME_LEN 32
8ab83f56 SD	36	#define MAX_STRING_SIZE PATH_MAX
	37
	38	/* Reserved field names */
	39	#define FIELD_STRING_IP "__probe_ip"
	40	#define FIELD_STRING_RETIP "__probe_ret_ip"
	41	#define FIELD_STRING_FUNC "__probe_func"
	42
	43	#undef DEFINE_FIELD
	44	#define DEFINE_FIELD(type, item, name, is_signed) \
	45	do { \
	46	ret = trace_define_field(event_call, #type, name, \
	47	offsetof(typeof(field), item), \
	48	sizeof(field.item), is_signed, \
	49	FILTER_OTHER); \
	50	if (ret) \
	51	return ret; \
	52	} while (0)
	53
	54
	55	/* Flags for trace_probe */
	56	#define TP_FLAG_TRACE 1
	57	#define TP_FLAG_PROFILE 2
8ab83f56	58
9178412d MH	59	/* data_loc: data location, compatible with u32 */
	60	#define make_data_loc(len, offs) \
	61	(((u32)(len) << 16) \| ((u32)(offs) & 0xffff))
	62	#define get_loc_len(dl) ((u32)(dl) >> 16)
	63	#define get_loc_offs(dl) ((u32)(dl) & 0xffff)
8ab83f56	64
3da0f180	65	static nokprobe_inline void get_loc_data(u32 dl, void *ent)
b26c74e1	66	{
9178412d	67	return (u8 )ent + get_loc_offs(dl);
b26c74e1 NK	68	}
b26c74e1 NK	69
40b53b77 MH	70	static nokprobe_inline u32 update_data_loc(u32 loc, int consumed)
	71	{
	72	u32 maxlen = get_loc_len(loc);
	73	u32 offset = get_loc_offs(loc);
	74
	75	return make_data_loc(maxlen - consumed, offset + consumed);
	76	}
	77
8ab83f56	78	/* Printing function type */
56de7630	79	typedef int (print_type_func_t)(struct trace_seq , void , void );
8ab83f56	80
53305928 MH	81	enum fetch_op {
	82	FETCH_OP_NOP = 0,
	83	// Stage 1 (load) ops
	84	FETCH_OP_REG, /* Register : .param = offset */
	85	FETCH_OP_STACK, /* Stack : .param = index */
	86	FETCH_OP_STACKP, /* Stack pointer */
	87	FETCH_OP_RETVAL, /* Return value */
	88	FETCH_OP_IMM, /* Immediate : .immediate */
	89	FETCH_OP_COMM, /* Current comm */
a1303af5	90	FETCH_OP_ARG, /* Function argument : .param */
53305928 MH	91	FETCH_OP_FOFFS, /* File offset: .immediate */
	92	// Stage 2 (dereference) op
	93	FETCH_OP_DEREF, /* Dereference: .offset */
e65f7ae7	94	FETCH_OP_UDEREF, /* User-space Dereference: .offset */
53305928 MH	95	// Stage 3 (store) ops
	96	FETCH_OP_ST_RAW, /* Raw: .size */
	97	FETCH_OP_ST_MEM, /* Mem: .offset, .size */
e65f7ae7	98	FETCH_OP_ST_UMEM, /* Mem: .offset, .size */
53305928	99	FETCH_OP_ST_STRING, /* String: .offset, .size */
88903c46	100	FETCH_OP_ST_USTRING, /* User String: .offset, .size */
53305928 MH	101	// Stage 4 (modify) op
53305928 MH	102	FETCH_OP_MOD_BF, /* Bitfield: .basesize, .lshift, .rshift */
40b53b77 MH	103	// Stage 5 (loop) op
40b53b77 MH	104	FETCH_OP_LP_ARRAY, /* Array: .param = loop count */
53305928	105	FETCH_OP_END,
a6682814	106	FETCH_NOP_SYMBOL, /* Unresolved Symbol holder */
8ab83f56 SD	107	};
8ab83f56 SD	108
53305928 MH	109	struct fetch_insn {
	110	enum fetch_op op;
	111	union {
	112	unsigned int param;
	113	struct {
	114	unsigned int size;
	115	int offset;
	116	};
	117	struct {
	118	unsigned char basesize;
	119	unsigned char lshift;
	120	unsigned char rshift;
	121	};
	122	unsigned long immediate;
a6682814	123	void *data;
53305928 MH	124	};
	125	};
	126
	127	/* fetch + derefN + store + mod + end <= 16, this allows N=12, enough /
	128	#define FETCH_INSN_MAX 16
4dd537ac	129	#define FETCH_TOKEN_COMM (-ECOMM)
53305928	130
8ab83f56 SD	131	/* Fetch type information table */
	132	struct fetch_type {
	133	const char name; / Name of type */
	134	size_t size; /* Byte size of type */
	135	int is_signed; /* Signed flag */
	136	print_type_func_t print; /* Print functions */
	137	const char fmt; / Fromat string */
	138	const char fmttype; / Name in format file */
8ab83f56 SD	139	};
8ab83f56 SD	140
34fee3a1 NK	141	/* For defining macros, define string/string_size types */
	142	typedef u32 string;
	143	typedef u32 string_size;
	144
b26c74e1 NK	145	#define PRINT_TYPE_FUNC_NAME(type) print_type_##type
	146	#define PRINT_TYPE_FMT_NAME(type) print_type_format_##type
	147
	148	/* Printing in basic type function template */
	149	#define DECLARE_BASIC_PRINT_TYPE_FUNC(type) \
56de7630	150	int PRINT_TYPE_FUNC_NAME(type)(struct trace_seq s, void data, void *ent);\
b26c74e1 NK	151	extern const char PRINT_TYPE_FMT_NAME(type)[]
	152
	153	DECLARE_BASIC_PRINT_TYPE_FUNC(u8);
	154	DECLARE_BASIC_PRINT_TYPE_FUNC(u16);
	155	DECLARE_BASIC_PRINT_TYPE_FUNC(u32);
	156	DECLARE_BASIC_PRINT_TYPE_FUNC(u64);
	157	DECLARE_BASIC_PRINT_TYPE_FUNC(s8);
	158	DECLARE_BASIC_PRINT_TYPE_FUNC(s16);
	159	DECLARE_BASIC_PRINT_TYPE_FUNC(s32);
	160	DECLARE_BASIC_PRINT_TYPE_FUNC(s64);
17ce3dc7 MH	161	DECLARE_BASIC_PRINT_TYPE_FUNC(x8);
	162	DECLARE_BASIC_PRINT_TYPE_FUNC(x16);
	163	DECLARE_BASIC_PRINT_TYPE_FUNC(x32);
	164	DECLARE_BASIC_PRINT_TYPE_FUNC(x64);
	165
b26c74e1	166	DECLARE_BASIC_PRINT_TYPE_FUNC(string);
60c2e0ce	167	DECLARE_BASIC_PRINT_TYPE_FUNC(symbol);
b26c74e1 NK	168
b26c74e1 NK	169	/* Default (unsigned long) fetch type */
bdca79c2	170	#define __DEFAULT_FETCH_TYPE(t) x##t
b26c74e1 NK	171	#define _DEFAULT_FETCH_TYPE(t) __DEFAULT_FETCH_TYPE(t)
	172	#define DEFAULT_FETCH_TYPE _DEFAULT_FETCH_TYPE(BITS_PER_LONG)
	173	#define DEFAULT_FETCH_TYPE_STR __stringify(DEFAULT_FETCH_TYPE)
	174
60c2e0ce MH	175	#define __ADDR_FETCH_TYPE(t) u##t
	176	#define _ADDR_FETCH_TYPE(t) __ADDR_FETCH_TYPE(t)
	177	#define ADDR_FETCH_TYPE _ADDR_FETCH_TYPE(BITS_PER_LONG)
	178
b26c74e1 NK	179	#define __ASSIGN_FETCH_TYPE(_name, ptype, ftype, _size, sign, _fmttype) \
	180	{.name = _name, \
	181	.size = _size, \
	182	.is_signed = sign, \
	183	.print = PRINT_TYPE_FUNC_NAME(ptype), \
	184	.fmt = PRINT_TYPE_FMT_NAME(ptype), \
	185	.fmttype = _fmttype, \
b26c74e1	186	}
60c2e0ce MH	187	#define _ASSIGN_FETCH_TYPE(_name, ptype, ftype, _size, sign, _fmttype) \
60c2e0ce MH	188	__ASSIGN_FETCH_TYPE(_name, ptype, ftype, _size, sign, #_fmttype)
b26c74e1	189	#define ASSIGN_FETCH_TYPE(ptype, ftype, sign) \
60c2e0ce	190	_ASSIGN_FETCH_TYPE(#ptype, ptype, ftype, sizeof(ftype), sign, ptype)
b26c74e1	191
17ce3dc7 MH	192	/* If ptype is an alias of atype, use this macro (show atype in format) */
17ce3dc7 MH	193	#define ASSIGN_FETCH_TYPE_ALIAS(ptype, atype, ftype, sign) \
60c2e0ce	194	_ASSIGN_FETCH_TYPE(#ptype, ptype, ftype, sizeof(ftype), sign, atype)
17ce3dc7	195
34fee3a1	196	#define ASSIGN_FETCH_TYPE_END {}
40b53b77	197	#define MAX_ARRAY_LEN 64
34fee3a1	198
6b0b7551	199	#ifdef CONFIG_KPROBE_EVENTS
b4da3340 MH	200	bool trace_kprobe_on_func_entry(struct trace_event_call *call);
b4da3340 MH	201	bool trace_kprobe_error_injectable(struct trace_event_call *call);
1301a44e	202	#else
b4da3340	203	static inline bool trace_kprobe_on_func_entry(struct trace_event_call *call)
9802d865	204	{
b4da3340	205	return false;
9802d865 JB	206	}
9802d865 JB	207
b4da3340	208	static inline bool trace_kprobe_error_injectable(struct trace_event_call *call)
9802d865	209	{
b4da3340	210	return false;
9802d865	211	}
6b0b7551	212	#endif /* CONFIG_KPROBE_EVENTS */
1301a44e	213
8ab83f56	214	struct probe_arg {
53305928 MH	215	struct fetch_insn *code;
53305928 MH	216	bool dynamic;/* Dynamic array (string) is used */
8ab83f56	217	unsigned int offset; /* Offset from argument entry */
40b53b77	218	unsigned int count; /* Array count */
8ab83f56 SD	219	const char name; / Name of this argument */
8ab83f56 SD	220	const char comm; / Command of this argument */
40b53b77	221	char fmt; / Format string if needed */
8ab83f56 SD	222	const struct fetch_type type; / Type of this argument */
	223	};
	224
c31ffb3f NK	225	struct trace_probe {
c31ffb3f NK	226	unsigned int flags; /* For TP_FLAG_* */
2425bcb9 SRRH	227	struct trace_event_class class;
2425bcb9 SRRH	228	struct trace_event_call call;
c31ffb3f NK	229	struct list_head files;
	230	ssize_t size; /* trace entry size */
	231	unsigned int nr_args;
	232	struct probe_arg args[];
	233	};
	234
70ed91c6	235	struct event_file_link {
7f1d2f82	236	struct trace_event_file *file;
70ed91c6 J	237	struct list_head list;
	238	};
	239
747774d6 MH	240	static inline bool trace_probe_test_flag(struct trace_probe *tp,
	241	unsigned int flag)
	242	{
	243	return !!(tp->flags & flag);
	244	}
	245
	246	static inline void trace_probe_set_flag(struct trace_probe *tp,
	247	unsigned int flag)
	248	{
	249	tp->flags \|= flag;
	250	}
	251
	252	static inline void trace_probe_clear_flag(struct trace_probe *tp,
	253	unsigned int flag)
	254	{
	255	tp->flags &= ~flag;
	256	}
	257
c31ffb3f NK	258	static inline bool trace_probe_is_enabled(struct trace_probe *tp)
c31ffb3f NK	259	{
747774d6	260	return trace_probe_test_flag(tp, TP_FLAG_TRACE \| TP_FLAG_PROFILE);
c31ffb3f NK	261	}
c31ffb3f NK	262
b55ce203 MH	263	static inline const char trace_probe_name(struct trace_probe tp)
	264	{
	265	return trace_event_name(&tp->call);
	266	}
	267
	268	static inline const char trace_probe_group_name(struct trace_probe tp)
	269	{
	270	return tp->call.class->system;
	271	}
	272
e3dc9f89 MH	273	static inline struct trace_event_call *
	274	trace_probe_event_call(struct trace_probe *tp)
	275	{
	276	return &tp->call;
	277	}
	278
46e5376d MH	279	static inline int trace_probe_unregister_event_call(struct trace_probe *tp)
	280	{
	281	/* tp->event is unregistered in trace_remove_event_call() */
	282	return trace_remove_event_call(&tp->call);
	283	}
455b2899	284
b5f935ee MH	285	static inline bool trace_probe_has_single_file(struct trace_probe *tp)
	286	{
	287	return !!list_is_singular(&tp->files);
	288	}
	289
	290	int trace_probe_init(struct trace_probe tp, const char event,
	291	const char *group);
	292	void trace_probe_cleanup(struct trace_probe *tp);
	293	int trace_probe_register_event_call(struct trace_probe *tp);
	294	int trace_probe_add_file(struct trace_probe tp, struct trace_event_file file);
	295	int trace_probe_remove_file(struct trace_probe *tp,
	296	struct trace_event_file *file);
	297	struct event_file_link trace_probe_get_file_link(struct trace_probe tp,
	298	struct trace_event_file *file);
	299
	300	#define trace_probe_for_each_link(pos, tp) \
	301	list_for_each_entry(pos, &(tp)->files, list)
	302	#define trace_probe_for_each_link_rcu(pos, tp) \
	303	list_for_each_entry_rcu(pos, &(tp)->files, list)
	304
8ab83f56	305	/* Check the name is good for event/group/fields */
f0132c4e	306	static inline bool is_good_name(const char *name)
8ab83f56 SD	307	{
8ab83f56 SD	308	if (!isalpha(name) && name != '_')
f0132c4e	309	return false;
8ab83f56 SD	310	while (*++name != '\0') {
8ab83f56 SD	311	if (!isalpha(name) && !isdigit(name) && *name != '_')
f0132c4e	312	return false;
8ab83f56	313	}
f0132c4e	314	return true;
8ab83f56 SD	315	}
8ab83f56 SD	316
a1303af5 MH	317	#define TPARG_FL_RETURN BIT(0)
	318	#define TPARG_FL_KERNEL BIT(1)
	319	#define TPARG_FL_FENTRY BIT(2)
	320	#define TPARG_FL_MASK GENMASK(2, 0)
	321
d00bbea9 MH	322	extern int traceprobe_parse_probe_arg(struct trace_probe *tp, int i,
d00bbea9 MH	323	char *arg, unsigned int flags);
8ab83f56	324
a6682814	325	extern int traceprobe_update_arg(struct probe_arg *arg);
8ab83f56 SD	326	extern void traceprobe_free_probe_arg(struct probe_arg *arg);
8ab83f56 SD	327
c5d343b6	328	extern int traceprobe_split_symbol_offset(char symbol, long offset);
ab105a4f MH	329	int traceprobe_parse_event_name(const char pevent, const char pgroup,
ab105a4f MH	330	char *buf, int offset);
8ab83f56	331
0a46c854	332	extern int traceprobe_set_print_fmt(struct trace_probe *tp, bool is_return);
e12f03d7 SL	333
	334	#ifdef CONFIG_PERF_EVENTS
	335	extern struct trace_event_call *
	336	create_local_trace_kprobe(char func, void addr, unsigned long offs,
	337	bool is_return);
	338	extern void destroy_local_trace_kprobe(struct trace_event_call *event_call);
33ea4b24 SL	339
33ea4b24 SL	340	extern struct trace_event_call *
a6ca88b2 SL	341	create_local_trace_uprobe(char *name, unsigned long offs,
a6ca88b2 SL	342	unsigned long ref_ctr_offset, bool is_return);
33ea4b24	343	extern void destroy_local_trace_uprobe(struct trace_event_call *event_call);
e12f03d7	344	#endif
eeb07b06 MH	345	extern int traceprobe_define_arg_fields(struct trace_event_call *event_call,
eeb07b06 MH	346	size_t offset, struct trace_probe *tp);
ab105a4f MH	347
	348	#undef ERRORS
	349	#define ERRORS \
	350	C(FILE_NOT_FOUND, "Failed to find the given file"), \
	351	C(NO_REGULAR_FILE, "Not a regular file"), \
	352	C(BAD_REFCNT, "Invalid reference counter offset"), \
	353	C(REFCNT_OPEN_BRACE, "Reference counter brace is not closed"), \
	354	C(BAD_REFCNT_SUFFIX, "Reference counter has wrong suffix"), \
	355	C(BAD_UPROBE_OFFS, "Invalid uprobe offset"), \
	356	C(MAXACT_NO_KPROBE, "Maxactive is not for kprobe"), \
	357	C(BAD_MAXACT, "Invalid maxactive number"), \
	358	C(MAXACT_TOO_BIG, "Maxactive is too big"), \
	359	C(BAD_PROBE_ADDR, "Invalid probed address or symbol"), \
	360	C(BAD_RETPROBE, "Retprobe address must be an function entry"), \
	361	C(NO_GROUP_NAME, "Group name is not specified"), \
	362	C(GROUP_TOO_LONG, "Group name is too long"), \
	363	C(BAD_GROUP_NAME, "Group name must follow the same rules as C identifiers"), \
	364	C(NO_EVENT_NAME, "Event name is not specified"), \
	365	C(EVENT_TOO_LONG, "Event name is too long"), \
	366	C(BAD_EVENT_NAME, "Event name must follow the same rules as C identifiers"), \
	367	C(RETVAL_ON_PROBE, "$retval is not available on probe"), \
	368	C(BAD_STACK_NUM, "Invalid stack number"), \
	369	C(BAD_ARG_NUM, "Invalid argument number"), \
	370	C(BAD_VAR, "Invalid $-valiable specified"), \
	371	C(BAD_REG_NAME, "Invalid register name"), \
	372	C(BAD_MEM_ADDR, "Invalid memory address"), \
	373	C(FILE_ON_KPROBE, "File offset is not available with kprobe"), \
	374	C(BAD_FILE_OFFS, "Invalid file offset value"), \
	375	C(SYM_ON_UPROBE, "Symbol is not available with uprobe"), \
	376	C(TOO_MANY_OPS, "Dereference is too much nested"), \
	377	C(DEREF_NEED_BRACE, "Dereference needs a brace"), \
	378	C(BAD_DEREF_OFFS, "Invalid dereference offset"), \
	379	C(DEREF_OPEN_BRACE, "Dereference brace is not closed"), \
	380	C(COMM_CANT_DEREF, "$comm can not be dereferenced"), \
	381	C(BAD_FETCH_ARG, "Invalid fetch argument"), \
	382	C(ARRAY_NO_CLOSE, "Array is not closed"), \
	383	C(BAD_ARRAY_SUFFIX, "Array has wrong suffix"), \
	384	C(BAD_ARRAY_NUM, "Invalid array size"), \
	385	C(ARRAY_TOO_BIG, "Array number is too big"), \
	386	C(BAD_TYPE, "Unknown type is specified"), \
	387	C(BAD_STRING, "String accepts only memory argument"), \
	388	C(BAD_BITFIELD, "Invalid bitfield"), \
	389	C(ARG_NAME_TOO_LONG, "Argument name is too long"), \
	390	C(NO_ARG_NAME, "Argument name is not specified"), \
	391	C(BAD_ARG_NAME, "Argument name must follow the same rules as C identifiers"), \
	392	C(USED_ARG_NAME, "This argument name is already used"), \
	393	C(ARG_TOO_LONG, "Argument expression is too long"), \
	394	C(NO_ARG_BODY, "No argument expression"), \
	395	C(BAD_INSN_BNDRY, "Probe point is not an instruction boundary"),\
	396	C(FAIL_REG_PROBE, "Failed to register probe event"),
	397
	398	#undef C
	399	#define C(a, b) TP_ERR_##a
	400
	401	/* Define TP_ERR_ */
	402	enum { ERRORS };
	403
	404	/* Error text is defined in trace_probe.c */
	405
	406	struct trace_probe_log {
	407	const char *subsystem;
	408	const char **argv;
	409	int argc;
	410	int index;
411	};
412
413	void trace_probe_log_init(const char subsystem, int argc, const char *argv);
414	void trace_probe_log_set_index(int index);
415	void trace_probe_log_clear(void);
416	void __trace_probe_log_err(int offset, int err);
417
418	#define trace_probe_log_err(offs, err) \
419	__trace_probe_log_err(offs, TP_ERR_##err)