[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
#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));

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