include/lttng/endpoint.h

   1 /*
   2  * Copyright (C) 2017 Jérémie Galarneau <jeremie.galarneau@efficios.com>
   3  *
   4  * SPDX-License-Identifier: LGPL-2.1-only
   5  *
   6  */
   7
   8 #ifndef LTTNG_ENDPOINT_H
   9 #define LTTNG_ENDPOINT_H
  10
  11 #ifdef __cplusplus
  12 extern "C" {
  13 #endif
  14
  15 /*
  16  * Default LTTng session daemon notification endpoint singleton.
  17  *
  18  * For use during the creation of a notification channel. This endpoint
  19  * implements the following policy to connect to a session daemon's
  20  * notification delivery channel:
  21  *   - If the caller is root or part of the tracing group:
  22  *     - Attempt to connect to the "root" (global) session daemon,
  23  *     - Fallback to the session daemon running as the caller's user.
  24  *   - Otherwise (caller is an unpriviliged user):
  25  *     - Attempt to connect to the session daemon running as the caller's user.
  26  */
  27 extern struct lttng_endpoint *lttng_session_daemon_notification_endpoint;
  28
  29 /*
  30  * Default LTTng session daemon command endpoint singleton.
  31  *
  32  * For use as part of the invocation of a command. This endpoint
  33  * implements the following policy to connect to a session daemon's
  34  * command channel:
  35  *   - If the caller is root or part of the tracing group:
  36  *     - Attempt to connect to the "root" (global) session daemon,
  37  *     - Fallback to the session daemon running as the caller's user.
  38  *   - Otherwise (caller is an unpriviliged user):
  39  *     - Attempt to connect to the session daemon running as the caller's user.
  40  */
  41 extern struct lttng_endpoint *lttng_session_daemon_command_endpoint;
  42
  43 #ifdef __cplusplus
  44 }
  45 #endif
  46
  47 #endif /* LTTNG_ENDPOINT_H */