trackers: change error code from "pid" to "id"
[lttng-tools.git] / include / lttng / domain.h
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
22 extern "C" {
23 #endif
24
25 #include <lttng/constant.h>
26
27 /*
28 * Domain types: the different possible tracers.
29 */
30 enum lttng_domain_type {
31 LTTNG_DOMAIN_NONE = 0, /* No associated domain. */
32 LTTNG_DOMAIN_KERNEL = 1, /* Linux Kernel tracer. */
33 LTTNG_DOMAIN_UST = 2, /* Global Userspace tracer. */
34 LTTNG_DOMAIN_JUL = 3, /* Java Util Logging. */
35 LTTNG_DOMAIN_LOG4J = 4, /* Java Log4j Framework. */
36 LTTNG_DOMAIN_PYTHON = 5, /* Python logging Framework. */
37 };
38
39 /* Buffer type for a specific domain. */
40 enum lttng_buffer_type {
41 LTTNG_BUFFER_PER_PID, /* Only supported by UST being the default. */
42 LTTNG_BUFFER_PER_UID, /* Only supported by UST. */
43 LTTNG_BUFFER_GLOBAL, /* Only supported by the Kernel. */
44 };
45
46 /*
47 * The structures should be initialized to zero before use.
48 */
49 #define LTTNG_DOMAIN_PADDING1 12
50 #define LTTNG_DOMAIN_PADDING2 LTTNG_SYMBOL_NAME_LEN + 32
51 struct lttng_domain {
52 enum lttng_domain_type type;
53 enum lttng_buffer_type buf_type;
54 char padding[LTTNG_DOMAIN_PADDING1];
55
56 union {
57 pid_t pid;
58 char exec_name[LTTNG_NAME_MAX];
59 char padding[LTTNG_DOMAIN_PADDING2];
60 } attr;
61 };
62
63 /*
64 * List the registered domain(s) of a session.
65 *
66 * Session name CAN NOT be NULL.
67 *
68 * Return the size (number of entries) of the "lttng_domain" array. Caller
69 * must free domains. On error, a negative LTTng error code is returned.
70 */
71 extern int lttng_list_domains(const char *session_name,
72 struct lttng_domain **domains);
73
74 #ifdef __cplusplus
75 }
76 #endif
77
78 #endif /* LTTNG_DOMAIN_H */
This page took 0.030043 seconds and 4 git commands to generate.