ltt-control/liblttctl/lttctl.h

   1 /* libltt header file
   2  *
   3  * Copyright 2005-
   4  *     Mathieu Desnoyers <mathieu.desnoyers@polymtl.ca>
   5  *
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  *
  18  * Inspired from iptables, by James Morris <jmorris@intercode.com.au>.
  19  *
  20  */
  21
  22 #ifndef _LIBLTT_H
  23 #define _LIBLTT_H
  24
  25 #include <linux/limits.h>
  26 #include <asm/types.h>
  27 #include <sys/socket.h>
  28 #include <linux/netlink.h>
  29
  30 #ifndef NETLINK_LTT
  31 #define NETLINK_LTT 31
  32 #endif
  33
  34
  35 enum trace_op {
  36         OP_CREATE,
  37         OP_DESTROY,
  38         OP_START,
  39         OP_STOP,
  40         OP_NONE
  41 };
  42
  43 enum trace_mode {
  44         LTT_TRACE_NORMAL,
  45         LTT_TRACE_FLIGHT
  46 };
  47
  48 typedef struct lttctl_peer_msg {
  49         char trace_name[NAME_MAX];
  50         enum trace_op op;
  51         union {
  52     struct {
  53       enum trace_mode mode;
  54       unsigned subbuf_size;
  55       unsigned n_subbufs;
  56     } new_trace;
  57         } args;
  58 } lttctl_peer_msg_t;
  59
  60
  61 struct lttctl_handle
  62 {
  63   int fd;
  64   //u_int8_t blocking;
  65   struct sockaddr_nl local;
  66   struct sockaddr_nl peer;
  67 };
  68
  69 typedef struct lttctl_resp_msg {
  70         int err;
  71 } lttctl_resp_msg_t;
  72
  73 struct lttctl_handle *lttctl_create_handle(void);
  74
  75 int lttctl_destroy_handle(struct lttctl_handle *h);
  76
  77
  78 int lttctl_create_trace(const struct lttctl_handle *h,
  79                 char *name, enum trace_mode mode, unsigned subbuf_size, unsigned n_subbufs);
  80
  81 int lttctl_destroy_trace(const struct lttctl_handle *handle, char *name);
  82
  83 int lttctl_start(const struct lttctl_handle *handle, char *name);
  84
  85 int lttctl_stop(const struct lttctl_handle *handle, char *name);
  86
  87 #define LTTCTLM_BASE    0x10
  88 #define LTTCTLM_CONTROL (LTTCTLM_BASE + 1)      /* LTT control message */
  89
  90
  91 #endif //_LIBLTT_H