src/bin/lttng-sessiond/channel.c

   1 /*
   2  * Copyright (C) 2011 - David Goulet <david.goulet@polymtl.ca>
   3  * Copyright (C) 2016 - Jérémie Galarneau <jeremie.galarneau@efficios.com>
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License, version 2 only,
   7  * as published by the Free Software Foundation.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License along
  15  * with this program; if not, write to the Free Software Foundation, Inc.,
  16  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  17  */
  18
  19 #define _LGPL_SOURCE
  20 #include <inttypes.h>
  21 #include <string.h>
  22 #include <unistd.h>
  23
  24 #include <common/common.h>
  25 #include <common/defaults.h>
  26 #include <common/sessiond-comm/sessiond-comm.h>
  27
  28 #include "channel.h"
  29 #include "lttng-sessiond.h"
  30 #include "kernel.h"
  31 #include "ust-ctl.h"
  32 #include "utils.h"
  33 #include "ust-app.h"
  34 #include "agent.h"
  35
  36 /*
  37  * Return allocated channel attributes.
  38  */
  39 struct lttng_channel *channel_new_default_attr(int dom,
  40                 enum lttng_buffer_type type)
  41 {
  42         struct lttng_channel *chan;
  43         const char *channel_name = DEFAULT_CHANNEL_NAME;
  44
  45         chan = zmalloc(sizeof(struct lttng_channel));
  46         if (chan == NULL) {
  47                 PERROR("zmalloc channel init");
  48                 goto error_alloc;
  49         }
  50
  51         /* Same for all domains. */
  52         chan->attr.overwrite = DEFAULT_CHANNEL_OVERWRITE;
  53         chan->attr.tracefile_size = DEFAULT_CHANNEL_TRACEFILE_SIZE;
  54         chan->attr.tracefile_count = DEFAULT_CHANNEL_TRACEFILE_COUNT;
  55
  56         switch (dom) {
  57         case LTTNG_DOMAIN_KERNEL:
  58                 assert(type == LTTNG_BUFFER_GLOBAL);
  59                 chan->attr.subbuf_size =
  60                         default_get_kernel_channel_subbuf_size();
  61                 chan->attr.num_subbuf = DEFAULT_KERNEL_CHANNEL_SUBBUF_NUM;
  62                 chan->attr.output = DEFAULT_KERNEL_CHANNEL_OUTPUT;
  63                 chan->attr.switch_timer_interval = DEFAULT_KERNEL_CHANNEL_SWITCH_TIMER;
  64                 chan->attr.read_timer_interval = DEFAULT_KERNEL_CHANNEL_READ_TIMER;
  65                 chan->attr.live_timer_interval = DEFAULT_KERNEL_CHANNEL_LIVE_TIMER;
  66                 break;
  67         case LTTNG_DOMAIN_JUL:
  68                 channel_name = DEFAULT_JUL_CHANNEL_NAME;
  69                 goto common_ust;
  70         case LTTNG_DOMAIN_LOG4J:
  71                 channel_name = DEFAULT_LOG4J_CHANNEL_NAME;
  72                 goto common_ust;
  73         case LTTNG_DOMAIN_PYTHON:
  74                 channel_name = DEFAULT_PYTHON_CHANNEL_NAME;
  75                 goto common_ust;
  76         case LTTNG_DOMAIN_UST:
  77 common_ust:
  78                 switch (type) {
  79                 case LTTNG_BUFFER_PER_UID:
  80                         chan->attr.subbuf_size = default_get_ust_uid_channel_subbuf_size();
  81                         chan->attr.num_subbuf = DEFAULT_UST_UID_CHANNEL_SUBBUF_NUM;
  82                         chan->attr.output = DEFAULT_UST_UID_CHANNEL_OUTPUT;
  83                         chan->attr.switch_timer_interval =
  84                                 DEFAULT_UST_UID_CHANNEL_SWITCH_TIMER;
  85                         chan->attr.read_timer_interval =
  86                                 DEFAULT_UST_UID_CHANNEL_READ_TIMER;
  87                         chan->attr.live_timer_interval =
  88                                 DEFAULT_UST_UID_CHANNEL_LIVE_TIMER;
  89                         break;
  90                 case LTTNG_BUFFER_PER_PID:
  91                 default:
  92                         chan->attr.subbuf_size = default_get_ust_pid_channel_subbuf_size();
  93                         chan->attr.num_subbuf = DEFAULT_UST_PID_CHANNEL_SUBBUF_NUM;
  94                         chan->attr.output = DEFAULT_UST_PID_CHANNEL_OUTPUT;
  95                         chan->attr.switch_timer_interval =
  96                                 DEFAULT_UST_PID_CHANNEL_SWITCH_TIMER;
  97                         chan->attr.read_timer_interval =
  98                                 DEFAULT_UST_PID_CHANNEL_READ_TIMER;
  99                         chan->attr.live_timer_interval =
 100                                 DEFAULT_UST_UID_CHANNEL_LIVE_TIMER;
 101                         break;
 102                 }
 103                 break;
 104         default:
 105                 goto error;     /* Not implemented */
 106         }
 107
 108         if (snprintf(chan->name, sizeof(chan->name), "%s",
 109                         channel_name) < 0) {
 110                 PERROR("snprintf default channel name");
 111                 goto error;
 112         }
 113         return chan;
 114
 115 error:
 116         free(chan);
 117 error_alloc:
 118         return NULL;
 119 }
 120
 121 /*
 122  * Disable kernel channel of the kernel session.
 123  */
 124 int channel_kernel_disable(struct ltt_kernel_session *ksession,
 125                 char *channel_name)
 126 {
 127         int ret;
 128         struct ltt_kernel_channel *kchan;
 129
 130         assert(ksession);
 131         assert(channel_name);
 132
 133         kchan = trace_kernel_get_channel_by_name(channel_name, ksession);
 134         if (kchan == NULL) {
 135                 ret = LTTNG_ERR_KERN_CHAN_NOT_FOUND;
 136                 goto error;
 137         }
 138
 139         /* Only if channel is enabled disable it. */
 140         if (kchan->enabled == 1) {
 141                 ret = kernel_disable_channel(kchan);
 142                 if (ret < 0 && ret != -EEXIST) {
 143                         ret = LTTNG_ERR_KERN_CHAN_DISABLE_FAIL;
 144                         goto error;
 145                 }
 146         }
 147
 148         ret = LTTNG_OK;
 149
 150 error:
 151         return ret;
 152 }
 153
 154 /*
 155  * Enable kernel channel of the kernel session.
 156  */
 157 int channel_kernel_enable(struct ltt_kernel_session *ksession,
 158                 struct ltt_kernel_channel *kchan)
 159 {
 160         int ret;
 161
 162         assert(ksession);
 163         assert(kchan);
 164
 165         if (kchan->enabled == 0) {
 166                 ret = kernel_enable_channel(kchan);
 167                 if (ret < 0) {
 168                         ret = LTTNG_ERR_KERN_CHAN_ENABLE_FAIL;
 169                         goto error;
 170                 }
 171         } else {
 172                 ret = LTTNG_ERR_KERN_CHAN_EXIST;
 173                 goto error;
 174         }
 175
 176         ret = LTTNG_OK;
 177
 178 error:
 179         return ret;
 180 }
 181
 182 static int channel_validate(struct lttng_channel *attr)
 183 {
 184         /*
 185          * The ringbuffer (both in user space and kernel) behave badly
 186          * in overwrite mode and with less than 2 subbuf so block it
 187          * right away and send back an invalid attribute error.
 188          */
 189         if (attr->attr.overwrite && attr->attr.num_subbuf < 2) {
 190                 return -1;
 191         }
 192         return 0;
 193 }
 194
 195 /*
 196  * Create kernel channel of the kernel session and notify kernel thread.
 197  */
 198 int channel_kernel_create(struct ltt_kernel_session *ksession,
 199                 struct lttng_channel *attr, int kernel_pipe)
 200 {
 201         int ret;
 202         struct lttng_channel *defattr = NULL;
 203
 204         assert(ksession);
 205
 206         /* Creating channel attributes if needed */
 207         if (attr == NULL) {
 208                 defattr = channel_new_default_attr(LTTNG_DOMAIN_KERNEL,
 209                                 LTTNG_BUFFER_GLOBAL);
 210                 if (defattr == NULL) {
 211                         ret = LTTNG_ERR_FATAL;
 212                         goto error;
 213                 }
 214                 attr = defattr;
 215         }
 216
 217         /*
 218          * Set the overwrite mode for this channel based on the session
 219          * type unless the client explicitly overrides the channel mode.
 220          */
 221         if (attr->attr.overwrite == DEFAULT_CHANNEL_OVERWRITE) {
 222                 if (ksession->snapshot_mode) {
 223                         attr->attr.overwrite = 1;
 224                 } else {
 225                         attr->attr.overwrite = 0;
 226                 }
 227         }
 228
 229         /* Enforce mmap output for snapshot sessions. */
 230         if (ksession->snapshot_mode) {
 231                 attr->attr.output = LTTNG_EVENT_MMAP;
 232         }
 233
 234         /* Validate common channel properties. */
 235         if (channel_validate(attr) < 0) {
 236                 ret = LTTNG_ERR_INVALID;
 237                 goto error;
 238         }
 239
 240         /* Channel not found, creating it */
 241         ret = kernel_create_channel(ksession, attr);
 242         if (ret < 0) {
 243                 ret = LTTNG_ERR_KERN_CHAN_FAIL;
 244                 goto error;
 245         }
 246
 247         /* Notify kernel thread that there is a new channel */
 248         ret = notify_thread_pipe(kernel_pipe);
 249         if (ret < 0) {
 250                 ret = LTTNG_ERR_FATAL;
 251                 goto error;
 252         }
 253
 254         ret = LTTNG_OK;
 255 error:
 256         free(defattr);
 257         return ret;
 258 }
 259
 260 /*
 261  * Enable UST channel for session and domain.
 262  */
 263 int channel_ust_enable(struct ltt_ust_session *usess,
 264                 struct ltt_ust_channel *uchan)
 265 {
 266         int ret = LTTNG_OK;
 267
 268         assert(usess);
 269         assert(uchan);
 270
 271         /* If already enabled, everything is OK */
 272         if (uchan->enabled) {
 273                 DBG3("Channel %s already enabled. Skipping", uchan->name);
 274                 ret = LTTNG_ERR_UST_CHAN_EXIST;
 275                 goto end;
 276         }
 277
 278         DBG2("Channel %s being enabled in UST domain", uchan->name);
 279
 280         /*
 281          * Enable channel for UST global domain on all applications. Ignore return
 282          * value here since whatever error we got, it means that the channel was
 283          * not created on one or many registered applications and we can not report
 284          * this to the user yet. However, at this stage, the channel was
 285          * successfully created on the session daemon side so the enable-channel
 286          * command is a success.
 287          */
 288         (void) ust_app_enable_channel_glb(usess, uchan);
 289
 290         uchan->enabled = 1;
 291         DBG2("Channel %s enabled successfully", uchan->name);
 292
 293 end:
 294         return ret;
 295 }
 296
 297 /*
 298  * Create UST channel for session and domain.
 299  */
 300 int channel_ust_create(struct ltt_ust_session *usess,
 301                 struct lttng_channel *attr, enum lttng_buffer_type type)
 302 {
 303         int ret = LTTNG_OK;
 304         struct ltt_ust_channel *uchan = NULL;
 305         struct lttng_channel *defattr = NULL;
 306         enum lttng_domain_type domain = LTTNG_DOMAIN_UST;
 307
 308         assert(usess);
 309
 310         /* Creating channel attributes if needed */
 311         if (attr == NULL) {
 312                 defattr = channel_new_default_attr(LTTNG_DOMAIN_UST, type);
 313                 if (defattr == NULL) {
 314                         ret = LTTNG_ERR_FATAL;
 315                         goto error;
 316                 }
 317                 attr = defattr;
 318         } else {
 319                 /*
 320                  * HACK: Set the channel's subdomain (JUL, Log4j, Python, etc.)
 321                  * based on the default name.
 322                  */
 323                 if (!strcmp(attr->name, DEFAULT_JUL_CHANNEL_NAME)) {
 324                         domain = LTTNG_DOMAIN_JUL;
 325                 } else if (!strcmp(attr->name, DEFAULT_LOG4J_CHANNEL_NAME)) {
 326                         domain = LTTNG_DOMAIN_LOG4J;
 327                 } else if (!strcmp(attr->name, DEFAULT_PYTHON_CHANNEL_NAME)) {
 328                         domain = LTTNG_DOMAIN_PYTHON;
 329                 }
 330         }
 331
 332         /*
 333          * Set the overwrite mode for this channel based on the session
 334          * type unless the client explicitly overrides the channel mode.
 335          */
 336         if (attr->attr.overwrite == DEFAULT_CHANNEL_OVERWRITE) {
 337                 if (usess->snapshot_mode) {
 338                         attr->attr.overwrite = 1;
 339                 } else {
 340                         attr->attr.overwrite = 0;
 341                 }
 342         }
 343
 344         /* Enforce mmap output for snapshot sessions. */
 345         if (usess->snapshot_mode) {
 346                 attr->attr.output = LTTNG_EVENT_MMAP;
 347         }
 348
 349         /* Validate common channel properties. */
 350         if (channel_validate(attr) < 0) {
 351                 ret = LTTNG_ERR_INVALID;
 352                 goto error;
 353         }
 354
 355         /*
 356          * Validate UST buffer size and number of buffers: must both be power of 2
 357          * and nonzero. We validate right here for UST, because applications will
 358          * not report the error to the user (unlike kernel tracing).
 359          */
 360         if (!attr->attr.subbuf_size ||
 361                         (attr->attr.subbuf_size & (attr->attr.subbuf_size - 1))) {
 362                 ret = LTTNG_ERR_INVALID;
 363                 goto error;
 364         }
 365
 366         /*
 367          * Invalid subbuffer size if it's lower then the page size.
 368          */
 369         if (attr->attr.subbuf_size < page_size) {
 370                 ret = LTTNG_ERR_INVALID;
 371                 goto error;
 372         }
 373
 374         if (!attr->attr.num_subbuf ||
 375                         (attr->attr.num_subbuf & (attr->attr.num_subbuf - 1))) {
 376                 ret = LTTNG_ERR_INVALID;
 377                 goto error;
 378         }
 379
 380         if (attr->attr.output != LTTNG_EVENT_MMAP) {
 381                 ret = LTTNG_ERR_NOT_SUPPORTED;
 382                 goto error;
 383         }
 384
 385         /*
 386          * The tracefile_size should not be < to the subbuf_size, otherwise
 387          * we won't be able to write the packets on disk
 388          */
 389         if ((attr->attr.tracefile_size > 0) &&
 390                         (attr->attr.tracefile_size < attr->attr.subbuf_size)) {
 391                 ret = LTTNG_ERR_INVALID;
 392                 goto error;
 393         }
 394
 395         /* Validate buffer type. */
 396         switch (type) {
 397         case LTTNG_BUFFER_PER_PID:
 398                 break;
 399         case LTTNG_BUFFER_PER_UID:
 400                 break;
 401         default:
 402                 ret = LTTNG_ERR_BUFFER_NOT_SUPPORTED;
 403                 goto error;
 404         }
 405
 406         /* Create UST channel */
 407         uchan = trace_ust_create_channel(attr, domain);
 408         if (uchan == NULL) {
 409                 ret = LTTNG_ERR_FATAL;
 410                 goto error;
 411         }
 412
 413         uchan->enabled = 1;
 414         if (trace_ust_is_max_id(usess->used_channel_id)) {
 415                 ret = LTTNG_ERR_UST_CHAN_FAIL;
 416                 goto error;
 417         }
 418         uchan->id = trace_ust_get_next_chan_id(usess);
 419
 420         DBG2("Channel %s is being created for UST with buffer %d and id %" PRIu64,
 421                         uchan->name, type, uchan->id);
 422
 423         /* Flag session buffer type. */
 424         if (!usess->buffer_type_changed) {
 425                 usess->buffer_type = type;
 426                 usess->buffer_type_changed = 1;
 427         } else if (usess->buffer_type != type) {
 428                 /* Buffer type was already set. Refuse to create channel. */
 429                 ret = LTTNG_ERR_BUFFER_TYPE_MISMATCH;
 430                 goto error_free_chan;
 431         }
 432
 433         /* Enable channel for global domain */
 434         ret = ust_app_create_channel_glb(usess, uchan);
 435         if (ret < 0 && ret != -LTTNG_UST_ERR_EXIST) {
 436                 ret = LTTNG_ERR_UST_CHAN_FAIL;
 437                 goto error_free_chan;
 438         }
 439
 440         /* Adding the channel to the channel hash table. */
 441         rcu_read_lock();
 442         if (strncmp(uchan->name, DEFAULT_METADATA_NAME,
 443                                 sizeof(uchan->name))) {
 444                 lttng_ht_add_unique_str(usess->domain_global.channels, &uchan->node);
 445         } else {
 446                 /*
 447                  * Copy channel attribute to session if this is metadata so if NO
 448                  * application exists we can access that data in the shadow copy during
 449                  * the global update of newly registered application.
 450                  */
 451                 memcpy(&usess->metadata_attr, &uchan->attr,
 452                                 sizeof(usess->metadata_attr));
 453         }
 454         rcu_read_unlock();
 455
 456         DBG2("Channel %s created successfully", uchan->name);
 457         if (domain != LTTNG_DOMAIN_UST) {
 458                 struct agent *agt = trace_ust_find_agent(usess, domain);
 459
 460                 if (!agt) {
 461                         agt = agent_create(domain);
 462                         if (!agt) {
 463                                 ret = LTTNG_ERR_NOMEM;
 464                                 goto error_free_chan;
 465                         }
 466                         agent_add(agt, usess->agents);
 467                 }
 468         }
 469
 470         free(defattr);
 471         return LTTNG_OK;
 472
 473 error_free_chan:
 474         /*
 475          * No need to remove the channel from the hash table because at this point
 476          * it was not added hence the direct call and no call_rcu().
 477          */
 478         trace_ust_destroy_channel(uchan);
 479 error:
 480         free(defattr);
 481         return ret;
 482 }
 483
 484 /*
 485  * Disable UST channel for session and domain.
 486  */
 487 int channel_ust_disable(struct ltt_ust_session *usess,
 488                 struct ltt_ust_channel *uchan)
 489 {
 490         int ret = LTTNG_OK;
 491
 492         assert(usess);
 493         assert(uchan);
 494
 495         /* Already disabled */
 496         if (uchan->enabled == 0) {
 497                 DBG2("Channel UST %s already disabled", uchan->name);
 498                 goto end;
 499         }
 500
 501         DBG2("Channel %s being disabled in UST global domain", uchan->name);
 502         /* Disable channel for global domain */
 503         ret = ust_app_disable_channel_glb(usess, uchan);
 504         if (ret < 0 && ret != -LTTNG_UST_ERR_EXIST) {
 505                 ret = LTTNG_ERR_UST_CHAN_DISABLE_FAIL;
 506                 goto error;
 507         }
 508
 509         uchan->enabled = 0;
 510
 511         DBG2("Channel %s disabled successfully", uchan->name);
 512
 513         return LTTNG_OK;
 514
 515 end:
 516 error:
 517         return ret;
 518 }