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