src/lib/lttng-ctl/lttng-ctl-helper.h

   1 /*
   2  * Copyright (C) 2013 David Goulet <dgoulet@efficios.com>
   3  *
   4  * SPDX-License-Identifier: LGPL-2.1-only
   5  *
   6  */
   7
   8 #ifndef LTTNG_CTL_HELPER_H
   9 #define LTTNG_CTL_HELPER_H
  10
  11 #include <stdio.h>
  12
  13 #include <common/sessiond-comm/sessiond-comm.h>
  14 #include <lttng/lttng.h>
  15
  16 /*
  17  * NOTE: Every symbol in this helper header MUST be set to hidden so not to
  18  * polute the library name space. Use LTTNG_HIDDEN macro before declaring the
  19  * function in the C file.
  20  */
  21
  22 /* Copy helper functions. */
  23 void lttng_ctl_copy_string(char *dst, const char *src, size_t len);
  24 void lttng_ctl_copy_lttng_domain(struct lttng_domain *dst,
  25                 struct lttng_domain *src);
  26
  27 /*
  28  * Sends the lttcomm message to the session daemon and fills buf if the
  29  * returned data is not NULL.
  30  *
  31  * Return the size of the received data on success or else a negative lttng
  32  * error code. If buf is NULL, 0 is returned on success.
  33  */
  34 int lttng_ctl_ask_sessiond_fds_varlen(struct lttcomm_session_msg *lsm,
  35                 const int *fds, size_t nb_fd,
  36                 const void *vardata, size_t vardata_len,
  37                 void **user_payload_buf, void **user_cmd_header_buf,
  38                 size_t *user_cmd_header_len);
  39
  40 /*
  41  * Calls lttng_ctl_ask_sessiond_fds_varlen() with no expected command header.
  42  */
  43 static inline int lttng_ctl_ask_sessiond_varlen_no_cmd_header(
  44                 struct lttcomm_session_msg *lsm,
  45                 const void *vardata,
  46                 size_t vardata_len,
  47                 void **user_payload_buf)
  48 {
  49         return lttng_ctl_ask_sessiond_fds_varlen(lsm, NULL, 0, vardata,
  50                 vardata_len, user_payload_buf, NULL, NULL);
  51 }
  52
  53 /*
  54  * Calls lttng_ctl_ask_sessiond_fds_varlen() with fds and no expected command header.
  55  */
  56 static inline
  57 int lttng_ctl_ask_sessiond_fds_no_cmd_header(struct lttcomm_session_msg *lsm,
  58                 const int *fds, size_t nb_fd, void **buf)
  59 {
  60         return lttng_ctl_ask_sessiond_fds_varlen(lsm, fds, nb_fd, NULL,
  61                 0, NULL, NULL, NULL);
  62 }
  63 /*
  64  * Use this if no variable length data needs to be sent.
  65  */
  66 static inline
  67 int lttng_ctl_ask_sessiond(struct lttcomm_session_msg *lsm, void **buf)
  68 {
  69         return lttng_ctl_ask_sessiond_varlen_no_cmd_header(lsm, NULL, 0, buf);
  70 }
  71
  72 int lttng_check_tracing_group(void);
  73
  74 int connect_sessiond(void);
  75
  76 #endif /* LTTNG_CTL_HELPER_H */