[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,
	LTTNG_KERNEL_KPROBE,
	LTTNG_KERNEL_FUNCTION,
};

/*
 * 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 */
};

/*
 * 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_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_kernel_context_type {
	LTTNG_KERNEL_CONTEXT_PID,
	LTTNG_KERNEL_CONTEXT_PERF_COUNTER,
	LTTNG_KERNEL_CONTEXT_COMM,
	LTTNG_KERNEL_CONTEXT_PRIO,
	LTTNG_KERNEL_CONTEXT_NICE,
	LTTNG_KERNEL_CONTEXT_VPID,
	LTTNG_KERNEL_CONTEXT_TID,
	LTTNG_KERNEL_CONTEXT_VTID,
	LTTNG_KERNEL_CONTEXT_PPID,
	LTTNG_KERNEL_CONTEXT_VPPID,
};

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)

/* 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 {
ab2277d6 MD	19	LTTNG_KERNEL_TRACEPOINT,
	20	LTTNG_KERNEL_KPROBE,
	21	LTTNG_KERNEL_FUNCTION,
57a13317 MD	22	};
	23
	24	/*
	25	* LTTng DebugFS ABI structures.
	26	*/
	27
38d024ae	28	struct lttng_kernel_channel {
9e245ead MD	29	int overwrite; /* 1: overwrite, 0: discard */
9e245ead MD	30	uint64_t subbuf_size; /* in bytes */
80c16bcf	31	uint64_t num_subbuf;
9e245ead MD	32	unsigned int switch_timer_interval; /* usecs */
9e245ead MD	33	unsigned int read_timer_interval; /* usecs */
57a13317 MD	34	};
57a13317 MD	35
38d024ae MD	36	/*
	37	* Either addr is used, or symbol_name and offset.
	38	*/
	39	struct lttng_kernel_kprobe {
80c16bcf	40	uint64_t addr;
38d024ae	41
80c16bcf	42	uint64_t offset;
e0a7a7c4	43	char symbol_name[LTTNG_SYM_NAME_LEN];
d6d808f3 MD	44	};
d6d808f3 MD	45
f17701fb	46	struct lttng_kernel_function_tracer {
e0a7a7c4	47	char symbol_name[LTTNG_SYM_NAME_LEN];
f17701fb MD	48	};
f17701fb MD	49
d6d808f3	50	struct lttng_kernel_event {
30bdb6e4	51	char name[LTTNG_SYM_NAME_LEN]; /* event name */
d6d808f3 MD	52	enum lttng_kernel_instrumentation instrumentation;
	53	/* Per instrumentation type configuration */
	54	union {
	55	struct lttng_kernel_kprobe kprobe;
f17701fb	56	struct lttng_kernel_function_tracer ftrace;
d6d808f3	57	} u;
38d024ae	58	};
c099397a	59
80c16bcf MD	60	struct lttng_kernel_tracer_version {
	61	uint32_t version;
	62	uint32_t patchlevel;
	63	uint32_t sublevel;
	64	};
	65
12a313a5 MD	66	enum lttng_kernel_context_type {
	67	LTTNG_KERNEL_CONTEXT_PID,
	68	LTTNG_KERNEL_CONTEXT_PERF_COUNTER,
25b2f99a	69	LTTNG_KERNEL_CONTEXT_COMM,
a8ad3613	70	LTTNG_KERNEL_CONTEXT_PRIO,
53f1f0ca	71	LTTNG_KERNEL_CONTEXT_NICE,
b64bc438 MD	72	LTTNG_KERNEL_CONTEXT_VPID,
	73	LTTNG_KERNEL_CONTEXT_TID,
	74	LTTNG_KERNEL_CONTEXT_VTID,
	75	LTTNG_KERNEL_CONTEXT_PPID,
	76	LTTNG_KERNEL_CONTEXT_VPPID,
8070f5c0 MD	77	};
	78
	79	struct lttng_kernel_perf_counter_ctx {
	80	uint32_t type;
	81	uint64_t config;
c24a0d71	82	char name[LTTNG_SYM_NAME_LEN];
8070f5c0 MD	83	};
	84
	85	struct lttng_kernel_context {
12a313a5	86	enum lttng_kernel_context_type ctx;
8070f5c0	87	union {
8070f5c0 MD	88	struct lttng_kernel_perf_counter_ctx perf_counter;
	89	} u;
	90	};
	91
33749530	92	/* LTTng file descriptor ioctl */
ab2277d6	93	#define LTTNG_KERNEL_SESSION _IO(0xF6, 0x40)
33749530 MD	94	#define LTTNG_KERNEL_TRACER_VERSION \
33749530 MD	95	_IOR(0xF6, 0x41, struct lttng_kernel_tracer_version)
271b6681	96	#define LTTNG_KERNEL_TRACEPOINT_LIST _IO(0xF6, 0x42)
33749530 MD	97
	98	/* Session FD ioctl */
	99	#define LTTNG_KERNEL_METADATA \
	100	_IOW(0xF6, 0x50, struct lttng_kernel_channel)
ab2277d6	101	#define LTTNG_KERNEL_CHANNEL \
33749530 MD	102	_IOW(0xF6, 0x51, struct lttng_kernel_channel)
	103	#define LTTNG_KERNEL_SESSION_START _IO(0xF6, 0x52)
	104	#define LTTNG_KERNEL_SESSION_STOP _IO(0xF6, 0x53)
	105
	106	/* Channel FD ioctl */
	107	#define LTTNG_KERNEL_STREAM _IO(0xF6, 0x60)
ab2277d6	108	#define LTTNG_KERNEL_EVENT \
33749530	109	_IOW(0xF6, 0x61, struct lttng_kernel_event)
57a13317	110
8070f5c0 MD	111	/* Event and Channel FD ioctl */
	112	#define LTTNG_KERNEL_CONTEXT \
	113	_IOW(0xF6, 0x70, struct lttng_kernel_context)
	114
e64957da MD	115	/* Event, Channel and Session ioctl */
	116	#define LTTNG_KERNEL_ENABLE _IO(0xF6, 0x80)
	117	#define LTTNG_KERNEL_DISABLE _IO(0xF6, 0x81)
	118
57a13317	119	#endif /* _LTT_DEBUGFS_ABI_H */