1 #ifndef BABELTRACE_LIB_COPY_TRACE_H
2 #define BABELTRACE_LIB_COPY_TRACE_H
5 * BabelTrace - Library to create a copy of a CTF trace
7 * Copyright 2017 Julien Desfossez <jdesfossez@efficios.com>
9 * Author: Julien Desfossez <jdesfossez@efficios.com>
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:
18 * The above copyright notice and this permission notice shall be included in
19 * all copies or substantial portions of the Software.
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
31 #include <babeltrace/babeltrace-internal.h>
32 #include <babeltrace/babeltrace.h>
39 * Create a copy of the clock_class passed in parameter.
41 * Returns NULL on error.
43 struct bt_clock_class
*ctf_copy_clock_class(FILE *err
,
44 struct bt_clock_class
*clock_class
);
47 * Copy all the clock classes from the input trace and add them to the writer
50 * Returns BT_COMPONENT_STATUS_OK on success, and BT_COMPONENT_STATUS_ERROR on
54 enum bt_component_status
ctf_copy_clock_classes(FILE *err
,
55 struct bt_trace
*writer_trace
,
56 struct bt_stream_class
*writer_stream_class
,
57 struct bt_trace
*trace
);
60 * Create a copy of the event class passed in parameter.
62 * Returns NULL on error.
65 struct bt_event_class
*ctf_copy_event_class(FILE *err
,
66 struct bt_event_class
*event_class
);
69 * Copy all the event classes from the input stream class and add them to the
70 * writer_stream_class.
72 * Returns BT_COMPONENT_STATUS_OK on success, and BT_COMPONENT_STATUS_ERROR on
76 enum bt_component_status
ctf_copy_event_classes(FILE *err
,
77 struct bt_stream_class
*stream_class
,
78 struct bt_stream_class
*writer_stream_class
);
81 * Create a copy of the stream class passed in parameter.
83 * Returns NULL or error.
86 struct bt_stream_class
*ctf_copy_stream_class(FILE *err
,
87 struct bt_stream_class
*stream_class
,
88 struct bt_trace
*writer_trace
,
92 * Copy the value of a packet context field and add it to the
93 * writer_packet_context. Only supports unsigned integers for now.
95 * Returns BT_COMPONENT_STATUS_OK on success, and BT_COMPONENT_STATUS_ERROR on
99 enum bt_component_status
ctf_copy_packet_context_field(FILE *err
,
100 struct bt_field
*field
, const char *field_name
,
101 struct bt_field
*writer_packet_context
,
102 struct bt_field_type
*writer_packet_context_type
);
106 * Copy the packet_header from the packet passed in parameter and assign it
107 * to the writer_stream.
109 * Returns 0 on success or -1 on error.
112 int ctf_stream_copy_packet_header(FILE *err
, struct bt_packet
*packet
,
113 struct bt_stream
*writer_stream
);
116 * Copy the packet_header from the packet passed in parameter and assign it
117 * to the writer_packet.
119 * Returns 0 on success or -1 on error.
122 int ctf_packet_copy_header(FILE *err
, struct bt_packet
*packet
,
123 struct bt_packet
*writer_packet
);
126 * Copy all the field values of the packet context from the packet passed in
127 * parameter and set it to the writer_stream.
129 * Returns 0 on success or -1 on error.
132 int ctf_stream_copy_packet_context(FILE *err
, struct bt_packet
*packet
,
133 struct bt_stream
*writer_stream
);
136 * Copy all the field values of the packet context from the packet passed in
137 * parameter and set it to the writer_packet.
139 * Returns 0 on success or -1 on error.
142 int ctf_packet_copy_context(FILE *err
, struct bt_packet
*packet
,
143 struct bt_stream
*writer_stream
,
144 struct bt_packet
*writer_packet
);
147 * Create and return a copy of the event passed in parameter. The caller has to
148 * append it to the writer_stream.
150 * Returns NULL on error.
153 struct bt_event
*ctf_copy_event(FILE *err
, struct bt_event
*event
,
154 struct bt_event_class
*writer_event_class
,
158 * Copies the content of the event header to writer_event_header.
160 * Returns 0 on success, -1 on error.
163 int ctf_copy_event_header(FILE *err
, struct bt_event
*event
,
164 struct bt_event_class
*writer_event_class
,
165 struct bt_event
*writer_event
,
166 struct bt_field
*event_header
);
169 * Copy the environment and the packet header from the input trace to the
172 * Returns BT_COMPONENT_STATUS_OK on success, and BT_COMPONENT_STATUS_ERROR on
176 enum bt_component_status
ctf_copy_trace(FILE *err
, struct bt_trace
*trace
,
177 struct bt_trace
*writer_trace
);
183 #endif /* BABELTRACE_LIB_COPY_TRACE_H */