[lttng-tools.git] / src / bin / lttng-sessiond / buffer-registry.h

/*
 * Copyright (C) 2013 - David Goulet <dgoulet@efficios.com>
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License, version 2 only, as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
 * more details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc., 51
 * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */

#ifndef LTTNG_BUFFER_REGISTRY_H
#define LTTNG_BUFFER_REGISTRY_H

#include <stdint.h>
#include <urcu/list.h>

#include <lttng/lttng.h>
#include <common/hashtable/hashtable.h>

#include "consumer.h"
#include "ust-ctl.h"
#include "ust-registry.h"

struct buffer_reg_stream {
	struct cds_list_head lnode;
	union {
		/* Original object data that MUST be copied over. */
		struct lttng_ust_object_data *ust;
	} obj;
};

struct buffer_reg_channel {
	/* This key is the same as a tracing channel key. */
	uint32_t key;
	/* Key of the channel on the consumer side. */
	uint64_t consumer_key;
	/* Stream registry object of this channel registry. */
	struct cds_list_head streams;
	/* Used to ensure mutual exclusion to the stream's list. */
	pthread_mutex_t stream_list_lock;
	/* Node for hash table usage. */
	struct lttng_ht_node_u64 node;
	union {
		/* Original object data that MUST be copied over. */
		struct lttng_ust_object_data *ust;
	} obj;
};

struct buffer_reg_session {
	/* Registry per domain. */
	union {
		struct ust_registry_session *ust;
	} reg;

	/* Contains buffer registry channel indexed by tracing channel key. */
	struct lttng_ht *channels;
};

/*
 * Registry object for per UID buffers.
 */
struct buffer_reg_uid {
	/*
	 * Keys to match this object in a hash table. The following three variables
	 * identify a unique per UID buffer registry.
	 */
	int session_id;		/* Unique tracing session id. */
	int bits_per_long;	/* ABI */
	uid_t uid;			/* Owner. */

	enum lttng_domain_type domain;
	struct buffer_reg_session *registry;

	/* Indexed by session id. */
	struct lttng_ht_node_u64 node;
	/* Node of a linked list used to teardown object at a destroy session. */
	struct cds_list_head lnode;
};

/*
 * Registry object for per PID buffers.
 */
struct buffer_reg_pid {
	int session_id;

	struct buffer_reg_session *registry;

	/* Indexed by session id. */
	struct lttng_ht_node_ulong node;
};

/* Buffer registry per UID. */
void buffer_reg_init_uid_registry(void);
int buffer_reg_uid_create(int session_id, uint32_t bits_per_long, uid_t uid,
		enum lttng_domain_type domain, struct buffer_reg_uid **regp);
void buffer_reg_uid_add(struct buffer_reg_uid *reg);
struct buffer_reg_uid *buffer_reg_uid_find(int session_id,
		uint32_t bits_per_long, uid_t uid);
void buffer_reg_uid_remove(struct buffer_reg_uid *regp);
void buffer_reg_uid_destroy(struct buffer_reg_uid *regp,
		struct consumer_output *consumer);

/* Buffer registry per PID. */
void buffer_reg_init_pid_registry(void);
int buffer_reg_pid_create(int session_id, struct buffer_reg_pid **regp);
void buffer_reg_pid_add(struct buffer_reg_pid *reg);
struct buffer_reg_pid *buffer_reg_pid_find(int session_id);
void buffer_reg_pid_remove(struct buffer_reg_pid *regp);
void buffer_reg_pid_destroy(struct buffer_reg_pid *regp);

/* Channel */
int buffer_reg_channel_create(uint64_t key, struct buffer_reg_channel **regp);
void buffer_reg_channel_add(struct buffer_reg_session *session,
		struct buffer_reg_channel *channel);
struct buffer_reg_channel *buffer_reg_channel_find(uint64_t key,
		struct buffer_reg_uid *reg);
void buffer_reg_channel_remove(struct buffer_reg_session *session,
		struct buffer_reg_channel *regp);
void buffer_reg_channel_destroy(struct buffer_reg_channel *regp,
		enum lttng_domain_type domain);

/* Stream */
int buffer_reg_stream_create(struct buffer_reg_stream **regp);
void buffer_reg_stream_add(struct buffer_reg_stream *stream,
		struct buffer_reg_channel *channel);
void buffer_reg_stream_destroy(struct buffer_reg_stream *regp,
		enum lttng_domain_type domain);

/* Global registry. */
void buffer_reg_destroy_registries(void);

#endif /* LTTNG_BUFFER_REGISTRY_H */
Commit	Line	Data
7972aab2 DG	1	/*
	2	* Copyright (C) 2013 - David Goulet <dgoulet@efficios.com>
	3	*
	4	* This program is free software; you can redistribute it and/or modify it
	5	* under the terms of the GNU General Public License, version 2 only, as
	6	* published by the Free Software Foundation.
	7	*
	8	* This program is distributed in the hope that it will be useful, but WITHOUT
	9	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
	10	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
	11	* more details.
	12	*
	13	* You should have received a copy of the GNU General Public License along with
	14	* this program; if not, write to the Free Software Foundation, Inc., 51
	15	* Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
	16	*/
	17
	18	#ifndef LTTNG_BUFFER_REGISTRY_H
	19	#define LTTNG_BUFFER_REGISTRY_H
	20
	21	#include <stdint.h>
7972aab2 DG	22	#include <urcu/list.h>
	23
	24	#include <lttng/lttng.h>
	25	#include <common/hashtable/hashtable.h>
	26
	27	#include "consumer.h"
534b3ed8	28	#include "ust-ctl.h"
7972aab2 DG	29	#include "ust-registry.h"
	30
	31	struct buffer_reg_stream {
	32	struct cds_list_head lnode;
	33	union {
	34	/* Original object data that MUST be copied over. */
	35	struct lttng_ust_object_data *ust;
	36	} obj;
	37	};
	38
	39	struct buffer_reg_channel {
	40	/* This key is the same as a tracing channel key. */
	41	uint32_t key;
	42	/* Key of the channel on the consumer side. */
	43	uint64_t consumer_key;
	44	/* Stream registry object of this channel registry. */
	45	struct cds_list_head streams;
	46	/* Used to ensure mutual exclusion to the stream's list. */
	47	pthread_mutex_t stream_list_lock;
	48	/* Node for hash table usage. */
	49	struct lttng_ht_node_u64 node;
	50	union {
	51	/* Original object data that MUST be copied over. */
	52	struct lttng_ust_object_data *ust;
	53	} obj;
	54	};
	55
	56	struct buffer_reg_session {
	57	/* Registry per domain. */
	58	union {
	59	struct ust_registry_session *ust;
	60	} reg;
	61
	62	/* Contains buffer registry channel indexed by tracing channel key. */
	63	struct lttng_ht *channels;
	64	};
	65
	66	/*
	67	* Registry object for per UID buffers.
	68	*/
	69	struct buffer_reg_uid {
	70	/*
	71	* Keys to match this object in a hash table. The following three variables
	72	* identify a unique per UID buffer registry.
	73	*/
	74	int session_id; /* Unique tracing session id. */
	75	int bits_per_long; /* ABI */
	76	uid_t uid; /* Owner. */
	77
	78	enum lttng_domain_type domain;
	79	struct buffer_reg_session *registry;
	80
	81	/* Indexed by session id. */
	82	struct lttng_ht_node_u64 node;
	83	/* Node of a linked list used to teardown object at a destroy session. */
	84	struct cds_list_head lnode;
	85	};
	86
	87	/*
	88	* Registry object for per PID buffers.
	89	*/
	90	struct buffer_reg_pid {
	91	int session_id;
	92
93	struct buffer_reg_session *registry;
94
95	/* Indexed by session id. */
96	struct lttng_ht_node_ulong node;
97	};
98
99	/* Buffer registry per UID. */
100	void buffer_reg_init_uid_registry(void);
101	int buffer_reg_uid_create(int session_id, uint32_t bits_per_long, uid_t uid,
102	enum lttng_domain_type domain, struct buffer_reg_uid **regp);
103	void buffer_reg_uid_add(struct buffer_reg_uid *reg);
104	struct buffer_reg_uid *buffer_reg_uid_find(int session_id,
105	uint32_t bits_per_long, uid_t uid);
106	void buffer_reg_uid_remove(struct buffer_reg_uid *regp);
107	void buffer_reg_uid_destroy(struct buffer_reg_uid *regp,
108	struct consumer_output *consumer);
109
110	/* Buffer registry per PID. */
111	void buffer_reg_init_pid_registry(void);
112	int buffer_reg_pid_create(int session_id, struct buffer_reg_pid **regp);
113	void buffer_reg_pid_add(struct buffer_reg_pid *reg);
114	struct buffer_reg_pid *buffer_reg_pid_find(int session_id);
115	void buffer_reg_pid_remove(struct buffer_reg_pid *regp);
116	void buffer_reg_pid_destroy(struct buffer_reg_pid *regp);
117
118	/* Channel */
119	int buffer_reg_channel_create(uint64_t key, struct buffer_reg_channel **regp);
120	void buffer_reg_channel_add(struct buffer_reg_session *session,
121	struct buffer_reg_channel *channel);
122	struct buffer_reg_channel *buffer_reg_channel_find(uint64_t key,
123	struct buffer_reg_uid *reg);
124	void buffer_reg_channel_remove(struct buffer_reg_session *session,
125	struct buffer_reg_channel *regp);
126	void buffer_reg_channel_destroy(struct buffer_reg_channel *regp,
127	enum lttng_domain_type domain);
128
129	/* Stream */
130	int buffer_reg_stream_create(struct buffer_reg_stream **regp);
131	void buffer_reg_stream_add(struct buffer_reg_stream *stream,
132	struct buffer_reg_channel *channel);
133	void buffer_reg_stream_destroy(struct buffer_reg_stream *regp,
134	enum lttng_domain_type domain);
135
7972aab2 DG	136	/* Global registry. */
	137	void buffer_reg_destroy_registries(void);
	138
	139	#endif /* LTTNG_BUFFER_REGISTRY_H */