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

/* SPDX-License-Identifier: (GPL-2.0 or LGPL-2.1)
 *
 * lttng-abi.h
 *
 * LTTng ABI header
 *
 * Copyright (C) 2010-2012 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
 */

#ifndef _LTTNG_ABI_H
#define _LTTNG_ABI_H

#include <linux/fs.h>

/*
 * Major/minor version of ABI exposed to lttng tools. Major number
 * should be increased when an incompatible ABI change is done.
 */
#define LTTNG_MODULES_ABI_MAJOR_VERSION		2
#define LTTNG_MODULES_ABI_MINOR_VERSION		5

#define LTTNG_KERNEL_SYM_NAME_LEN	256
#define LTTNG_KERNEL_SESSION_NAME_LEN	256

/*
 * The expected iso8601 time formats are either:
 *
 * - YYYYmmddTHHMMSS+HHMM           (20 characters + \0)
 * - YYYY-mm-ddTHH:MM:SS+HH:MM      (25 characters + \0)
 */
#define LTTNG_KERNEL_SESSION_CREATION_TIME_ISO8601_LEN	26

enum lttng_kernel_instrumentation {
	LTTNG_KERNEL_TRACEPOINT	= 0,
	LTTNG_KERNEL_KPROBE	= 1,
	LTTNG_KERNEL_FUNCTION	= 2,
	LTTNG_KERNEL_KRETPROBE	= 3,
	LTTNG_KERNEL_NOOP	= 4,	/* not hooked */
	LTTNG_KERNEL_SYSCALL	= 5,
	LTTNG_KERNEL_UPROBE	= 6,
};

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

/*
 * LTTng DebugFS ABI structures.
 */
#define LTTNG_KERNEL_CHANNEL_PADDING	LTTNG_KERNEL_SYM_NAME_LEN + 32
struct lttng_kernel_channel {
	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 */
	int overwrite;				/* 1: overwrite, 0: discard */
	char padding[LTTNG_KERNEL_CHANNEL_PADDING];
} __attribute__((packed));

struct lttng_kernel_kretprobe {
	uint64_t addr;

	uint64_t offset;
	char symbol_name[LTTNG_KERNEL_SYM_NAME_LEN];
} __attribute__((packed));

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

	uint64_t offset;
	char symbol_name[LTTNG_KERNEL_SYM_NAME_LEN];
} __attribute__((packed));

struct lttng_kernel_function_tracer {
	char symbol_name[LTTNG_KERNEL_SYM_NAME_LEN];
} __attribute__((packed));

struct lttng_kernel_uprobe {
	int fd;
} __attribute__((packed));

struct lttng_kernel_event_callsite_uprobe {
	uint64_t offset;
} __attribute__((packed));

struct lttng_kernel_event_callsite {
	union {
		struct lttng_kernel_event_callsite_uprobe uprobe;
	} u;
} __attribute__((packed));

enum lttng_kernel_syscall_entryexit {
	LTTNG_KERNEL_SYSCALL_ENTRYEXIT = 0,
	LTTNG_KERNEL_SYSCALL_ENTRY = 1,		/* Not implemented. */
	LTTNG_KERNEL_SYSCALL_EXIT = 2,		/* Not implemented. */
};

enum lttng_kernel_syscall_abi {
	LTTNG_KERNEL_SYSCALL_ABI_ALL = 0,
	LTTNG_KERNEL_SYSCALL_ABI_NATIVE = 1,	/* Not implemented. */
	LTTNG_KERNEL_SYSCALL_ABI_COMPAT = 2,	/* Not implemented. */
};

enum lttng_kernel_syscall_match {
	LTTNG_SYSCALL_MATCH_NAME = 0,
	LTTNG_SYSCALL_MATCH_NR = 1,		/* Not implemented. */
};

struct lttng_kernel_syscall {
	uint8_t entryexit;	/* enum lttng_kernel_syscall_entryexit */
	uint8_t abi;		/* enum lttng_kernel_syscall_abi */
	uint8_t match;		/* enum lttng_kernel_syscall_match */
	uint8_t padding;
	uint32_t nr;		/* For LTTNG_SYSCALL_MATCH_NR */
} __attribute__((packed));

/*
 * For syscall tracing, name = "*" means "enable all".
 */
#define LTTNG_KERNEL_EVENT_PADDING1	16
#define LTTNG_KERNEL_EVENT_PADDING2	LTTNG_KERNEL_SYM_NAME_LEN + 32
struct lttng_kernel_event {
	char name[LTTNG_KERNEL_SYM_NAME_LEN];	/* event name */
	enum lttng_kernel_instrumentation instrumentation;
	char padding[LTTNG_KERNEL_EVENT_PADDING1];

	/* Per instrumentation type configuration */
	union {
		struct lttng_kernel_kretprobe kretprobe;
		struct lttng_kernel_kprobe kprobe;
		struct lttng_kernel_function_tracer ftrace;
		struct lttng_kernel_uprobe uprobe;
		struct lttng_kernel_syscall syscall;
		char padding[LTTNG_KERNEL_EVENT_PADDING2];
	} u;
} __attribute__((packed));

struct lttng_kernel_tracer_version {
	uint32_t major;
	uint32_t minor;
	uint32_t patchlevel;
} __attribute__((packed));

struct lttng_kernel_tracer_abi_version {
	uint32_t major;
	uint32_t minor;
} __attribute__((packed));

struct lttng_kernel_session_name {
	char name[LTTNG_KERNEL_SESSION_NAME_LEN];
} __attribute__((packed));

struct lttng_kernel_session_creation_time {
	char iso8601[LTTNG_KERNEL_SESSION_CREATION_TIME_ISO8601_LEN];
} __attribute__((packed));

enum lttng_kernel_calibrate_type {
	LTTNG_KERNEL_CALIBRATE_KRETPROBE,
};

struct lttng_kernel_calibrate {
	enum lttng_kernel_calibrate_type type;	/* type (input) */
} __attribute__((packed));

struct lttng_kernel_syscall_mask {
	uint32_t len;	/* in bits */
	char mask[];
} __attribute__((packed));

enum lttng_kernel_context_type {
	LTTNG_KERNEL_CONTEXT_PID		= 0,
	LTTNG_KERNEL_CONTEXT_PERF_COUNTER	= 1,
	LTTNG_KERNEL_CONTEXT_PROCNAME		= 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,
	LTTNG_KERNEL_CONTEXT_HOSTNAME		= 10,
	LTTNG_KERNEL_CONTEXT_CPU_ID		= 11,
	LTTNG_KERNEL_CONTEXT_INTERRUPTIBLE	= 12,
	LTTNG_KERNEL_CONTEXT_PREEMPTIBLE	= 13,
	LTTNG_KERNEL_CONTEXT_NEED_RESCHEDULE	= 14,
	LTTNG_KERNEL_CONTEXT_MIGRATABLE		= 15,
	LTTNG_KERNEL_CONTEXT_CALLSTACK_KERNEL	= 16,
	LTTNG_KERNEL_CONTEXT_CALLSTACK_USER	= 17,
	LTTNG_KERNEL_CONTEXT_CGROUP_NS		= 18,
	LTTNG_KERNEL_CONTEXT_IPC_NS		= 19,
	LTTNG_KERNEL_CONTEXT_MNT_NS		= 20,
	LTTNG_KERNEL_CONTEXT_NET_NS		= 21,
	LTTNG_KERNEL_CONTEXT_PID_NS		= 22,
	LTTNG_KERNEL_CONTEXT_USER_NS		= 23,
	LTTNG_KERNEL_CONTEXT_UTS_NS		= 24,
	LTTNG_KERNEL_CONTEXT_UID		= 25,
	LTTNG_KERNEL_CONTEXT_EUID		= 26,
	LTTNG_KERNEL_CONTEXT_SUID		= 27,
	LTTNG_KERNEL_CONTEXT_GID		= 28,
	LTTNG_KERNEL_CONTEXT_EGID		= 29,
	LTTNG_KERNEL_CONTEXT_SGID		= 30,
	LTTNG_KERNEL_CONTEXT_VUID		= 31,
	LTTNG_KERNEL_CONTEXT_VEUID		= 32,
	LTTNG_KERNEL_CONTEXT_VSUID		= 33,
	LTTNG_KERNEL_CONTEXT_VGID		= 34,
	LTTNG_KERNEL_CONTEXT_VEGID		= 35,
	LTTNG_KERNEL_CONTEXT_VSGID		= 36,
};

struct lttng_kernel_perf_counter_ctx {
	uint32_t type;
	uint64_t config;
	char name[LTTNG_KERNEL_SYM_NAME_LEN];
} __attribute__((packed));

#define LTTNG_KERNEL_CONTEXT_PADDING1	16
#define LTTNG_KERNEL_CONTEXT_PADDING2	LTTNG_KERNEL_SYM_NAME_LEN + 32
struct lttng_kernel_context {
	enum lttng_kernel_context_type ctx;
	char padding[LTTNG_KERNEL_CONTEXT_PADDING1];

	union {
		struct lttng_kernel_perf_counter_ctx perf_counter;
		char padding[LTTNG_KERNEL_CONTEXT_PADDING2];
	} u;
} __attribute__((packed));

#define LTTNG_KERNEL_FILTER_BYTECODE_MAX_LEN		65536
struct lttng_kernel_filter_bytecode {
	uint32_t len;
	uint32_t reloc_offset;
	uint64_t seqnum;
	char data[0];
} __attribute__((packed));

enum lttng_kernel_tracker_type {
	LTTNG_KERNEL_TRACKER_UNKNOWN		= -1,

	LTTNG_KERNEL_TRACKER_PID		= 0,
	LTTNG_KERNEL_TRACKER_VPID		= 1,
	LTTNG_KERNEL_TRACKER_UID		= 2,
	LTTNG_KERNEL_TRACKER_VUID		= 3,
	LTTNG_KERNEL_TRACKER_GID		= 4,
	LTTNG_KERNEL_TRACKER_VGID		= 5,
};

struct lttng_kernel_tracker_args {
	enum lttng_kernel_tracker_type type;
	int32_t id;
};

/* LTTng file descriptor ioctl */
/* lttng-abi-old.h reserve 0x40, 0x41, 0x42, 0x43, and 0x44. */
#define LTTNG_KERNEL_SESSION			_IO(0xF6, 0x45)
#define LTTNG_KERNEL_TRACER_VERSION		\
	_IOR(0xF6, 0x46, struct lttng_kernel_tracer_version)
#define LTTNG_KERNEL_TRACEPOINT_LIST		_IO(0xF6, 0x47)
#define LTTNG_KERNEL_WAIT_QUIESCENT		_IO(0xF6, 0x48)
#define LTTNG_KERNEL_CALIBRATE			\
	_IOWR(0xF6, 0x49, struct lttng_kernel_calibrate)
#define LTTNG_KERNEL_SYSCALL_LIST		_IO(0xF6, 0x4A)
#define LTTNG_KERNEL_TRACER_ABI_VERSION		\
	_IOR(0xF6, 0x4B, struct lttng_kernel_tracer_abi_version)

/* Session FD ioctl */
/* lttng-abi-old.h reserve 0x50, 0x51, 0x52, and 0x53. */
#define LTTNG_KERNEL_METADATA			\
	_IOW(0xF6, 0x54, struct lttng_kernel_channel)
#define LTTNG_KERNEL_CHANNEL			\
	_IOW(0xF6, 0x55, struct lttng_kernel_channel)
#define LTTNG_KERNEL_SESSION_START		_IO(0xF6, 0x56)
#define LTTNG_KERNEL_SESSION_STOP		_IO(0xF6, 0x57)
#define LTTNG_KERNEL_SESSION_TRACK_PID		\
	_IOR(0xF6, 0x58, int32_t)
#define LTTNG_KERNEL_SESSION_UNTRACK_PID	\
	_IOR(0xF6, 0x59, int32_t)

/*
 * ioctl 0x58 and 0x59 are duplicated here. It works, since _IOR vs _IO
 * are generating two different ioctl numbers, but this was not done on
 * purpose. We should generally try to avoid those duplications.
 */
#define LTTNG_KERNEL_SESSION_LIST_TRACKER_PIDS	_IO(0xF6, 0x58)
#define LTTNG_KERNEL_SESSION_METADATA_REGEN	_IO(0xF6, 0x59)

/* lttng-abi-old.h reserve 0x5A and 0x5B. */
#define LTTNG_KERNEL_SESSION_STATEDUMP		_IO(0xF6, 0x5C)
#define LTTNG_KERNEL_SESSION_SET_NAME		\
	_IOR(0xF6, 0x5D, struct lttng_kernel_session_name)
#define LTTNG_KERNEL_SESSION_SET_CREATION_TIME		\
	_IOR(0xF6, 0x5E, struct lttng_kernel_session_creation_time)

/* Channel FD ioctl */
/* lttng-abi-old.h reserve 0x60 and 0x61. */
#define LTTNG_KERNEL_STREAM			_IO(0xF6, 0x62)
#define LTTNG_KERNEL_EVENT			\
	_IOW(0xF6, 0x63, struct lttng_kernel_event)
#define LTTNG_KERNEL_SYSCALL_MASK		\
	_IOWR(0xF6, 0x64, struct lttng_kernel_syscall_mask)

/* Event and Channel FD ioctl */
/* lttng-abi-old.h reserve 0x70. */
#define LTTNG_KERNEL_CONTEXT			\
	_IOW(0xF6, 0x71, struct lttng_kernel_context)

/* Event, Channel and Session ioctl */
/* lttng-abi-old.h reserve 0x80 and 0x81. */
#define LTTNG_KERNEL_ENABLE			_IO(0xF6, 0x82)
#define LTTNG_KERNEL_DISABLE			_IO(0xF6, 0x83)

/* Event FD ioctl */
#define LTTNG_KERNEL_FILTER			_IO(0xF6, 0x90)
#define LTTNG_KERNEL_ADD_CALLSITE		_IO(0xF6, 0x91)

/* Session FD ioctl (continued) */
#define LTTNG_KERNEL_SESSION_LIST_TRACKER_IDS	\
	_IOR(0xF6, 0xA0, struct lttng_kernel_tracker_args)
#define LTTNG_KERNEL_SESSION_TRACK_ID		\
	_IOR(0xF6, 0xA1, struct lttng_kernel_tracker_args)
#define LTTNG_KERNEL_SESSION_UNTRACK_ID		\
	_IOR(0xF6, 0xA2, struct lttng_kernel_tracker_args)

/*
 * LTTng-specific ioctls for the lib ringbuffer.
 *
 * Operations applying to the current sub-buffer need to occur between
 * a get/put or get_next/put_next ioctl pair.
 */

/* returns the timestamp begin of the current sub-buffer */
#define LTTNG_RING_BUFFER_GET_TIMESTAMP_BEGIN	_IOR(0xF6, 0x20, uint64_t)
/* returns the timestamp end of the current sub-buffer */
#define LTTNG_RING_BUFFER_GET_TIMESTAMP_END	_IOR(0xF6, 0x21, uint64_t)
/* returns the number of events discarded of the current sub-buffer */
#define LTTNG_RING_BUFFER_GET_EVENTS_DISCARDED	_IOR(0xF6, 0x22, uint64_t)
/* returns the packet payload size of the current sub-buffer */
#define LTTNG_RING_BUFFER_GET_CONTENT_SIZE	_IOR(0xF6, 0x23, uint64_t)
/* returns the packet size of the current sub-buffer*/
#define LTTNG_RING_BUFFER_GET_PACKET_SIZE	_IOR(0xF6, 0x24, uint64_t)
/* returns the stream id (invariant for the stream) */
#define LTTNG_RING_BUFFER_GET_STREAM_ID		_IOR(0xF6, 0x25, uint64_t)
/* returns the current timestamp as perceived from the tracer */
#define LTTNG_RING_BUFFER_GET_CURRENT_TIMESTAMP	_IOR(0xF6, 0x26, uint64_t)
/* returns the packet sequence number of the current sub-buffer */
#define LTTNG_RING_BUFFER_GET_SEQ_NUM		_IOR(0xF6, 0x27, uint64_t)
/* returns the stream instance id (invariant for the stream) */
#define LTTNG_RING_BUFFER_INSTANCE_ID		_IOR(0xF6, 0x28, uint64_t)

#ifdef CONFIG_COMPAT
/* returns the timestamp begin of the current sub-buffer */
#define LTTNG_RING_BUFFER_COMPAT_GET_TIMESTAMP_BEGIN \
	LTTNG_RING_BUFFER_GET_TIMESTAMP_BEGIN
/* returns the timestamp end of the current sub-buffer */
#define LTTNG_RING_BUFFER_COMPAT_GET_TIMESTAMP_END \
	LTTNG_RING_BUFFER_GET_TIMESTAMP_END
/* returns the number of events discarded of the current sub-buffer */
#define LTTNG_RING_BUFFER_COMPAT_GET_EVENTS_DISCARDED \
	LTTNG_RING_BUFFER_GET_EVENTS_DISCARDED
/* returns the packet payload size of the current sub-buffer */
#define LTTNG_RING_BUFFER_COMPAT_GET_CONTENT_SIZE \
	LTTNG_RING_BUFFER_GET_CONTENT_SIZE
/* returns the packet size of the current sub-buffer */
#define LTTNG_RING_BUFFER_COMPAT_GET_PACKET_SIZE \
	LTTNG_RING_BUFFER_GET_PACKET_SIZE
/* returns the stream id (invariant for the stream) */
#define LTTNG_RING_BUFFER_COMPAT_GET_STREAM_ID \
	LTTNG_RING_BUFFER_GET_STREAM_ID
/* returns the current timestamp as perceived from the tracer */
#define LTTNG_RING_BUFFER_COMPAT_GET_CURRENT_TIMESTAMP \
	LTTNG_RING_BUFFER_GET_CURRENT_TIMESTAMP
/* returns the packet sequence number of the current sub-buffer */
#define LTTNG_RING_BUFFER_COMPAT_GET_SEQ_NUM	\
	LTTNG_RING_BUFFER_GET_SEQ_NUM
/* returns the stream instance id (invariant for the stream) */
#define LTTNG_RING_BUFFER_COMPAT_INSTANCE_ID	\
	LTTNG_RING_BUFFER_INSTANCE_ID
#endif /* CONFIG_COMPAT */

#endif /* _LTTNG_ABI_H */
Commit	Line	Data
	1	/* SPDX-License-Identifier: (GPL-2.0 or LGPL-2.1)
	2	*
	3	* lttng-abi.h
	4	*
	5	* LTTng ABI header
	6	*
	7	* Copyright (C) 2010-2012 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
	8	*/
	9
	10	#ifndef _LTTNG_ABI_H
	11	#define _LTTNG_ABI_H
	12
	13	#include <linux/fs.h>
	14
	15	/*
	16	* Major/minor version of ABI exposed to lttng tools. Major number
	17	* should be increased when an incompatible ABI change is done.
	18	*/
	19	#define LTTNG_MODULES_ABI_MAJOR_VERSION 2
	20	#define LTTNG_MODULES_ABI_MINOR_VERSION 5
	21
	22	#define LTTNG_KERNEL_SYM_NAME_LEN 256
	23	#define LTTNG_KERNEL_SESSION_NAME_LEN 256
	24
	25	/*
	26	* The expected iso8601 time formats are either:
	27	*
	28	* - YYYYmmddTHHMMSS+HHMM (20 characters + \0)
	29	* - YYYY-mm-ddTHH:MM:SS+HH:MM (25 characters + \0)
	30	*/
	31	#define LTTNG_KERNEL_SESSION_CREATION_TIME_ISO8601_LEN 26
	32
	33	enum lttng_kernel_instrumentation {
	34	LTTNG_KERNEL_TRACEPOINT = 0,
	35	LTTNG_KERNEL_KPROBE = 1,
	36	LTTNG_KERNEL_FUNCTION = 2,
	37	LTTNG_KERNEL_KRETPROBE = 3,
	38	LTTNG_KERNEL_NOOP = 4, /* not hooked */
	39	LTTNG_KERNEL_SYSCALL = 5,
	40	LTTNG_KERNEL_UPROBE = 6,
	41	};
	42
	43	/*
	44	* LTTng consumer mode
	45	*/
	46	enum lttng_kernel_output {
	47	LTTNG_KERNEL_SPLICE = 0,
	48	LTTNG_KERNEL_MMAP = 1,
	49	};
	50
	51	/*
	52	* LTTng DebugFS ABI structures.
	53	*/
	54	#define LTTNG_KERNEL_CHANNEL_PADDING LTTNG_KERNEL_SYM_NAME_LEN + 32
	55	struct lttng_kernel_channel {
	56	uint64_t subbuf_size; /* in bytes */
	57	uint64_t num_subbuf;
	58	unsigned int switch_timer_interval; /* usecs */
	59	unsigned int read_timer_interval; /* usecs */
	60	enum lttng_kernel_output output; /* splice, mmap */
	61	int overwrite; /* 1: overwrite, 0: discard */
	62	char padding[LTTNG_KERNEL_CHANNEL_PADDING];
	63	} __attribute__((packed));
	64
	65	struct lttng_kernel_kretprobe {
	66	uint64_t addr;
	67
	68	uint64_t offset;
	69	char symbol_name[LTTNG_KERNEL_SYM_NAME_LEN];
	70	} __attribute__((packed));
	71
	72	/*
	73	* Either addr is used, or symbol_name and offset.
	74	*/
	75	struct lttng_kernel_kprobe {
	76	uint64_t addr;
	77
	78	uint64_t offset;
	79	char symbol_name[LTTNG_KERNEL_SYM_NAME_LEN];
	80	} __attribute__((packed));
	81
	82	struct lttng_kernel_function_tracer {
	83	char symbol_name[LTTNG_KERNEL_SYM_NAME_LEN];
	84	} __attribute__((packed));
	85
	86	struct lttng_kernel_uprobe {
	87	int fd;
	88	} __attribute__((packed));
	89
	90	struct lttng_kernel_event_callsite_uprobe {
	91	uint64_t offset;
	92	} __attribute__((packed));
	93
	94	struct lttng_kernel_event_callsite {
	95	union {
	96	struct lttng_kernel_event_callsite_uprobe uprobe;
	97	} u;
	98	} __attribute__((packed));
	99
	100	enum lttng_kernel_syscall_entryexit {
	101	LTTNG_KERNEL_SYSCALL_ENTRYEXIT = 0,
	102	LTTNG_KERNEL_SYSCALL_ENTRY = 1, /* Not implemented. */
	103	LTTNG_KERNEL_SYSCALL_EXIT = 2, /* Not implemented. */
	104	};
	105
	106	enum lttng_kernel_syscall_abi {
	107	LTTNG_KERNEL_SYSCALL_ABI_ALL = 0,
	108	LTTNG_KERNEL_SYSCALL_ABI_NATIVE = 1, /* Not implemented. */
	109	LTTNG_KERNEL_SYSCALL_ABI_COMPAT = 2, /* Not implemented. */
	110	};
	111
	112	enum lttng_kernel_syscall_match {
	113	LTTNG_SYSCALL_MATCH_NAME = 0,
	114	LTTNG_SYSCALL_MATCH_NR = 1, /* Not implemented. */
	115	};
	116
	117	struct lttng_kernel_syscall {
	118	uint8_t entryexit; /* enum lttng_kernel_syscall_entryexit */
	119	uint8_t abi; /* enum lttng_kernel_syscall_abi */
	120	uint8_t match; /* enum lttng_kernel_syscall_match */
	121	uint8_t padding;
	122	uint32_t nr; /* For LTTNG_SYSCALL_MATCH_NR */
	123	} __attribute__((packed));
	124
	125	/*
	126	* For syscall tracing, name = "*" means "enable all".
	127	*/
	128	#define LTTNG_KERNEL_EVENT_PADDING1 16
	129	#define LTTNG_KERNEL_EVENT_PADDING2 LTTNG_KERNEL_SYM_NAME_LEN + 32
	130	struct lttng_kernel_event {
	131	char name[LTTNG_KERNEL_SYM_NAME_LEN]; /* event name */
	132	enum lttng_kernel_instrumentation instrumentation;
	133	char padding[LTTNG_KERNEL_EVENT_PADDING1];
	134
	135	/* Per instrumentation type configuration */
	136	union {
	137	struct lttng_kernel_kretprobe kretprobe;
	138	struct lttng_kernel_kprobe kprobe;
	139	struct lttng_kernel_function_tracer ftrace;
	140	struct lttng_kernel_uprobe uprobe;
	141	struct lttng_kernel_syscall syscall;
	142	char padding[LTTNG_KERNEL_EVENT_PADDING2];
	143	} u;
	144	} __attribute__((packed));
	145
	146	struct lttng_kernel_tracer_version {
	147	uint32_t major;
	148	uint32_t minor;
	149	uint32_t patchlevel;
	150	} __attribute__((packed));
	151
	152	struct lttng_kernel_tracer_abi_version {
	153	uint32_t major;
	154	uint32_t minor;
	155	} __attribute__((packed));
	156
	157	struct lttng_kernel_session_name {
	158	char name[LTTNG_KERNEL_SESSION_NAME_LEN];
	159	} __attribute__((packed));
	160
	161	struct lttng_kernel_session_creation_time {
	162	char iso8601[LTTNG_KERNEL_SESSION_CREATION_TIME_ISO8601_LEN];
	163	} __attribute__((packed));
	164
	165	enum lttng_kernel_calibrate_type {
	166	LTTNG_KERNEL_CALIBRATE_KRETPROBE,
	167	};
	168
	169	struct lttng_kernel_calibrate {
	170	enum lttng_kernel_calibrate_type type; /* type (input) */
	171	} __attribute__((packed));
	172
	173	struct lttng_kernel_syscall_mask {
	174	uint32_t len; /* in bits */
	175	char mask[];
	176	} __attribute__((packed));
	177
	178	enum lttng_kernel_context_type {
	179	LTTNG_KERNEL_CONTEXT_PID = 0,
	180	LTTNG_KERNEL_CONTEXT_PERF_COUNTER = 1,
	181	LTTNG_KERNEL_CONTEXT_PROCNAME = 2,
	182	LTTNG_KERNEL_CONTEXT_PRIO = 3,
	183	LTTNG_KERNEL_CONTEXT_NICE = 4,
	184	LTTNG_KERNEL_CONTEXT_VPID = 5,
	185	LTTNG_KERNEL_CONTEXT_TID = 6,
	186	LTTNG_KERNEL_CONTEXT_VTID = 7,
	187	LTTNG_KERNEL_CONTEXT_PPID = 8,
	188	LTTNG_KERNEL_CONTEXT_VPPID = 9,
	189	LTTNG_KERNEL_CONTEXT_HOSTNAME = 10,
	190	LTTNG_KERNEL_CONTEXT_CPU_ID = 11,
	191	LTTNG_KERNEL_CONTEXT_INTERRUPTIBLE = 12,
	192	LTTNG_KERNEL_CONTEXT_PREEMPTIBLE = 13,
	193	LTTNG_KERNEL_CONTEXT_NEED_RESCHEDULE = 14,
	194	LTTNG_KERNEL_CONTEXT_MIGRATABLE = 15,
	195	LTTNG_KERNEL_CONTEXT_CALLSTACK_KERNEL = 16,
	196	LTTNG_KERNEL_CONTEXT_CALLSTACK_USER = 17,
	197	LTTNG_KERNEL_CONTEXT_CGROUP_NS = 18,
	198	LTTNG_KERNEL_CONTEXT_IPC_NS = 19,
	199	LTTNG_KERNEL_CONTEXT_MNT_NS = 20,
	200	LTTNG_KERNEL_CONTEXT_NET_NS = 21,
	201	LTTNG_KERNEL_CONTEXT_PID_NS = 22,
	202	LTTNG_KERNEL_CONTEXT_USER_NS = 23,
	203	LTTNG_KERNEL_CONTEXT_UTS_NS = 24,
	204	LTTNG_KERNEL_CONTEXT_UID = 25,
	205	LTTNG_KERNEL_CONTEXT_EUID = 26,
	206	LTTNG_KERNEL_CONTEXT_SUID = 27,
	207	LTTNG_KERNEL_CONTEXT_GID = 28,
	208	LTTNG_KERNEL_CONTEXT_EGID = 29,
	209	LTTNG_KERNEL_CONTEXT_SGID = 30,
	210	LTTNG_KERNEL_CONTEXT_VUID = 31,
	211	LTTNG_KERNEL_CONTEXT_VEUID = 32,
	212	LTTNG_KERNEL_CONTEXT_VSUID = 33,
	213	LTTNG_KERNEL_CONTEXT_VGID = 34,
	214	LTTNG_KERNEL_CONTEXT_VEGID = 35,
	215	LTTNG_KERNEL_CONTEXT_VSGID = 36,
	216	};
	217
	218	struct lttng_kernel_perf_counter_ctx {
	219	uint32_t type;
	220	uint64_t config;
	221	char name[LTTNG_KERNEL_SYM_NAME_LEN];
	222	} __attribute__((packed));
	223
	224	#define LTTNG_KERNEL_CONTEXT_PADDING1 16
	225	#define LTTNG_KERNEL_CONTEXT_PADDING2 LTTNG_KERNEL_SYM_NAME_LEN + 32
	226	struct lttng_kernel_context {
	227	enum lttng_kernel_context_type ctx;
	228	char padding[LTTNG_KERNEL_CONTEXT_PADDING1];
	229
	230	union {
	231	struct lttng_kernel_perf_counter_ctx perf_counter;
	232	char padding[LTTNG_KERNEL_CONTEXT_PADDING2];
	233	} u;
	234	} __attribute__((packed));
	235
	236	#define LTTNG_KERNEL_FILTER_BYTECODE_MAX_LEN 65536
	237	struct lttng_kernel_filter_bytecode {
	238	uint32_t len;
	239	uint32_t reloc_offset;
	240	uint64_t seqnum;
	241	char data[0];
	242	} __attribute__((packed));
	243
	244	enum lttng_kernel_tracker_type {
	245	LTTNG_KERNEL_TRACKER_UNKNOWN = -1,
	246
	247	LTTNG_KERNEL_TRACKER_PID = 0,
	248	LTTNG_KERNEL_TRACKER_VPID = 1,
	249	LTTNG_KERNEL_TRACKER_UID = 2,
	250	LTTNG_KERNEL_TRACKER_VUID = 3,
	251	LTTNG_KERNEL_TRACKER_GID = 4,
	252	LTTNG_KERNEL_TRACKER_VGID = 5,
	253	};
	254
	255	struct lttng_kernel_tracker_args {
	256	enum lttng_kernel_tracker_type type;
	257	int32_t id;
	258	};
	259
	260	/* LTTng file descriptor ioctl */
	261	/* lttng-abi-old.h reserve 0x40, 0x41, 0x42, 0x43, and 0x44. */
	262	#define LTTNG_KERNEL_SESSION _IO(0xF6, 0x45)
	263	#define LTTNG_KERNEL_TRACER_VERSION \
	264	_IOR(0xF6, 0x46, struct lttng_kernel_tracer_version)
	265	#define LTTNG_KERNEL_TRACEPOINT_LIST _IO(0xF6, 0x47)
	266	#define LTTNG_KERNEL_WAIT_QUIESCENT _IO(0xF6, 0x48)
	267	#define LTTNG_KERNEL_CALIBRATE \
	268	_IOWR(0xF6, 0x49, struct lttng_kernel_calibrate)
	269	#define LTTNG_KERNEL_SYSCALL_LIST _IO(0xF6, 0x4A)
	270	#define LTTNG_KERNEL_TRACER_ABI_VERSION \
	271	_IOR(0xF6, 0x4B, struct lttng_kernel_tracer_abi_version)
	272
	273	/* Session FD ioctl */
	274	/* lttng-abi-old.h reserve 0x50, 0x51, 0x52, and 0x53. */
	275	#define LTTNG_KERNEL_METADATA \
	276	_IOW(0xF6, 0x54, struct lttng_kernel_channel)
	277	#define LTTNG_KERNEL_CHANNEL \
	278	_IOW(0xF6, 0x55, struct lttng_kernel_channel)
	279	#define LTTNG_KERNEL_SESSION_START _IO(0xF6, 0x56)
	280	#define LTTNG_KERNEL_SESSION_STOP _IO(0xF6, 0x57)
	281	#define LTTNG_KERNEL_SESSION_TRACK_PID \
	282	_IOR(0xF6, 0x58, int32_t)
	283	#define LTTNG_KERNEL_SESSION_UNTRACK_PID \
	284	_IOR(0xF6, 0x59, int32_t)
	285
	286	/*
	287	* ioctl 0x58 and 0x59 are duplicated here. It works, since _IOR vs _IO
	288	* are generating two different ioctl numbers, but this was not done on
	289	* purpose. We should generally try to avoid those duplications.
	290	*/
	291	#define LTTNG_KERNEL_SESSION_LIST_TRACKER_PIDS _IO(0xF6, 0x58)
	292	#define LTTNG_KERNEL_SESSION_METADATA_REGEN _IO(0xF6, 0x59)
	293
	294	/* lttng-abi-old.h reserve 0x5A and 0x5B. */
	295	#define LTTNG_KERNEL_SESSION_STATEDUMP _IO(0xF6, 0x5C)
	296	#define LTTNG_KERNEL_SESSION_SET_NAME \
	297	_IOR(0xF6, 0x5D, struct lttng_kernel_session_name)
	298	#define LTTNG_KERNEL_SESSION_SET_CREATION_TIME \
	299	_IOR(0xF6, 0x5E, struct lttng_kernel_session_creation_time)
	300
	301	/* Channel FD ioctl */
	302	/* lttng-abi-old.h reserve 0x60 and 0x61. */
	303	#define LTTNG_KERNEL_STREAM _IO(0xF6, 0x62)
	304	#define LTTNG_KERNEL_EVENT \
	305	_IOW(0xF6, 0x63, struct lttng_kernel_event)
	306	#define LTTNG_KERNEL_SYSCALL_MASK \
	307	_IOWR(0xF6, 0x64, struct lttng_kernel_syscall_mask)
	308
	309	/* Event and Channel FD ioctl */
	310	/* lttng-abi-old.h reserve 0x70. */
	311	#define LTTNG_KERNEL_CONTEXT \
	312	_IOW(0xF6, 0x71, struct lttng_kernel_context)
	313
	314	/* Event, Channel and Session ioctl */
	315	/* lttng-abi-old.h reserve 0x80 and 0x81. */
	316	#define LTTNG_KERNEL_ENABLE _IO(0xF6, 0x82)
	317	#define LTTNG_KERNEL_DISABLE _IO(0xF6, 0x83)
	318
	319	/* Event FD ioctl */
	320	#define LTTNG_KERNEL_FILTER _IO(0xF6, 0x90)
	321	#define LTTNG_KERNEL_ADD_CALLSITE _IO(0xF6, 0x91)
	322
	323	/* Session FD ioctl (continued) */
	324	#define LTTNG_KERNEL_SESSION_LIST_TRACKER_IDS \
	325	_IOR(0xF6, 0xA0, struct lttng_kernel_tracker_args)
	326	#define LTTNG_KERNEL_SESSION_TRACK_ID \
	327	_IOR(0xF6, 0xA1, struct lttng_kernel_tracker_args)
	328	#define LTTNG_KERNEL_SESSION_UNTRACK_ID \
	329	_IOR(0xF6, 0xA2, struct lttng_kernel_tracker_args)
	330
	331	/*
	332	* LTTng-specific ioctls for the lib ringbuffer.
	333	*
	334	* Operations applying to the current sub-buffer need to occur between
	335	* a get/put or get_next/put_next ioctl pair.
	336	*/
	337
	338	/* returns the timestamp begin of the current sub-buffer */
	339	#define LTTNG_RING_BUFFER_GET_TIMESTAMP_BEGIN _IOR(0xF6, 0x20, uint64_t)
	340	/* returns the timestamp end of the current sub-buffer */
	341	#define LTTNG_RING_BUFFER_GET_TIMESTAMP_END _IOR(0xF6, 0x21, uint64_t)
	342	/* returns the number of events discarded of the current sub-buffer */
	343	#define LTTNG_RING_BUFFER_GET_EVENTS_DISCARDED _IOR(0xF6, 0x22, uint64_t)
	344	/* returns the packet payload size of the current sub-buffer */
	345	#define LTTNG_RING_BUFFER_GET_CONTENT_SIZE _IOR(0xF6, 0x23, uint64_t)
	346	/* returns the packet size of the current sub-buffer*/
	347	#define LTTNG_RING_BUFFER_GET_PACKET_SIZE _IOR(0xF6, 0x24, uint64_t)
	348	/* returns the stream id (invariant for the stream) */
	349	#define LTTNG_RING_BUFFER_GET_STREAM_ID _IOR(0xF6, 0x25, uint64_t)
	350	/* returns the current timestamp as perceived from the tracer */
	351	#define LTTNG_RING_BUFFER_GET_CURRENT_TIMESTAMP _IOR(0xF6, 0x26, uint64_t)
	352	/* returns the packet sequence number of the current sub-buffer */
	353	#define LTTNG_RING_BUFFER_GET_SEQ_NUM _IOR(0xF6, 0x27, uint64_t)
	354	/* returns the stream instance id (invariant for the stream) */
	355	#define LTTNG_RING_BUFFER_INSTANCE_ID _IOR(0xF6, 0x28, uint64_t)
	356
	357	#ifdef CONFIG_COMPAT
	358	/* returns the timestamp begin of the current sub-buffer */
	359	#define LTTNG_RING_BUFFER_COMPAT_GET_TIMESTAMP_BEGIN \
	360	LTTNG_RING_BUFFER_GET_TIMESTAMP_BEGIN
	361	/* returns the timestamp end of the current sub-buffer */
	362	#define LTTNG_RING_BUFFER_COMPAT_GET_TIMESTAMP_END \
	363	LTTNG_RING_BUFFER_GET_TIMESTAMP_END
	364	/* returns the number of events discarded of the current sub-buffer */
	365	#define LTTNG_RING_BUFFER_COMPAT_GET_EVENTS_DISCARDED \
	366	LTTNG_RING_BUFFER_GET_EVENTS_DISCARDED
	367	/* returns the packet payload size of the current sub-buffer */
	368	#define LTTNG_RING_BUFFER_COMPAT_GET_CONTENT_SIZE \
	369	LTTNG_RING_BUFFER_GET_CONTENT_SIZE
	370	/* returns the packet size of the current sub-buffer */
	371	#define LTTNG_RING_BUFFER_COMPAT_GET_PACKET_SIZE \
	372	LTTNG_RING_BUFFER_GET_PACKET_SIZE
	373	/* returns the stream id (invariant for the stream) */
	374	#define LTTNG_RING_BUFFER_COMPAT_GET_STREAM_ID \
	375	LTTNG_RING_BUFFER_GET_STREAM_ID
	376	/* returns the current timestamp as perceived from the tracer */
	377	#define LTTNG_RING_BUFFER_COMPAT_GET_CURRENT_TIMESTAMP \
	378	LTTNG_RING_BUFFER_GET_CURRENT_TIMESTAMP
	379	/* returns the packet sequence number of the current sub-buffer */
	380	#define LTTNG_RING_BUFFER_COMPAT_GET_SEQ_NUM \
	381	LTTNG_RING_BUFFER_GET_SEQ_NUM
	382	/* returns the stream instance id (invariant for the stream) */
	383	#define LTTNG_RING_BUFFER_COMPAT_INSTANCE_ID \
	384	LTTNG_RING_BUFFER_INSTANCE_ID
	385	#endif /* CONFIG_COMPAT */
	386
	387	#endif /* _LTTNG_ABI_H */