liblttng-ust-ctl/ustctl.c

   1 /*
   2  * Copyright (C) 2011 - Julien Desfossez <julien.desfossez@polymtl.ca>
   3  *                      Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
   4  *
   5  * This program is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU General Public License
   7  * as published by the Free Software Foundation; only version 2
   8  * of the License.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  18  */
  19
  20 #include <string.h>
  21 #include <lttng/ust-ctl.h>
  22 #include <lttng/ust-abi.h>
  23 #include <lttng/ust-events.h>
  24 #include <sys/mman.h>
  25
  26 #include <usterr-signal-safe.h>
  27 #include <ust-comm.h>
  28
  29 #include "../libringbuffer/backend.h"
  30 #include "../libringbuffer/frontend.h"
  31
  32 volatile enum ust_loglevel ust_loglevel;
  33
  34 static
  35 void init_object(struct lttng_ust_object_data *data)
  36 {
  37         data->handle = -1;
  38         data->shm_fd = -1;
  39         data->wait_fd = -1;
  40         data->memory_map_size = 0;
  41 }
  42
  43 int ustctl_release_handle(int sock, int handle)
  44 {
  45         struct ustcomm_ust_msg lum;
  46         struct ustcomm_ust_reply lur;
  47         int ret;
  48
  49         if (sock >= 0) {
  50                 memset(&lum, 0, sizeof(lum));
  51                 lum.handle = handle;
  52                 lum.cmd = LTTNG_UST_RELEASE;
  53                 ret = ustcomm_send_app_cmd(sock, &lum, &lur);
  54                 if (ret < 0) {
  55                         return ret;
  56                 }
  57         }
  58         return 0;
  59 }
  60 /*
  61  * If sock is negative, it means we don't have to notify the other side
  62  * (e.g. application has already vanished).
  63  */
  64 int ustctl_release_object(int sock, struct lttng_ust_object_data *data)
  65 {
  66         int ret;
  67
  68         if (data->shm_fd >= 0) {
  69                 ret = close(data->shm_fd);
  70                 if (ret < 0) {
  71                         return ret;
  72                 }
  73         }
  74         if (data->wait_fd >= 0) {
  75                 ret = close(data->wait_fd);
  76                 if (ret < 0) {
  77                         return ret;
  78                 }
  79         }
  80         return ustctl_release_handle(sock, data->handle);
  81 }
  82
  83 /*
  84  * Send registration done packet to the application.
  85  */
  86 int ustctl_register_done(int sock)
  87 {
  88         struct ustcomm_ust_msg lum;
  89         struct ustcomm_ust_reply lur;
  90         int ret;
  91
  92         DBG("Sending register done command to %d", sock);
  93         memset(&lum, 0, sizeof(lum));
  94         lum.handle = LTTNG_UST_ROOT_HANDLE;
  95         lum.cmd = LTTNG_UST_REGISTER_DONE;
  96         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
  97         if (ret)
  98                 return ret;
  99         if (lur.ret_code != USTCOMM_OK) {
 100                 DBG("Return code: %s", ustcomm_get_readable_code(lur.ret_code));
 101                 goto error;
 102         }
 103         return 0;
 104
 105 error:
 106         return -1;
 107 }
 108
 109 /*
 110  * returns session handle.
 111  */
 112 int ustctl_create_session(int sock)
 113 {
 114         struct ustcomm_ust_msg lum;
 115         struct ustcomm_ust_reply lur;
 116         int ret, session_handle;
 117
 118         /* Create session */
 119         memset(&lum, 0, sizeof(lum));
 120         lum.handle = LTTNG_UST_ROOT_HANDLE;
 121         lum.cmd = LTTNG_UST_SESSION;
 122         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 123         if (ret)
 124                 return ret;
 125         session_handle = lur.ret_val;
 126         DBG("received session handle %u", session_handle);
 127         return session_handle;
 128 }
 129
 130 /* open the metadata global channel */
 131 int ustctl_open_metadata(int sock, int session_handle,
 132                 struct lttng_ust_channel_attr *chops,
 133                 struct lttng_ust_object_data **_metadata_data)
 134 {
 135         struct ustcomm_ust_msg lum;
 136         struct ustcomm_ust_reply lur;
 137         struct lttng_ust_object_data *metadata_data;
 138         int ret, err = 0;
 139
 140         metadata_data = malloc(sizeof(*metadata_data));
 141         if (!metadata_data)
 142                 return -ENOMEM;
 143         init_object(metadata_data);
 144         /* Create metadata channel */
 145         memset(&lum, 0, sizeof(lum));
 146         lum.handle = session_handle;
 147         lum.cmd = LTTNG_UST_METADATA;
 148         lum.u.channel.overwrite = chops->overwrite;
 149         lum.u.channel.subbuf_size = chops->subbuf_size;
 150         lum.u.channel.num_subbuf = chops->num_subbuf;
 151         lum.u.channel.switch_timer_interval = chops->switch_timer_interval;
 152         lum.u.channel.read_timer_interval = chops->read_timer_interval;
 153         lum.u.channel.output = chops->output;
 154         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 155         if (ret) {
 156                 free(metadata_data);
 157                 return ret;
 158         }
 159         if (lur.ret_code != USTCOMM_OK) {
 160                 free(metadata_data);
 161                 return lur.ret_code;
 162         }
 163         metadata_data->handle = lur.ret_val;
 164         DBG("received metadata handle %u", metadata_data->handle);
 165         metadata_data->memory_map_size = lur.u.channel.memory_map_size;
 166         /* get shm fd */
 167         ret = ustcomm_recv_fd(sock);
 168         if (ret < 0)
 169                 err = 1;
 170         else
 171                 metadata_data->shm_fd = ret;
 172         /*
 173          * We need to get the second FD even if the first fails, because
 174          * libust expects us to read the two FDs.
 175          */
 176         /* get wait fd */
 177         ret = ustcomm_recv_fd(sock);
 178         if (ret < 0)
 179                 err = 1;
 180         else
 181                 metadata_data->wait_fd = ret;
 182         if (err)
 183                 goto error;
 184         *_metadata_data = metadata_data;
 185         return 0;
 186
 187 error:
 188         (void) ustctl_release_object(sock, metadata_data);
 189         free(metadata_data);
 190         return -EINVAL;
 191 }
 192
 193 int ustctl_create_channel(int sock, int session_handle,
 194                 struct lttng_ust_channel_attr *chops,
 195                 struct lttng_ust_object_data **_channel_data)
 196 {
 197         struct ustcomm_ust_msg lum;
 198         struct ustcomm_ust_reply lur;
 199         struct lttng_ust_object_data *channel_data;
 200         int ret, err = 0;
 201
 202         channel_data = malloc(sizeof(*channel_data));
 203         if (!channel_data)
 204                 return -ENOMEM;
 205         init_object(channel_data);
 206         /* Create metadata channel */
 207         memset(&lum, 0, sizeof(lum));
 208         lum.handle = session_handle;
 209         lum.cmd = LTTNG_UST_CHANNEL;
 210         lum.u.channel.overwrite = chops->overwrite;
 211         lum.u.channel.subbuf_size = chops->subbuf_size;
 212         lum.u.channel.num_subbuf = chops->num_subbuf;
 213         lum.u.channel.switch_timer_interval = chops->switch_timer_interval;
 214         lum.u.channel.read_timer_interval = chops->read_timer_interval;
 215         lum.u.channel.output = chops->output;
 216         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 217         if (ret) {
 218                 free(channel_data);
 219                 return ret;
 220         }
 221         if (lur.ret_code != USTCOMM_OK) {
 222                 free(channel_data);
 223                 return lur.ret_code;
 224         }
 225         channel_data->handle = lur.ret_val;
 226         DBG("received channel handle %u", channel_data->handle);
 227         channel_data->memory_map_size = lur.u.channel.memory_map_size;
 228         /* get shm fd */
 229         ret = ustcomm_recv_fd(sock);
 230         if (ret < 0)
 231                 err = 1;
 232         else
 233                 channel_data->shm_fd = ret;
 234         /*
 235          * We need to get the second FD even if the first fails, because
 236          * libust expects us to read the two FDs.
 237          */
 238         /* get wait fd */
 239         ret = ustcomm_recv_fd(sock);
 240         if (ret < 0)
 241                 err = 1;
 242         else
 243                 channel_data->wait_fd = ret;
 244         if (err)
 245                 goto error;
 246         *_channel_data = channel_data;
 247         return 0;
 248
 249 error:
 250         (void) ustctl_release_object(sock, channel_data);
 251         free(channel_data);
 252         return -EINVAL;
 253 }
 254
 255 /*
 256  * Return -ENOENT if no more stream is available for creation.
 257  * Return 0 on success.
 258  * Return negative error value on error.
 259  */
 260 int ustctl_create_stream(int sock, struct lttng_ust_object_data *channel_data,
 261                 struct lttng_ust_object_data **_stream_data)
 262 {
 263         struct ustcomm_ust_msg lum;
 264         struct ustcomm_ust_reply lur;
 265         struct lttng_ust_object_data *stream_data;
 266         int ret, fd, err = 0;
 267
 268         stream_data = malloc(sizeof(*stream_data));
 269         if (!stream_data)
 270                 return -ENOMEM;
 271         init_object(stream_data);
 272         memset(&lum, 0, sizeof(lum));
 273         lum.handle = channel_data->handle;
 274         lum.cmd = LTTNG_UST_STREAM;
 275         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 276         if (ret) {
 277                 free(stream_data);
 278                 return ret;
 279         }
 280         if (lur.ret_code != USTCOMM_OK) {
 281                 free(stream_data);
 282                 return lur.ret_code;
 283         }
 284
 285         stream_data->handle = lur.ret_val;
 286         DBG("received stream handle %u", stream_data->handle);
 287         stream_data->memory_map_size = lur.u.stream.memory_map_size;
 288         /* get shm fd */
 289         fd = ustcomm_recv_fd(sock);
 290         if (fd < 0)
 291                 err = 1;
 292         else
 293                 stream_data->shm_fd = fd;
 294         /*
 295          * We need to get the second FD even if the first fails, because
 296          * libust expects us to read the two FDs.
 297          */
 298         /* get wait fd */
 299         fd = ustcomm_recv_fd(sock);
 300         if (fd < 0)
 301                 err = 1;
 302         else
 303                 stream_data->wait_fd = fd;
 304         if (err)
 305                 goto error;
 306         *_stream_data = stream_data;
 307         return ret;
 308
 309 error:
 310         (void) ustctl_release_object(sock, stream_data);
 311         free(stream_data);
 312         return -EINVAL;
 313 }
 314
 315 int ustctl_create_event(int sock, struct lttng_ust_event *ev,
 316                 struct lttng_ust_object_data *channel_data,
 317                 struct lttng_ust_object_data **_event_data)
 318 {
 319         struct ustcomm_ust_msg lum;
 320         struct ustcomm_ust_reply lur;
 321         struct lttng_ust_object_data *event_data;
 322         int ret;
 323
 324         event_data = malloc(sizeof(*event_data));
 325         if (!event_data)
 326                 return -ENOMEM;
 327         init_object(event_data);
 328         memset(&lum, 0, sizeof(lum));
 329         lum.handle = channel_data->handle;
 330         lum.cmd = LTTNG_UST_EVENT;
 331         strncpy(lum.u.event.name, ev->name,
 332                 LTTNG_UST_SYM_NAME_LEN);
 333         lum.u.event.instrumentation = ev->instrumentation;
 334         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 335         if (ret) {
 336                 free(event_data);
 337                 return ret;
 338         }
 339         event_data->handle = lur.ret_val;
 340         DBG("received event handle %u", event_data->handle);
 341         *_event_data = event_data;
 342         return 0;
 343 }
 344
 345 int ustctl_add_context(int sock, struct lttng_ust_context *ctx,
 346                 struct lttng_ust_object_data *obj_data,
 347                 struct lttng_ust_object_data **_context_data)
 348 {
 349         struct ustcomm_ust_msg lum;
 350         struct ustcomm_ust_reply lur;
 351         struct lttng_ust_object_data *context_data;
 352         int ret;
 353
 354         context_data = malloc(sizeof(*context_data));
 355         if (!context_data)
 356                 return -ENOMEM;
 357         init_object(context_data);
 358         memset(&lum, 0, sizeof(lum));
 359         lum.handle = obj_data->handle;
 360         lum.cmd = LTTNG_UST_CONTEXT;
 361         lum.u.context.ctx = ctx->ctx;
 362         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 363         if (ret) {
 364                 free(context_data);
 365                 return ret;
 366         }
 367         context_data->handle = lur.ret_val;
 368         DBG("received context handle %u", context_data->handle);
 369         *_context_data = context_data;
 370         return ret;
 371 }
 372
 373 /* Enable event, channel and session ioctl */
 374 int ustctl_enable(int sock, struct lttng_ust_object_data *object)
 375 {
 376         struct ustcomm_ust_msg lum;
 377         struct ustcomm_ust_reply lur;
 378         int ret;
 379
 380         memset(&lum, 0, sizeof(lum));
 381         lum.handle = object->handle;
 382         lum.cmd = LTTNG_UST_ENABLE;
 383         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 384         if (ret)
 385                 return ret;
 386         DBG("enabled handle %u", object->handle);
 387         return 0;
 388 }
 389
 390 /* Disable event, channel and session ioctl */
 391 int ustctl_disable(int sock, struct lttng_ust_object_data *object)
 392 {
 393         struct ustcomm_ust_msg lum;
 394         struct ustcomm_ust_reply lur;
 395         int ret;
 396
 397         memset(&lum, 0, sizeof(lum));
 398         lum.handle = object->handle;
 399         lum.cmd = LTTNG_UST_DISABLE;
 400         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 401         if (ret)
 402                 return ret;
 403         DBG("disable handle %u", object->handle);
 404         return 0;
 405 }
 406
 407 int ustctl_start_session(int sock, int handle)
 408 {
 409         struct lttng_ust_object_data obj;
 410
 411         obj.handle = handle;
 412         return ustctl_enable(sock, &obj);
 413 }
 414
 415 int ustctl_stop_session(int sock, int handle)
 416 {
 417         struct lttng_ust_object_data obj;
 418
 419         obj.handle = handle;
 420         return ustctl_disable(sock, &obj);
 421 }
 422
 423 int ustctl_tracepoint_list(int sock)
 424 {
 425         struct ustcomm_ust_msg lum;
 426         struct ustcomm_ust_reply lur;
 427         int ret, tp_list_handle;
 428
 429         memset(&lum, 0, sizeof(lum));
 430         lum.handle = LTTNG_UST_ROOT_HANDLE;
 431         lum.cmd = LTTNG_UST_TRACEPOINT_LIST;
 432         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 433         if (ret)
 434                 return ret;
 435         tp_list_handle = lur.ret_val;
 436         DBG("received tracepoint list handle %u", tp_list_handle);
 437         return tp_list_handle;
 438 }
 439
 440 int ustctl_tracepoint_list_get(int sock, int tp_list_handle,
 441                 struct lttng_ust_tracepoint_iter *iter)
 442 {
 443         struct ustcomm_ust_msg lum;
 444         struct ustcomm_ust_reply lur;
 445         int ret;
 446
 447         memset(&lum, 0, sizeof(lum));
 448         lum.handle = tp_list_handle;
 449         lum.cmd = LTTNG_UST_TRACEPOINT_LIST_GET;
 450         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 451         if (ret)
 452                 return ret;
 453         DBG("received tracepoint list entry name %s loglevel %s loglevel_value %lld",
 454                 lur.u.tracepoint.name,
 455                 lur.u.tracepoint.loglevel,
 456                 (unsigned long long) lur.u.tracepoint.loglevel_value);
 457         memcpy(iter, &lur.u.tracepoint, sizeof(*iter));
 458         return 0;
 459 }
 460
 461 int ustctl_tracer_version(int sock, struct lttng_ust_tracer_version *v)
 462 {
 463         struct ustcomm_ust_msg lum;
 464         struct ustcomm_ust_reply lur;
 465         int ret;
 466
 467         memset(&lum, 0, sizeof(lum));
 468         lum.handle = LTTNG_UST_ROOT_HANDLE;
 469         lum.cmd = LTTNG_UST_TRACER_VERSION;
 470         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 471         if (ret)
 472                 return ret;
 473         memcpy(v, &lur.u.version, sizeof(*v));
 474         DBG("received tracer version");
 475         return 0;
 476 }
 477
 478 int ustctl_wait_quiescent(int sock)
 479 {
 480         struct ustcomm_ust_msg lum;
 481         struct ustcomm_ust_reply lur;
 482         int ret;
 483
 484         memset(&lum, 0, sizeof(lum));
 485         lum.handle = LTTNG_UST_ROOT_HANDLE;
 486         lum.cmd = LTTNG_UST_WAIT_QUIESCENT;
 487         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 488         if (ret)
 489                 return ret;
 490         DBG("waited for quiescent state");
 491         return 0;
 492 }
 493
 494 int ustctl_calibrate(int sock, struct lttng_ust_calibrate *calibrate)
 495 {
 496         return -ENOSYS;
 497 }
 498
 499 int ustctl_sock_flush_buffer(int sock, struct lttng_ust_object_data *object)
 500 {
 501         struct ustcomm_ust_msg lum;
 502         struct ustcomm_ust_reply lur;
 503         int ret;
 504
 505         memset(&lum, 0, sizeof(lum));
 506         lum.handle = object->handle;
 507         lum.cmd = LTTNG_UST_FLUSH_BUFFER;
 508         ret = ustcomm_send_app_cmd(sock, &lum, &lur);
 509         if (ret)
 510                 return ret;
 511         DBG("flushed buffer handle %u", object->handle);
 512         return 0;
 513 }
 514
 515 /* Buffer operations */
 516
 517 /* Map channel shm into process memory */
 518 struct lttng_ust_shm_handle *ustctl_map_channel(struct lttng_ust_object_data *chan_data)
 519 {
 520         struct lttng_ust_shm_handle *handle;
 521         struct channel *chan;
 522         size_t chan_size;
 523         struct lttng_ust_lib_ring_buffer_config *config;
 524         int ret;
 525
 526         handle = channel_handle_create(chan_data->shm_fd,
 527                 chan_data->wait_fd,
 528                 chan_data->memory_map_size);
 529         if (!handle) {
 530                 ERR("create handle error");
 531                 return NULL;
 532         }
 533         /*
 534          * Set to -1, and then close the shm fd, and set the handle shm
 535          * fd to -1 too. We don't need the shm fds after they have been
 536          * mapped.
 537          * The wait_fd is set to -1 in chan_data because it is now owned
 538          * by the handle.
 539          */
 540         chan_data->shm_fd = -1;
 541         chan_data->wait_fd = -1;
 542
 543         /* chan is object 0. This is hardcoded. */
 544         if (handle->table->objects[0].shm_fd >= 0) {
 545                 ret = close(handle->table->objects[0].shm_fd);
 546                 if (ret) {
 547                         perror("Error closing shm_fd");
 548                 }
 549                 handle->table->objects[0].shm_fd = -1;
 550         }
 551
 552         /*
 553          * TODO: add consistency checks to be resilient if the
 554          * application try to feed us with incoherent channel structure
 555          * values.
 556          */
 557         chan = shmp(handle, handle->chan);
 558         /* chan is object 0. This is hardcoded. */
 559         chan_size = handle->table->objects[0].allocated_len;
 560         handle->shadow_chan = malloc(chan_size);
 561         if (!handle->shadow_chan) {
 562                 channel_destroy(chan, handle, 1);
 563                 return NULL;
 564         }
 565         memcpy(handle->shadow_chan, chan, chan_size);
 566         /*
 567          * The callback pointers in the producer are invalid in the
 568          * consumer. We need to look them up here.
 569          */
 570         config = &handle->shadow_chan->backend.config;
 571         switch (config->client_type) {
 572         case LTTNG_CLIENT_METADATA:
 573                 memcpy(&config->cb, lttng_client_callbacks_metadata,
 574                         sizeof(config->cb));
 575                 break;
 576         case LTTNG_CLIENT_DISCARD:
 577                 memcpy(&config->cb, lttng_client_callbacks_discard,
 578                         sizeof(config->cb));
 579                 break;
 580         case LTTNG_CLIENT_OVERWRITE:
 581                 memcpy(&config->cb, lttng_client_callbacks_overwrite,
 582                         sizeof(config->cb));
 583                 break;
 584         default:
 585                 ERR("Unknown client type %d", config->client_type);
 586                 channel_destroy(chan, handle, 1);
 587                 return NULL;
 588         }
 589         /* Replace the object table pointer. */
 590         ret = munmap(handle->table->objects[0].memory_map,
 591                 handle->table->objects[0].memory_map_size);
 592         if (ret) {
 593                 perror("munmap");
 594                 assert(0);
 595         }
 596         handle->table->objects[0].memory_map = (char *) handle->shadow_chan;
 597         handle->table->objects[0].is_shadow = 1;
 598         return handle;
 599 }
 600
 601 /* Add stream to channel shm and map its shm into process memory */
 602 int ustctl_add_stream(struct lttng_ust_shm_handle *handle,
 603                 struct lttng_ust_object_data *stream_data)
 604 {
 605         int ret;
 606
 607         if (!stream_data->handle)
 608                 return -ENOENT;
 609         /* map stream */
 610         ret = channel_handle_add_stream(handle,
 611                 stream_data->shm_fd,
 612                 stream_data->wait_fd,
 613                 stream_data->memory_map_size);
 614         if (ret) {
 615                 ERR("add stream error\n");
 616                 return ret;
 617         }
 618         /*
 619          * Set to -1 because the lttng_ust_shm_handle destruction will take care
 620          * of closing shm_fd and wait_fd.
 621          */
 622         stream_data->shm_fd = -1;
 623         stream_data->wait_fd = -1;
 624         return 0;
 625 }
 626
 627 void ustctl_unmap_channel(struct lttng_ust_shm_handle *handle)
 628 {
 629         struct channel *chan;
 630
 631         chan = shmp(handle, handle->chan);
 632         channel_destroy(chan, handle, 1);
 633 }
 634
 635 /*
 636  * ustctl closes the shm_fd fds after mapping it.
 637  */
 638 struct lttng_ust_lib_ring_buffer *ustctl_open_stream_read(struct lttng_ust_shm_handle *handle,
 639         int cpu)
 640 {
 641         struct channel *chan = handle->shadow_chan;
 642         int *shm_fd, *wait_fd;
 643         uint64_t *memory_map_size;
 644         struct lttng_ust_lib_ring_buffer *buf;
 645         int ret;
 646
 647         buf = channel_get_ring_buffer(&chan->backend.config,
 648                 chan, cpu, handle, &shm_fd, &wait_fd, &memory_map_size);
 649         if (!buf)
 650                 return NULL;
 651         ret = lib_ring_buffer_open_read(buf, handle, 1);
 652         if (ret)
 653                 return NULL;
 654         /*
 655          * We can close shm_fd early, right after is has been mapped.
 656          */
 657         if (*shm_fd >= 0) {
 658                 ret = close(*shm_fd);
 659                 if (ret) {
 660                         perror("Error closing shm_fd");
 661                 }
 662                 *shm_fd = -1;
 663         }
 664         return buf;
 665 }
 666
 667 void ustctl_close_stream_read(struct lttng_ust_shm_handle *handle,
 668                 struct lttng_ust_lib_ring_buffer *buf)
 669 {
 670         lib_ring_buffer_release_read(buf, handle, 1);
 671 }
 672
 673 /* For mmap mode, readable without "get" operation */
 674
 675 void *ustctl_get_mmap_base(struct lttng_ust_shm_handle *handle,
 676                 struct lttng_ust_lib_ring_buffer *buf)
 677 {
 678         return shmp(handle, buf->backend.memory_map);
 679 }
 680
 681 /* returns the length to mmap. */
 682 int ustctl_get_mmap_len(struct lttng_ust_shm_handle *handle,
 683                 struct lttng_ust_lib_ring_buffer *buf,
 684                 unsigned long *len)
 685 {
 686         unsigned long mmap_buf_len;
 687         struct channel *chan = handle->shadow_chan;
 688
 689         if (chan->backend.config.output != RING_BUFFER_MMAP)
 690                 return -EINVAL;
 691         mmap_buf_len = chan->backend.buf_size;
 692         if (chan->backend.extra_reader_sb)
 693                 mmap_buf_len += chan->backend.subbuf_size;
 694         if (mmap_buf_len > INT_MAX)
 695                 return -EFBIG;
 696         *len = mmap_buf_len;
 697         return 0;
 698 }
 699
 700 /* returns the maximum size for sub-buffers. */
 701 int ustctl_get_max_subbuf_size(struct lttng_ust_shm_handle *handle,
 702                 struct lttng_ust_lib_ring_buffer *buf,
 703                 unsigned long *len)
 704 {
 705         struct channel *chan = handle->shadow_chan;
 706
 707         *len = chan->backend.subbuf_size;
 708         return 0;
 709 }
 710
 711 /*
 712  * For mmap mode, operate on the current packet (between get/put or
 713  * get_next/put_next).
 714  */
 715
 716 /* returns the offset of the subbuffer belonging to the mmap reader. */
 717 int ustctl_get_mmap_read_offset(struct lttng_ust_shm_handle *handle,
 718                 struct lttng_ust_lib_ring_buffer *buf, unsigned long *off)
 719 {
 720         struct channel *chan = handle->shadow_chan;
 721         unsigned long sb_bindex;
 722
 723         if (chan->backend.config.output != RING_BUFFER_MMAP)
 724                 return -EINVAL;
 725         sb_bindex = subbuffer_id_get_index(&chan->backend.config,
 726                                            buf->backend.buf_rsb.id);
 727         *off = shmp(handle, shmp_index(handle, buf->backend.array, sb_bindex)->shmp)->mmap_offset;
 728         return 0;
 729 }
 730
 731 /* returns the size of the current sub-buffer, without padding (for mmap). */
 732 int ustctl_get_subbuf_size(struct lttng_ust_shm_handle *handle,
 733                 struct lttng_ust_lib_ring_buffer *buf, unsigned long *len)
 734 {
 735         struct channel *chan = handle->shadow_chan;
 736
 737         *len = lib_ring_buffer_get_read_data_size(&chan->backend.config, buf,
 738                 handle);
 739         return 0;
 740 }
 741
 742 /* returns the size of the current sub-buffer, without padding (for mmap). */
 743 int ustctl_get_padded_subbuf_size(struct lttng_ust_shm_handle *handle,
 744                 struct lttng_ust_lib_ring_buffer *buf, unsigned long *len)
 745 {
 746         struct channel *chan = handle->shadow_chan;
 747
 748         *len = lib_ring_buffer_get_read_data_size(&chan->backend.config, buf,
 749                 handle);
 750         *len = PAGE_ALIGN(*len);
 751         return 0;
 752 }
 753
 754 /* Get exclusive read access to the next sub-buffer that can be read. */
 755 int ustctl_get_next_subbuf(struct lttng_ust_shm_handle *handle,
 756                 struct lttng_ust_lib_ring_buffer *buf)
 757 {
 758         return lib_ring_buffer_get_next_subbuf(buf, handle);
 759 }
 760
 761
 762 /* Release exclusive sub-buffer access, move consumer forward. */
 763 int ustctl_put_next_subbuf(struct lttng_ust_shm_handle *handle,
 764                 struct lttng_ust_lib_ring_buffer *buf)
 765 {
 766         lib_ring_buffer_put_next_subbuf(buf, handle);
 767         return 0;
 768 }
 769
 770 /* snapshot */
 771
 772 /* Get a snapshot of the current ring buffer producer and consumer positions */
 773 int ustctl_snapshot(struct lttng_ust_shm_handle *handle,
 774                 struct lttng_ust_lib_ring_buffer *buf)
 775 {
 776         return lib_ring_buffer_snapshot(buf, &buf->cons_snapshot,
 777                         &buf->prod_snapshot, handle);
 778 }
 779
 780 /* Get the consumer position (iteration start) */
 781 int ustctl_snapshot_get_consumed(struct lttng_ust_shm_handle *handle,
 782                 struct lttng_ust_lib_ring_buffer *buf, unsigned long *pos)
 783 {
 784         *pos = buf->cons_snapshot;
 785         return 0;
 786 }
 787
 788 /* Get the producer position (iteration end) */
 789 int ustctl_snapshot_get_produced(struct lttng_ust_shm_handle *handle,
 790                 struct lttng_ust_lib_ring_buffer *buf, unsigned long *pos)
 791 {
 792         *pos = buf->prod_snapshot;
 793         return 0;
 794 }
 795
 796 /* Get exclusive read access to the specified sub-buffer position */
 797 int ustctl_get_subbuf(struct lttng_ust_shm_handle *handle,
 798                 struct lttng_ust_lib_ring_buffer *buf, unsigned long *pos)
 799 {
 800         return lib_ring_buffer_get_subbuf(buf, *pos, handle);
 801 }
 802
 803 /* Release exclusive sub-buffer access */
 804 int ustctl_put_subbuf(struct lttng_ust_shm_handle *handle,
 805                 struct lttng_ust_lib_ring_buffer *buf)
 806 {
 807         lib_ring_buffer_put_subbuf(buf, handle);
 808         return 0;
 809 }
 810
 811 void ustctl_flush_buffer(struct lttng_ust_shm_handle *handle,
 812                 struct lttng_ust_lib_ring_buffer *buf,
 813                 int producer_active)
 814 {
 815         lib_ring_buffer_switch_slow(buf,
 816                 producer_active ? SWITCH_ACTIVE : SWITCH_FLUSH,
 817                 handle);
 818 }