liblttsessiondcomm/liblttsessiondcomm.h

   1 /* Copyright (C) 2011 - David Goulet <david.goulet@polymtl.ca>
   2  *
   3  * This program is free software; you can redistribute it and/or
   4  * modify it under the terms of the GNU General Public License
   5  * as published by the Free Software Foundation; either version 2
   6  * of the License, or (at your option) any later version.
   7  *
   8  * This program is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11  * GNU General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public License
  14  * along with this program; if not, write to the Free Software
  15  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  16  *
  17  */
  18
  19 #ifndef _LIBLTTSESSIONDCOMM_H
  20 #define _LIBLTTSESSIONDCOMM_H
  21
  22 #include <limits.h>
  23 #include <uuid/uuid.h>
  24
  25 /* Default unix socket path */
  26 #define DEFAULT_GLOBAL_CLIENT_UNIX_SOCK         "/tmp/client-ltt-sessiond"
  27 #define DEFAULT_GLOBAL_APPS_UNIX_SOCK           "/tmp/apps-ltt-sessiond"
  28 #define DEFAULT_HOME_APPS_UNIX_SOCK                     "%s/.apps-ltt-sessiond"
  29 #define DEFAULT_HOME_CLIENT_UNIX_SOCK           "%s/.client-ltt-sessiond"
  30
  31 /* Queue size of listen(2) */
  32 #define MAX_LISTEN 10
  33
  34 /* Get the error code index from 0 since
  35  * LTTCOMM_OK start at 1000
  36  */
  37 #define LTTCOMM_ERR_INDEX(code) (code - LTTCOMM_OK)
  38
  39 enum lttcomm_command_type {
  40         LTTNG_CREATE_SESSION,
  41         LTTNG_DESTROY_SESSION,
  42         LTTNG_FORCE_SUBBUF_SWITCH,
  43         LTTNG_GET_ALL_SESSION,
  44         LTTNG_GET_SOCK_PATH,
  45         LTTNG_GET_SUBBUF_NUM_SIZE,
  46         LTTNG_LIST_MARKERS,
  47         LTTNG_LIST_SESSIONS,
  48         LTTNG_LIST_TRACE_EVENTS,
  49         LTTNG_SETUP_TRACE,
  50         LTTNG_SET_SOCK_PATH,
  51         LTTNG_SET_SUBBUF_NUM,
  52         LTTNG_SET_SUBBUF_SIZE,
  53         UST_ALLOC_TRACE,
  54         UST_CREATE_TRACE,
  55         UST_DESTROY_TRACE,
  56         UST_DISABLE_MARKER,
  57         UST_ENABLE_MARKER,
  58         UST_LIST_APPS,
  59         UST_START_TRACE,
  60         UST_STOP_TRACE,
  61 };
  62
  63 /*
  64  * lttcomm error code.
  65  */
  66 enum lttcomm_return_code {
  67         LTTCOMM_OK = 1000,              /* Ok */
  68         LTTCOMM_ERR,                    /* Unknown Error */
  69         LTTCOMM_UND,                    /* Undefine command */
  70         LTTCOMM_ALLOC_FAIL,             /* Trace allocation fail */
  71         LTTCOMM_NO_SESSION,             /* No session found */
  72         LTTCOMM_CREATE_FAIL,    /* Create trace fail */
  73         LTTCOMM_SESSION_FAIL,   /* Create session fail */
  74         LTTCOMM_START_FAIL,             /* Start tracing fail */
  75         LTTCOMM_LIST_FAIL,              /* Listing apps fail */
  76         LTTCOMM_NO_APPS,                /* No traceable application */
  77         LTTCOMM_NR,                             /* Last element */
  78 };
  79
  80 /*
  81  * Data structure for ltt-session received message
  82  */
  83 struct lttcomm_session_msg {
  84         /* Common data to almost all command */
  85         enum lttcomm_command_type cmd_type;
  86         uuid_t session_id;
  87         char trace_name[NAME_MAX];
  88         char session_name[NAME_MAX];
  89         pid_t pid;
  90         union {
  91                 struct {
  92                         int auto_session;
  93                 } create_session;
  94                 /* Marker data */
  95                 struct {
  96                         char channel[NAME_MAX];
  97                         char marker[NAME_MAX];
  98                 } marker;
  99                 /* SET_SOCK_PATH */
 100                 struct {
 101                         char sock_path[PATH_MAX];
 102                 } sock_path;
 103                 /* SET_SUBBUF_NUM */
 104                 struct {
 105                         unsigned int subbuf_num;
 106                         char channel[NAME_MAX];
 107                 } subbuf_num;
 108                 /* SET_SUBBUF_SIZE */
 109                 struct {
 110                         unsigned int subbuf_size;
 111                         char channel[NAME_MAX];
 112                 } subbuf_size;
 113         } u;
 114 };
 115
 116 /*
 117  * Data structure for the lttng client response
 118  */
 119 struct lttcomm_lttng_msg {
 120         enum lttcomm_command_type cmd_type;
 121         enum lttcomm_return_code ret_code;
 122         uuid_t session_id;
 123         pid_t pid;
 124         char trace_name[NAME_MAX];
 125         /* This flag indicates how many packet are in
 126          * the transmission. Ex: If list apps is requested,
 127          * and there is 4 pids registered, num_pckt will be 4
 128          */
 129         unsigned int num_pckt;
 130         union {
 131                 /* UST_LIST_APPS */
 132                 struct {
 133                         pid_t pid;
 134                 } list_apps;
 135         } u;
 136 };
 137
 138 extern int lttcomm_create_unix_sock(const char *pathname);
 139 extern int lttcomm_connect_unix_sock(const char *pathname);
 140 extern int lttcomm_accept_unix_sock(int sock);
 141 extern int lttcomm_listen_unix_sock(int sock);
 142 extern ssize_t lttcomm_recv_unix_sock(int sock, void *buf, size_t len);
 143 extern ssize_t lttcomm_send_unix_sock(int sock, void *buf, size_t len);
 144 extern const char *lttcomm_get_readable_code(enum lttcomm_return_code code);
 145
 146 #endif  /* _LIBLTTSESSIONDCOMM_H */