[lttng-modules.git] / ltt-debugfs-abi.h

#ifndef _LTT_DEBUGFS_ABI_H
#define _LTT_DEBUGFS_ABI_H

/*
 * ltt-debugfs-abi.h
 *
 * Copyright 2010 (c) - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
 *
 * LTTng debugfs ABI header
 *
 * Dual LGPL v2.1/GPL v2 license.
 */

#include <linux/fs.h>

#define LTTNG_SYM_NAME_LEN	128

enum lttng_kernel_instrumentation {
	LTTNG_KERNEL_TRACEPOINT	= 0,
	LTTNG_KERNEL_KPROBE	= 1,
	LTTNG_KERNEL_FUNCTION	= 2,
	LTTNG_KERNEL_KRETPROBE	= 3,
};

/*
 * LTTng consumer mode
 */
enum lttng_kernel_output {
	LTTNG_KERNEL_SPLICE	= 0,
	LTTNG_KERNEL_MMAP	= 1,
};

/*
 * LTTng DebugFS ABI structures.
 */

struct lttng_kernel_channel {
	int overwrite;				/* 1: overwrite, 0: discard */
	uint64_t subbuf_size;			/* in bytes */
	uint64_t num_subbuf;
	unsigned int switch_timer_interval;	/* usecs */
	unsigned int read_timer_interval;	/* usecs */
	enum lttng_kernel_output output;	/* splice, mmap */
};

struct lttng_kernel_kretprobe {
	uint64_t addr;

	uint64_t offset;
	char symbol_name[LTTNG_SYM_NAME_LEN];
};

/*
 * Either addr is used, or symbol_name and offset.
 */
struct lttng_kernel_kprobe {
	uint64_t addr;

	uint64_t offset;
	char symbol_name[LTTNG_SYM_NAME_LEN];
};

struct lttng_kernel_function_tracer {
	char symbol_name[LTTNG_SYM_NAME_LEN];
};

struct lttng_kernel_event {
	char name[LTTNG_SYM_NAME_LEN];	/* event name */
	enum lttng_kernel_instrumentation instrumentation;
	/* Per instrumentation type configuration */
	union {
		struct lttng_kernel_kretprobe kretprobe;
		struct lttng_kernel_kprobe kprobe;
		struct lttng_kernel_function_tracer ftrace;
	} u;
};

struct lttng_kernel_tracer_version {
	uint32_t version;
	uint32_t patchlevel;
	uint32_t sublevel;
};

enum lttng_calibrate_type {
	LTTNG_CALIBRATE_KRETPROBE,
};

struct lttng_calibrate {
	enum lttng_calibrate_type type;	/* type (input) */
	union {
		struct {
			uint64_t addr;	/* address to probe (output) */
		} kretprobe;
	} u;
};

enum lttng_kernel_context_type {
	LTTNG_KERNEL_CONTEXT_PID		= 0,
	LTTNG_KERNEL_CONTEXT_PERF_COUNTER	= 1,
	LTTNG_KERNEL_CONTEXT_COMM		= 2,
	LTTNG_KERNEL_CONTEXT_PRIO		= 3,
	LTTNG_KERNEL_CONTEXT_NICE		= 4,
	LTTNG_KERNEL_CONTEXT_VPID		= 5,
	LTTNG_KERNEL_CONTEXT_TID		= 6,
	LTTNG_KERNEL_CONTEXT_VTID		= 7,
	LTTNG_KERNEL_CONTEXT_PPID		= 8,
	LTTNG_KERNEL_CONTEXT_VPPID		= 9,
};

struct lttng_kernel_perf_counter_ctx {
	uint32_t type;
	uint64_t config;
	char name[LTTNG_SYM_NAME_LEN];
};

struct lttng_kernel_context {
	enum lttng_kernel_context_type ctx;
	union {
		struct lttng_kernel_perf_counter_ctx perf_counter;
	} u;
};

/* LTTng file descriptor ioctl */
#define LTTNG_KERNEL_SESSION			_IO(0xF6, 0x40)
#define LTTNG_KERNEL_TRACER_VERSION		\
	_IOR(0xF6, 0x41, struct lttng_kernel_tracer_version)
#define LTTNG_KERNEL_TRACEPOINT_LIST		_IO(0xF6, 0x42)
#define LTTNG_KERNEL_WAIT_QUIESCENT		_IO(0xF6, 0x43)
#define LTTNG_KERNEL_CALIBRATE			\
	_IOWR(0xF6, 0x44, struct lttng_calibrate)

/* Session FD ioctl */
#define LTTNG_KERNEL_METADATA			\
	_IOW(0xF6, 0x50, struct lttng_kernel_channel)
#define LTTNG_KERNEL_CHANNEL			\
	_IOW(0xF6, 0x51, struct lttng_kernel_channel)
#define LTTNG_KERNEL_SESSION_START		_IO(0xF6, 0x52)
#define LTTNG_KERNEL_SESSION_STOP		_IO(0xF6, 0x53)

/* Channel FD ioctl */
#define LTTNG_KERNEL_STREAM			_IO(0xF6, 0x60)
#define LTTNG_KERNEL_EVENT			\
	_IOW(0xF6, 0x61, struct lttng_kernel_event)

/* Event and Channel FD ioctl */
#define LTTNG_KERNEL_CONTEXT			\
	_IOW(0xF6, 0x70, struct lttng_kernel_context)

/* Event, Channel and Session ioctl */
#define LTTNG_KERNEL_ENABLE			_IO(0xF6, 0x80)
#define LTTNG_KERNEL_DISABLE			_IO(0xF6, 0x81)

#endif /* _LTT_DEBUGFS_ABI_H */
Commit	Line	Data
57a13317 MD	1	#ifndef _LTT_DEBUGFS_ABI_H
	2	#define _LTT_DEBUGFS_ABI_H
	3
	4	/*
	5	* ltt-debugfs-abi.h
	6	*
	7	* Copyright 2010 (c) - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
	8	*
	9	* LTTng debugfs ABI header
17baffe2 MD	10	*
17baffe2 MD	11	* Dual LGPL v2.1/GPL v2 license.
57a13317 MD	12	*/
	13
	14	#include <linux/fs.h>
	15
e0a7a7c4	16	#define LTTNG_SYM_NAME_LEN 128
d6d808f3	17
38d024ae	18	enum lttng_kernel_instrumentation {
4c183524 MD	19	LTTNG_KERNEL_TRACEPOINT = 0,
	20	LTTNG_KERNEL_KPROBE = 1,
	21	LTTNG_KERNEL_FUNCTION = 2,
7371f44c	22	LTTNG_KERNEL_KRETPROBE = 3,
57a13317 MD	23	};
57a13317 MD	24
96ba7208 JD	25	/*
	26	* LTTng consumer mode
	27	*/
	28	enum lttng_kernel_output {
	29	LTTNG_KERNEL_SPLICE = 0,
	30	LTTNG_KERNEL_MMAP = 1,
	31	};
	32
57a13317 MD	33	/*
	34	* LTTng DebugFS ABI structures.
	35	*/
	36
38d024ae	37	struct lttng_kernel_channel {
9e245ead MD	38	int overwrite; /* 1: overwrite, 0: discard */
9e245ead MD	39	uint64_t subbuf_size; /* in bytes */
80c16bcf	40	uint64_t num_subbuf;
9e245ead MD	41	unsigned int switch_timer_interval; /* usecs */
9e245ead MD	42	unsigned int read_timer_interval; /* usecs */
96ba7208	43	enum lttng_kernel_output output; /* splice, mmap */
57a13317 MD	44	};
57a13317 MD	45
7371f44c MD	46	struct lttng_kernel_kretprobe {
	47	uint64_t addr;
	48
	49	uint64_t offset;
	50	char symbol_name[LTTNG_SYM_NAME_LEN];
	51	};
	52
38d024ae MD	53	/*
	54	* Either addr is used, or symbol_name and offset.
	55	*/
	56	struct lttng_kernel_kprobe {
80c16bcf	57	uint64_t addr;
38d024ae	58
80c16bcf	59	uint64_t offset;
e0a7a7c4	60	char symbol_name[LTTNG_SYM_NAME_LEN];
d6d808f3 MD	61	};
d6d808f3 MD	62
f17701fb	63	struct lttng_kernel_function_tracer {
e0a7a7c4	64	char symbol_name[LTTNG_SYM_NAME_LEN];
f17701fb MD	65	};
f17701fb MD	66
d6d808f3	67	struct lttng_kernel_event {
30bdb6e4	68	char name[LTTNG_SYM_NAME_LEN]; /* event name */
d6d808f3 MD	69	enum lttng_kernel_instrumentation instrumentation;
	70	/* Per instrumentation type configuration */
	71	union {
7371f44c	72	struct lttng_kernel_kretprobe kretprobe;
d6d808f3	73	struct lttng_kernel_kprobe kprobe;
f17701fb	74	struct lttng_kernel_function_tracer ftrace;
d6d808f3	75	} u;
38d024ae	76	};
c099397a	77
80c16bcf MD	78	struct lttng_kernel_tracer_version {
	79	uint32_t version;
	80	uint32_t patchlevel;
	81	uint32_t sublevel;
	82	};
	83
57105fc2 MD	84	enum lttng_calibrate_type {
	85	LTTNG_CALIBRATE_KRETPROBE,
	86	};
	87
	88	struct lttng_calibrate {
	89	enum lttng_calibrate_type type; /* type (input) */
	90	union {
	91	struct {
	92	uint64_t addr; /* address to probe (output) */
	93	} kretprobe;
	94	} u;
	95	};
	96
12a313a5	97	enum lttng_kernel_context_type {
4c183524 MD	98	LTTNG_KERNEL_CONTEXT_PID = 0,
	99	LTTNG_KERNEL_CONTEXT_PERF_COUNTER = 1,
	100	LTTNG_KERNEL_CONTEXT_COMM = 2,
	101	LTTNG_KERNEL_CONTEXT_PRIO = 3,
	102	LTTNG_KERNEL_CONTEXT_NICE = 4,
	103	LTTNG_KERNEL_CONTEXT_VPID = 5,
	104	LTTNG_KERNEL_CONTEXT_TID = 6,
	105	LTTNG_KERNEL_CONTEXT_VTID = 7,
	106	LTTNG_KERNEL_CONTEXT_PPID = 8,
	107	LTTNG_KERNEL_CONTEXT_VPPID = 9,
8070f5c0 MD	108	};
	109
	110	struct lttng_kernel_perf_counter_ctx {
	111	uint32_t type;
	112	uint64_t config;
c24a0d71	113	char name[LTTNG_SYM_NAME_LEN];
8070f5c0 MD	114	};
	115
	116	struct lttng_kernel_context {
12a313a5	117	enum lttng_kernel_context_type ctx;
8070f5c0	118	union {
8070f5c0 MD	119	struct lttng_kernel_perf_counter_ctx perf_counter;
	120	} u;
	121	};
	122
33749530	123	/* LTTng file descriptor ioctl */
ab2277d6	124	#define LTTNG_KERNEL_SESSION _IO(0xF6, 0x40)
33749530 MD	125	#define LTTNG_KERNEL_TRACER_VERSION \
33749530 MD	126	_IOR(0xF6, 0x41, struct lttng_kernel_tracer_version)
271b6681	127	#define LTTNG_KERNEL_TRACEPOINT_LIST _IO(0xF6, 0x42)
360f38ea	128	#define LTTNG_KERNEL_WAIT_QUIESCENT _IO(0xF6, 0x43)
57105fc2 MD	129	#define LTTNG_KERNEL_CALIBRATE \
57105fc2 MD	130	_IOWR(0xF6, 0x44, struct lttng_calibrate)
33749530 MD	131
	132	/* Session FD ioctl */
	133	#define LTTNG_KERNEL_METADATA \
	134	_IOW(0xF6, 0x50, struct lttng_kernel_channel)
ab2277d6	135	#define LTTNG_KERNEL_CHANNEL \
33749530 MD	136	_IOW(0xF6, 0x51, struct lttng_kernel_channel)
	137	#define LTTNG_KERNEL_SESSION_START _IO(0xF6, 0x52)
	138	#define LTTNG_KERNEL_SESSION_STOP _IO(0xF6, 0x53)
	139
	140	/* Channel FD ioctl */
	141	#define LTTNG_KERNEL_STREAM _IO(0xF6, 0x60)
ab2277d6	142	#define LTTNG_KERNEL_EVENT \
33749530	143	_IOW(0xF6, 0x61, struct lttng_kernel_event)
57a13317	144
8070f5c0 MD	145	/* Event and Channel FD ioctl */
	146	#define LTTNG_KERNEL_CONTEXT \
	147	_IOW(0xF6, 0x70, struct lttng_kernel_context)
	148
e64957da MD	149	/* Event, Channel and Session ioctl */
	150	#define LTTNG_KERNEL_ENABLE _IO(0xF6, 0x80)
	151	#define LTTNG_KERNEL_DISABLE _IO(0xF6, 0x81)
	152
57a13317	153	#endif /* _LTT_DEBUGFS_ABI_H */