/usr/include/lttng/channel.h is in liblttng-ctl-dev 2.5.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 | /*
* Copyright (C) 2014 - David Goulet <dgoulet@efficios.com>
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License, version 2.1 only,
* as published by the Free Software Foundation.
*
* This library 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 Lesser General Public License
* for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this library; if not, write to the Free Software Foundation,
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef LTTNG_CHANNEL_H
#define LTTNG_CHANNEL_H
#include <lttng/domain.h>
#include <lttng/event.h>
#ifdef __cplusplus
extern "C" {
#endif
/*
* Tracer channel attributes. For both kernel and user-space.
*
* The structures should be initialized to zero before use.
*/
#define LTTNG_CHANNEL_ATTR_PADDING1 LTTNG_SYMBOL_NAME_LEN + 12
struct lttng_channel_attr {
int overwrite; /* 1: overwrite, 0: discard */
uint64_t subbuf_size; /* bytes */
uint64_t num_subbuf; /* power of 2 */
unsigned int switch_timer_interval; /* usec */
unsigned int read_timer_interval; /* usec */
enum lttng_event_output output; /* splice, mmap */
/* LTTng 2.1 padding limit */
uint64_t tracefile_size; /* bytes */
uint64_t tracefile_count; /* number of tracefiles */
/* LTTng 2.3 padding limit */
unsigned int live_timer_interval; /* usec */
char padding[LTTNG_CHANNEL_ATTR_PADDING1];
};
/*
* Channel information structure. For both kernel and user-space.
*
* The structures should be initialized to zero before use.
*/
#define LTTNG_CHANNEL_PADDING1 16
struct lttng_channel {
char name[LTTNG_SYMBOL_NAME_LEN];
uint32_t enabled;
struct lttng_channel_attr attr;
char padding[LTTNG_CHANNEL_PADDING1];
};
/*
* List the channel(s) of a session.
*
* The handle CAN NOT be NULL.
*
* Return the size (number of entries) of the "lttng_channel" array. Caller
* must free channels. On error, a negative LTTng error code is returned.
*/
extern int lttng_list_channels(struct lttng_handle *handle,
struct lttng_channel **channels);
/*
* Create or enable a channel.
*
* The chan and handle params can not be NULL.
*
* Return 0 on success else a negative LTTng error code.
*/
extern int lttng_enable_channel(struct lttng_handle *handle,
struct lttng_channel *chan);
/*
* Disable channel.
*
* Name and handle CAN NOT be NULL.
*
* Return 0 on success else a negative LTTng error code.
*/
extern int lttng_disable_channel(struct lttng_handle *handle,
const char *name);
/*
* Set the default channel attributes for a specific domain and an allocated
* lttng_channel_attr pointer.
*
* If one or both arguments are NULL, nothing happens.
*/
extern void lttng_channel_set_default_attr(struct lttng_domain *domain,
struct lttng_channel_attr *attr);
#ifdef __cplusplus
}
#endif
#endif /* LTTNG_CHANNEL_H */
|