src/bin/lttng-sessiond/trace-kernel.h

   1 /*
   2  * Copyright (C) 2011 - David Goulet <david.goulet@polymtl.ca>
   3  *
   4  * This program is free software; you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License, version 2 only,
   6  * as published by the Free Software Foundation.
   7  *
   8  * This program is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11  * GNU General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public License along
  14  * with this program; if not, write to the Free Software Foundation, Inc.,
  15  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  16  */
  17
  18 #ifndef _LTT_TRACE_KERNEL_H
  19 #define _LTT_TRACE_KERNEL_H
  20
  21 #include <urcu/list.h>
  22
  23 #include <lttng/lttng.h>
  24 #include <common/lttng-kernel.h>
  25
  26 /* Kernel event list */
  27 struct ltt_kernel_event_list {
  28         struct cds_list_head head;
  29 };
  30
  31 /* Channel stream list */
  32 struct ltt_kernel_stream_list {
  33         struct cds_list_head head;
  34 };
  35
  36 /* Channel list */
  37 struct ltt_kernel_channel_list {
  38         struct cds_list_head head;
  39 };
  40
  41 /* Kernel event */
  42 struct ltt_kernel_event {
  43         int fd;
  44         int enabled;
  45         /*
  46          * TODO: need internal representation to support more than a
  47          * single context.
  48          */
  49         struct lttng_kernel_context *ctx;
  50         struct lttng_kernel_event *event;
  51         struct cds_list_head list;
  52 };
  53
  54 /* Kernel channel */
  55 struct ltt_kernel_channel {
  56         int fd;
  57         int enabled;
  58         char *pathname;
  59         unsigned int stream_count;
  60         unsigned int event_count;
  61         /*
  62          * TODO: need internal representation to support more than a
  63          * single context.
  64          */
  65         struct lttng_kernel_context *ctx;
  66         struct lttng_channel *channel;
  67         struct ltt_kernel_event_list events_list;
  68         struct ltt_kernel_stream_list stream_list;
  69         struct cds_list_head list;
  70 };
  71
  72 /* Metadata */
  73 struct ltt_kernel_metadata {
  74         int fd;
  75         char *pathname;
  76         struct lttng_channel *conf;
  77 };
  78
  79 /* Channel stream */
  80 struct ltt_kernel_stream {
  81         int fd;
  82         char *pathname;
  83         int state;
  84         struct cds_list_head list;
  85 };
  86
  87 /* Kernel session */
  88 struct ltt_kernel_session {
  89         int fd;
  90         int metadata_stream_fd;
  91         int consumer_fds_sent;
  92         int consumer_fd;
  93         unsigned int channel_count;
  94         unsigned int stream_count_global;
  95         char *trace_path;
  96         struct ltt_kernel_metadata *metadata;
  97         struct ltt_kernel_channel_list channel_list;
  98         /* UID/GID of the user owning the session */
  99         uid_t uid;
 100         gid_t gid;
 101 };
 102
 103 /*
 104  * Lookup functions. NULL is returned if not found.
 105  */
 106 struct ltt_kernel_event *trace_kernel_get_event_by_name(
 107                 char *name, struct ltt_kernel_channel *channel);
 108 struct ltt_kernel_channel *trace_kernel_get_channel_by_name(
 109                 char *name, struct ltt_kernel_session *session);
 110
 111 /*
 112  * Create functions malloc() the data structure.
 113  */
 114 struct ltt_kernel_session *trace_kernel_create_session(char *path);
 115 struct ltt_kernel_channel *trace_kernel_create_channel(struct lttng_channel *chan, char *path);
 116 struct ltt_kernel_event *trace_kernel_create_event(struct lttng_event *ev);
 117 struct ltt_kernel_metadata *trace_kernel_create_metadata(char *path);
 118 struct ltt_kernel_stream *trace_kernel_create_stream(void);
 119
 120 /*
 121  * Destroy functions free() the data structure and remove from linked list if
 122  * it's applies.
 123  */
 124 void trace_kernel_destroy_session(struct ltt_kernel_session *session);
 125 void trace_kernel_destroy_metadata(struct ltt_kernel_metadata *metadata);
 126 void trace_kernel_destroy_channel(struct ltt_kernel_channel *channel);
 127 void trace_kernel_destroy_event(struct ltt_kernel_event *event);
 128 void trace_kernel_destroy_stream(struct ltt_kernel_stream *stream);
 129
 130 #endif /* _LTT_TRACE_KERNEL_H */