include/lttng/notification/notification-internal.h

   1 /*
   2  * Copyright (C) 2017 - Jérémie Galarneau <jeremie.galarneau@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_NOTIFICATION_INTERNAL_H
  19 #define LTTNG_NOTIFICATION_INTERNAL_H
  20
  21 #include <lttng/notification/notification.h>
  22 #include <common/macros.h>
  23 #include <stdint.h>
  24 #include <stdbool.h>
  25
  26 struct lttng_notification {
  27         struct lttng_condition *condition;
  28         struct lttng_evaluation *evaluation;
  29         bool owns_elements;
  30 };
  31
  32 struct lttng_notification_comm {
  33         /* length excludes its own length. */
  34         uint32_t length;
  35         /* A condition and evaluation object follow. */
  36         char payload[];
  37 } LTTNG_PACKED;
  38
  39 LTTNG_HIDDEN
  40 struct lttng_notification *lttng_notification_create(
  41                 struct lttng_condition *condition,
  42                 struct lttng_evaluation *evaluation);
  43
  44 LTTNG_HIDDEN
  45 ssize_t lttng_notification_serialize(struct lttng_notification *notification,
  46                 char *buf);
  47
  48 /*
  49  * FIXME Add explicit buffer bound checking using a "len" parameter to
  50  * ensure malformed buffers are caught and rejected.
  51  */
  52 LTTNG_HIDDEN
  53 ssize_t lttng_notification_create_from_buffer(const char *buf,
  54                 struct lttng_notification **notification);
  55
  56 #endif /* LTTNG_NOTIFICATION_INTERNAL_H */