libcounter/counter.h

   1 /*
   2  * lttng/counter.h
   3  *
   4  * LTTng Counters API
   5  *
   6  * Copyright (C) 2020 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
   7  *
   8  * Permission is hereby granted, free of charge, to any person obtaining a copy
   9  * of this software and associated documentation files (the "Software"), to deal
  10  * in the Software without restriction, including without limitation the rights
  11  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  12  * copies of the Software, and to permit persons to whom the Software is
  13  * furnished to do so, subject to the following conditions:
  14  *
  15  * The above copyright notice and this permission notice shall be included in
  16  * all copies or substantial portions of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  21  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  22  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  23  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  24  * SOFTWARE.
  25  */
  26
  27 #ifndef _LTTNG_COUNTER_H
  28 #define _LTTNG_COUNTER_H
  29
  30 #include <stdint.h>
  31 #include <lttng/ust-config.h>
  32 #include "counter-types.h"
  33
  34 /* max_nr_elem is for each dimension. */
  35 struct lib_counter *lttng_counter_create(const struct lib_counter_config *config,
  36                                          size_t nr_dimensions,
  37                                          const size_t *max_nr_elem,
  38                                          int64_t global_sum_step,
  39                                          int global_counter_fd,
  40                                          int nr_counter_cpu_fds,
  41                                          const int *counter_cpu_fds,
  42                                          bool is_daemon);
  43 void lttng_counter_destroy(struct lib_counter *counter);
  44
  45 int lttng_counter_set_global_shm(struct lib_counter *counter, int fd);
  46 int lttng_counter_set_cpu_shm(struct lib_counter *counter, int cpu, int fd);
  47
  48 int lttng_counter_get_global_shm(struct lib_counter *counter, int *fd, size_t *len);
  49 int lttng_counter_get_cpu_shm(struct lib_counter *counter, int cpu, int *fd, size_t *len);
  50
  51 int lttng_counter_read(const struct lib_counter_config *config,
  52                        struct lib_counter *counter,
  53                        const size_t *dimension_indexes,
  54                        int cpu, int64_t *value,
  55                        bool *overflow, bool *underflow);
  56 int lttng_counter_aggregate(const struct lib_counter_config *config,
  57                             struct lib_counter *counter,
  58                             const size_t *dimension_indexes,
  59                             int64_t *value,
  60                             bool *overflow, bool *underflow);
  61 int lttng_counter_clear(const struct lib_counter_config *config,
  62                         struct lib_counter *counter,
  63                         const size_t *dimension_indexes);
  64
  65 #endif /* _LTTNG_COUNTER_H */