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/graph/component.h>
33 #include <babeltrace/ctf-writer/writer.h>
40 * Create a copy of the clock_class passed in parameter.
42 * Returns NULL on error.
44 struct bt_ctf_clock_class
*ctf_copy_clock_class(FILE *err
,
45 struct bt_ctf_clock_class
*clock_class
);
48 * Copy all the clock classes from the input trace and add them to the writer
51 * Returns BT_COMPONENT_STATUS_OK on success, and BT_COMPONENT_STATUS_ERROR on
55 enum bt_component_status
ctf_copy_clock_classes(FILE *err
,
56 struct bt_ctf_trace
*writer_trace
,
57 struct bt_ctf_stream_class
*writer_stream_class
,
58 struct bt_ctf_trace
*trace
);
61 * Create a copy of the event class passed in paramater.
63 * Returns NULL on error.
66 struct bt_ctf_event_class
*ctf_copy_event_class(FILE *err
,
67 struct bt_ctf_event_class
*event_class
);
70 * Copy all the event classes from the input stream class and add them to the
71 * writer_stream_class.
73 * Returns BT_COMPONENT_STATUS_OK on success, and BT_COMPONENT_STATUS_ERROR on
77 enum bt_component_status
ctf_copy_event_classes(FILE *err
,
78 struct bt_ctf_stream_class
*stream_class
,
79 struct bt_ctf_stream_class
*writer_stream_class
);
82 * Create a copy of the stream class passed in parameter.
84 * Returns NULL or error.
87 struct bt_ctf_stream_class
*ctf_copy_stream_class(FILE *err
,
88 struct bt_ctf_stream_class
*stream_class
,
89 struct bt_ctf_trace
*writer_trace
,
93 * Copy the value of a packet context field and add it to the
94 * writer_packet_context. Only supports unsigned integers for now.
96 * Returns BT_COMPONENT_STATUS_OK on success, and BT_COMPONENT_STATUS_ERROR on
100 enum bt_component_status
ctf_copy_packet_context_field(FILE *err
,
101 struct bt_ctf_field
*field
, const char *field_name
,
102 struct bt_ctf_field
*writer_packet_context
,
103 struct bt_ctf_field_type
*writer_packet_context_type
);
106 * Copy all the field values of the packet context from the packet passed in
107 * parameter and set it to the current packet in the writer stream.
109 * Returns BT_COMPONENT_STATUS_OK on success, and BT_COMPONENT_STATUS_ERROR on
113 struct bt_ctf_field
*ctf_copy_packet_context(FILE *err
,
114 struct bt_ctf_packet
*packet
,
115 struct bt_ctf_stream
*writer_stream
);
118 * Create and return a copy of the event passed in parameter. The caller has to
119 * append it to the writer_stream.
121 * Returns NULL on error.
124 struct bt_ctf_event
*ctf_copy_event(FILE *err
, struct bt_ctf_event
*event
,
125 struct bt_ctf_event_class
*writer_event_class
,
129 * Copies the content of the event header to writer_event_header.
131 * Returns 0 on success, -1 on error.
134 int ctf_copy_event_header(FILE *err
, struct bt_ctf_event
*event
,
135 struct bt_ctf_event_class
*writer_event_class
,
136 struct bt_ctf_event
*writer_event
,
137 struct bt_ctf_field
*event_header
);
140 * Copy the environment and the packet header from the input trace to the
143 * Returns BT_COMPONENT_STATUS_OK on success, and BT_COMPONENT_STATUS_ERROR on
147 enum bt_component_status
ctf_copy_trace(FILE *err
, struct bt_ctf_trace
*trace
,
148 struct bt_ctf_trace
*writer_trace
);
154 #endif /* BABELTRACE_LIB_COPY_TRACE_H */