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 #include <lttng/lttng-export.h>
  12
  13 #ifdef __cplusplus
  14 extern "C" {
  15 #endif
  16
  17 /*
  18  * Default LTTng session daemon notification endpoint singleton.
  19  *
  20  * For use during the creation of a notification channel. This endpoint
  21  * implements the following policy to connect to a session daemon's
  22  * notification delivery channel:
  23  *   - If the caller is root or part of the tracing group:
  24  *     - Attempt to connect to the "root" (global) session daemon,
  25  *     - Fallback to the session daemon running as the caller's user.
  26  *   - Otherwise (caller is an unpriviliged user):
  27  *     - Attempt to connect to the session daemon running as the caller's user.
  28  */
  29 LTTNG_EXPORT extern struct lttng_endpoint *lttng_session_daemon_notification_endpoint;
  30
  31 /*
  32  * Default LTTng session daemon command endpoint singleton.
  33  *
  34  * For use as part of the invocation of a command. This endpoint
  35  * implements the following policy to connect to a session daemon's
  36  * command channel:
  37  *   - If the caller is root or part of the tracing group:
  38  *     - Attempt to connect to the "root" (global) session daemon,
  39  *     - Fallback to the session daemon running as the caller's user.
  40  *   - Otherwise (caller is an unpriviliged user):
  41  *     - Attempt to connect to the session daemon running as the caller's user.
  42  */
  43 LTTNG_EXPORT extern struct lttng_endpoint *lttng_session_daemon_command_endpoint;
  44
  45 #ifdef __cplusplus
  46 }
  47 #endif
  48
  49 #endif /* LTTNG_ENDPOINT_H */