fix sync with last babeltrace updates to live handling
[lttngtop.git] / lib / babeltrace / ctf / types.h
CommitLineData
b1acd2b3
JD
1#ifndef _BABELTRACE_CTF_TYPES_H
2#define _BABELTRACE_CTF_TYPES_H
3
4/*
5 * Common Trace Format
6 *
7 * Type header
8 *
9 * Copyright 2010 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
10 *
11 * Permission is hereby granted, free of charge, to any person obtaining a copy
12 * of this software and associated documentation files (the "Software"), to deal
13 * in the Software without restriction, including without limitation the rights
14 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
15 * copies of the Software, and to permit persons to whom the Software is
16 * furnished to do so, subject to the following conditions:
17 *
18 * The above copyright notice and this permission notice shall be included in
19 * all copies or substantial portions of the Software.
20 *
21 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
24 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
26 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
27 * SOFTWARE.
28 */
29
30#include <babeltrace/types.h>
31#include <babeltrace/babeltrace-internal.h>
32#include <sys/types.h>
33#include <sys/stat.h>
34#include <fcntl.h>
35#include <errno.h>
36#include <stdint.h>
37#include <unistd.h>
38#include <glib.h>
39#include <stdio.h>
40#include <inttypes.h>
41#include <babeltrace/mmap-align.h>
42
43#define LAST_OFFSET_POISON ((int64_t) ~0ULL)
44
45struct bt_stream_callbacks;
46
3bac1a1f
JD
47struct packet_index_time {
48 uint64_t timestamp_begin;
49 uint64_t timestamp_end;
50};
51
b1acd2b3
JD
52struct packet_index {
53 off_t offset; /* offset of the packet in the file, in bytes */
54 int64_t data_offset; /* offset of data within the packet, in bits */
55 uint64_t packet_size; /* packet size, in bits */
56 uint64_t content_size; /* content size, in bits */
b1acd2b3
JD
57 uint64_t events_discarded;
58 uint64_t events_discarded_len; /* length of the field, in bits */
3bac1a1f
JD
59 struct packet_index_time ts_cycles; /* timestamp in cycles */
60 struct packet_index_time ts_real; /* realtime timestamp */
b1acd2b3
JD
61};
62
63/*
64 * Always update ctf_stream_pos with ctf_move_pos and ctf_init_pos.
65 */
66struct ctf_stream_pos {
67 struct bt_stream_pos parent;
68 int fd; /* backing file fd. -1 if unset. */
12a91e9d 69 FILE *index_fp; /* backing index file fp. NULL if unset. */
3bac1a1f 70 GArray *packet_index; /* contains struct packet_index */
b1acd2b3
JD
71 int prot; /* mmap protection */
72 int flags; /* mmap flags */
73
74 /* Current position */
75 off_t mmap_offset; /* mmap offset in the file, in bytes */
76 off_t mmap_base_offset; /* offset of start of packet in mmap, in bytes */
77 uint64_t packet_size; /* current packet size, in bits */
78 uint64_t content_size; /* current content size, in bits */
79 uint64_t *content_size_loc; /* pointer to current content size */
80 struct mmap_align *base_mma;/* mmap base address */
81 int64_t offset; /* offset from base, in bits. EOF for end of file. */
82 int64_t last_offset; /* offset before the last read_event */
12a91e9d 83 int64_t data_offset; /* offset of data in current packet */
b1acd2b3
JD
84 uint64_t cur_index; /* current index in packet index */
85 uint64_t last_events_discarded; /* last known amount of event discarded */
86 void (*packet_seek)(struct bt_stream_pos *pos, size_t index,
87 int whence); /* function called to switch packet */
88
89 int dummy; /* dummy position, for length calculation */
90 struct bt_stream_callbacks *cb; /* Callbacks registered for iterator. */
12a91e9d 91 void *priv;
b1acd2b3
JD
92};
93
94static inline
95struct ctf_stream_pos *ctf_pos(struct bt_stream_pos *pos)
96{
97 return container_of(pos, struct ctf_stream_pos, parent);
98}
99
100BT_HIDDEN
101int ctf_integer_read(struct bt_stream_pos *pos, struct bt_definition *definition);
102BT_HIDDEN
103int ctf_integer_write(struct bt_stream_pos *pos, struct bt_definition *definition);
104BT_HIDDEN
105int ctf_float_read(struct bt_stream_pos *pos, struct bt_definition *definition);
106BT_HIDDEN
107int ctf_float_write(struct bt_stream_pos *pos, struct bt_definition *definition);
108BT_HIDDEN
109int ctf_string_read(struct bt_stream_pos *pos, struct bt_definition *definition);
110BT_HIDDEN
111int ctf_string_write(struct bt_stream_pos *pos, struct bt_definition *definition);
112BT_HIDDEN
113int ctf_enum_read(struct bt_stream_pos *pos, struct bt_definition *definition);
114BT_HIDDEN
115int ctf_enum_write(struct bt_stream_pos *pos, struct bt_definition *definition);
116BT_HIDDEN
117int ctf_struct_rw(struct bt_stream_pos *pos, struct bt_definition *definition);
118BT_HIDDEN
119int ctf_variant_rw(struct bt_stream_pos *pos, struct bt_definition *definition);
120BT_HIDDEN
121int ctf_array_read(struct bt_stream_pos *pos, struct bt_definition *definition);
122BT_HIDDEN
123int ctf_array_write(struct bt_stream_pos *pos, struct bt_definition *definition);
124BT_HIDDEN
125int ctf_sequence_read(struct bt_stream_pos *pos, struct bt_definition *definition);
126BT_HIDDEN
127int ctf_sequence_write(struct bt_stream_pos *pos, struct bt_definition *definition);
128
129void ctf_packet_seek(struct bt_stream_pos *pos, size_t index, int whence);
130
131int ctf_init_pos(struct ctf_stream_pos *pos, struct bt_trace_descriptor *trace,
132 int fd, int open_flags);
133int ctf_fini_pos(struct ctf_stream_pos *pos);
134
135/*
136 * move_pos - move position of a relative bit offset
137 *
12a91e9d
JD
138 * Return 1 if OK, 0 if out-of-bound.
139 *
b1acd2b3
JD
140 * TODO: allow larger files by updating base too.
141 */
142static inline
12a91e9d 143int ctf_move_pos(struct ctf_stream_pos *pos, uint64_t bit_offset)
b1acd2b3 144{
12a91e9d
JD
145 uint64_t max_len;
146
b1acd2b3
JD
147 printf_debug("ctf_move_pos test EOF: %" PRId64 "\n", pos->offset);
148 if (unlikely(pos->offset == EOF))
12a91e9d
JD
149 return 0;
150 if (pos->prot == PROT_READ)
151 max_len = pos->content_size;
152 else
153 max_len = pos->packet_size;
154 if (unlikely(pos->offset + bit_offset > max_len))
155 return 0;
156
b1acd2b3
JD
157 pos->offset += bit_offset;
158 printf_debug("ctf_move_pos after increment: %" PRId64 "\n", pos->offset);
12a91e9d 159 return 1;
b1acd2b3
JD
160}
161
162/*
163 * align_pos - align position on a bit offset (> 0)
164 *
12a91e9d
JD
165 * Return 1 if OK, 0 if out-of-bound.
166 *
b1acd2b3
JD
167 * TODO: allow larger files by updating base too.
168 */
169static inline
12a91e9d 170int ctf_align_pos(struct ctf_stream_pos *pos, uint64_t bit_offset)
b1acd2b3 171{
12a91e9d 172 return ctf_move_pos(pos, offset_align(pos->offset, bit_offset));
b1acd2b3
JD
173}
174
175static inline
176char *ctf_get_pos_addr(struct ctf_stream_pos *pos)
177{
178 /* Only makes sense to get the address after aligning on CHAR_BIT */
179 assert(!(pos->offset % CHAR_BIT));
180 return mmap_align_addr(pos->base_mma) +
181 pos->mmap_base_offset + (pos->offset / CHAR_BIT);
182}
183
184static inline
185void ctf_dummy_pos(struct ctf_stream_pos *pos, struct ctf_stream_pos *dummy)
186{
187 memcpy(dummy, pos, sizeof(struct ctf_stream_pos));
188 dummy->dummy = 1;
189 dummy->fd = -1;
190}
191
192/*
193 * Check if current packet can hold data.
194 * Returns 0 for success, negative error otherwise.
195 */
196static inline
197int ctf_pos_packet(struct ctf_stream_pos *dummy)
198{
199 if (unlikely(dummy->offset > dummy->packet_size))
200 return -ENOSPC;
201 return 0;
202}
203
204static inline
205void ctf_pos_pad_packet(struct ctf_stream_pos *pos)
206{
12a91e9d 207 ctf_packet_seek(&pos->parent, 0, SEEK_CUR);
b1acd2b3
JD
208}
209
210static inline
211int ctf_pos_access_ok(struct ctf_stream_pos *pos, uint64_t bit_len)
212{
12a91e9d
JD
213 uint64_t max_len;
214
b1acd2b3
JD
215 if (unlikely(pos->offset == EOF))
216 return 0;
12a91e9d
JD
217 if (pos->prot == PROT_READ)
218 max_len = pos->content_size;
219 else
220 max_len = pos->packet_size;
221 if (unlikely(pos->offset + bit_len > max_len))
b1acd2b3
JD
222 return 0;
223 return 1;
224}
225
226/*
12a91e9d 227 * Update the stream position to the current event. This moves to
b1acd2b3
JD
228 * the next packet if we are located at the end of the current packet.
229 */
230static inline
231void ctf_pos_get_event(struct ctf_stream_pos *pos)
232{
233 assert(pos->offset <= pos->content_size);
234 if (pos->offset == pos->content_size) {
235 printf_debug("ctf_packet_seek (before call): %" PRId64 "\n",
236 pos->offset);
237 pos->packet_seek(&pos->parent, 0, SEEK_CUR);
238 printf_debug("ctf_packet_seek (after call): %" PRId64 "\n",
239 pos->offset);
240 }
241}
242
243void ctf_print_timestamp(FILE *fp, struct ctf_stream_definition *stream,
244 uint64_t timestamp);
245
246#endif /* _BABELTRACE_CTF_TYPES_H */
This page took 0.047223 seconds and 4 git commands to generate.