src/common/index/index.h

   1 /*
   2  * Copyright (C) 2013 - Julien Desfossez <jdesfossez@efficios.com>
   3  *                      David Goulet <dgoulet@efficios.com>
   4  *               2016 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
   5  *
   6  * This program is free software; you can redistribute it and/or modify it
   7  * under the terms of the GNU General Public License, version 2 only, as
   8  * published by the Free Software Foundation.
   9  *
  10  * This program is distributed in the hope that it will be useful, but WITHOUT
  11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  12  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  13  * more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along with
  16  * this program; if not, write to the Free Software Foundation, Inc., 51
  17  * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18  */
  19
  20 #ifndef _INDEX_H
  21 #define _INDEX_H
  22
  23 #include <inttypes.h>
  24 #include <urcu/ref.h>
  25
  26 #include "ctf-index.h"
  27 #include <common/fs-handle.h>
  28 #include <common/trace-chunk.h>
  29
  30 struct lttng_index_file {
  31         struct fs_handle *file;
  32         uint32_t major;
  33         uint32_t minor;
  34         uint32_t element_len;
  35         struct lttng_trace_chunk *trace_chunk;
  36         struct urcu_ref ref;
  37 };
  38
  39 /*
  40  * create and open have refcount of 1. Use put to decrement the
  41  * refcount. Destroys when reaching 0. Use "get" to increment refcount.
  42  */
  43 enum lttng_trace_chunk_status lttng_index_file_create_from_trace_chunk(
  44                 struct lttng_trace_chunk *chunk,
  45                 const char *channel_path, const char *stream_name,
  46                 uint64_t stream_file_size, uint64_t stream_count,
  47                 uint32_t index_major, uint32_t index_minor,
  48                 bool unlink_existing_file, struct lttng_index_file **file);
  49
  50 enum lttng_trace_chunk_status lttng_index_file_create_from_trace_chunk_read_only(
  51                 struct lttng_trace_chunk *chunk,
  52                 const char *channel_path, const char *stream_name,
  53                 uint64_t stream_file_size, uint64_t stream_file_index,
  54                 uint32_t index_major, uint32_t index_minor,
  55                 bool expect_no_file, struct lttng_index_file **file);
  56
  57 int lttng_index_file_write(const struct lttng_index_file *index_file,
  58                 const struct ctf_packet_index *element);
  59 int lttng_index_file_read(const struct lttng_index_file *index_file,
  60                 struct ctf_packet_index *element);
  61
  62 void lttng_index_file_get(struct lttng_index_file *index_file);
  63 void lttng_index_file_put(struct lttng_index_file *index_file);
  64
  65 #endif /* _INDEX_H */