[lttv.git] / ltt-control / liblttctl / lttctl.h

/* libltt header file
 *
 * Copyright 2005-
 *		 Mathieu Desnoyers <mathieu.desnoyers@polymtl.ca>
 *
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * 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.
 *
 *
 * Inspired from iptables, by James Morris <jmorris@intercode.com.au>.
 * 
 */

#ifndef _LIBLTT_H
#define _LIBLTT_H

#include <linux/limits.h>
#include <asm/types.h>
#include <sys/socket.h>
#include <linux/netlink.h>

#ifndef NETLINK_LTT
#define NETLINK_LTT 31
#endif


enum trace_op {
	OP_CREATE,
	OP_DESTROY,
	OP_START,
	OP_STOP,
	OP_NONE
};

enum trace_mode {
	LTT_TRACE_NORMAL,
	LTT_TRACE_FLIGHT
};

typedef struct lttctl_peer_msg {
	char trace_name[NAME_MAX];
	char trace_type[NAME_MAX];
	enum trace_op op;
	union {
		struct {
			enum trace_mode mode;
			unsigned subbuf_size;
			unsigned n_subbufs;
		} new_trace;
	} args;
} lttctl_peer_msg_t;


struct lttctl_handle
{
	int fd;
	//u_int8_t blocking;
	struct sockaddr_nl local;
	struct sockaddr_nl peer;
};

typedef struct lttctl_resp_msg {
	int err;
} lttctl_resp_msg_t;

struct lttctl_handle *lttctl_create_handle(void);

int lttctl_destroy_handle(struct lttctl_handle *h);


int lttctl_create_trace(const struct lttctl_handle *h,
		char *name, enum trace_mode mode, char *trace_type, unsigned subbuf_size, unsigned n_subbufs);

int lttctl_destroy_trace(const struct lttctl_handle *handle, char *name);

int lttctl_start(const struct lttctl_handle *handle, char *name);

int lttctl_stop(const struct lttctl_handle *handle, char *name);

#define LTTCTLM_BASE	0x10
#define LTTCTLM_CONTROL	(LTTCTLM_BASE + 1)	/* LTT control message */


#endif //_LIBLTT_H
Commit	Line	Data
31d2c6b0	1	/* libltt header file
	2	*
	3	* Copyright 2005-
e59e4125	4	* Mathieu Desnoyers <mathieu.desnoyers@polymtl.ca>
31d2c6b0	5	*
	6	*
	7	* This program is free software; you can redistribute it and/or modify
	8	* it under the terms of the GNU General Public License as published by
	9	* the Free Software Foundation; either version 2 of the License, or
	10	* (at your option) any later version.
	11	*
	12	* This program is distributed in the hope that it will be useful,
	13	* but WITHOUT ANY WARRANTY; without even the implied warranty of
e59e4125	14	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
31d2c6b0	15	* GNU General Public License for more details.
	16	*
	17	*
	18	* Inspired from iptables, by James Morris <jmorris@intercode.com.au>.
	19	*
	20	*/
	21
	22	#ifndef _LIBLTT_H
	23	#define _LIBLTT_H
	24
	25	#include <linux/limits.h>
994ef399	26	#include <asm/types.h>
94fe07f4	27	#include <sys/socket.h>
ace0e68d	28	#include <linux/netlink.h>
	29
	30	#ifndef NETLINK_LTT
71a866fc	31	#define NETLINK_LTT 31
ace0e68d	32	#endif
ace0e68d	33
31d2c6b0	34
	35	enum trace_op {
	36	OP_CREATE,
	37	OP_DESTROY,
	38	OP_START,
ace0e68d	39	OP_STOP,
ace0e68d	40	OP_NONE
31d2c6b0	41	};
	42
	43	enum trace_mode {
ace0e68d	44	LTT_TRACE_NORMAL,
ace0e68d	45	LTT_TRACE_FLIGHT
31d2c6b0	46	};
31d2c6b0	47
fde1a29a	48	typedef struct lttctl_peer_msg {
fde1a29a	49	char trace_name[NAME_MAX];
313b3771	50	char trace_type[NAME_MAX];
fde1a29a	51	enum trace_op op;
fde1a29a	52	union {
e59e4125	53	struct {
	54	enum trace_mode mode;
	55	unsigned subbuf_size;
	56	unsigned n_subbufs;
	57	} new_trace;
fde1a29a	58	} args;
	59	} lttctl_peer_msg_t;
	60
31d2c6b0	61
	62	struct lttctl_handle
	63	{
e59e4125	64	int fd;
	65	//u_int8_t blocking;
	66	struct sockaddr_nl local;
	67	struct sockaddr_nl peer;
31d2c6b0	68	};
31d2c6b0	69
ace0e68d	70	typedef struct lttctl_resp_msg {
	71	int err;
	72	} lttctl_resp_msg_t;
31d2c6b0	73
ace0e68d	74	struct lttctl_handle *lttctl_create_handle(void);
31d2c6b0	75
	76	int lttctl_destroy_handle(struct lttctl_handle *h);
	77
	78
fde1a29a	79	int lttctl_create_trace(const struct lttctl_handle *h,
313b3771	80	char name, enum trace_mode mode, char trace_type, unsigned subbuf_size, unsigned n_subbufs);
31d2c6b0	81
ace0e68d	82	int lttctl_destroy_trace(const struct lttctl_handle handle, char name);
31d2c6b0	83
ace0e68d	84	int lttctl_start(const struct lttctl_handle handle, char name);
31d2c6b0	85
ace0e68d	86	int lttctl_stop(const struct lttctl_handle handle, char name);
31d2c6b0	87
	88	#define LTTCTLM_BASE 0x10
	89	#define LTTCTLM_CONTROL (LTTCTLM_BASE + 1) /* LTT control message */
	90
	91
	92	#endif //_LIBLTT_H