Split lttng.h into several files
[lttng-tools.git] / include / lttng / domain.h
CommitLineData
1239a312
DG
1/*
2 * Copyright (C) 2014 - David Goulet <dgoulet@efficios.com>
3 *
4 * This library is free software; you can redistribute it and/or modify it
5 * under the terms of the GNU Lesser General Public License, version 2.1 only,
6 * as published by the Free Software Foundation.
7 *
8 * This library 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 Lesser General Public License
11 * for more details.
12 *
13 * You should have received a copy of the GNU Lesser General Public License
14 * along with this library; if not, write to the Free Software Foundation,
15 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16 */
17
18#ifndef LTTNG_DOMAIN_H
19#define LTTNG_DOMAIN_H
20
21#ifdef __cplusplus
22extern "C" {
23#endif
24
25#include <lttng/constant.h>
26
27/*
28 * Domain types: the different possible tracers.
29 */
30enum lttng_domain_type {
31 LTTNG_DOMAIN_KERNEL = 1, /* Linux Kernel tracer. */
32 LTTNG_DOMAIN_UST = 2, /* Global Userspace tracer. */
33 LTTNG_DOMAIN_JUL = 3, /* Java Util Logging. */
34};
35
36/* Buffer type for a specific domain. */
37enum lttng_buffer_type {
38 LTTNG_BUFFER_PER_PID, /* Only supported by UST being the default. */
39 LTTNG_BUFFER_PER_UID, /* Only supported by UST. */
40 LTTNG_BUFFER_GLOBAL, /* Only supported by the Kernel. */
41};
42
43/*
44 * The structures should be initialized to zero before use.
45 */
46#define LTTNG_DOMAIN_PADDING1 12
47#define LTTNG_DOMAIN_PADDING2 LTTNG_SYMBOL_NAME_LEN + 32
48struct lttng_domain {
49 enum lttng_domain_type type;
50 enum lttng_buffer_type buf_type;
51 char padding[LTTNG_DOMAIN_PADDING1];
52
53 union {
54 pid_t pid;
55 char exec_name[NAME_MAX];
56 char padding[LTTNG_DOMAIN_PADDING2];
57 } attr;
58};
59
60/*
61 * List the registered domain(s) of a session.
62 *
63 * Session name CAN NOT be NULL.
64 *
65 * Return the size (number of entries) of the "lttng_domain" array. Caller
66 * must free domains. On error, a negative LTTng error code is returned.
67 */
68extern int lttng_list_domains(const char *session_name,
69 struct lttng_domain **domains);
70
71#ifdef __cplusplus
72}
73#endif
74
75#endif /* LTTNG_DOMAIN_H */
This page took 0.025763 seconds and 5 git commands to generate.