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_KERNEL                   = 1,      /* Linux Kernel tracer. */
  32         LTTNG_DOMAIN_UST                      = 2,      /* Global Userspace tracer. */
  33         LTTNG_DOMAIN_JUL                      = 3,      /* Java Util Logging. */
  34         LTTNG_DOMAIN_LOG4J                    = 4,      /* Java Log4j Framework. */
  35         LTTNG_DOMAIN_PYTHON                   = 5,      /* Python logging Framework. */
  36 };
  37
  38 /* Buffer type for a specific domain. */
  39 enum lttng_buffer_type {
  40         LTTNG_BUFFER_PER_PID,   /* Only supported by UST being the default. */
  41         LTTNG_BUFFER_PER_UID,   /* Only supported by UST. */
  42         LTTNG_BUFFER_GLOBAL,    /* Only supported by the Kernel. */
  43 };
  44
  45 /*
  46  * The structures should be initialized to zero before use.
  47  */
  48 #define LTTNG_DOMAIN_PADDING1              12
  49 #define LTTNG_DOMAIN_PADDING2              LTTNG_SYMBOL_NAME_LEN + 32
  50 struct lttng_domain {
  51         enum lttng_domain_type type;
  52         enum lttng_buffer_type buf_type;
  53         char padding[LTTNG_DOMAIN_PADDING1];
  54
  55         union {
  56                 pid_t pid;
  57                 char exec_name[NAME_MAX];
  58                 char padding[LTTNG_DOMAIN_PADDING2];
  59         } attr;
  60 };
  61
  62 /*
  63  * List the registered domain(s) of a session.
  64  *
  65  * Session name CAN NOT be NULL.
  66  *
  67  * Return the size (number of entries) of the "lttng_domain" array. Caller
  68  * must free domains. On error, a negative LTTng error code is returned.
  69  */
  70 extern int lttng_list_domains(const char *session_name,
  71                 struct lttng_domain **domains);
  72
  73 #ifdef __cplusplus
  74 }
  75 #endif
  76
  77 #endif /* LTTNG_DOMAIN_H */