X-Git-Url: http://git.efficios.com/?p=babeltrace.git;a=blobdiff_plain;f=src%2Flib%2Fgraph%2Fmessage%2Fiterator.h;h=b587735d4c48de40e4d486a837c0300988803c40;hp=36795bd083baa4e7902ada7a788d87604e37a3c7;hb=0235b0db7de5bcacdb3650c92461f2ce5eb2143d;hpb=54b135a0370e1ff40ff39515058b2f941955cd40 diff --git a/src/lib/graph/message/iterator.h b/src/lib/graph/message/iterator.h index 36795bd0..b587735d 100644 --- a/src/lib/graph/message/iterator.h +++ b/src/lib/graph/message/iterator.h @@ -1,118 +1,122 @@ -#ifndef BABELTRACE_GRAPH_MESSAGE_ITERATOR_INTERNAL_H -#define BABELTRACE_GRAPH_MESSAGE_ITERATOR_INTERNAL_H - /* + * SPDX-License-Identifier: MIT + * * Copyright 2017-2018 Philippe Proulx * Copyright 2015 Jérémie Galarneau - * - * Permission is hereby granted, free of charge, to any person obtaining a copy - * of this software and associated documentation files (the "Software"), to deal - * in the Software without restriction, including without limitation the rights - * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell - * copies of the Software, and to permit persons to whom the Software is - * furnished to do so, subject to the following conditions: - * - * The above copyright notice and this permission notice shall be included in - * all copies or substantial portions of the Software. - * - * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR - * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, - * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE - * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER - * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, - * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE - * SOFTWARE. */ +#ifndef BABELTRACE_GRAPH_MESSAGE_ITERATOR_INTERNAL_H +#define BABELTRACE_GRAPH_MESSAGE_ITERATOR_INTERNAL_H + #include "common/macros.h" #include "lib/object.h" -#include -#include -#include +#include +#include #include #include "common/assert.h" #include -#include +#include "common/uuid.h" struct bt_port; struct bt_graph; -enum bt_message_iterator_type { - BT_MESSAGE_ITERATOR_TYPE_SELF_COMPONENT_PORT_INPUT, - BT_MESSAGE_ITERATOR_TYPE_PORT_OUTPUT, -}; - -enum bt_self_component_port_input_message_iterator_state { +enum bt_message_iterator_state { /* Iterator is not initialized */ - BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_NON_INITIALIZED, + BT_MESSAGE_ITERATOR_STATE_NON_INITIALIZED, /* Iterator is active, not at the end yet, and not finalized */ - BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_ACTIVE, + BT_MESSAGE_ITERATOR_STATE_ACTIVE, /* * Iterator is ended, not finalized yet: the "next" method * returns BT_MESSAGE_ITERATOR_STATUS_END. */ - BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_ENDED, + BT_MESSAGE_ITERATOR_STATE_ENDED, /* Iterator is currently being finalized */ - BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_FINALIZING, + BT_MESSAGE_ITERATOR_STATE_FINALIZING, /* Iterator is finalized */ - BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_FINALIZED, + BT_MESSAGE_ITERATOR_STATE_FINALIZED, /* Iterator is seeking */ - BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_SEEKING, + BT_MESSAGE_ITERATOR_STATE_SEEKING, /* Iterator did seek, but returned `BT_MESSAGE_ITERATOR_STATUS_AGAIN` */ - BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_LAST_SEEKING_RETURNED_AGAIN, + BT_MESSAGE_ITERATOR_STATE_LAST_SEEKING_RETURNED_AGAIN, /* Iterator did seek, but returned error status */ - BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_LAST_SEEKING_RETURNED_ERROR, + BT_MESSAGE_ITERATOR_STATE_LAST_SEEKING_RETURNED_ERROR, }; -struct bt_message_iterator { - struct bt_object base; - enum bt_message_iterator_type type; - GPtrArray *msgs; -}; - -typedef enum bt_self_message_iterator_status -(*bt_self_component_port_input_message_iterator_next_method)( +typedef enum bt_message_iterator_class_next_method_status +(*bt_message_iterator_next_method)( void *, bt_message_array_const, uint64_t, uint64_t *); -typedef enum bt_self_message_iterator_status -(*bt_self_component_port_input_message_iterator_seek_ns_from_origin_method)( +typedef enum bt_message_iterator_class_seek_ns_from_origin_method_status +(*bt_message_iterator_seek_ns_from_origin_method)( void *, int64_t); -typedef enum bt_self_message_iterator_status -(*bt_self_component_port_input_message_iterator_seek_beginning_method)( +typedef enum bt_message_iterator_class_seek_beginning_method_status +(*bt_message_iterator_seek_beginning_method)( void *); -typedef bt_bool -(*bt_self_component_port_input_message_iterator_can_seek_ns_from_origin_method)( - void *, int64_t); +typedef enum bt_message_iterator_class_can_seek_ns_from_origin_method_status +(*bt_message_iterator_can_seek_ns_from_origin_method)( + void *, int64_t, bt_bool *); -typedef bt_bool -(*bt_self_component_port_input_message_iterator_can_seek_beginning_method)( - void *); +typedef enum bt_message_iterator_class_can_seek_beginning_method_status +(*bt_message_iterator_can_seek_beginning_method)( + void *, bt_bool *); -struct bt_self_component_port_input_message_iterator { - struct bt_message_iterator base; +struct bt_self_message_iterator_configuration { + bool frozen; + bool can_seek_forward; +}; + +struct bt_message_iterator { + struct bt_object base; + GPtrArray *msgs; struct bt_component *upstream_component; /* Weak */ struct bt_port *upstream_port; /* Weak */ struct bt_connection *connection; /* Weak */ struct bt_graph *graph; /* Weak */ + struct bt_self_message_iterator_configuration config; + + /* + * Array of + * `struct bt_message_iterator *` + * (weak). + * + * This is an array of upstream message iterators on which this + * iterator depends. The references are weak: an upstream + * message iterator is responsible for removing its entry within + * this array on finalization/destruction. + */ + GPtrArray *upstream_msg_iters; + + /* + * Downstream message iterator which depends on this message + * iterator (weak). + * + * This can be `NULL` if this message iterator's owner is a sink + * component. + */ + struct bt_message_iterator *downstream_msg_iter; struct { - bt_self_component_port_input_message_iterator_next_method next; - bt_self_component_port_input_message_iterator_seek_ns_from_origin_method seek_ns_from_origin; - bt_self_component_port_input_message_iterator_seek_beginning_method seek_beginning; - bt_self_component_port_input_message_iterator_can_seek_ns_from_origin_method can_seek_ns_from_origin; - bt_self_component_port_input_message_iterator_can_seek_beginning_method can_seek_beginning; + bt_message_iterator_next_method next; + + /* These two are always both set or both unset. */ + bt_message_iterator_seek_ns_from_origin_method seek_ns_from_origin; + bt_message_iterator_can_seek_ns_from_origin_method can_seek_ns_from_origin; + + /* These two are always both set or both unset. */ + bt_message_iterator_seek_beginning_method seek_beginning; + bt_message_iterator_can_seek_beginning_method can_seek_beginning; } methods; - enum bt_self_component_port_input_message_iterator_state state; + enum bt_message_iterator_state state; /* * Timestamp of the last received message (or INT64_MIN in the @@ -145,7 +149,7 @@ struct bt_self_component_port_input_message_iterator { * irrelevant (as the clock will be correlatable with other * clocks having the same origin). */ - uint8_t uuid[BABELTRACE_UUID_LEN]; + bt_uuid_t uuid; } clock_expectation; /* @@ -179,46 +183,34 @@ struct bt_self_component_port_input_message_iterator { void *user_data; }; -struct bt_port_output_message_iterator { - struct bt_message_iterator base; - struct bt_graph *graph; /* Owned by this */ - struct bt_component_sink *colander; /* Owned by this */ - - /* - * Only used temporarily as a bridge between a colander sink and - * the user. - */ - uint64_t count; -}; - BT_HIDDEN -void bt_self_component_port_input_message_iterator_try_finalize( - struct bt_self_component_port_input_message_iterator *iterator); +void bt_message_iterator_try_finalize( + struct bt_message_iterator *iterator); BT_HIDDEN -void bt_self_component_port_input_message_iterator_set_connection( - struct bt_self_component_port_input_message_iterator *iterator, +void bt_message_iterator_set_connection( + struct bt_message_iterator *iterator, struct bt_connection *connection); static inline -const char *bt_self_component_port_input_message_iterator_state_string( - enum bt_self_component_port_input_message_iterator_state state) +const char *bt_message_iterator_state_string( + enum bt_message_iterator_state state) { switch (state) { - case BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_ACTIVE: - return "BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_ACTIVE"; - case BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_ENDED: - return "BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_ENDED"; - case BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_FINALIZING: - return "BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_FINALIZING"; - case BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_FINALIZED: - return "BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_FINALIZED"; - case BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_SEEKING: - return "BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_SEEKING"; - case BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_LAST_SEEKING_RETURNED_AGAIN: - return "BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_LAST_SEEKING_RETURNED_AGAIN"; - case BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_LAST_SEEKING_RETURNED_ERROR: - return "BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_STATE_LAST_SEEKING_RETURNED_ERROR"; + case BT_MESSAGE_ITERATOR_STATE_ACTIVE: + return "ACTIVE"; + case BT_MESSAGE_ITERATOR_STATE_ENDED: + return "ENDED"; + case BT_MESSAGE_ITERATOR_STATE_FINALIZING: + return "FINALIZING"; + case BT_MESSAGE_ITERATOR_STATE_FINALIZED: + return "FINALIZED"; + case BT_MESSAGE_ITERATOR_STATE_SEEKING: + return "SEEKING"; + case BT_MESSAGE_ITERATOR_STATE_LAST_SEEKING_RETURNED_AGAIN: + return "LAST_SEEKING_RETURNED_AGAIN"; + case BT_MESSAGE_ITERATOR_STATE_LAST_SEEKING_RETURNED_ERROR: + return "LAST_SEEKING_RETURNED_ERROR"; default: return "(unknown)"; }